目录
- 一、安装 nvm 管理 Node 版本
- 二、拉取源码
- 三、安装依赖并启动项目
- 四、配置 API Token
- 五、安装插件
- 六、LuckReport 项目推荐
- 1、项目简介
- 2、在线体验
DeepSeek 最近开源了自己的官方 Agent 运行框架 DeepSeek Harness，简称 dsh。它自带 Web 界面，模型适配、文件编辑、命令执行这些能力都是插件，可以自由替换。这篇文章介绍下怎么把这个 Agent 运行起来，包括用 nvm 装 Node、代理拉源码、启动项目、配置 token 和安装插件。
一、安装 nvm 管理 Node 版本
1、Node 版本要求
dsh 对 Node 版本有硬性要求，package.json 里的 engines 约束是：
^22.19.0||>=24.0.0也就是 Node 22.19.0 及以上，或者 24.0.0 及以上。我机器上原来装的是 Node 16，启动直接报错，装之前记得先看一眼版本。
2、安装 nvm-windows
为了不影响原有项目的 Node 版本，我用 nvm 来做版本切换。Windows 上用的是 nvm-windows，去发布页下载 nvm-setup.exe：
nvm-windows releases
如果 GitHub 下载慢，同样可以在下载链接前面加上 gh-proxy 代理：
https://gh-proxy.com/https://github.com/coreybutler/nvm-windows/releases/download/v1.2.2/nvm-setup.exe安装一路下一步就行，装完重开终端，运行nvm -v能看到版本号就说明装好了。
3、配置国内镜像（可选但建议）
nvm 默认从 Node 官网下载安装包，国内速度很慢，建议先切到淘宝镜像：
# 配置 node 下载镜像，解决 nvm install 卡住的问题nvm node_mirror https://npmmirror.com/mirrors/node/# 配置 npm 镜像nvm npm_mirror https://npmmirror.com/mirrors/npm/4、安装并切换 Node 版本
# 安装 Node 22.19.0，也可以直接 nvm install 24 装最新的nvminstall22.19.0# 切换到该版本，会提示需要管理员权限，用管理员身份打开终端即可nvm use22.19.0# 验证node-v# 输出 v22.19.0npm-v到这里 Node 环境就准备好了，原来的旧版本也还在，需要的时候nvm use 16就能切回去。
二、拉取源码
直接克隆 GitHub 仓库在国内经常卡住或者速度只有几 KB/s，这里用 gh-proxy 做代理加速。用法很简单，在原始 git 链接前面加上https://gh-proxy.com/就行：
# 原始地址：https://github.com/deepseek-ai/deepseek-harness.git# 前面拼接 gh-proxy 代理地址即可加速gitclone https://gh-proxy.com/https://github.com/deepseek-ai/deepseek-harness.git实测走代理后几 MB/s，很快就拉完了。进入项目目录：
cddeepseek-harness三、安装依赖并启动项目
1、安装 pnpm
源码构建需要 pnpm，直接用 npm 全局安装：
# 全局安装 pnpmnpminstall-gpnpm# 验证，能看到版本号就说明装好了pnpm-v2、安装依赖并构建
# 安装依赖pnpminstall# 构建前端产物，这一步不能省，跳过会导致 Web 界面异常pnpmrun build3、启动项目
# 源码模式启动 Web UIpnpmdsh web终端出现类似dsh web: http://127.0.0.1:3080的输出就说明启动成功了，浏览器打开这个地址就能看到界面。
四、配置 API Token
启动 Agent 后还需要配置模型的 API Key。
1、申请 Key
打开 DeepSeek 开放平台，登录后在 API Keys 页面创建一个密钥。注意密钥只在创建那一刻显示一次，要马上复制保存下来。
2、在界面里配置
在 Web 界面左下角进入设置，找到模型配置，把 API Key 粘贴进去保存即可，除了 DeepSeek 外你还可以添加其它模型
如果遇到打开设置页提示 HTTP 403 的情况，可能是浏览器启用了 Page Assist 插件，禁用插件即可
五、安装插件
dsh 的设计就是万物皆插件，官方只提供了一个基础界面，功能扩展主要靠插件。插件安装用dsh plugin命令，源码模式下在前面加pnpm就行：
# npm 包形式的插件，源码模式下用 pnpm dshpnpmdsh plugin--profilewebadd<npm包名># 也可以直接从 GitHub 仓库安装pnpmdsh plugin--profilewebaddgit+https://github.com/<作者>/<仓库>.git# 查看已安装的插件pnpmdsh plugin--profileweb list# 添加一个皮肤插件pnpmdsh plugin--profilewebaddhttps://gh-proxy.org/https://github.com/kingOfSoySauce/dsh-liang-skin/releases/download/v0.1.4/dsh-client-liang-intensity-skin-0.1.4.tgz装完插件要重启pnpm dsh web并刷新页面才能生效，然后在界面的设置里就能看到新装的插件
六、LuckReport 项目推荐
导航：LuckReport专栏
1、项目简介
Luck-Report 是一款基于开源项目 UReport2 重构的 Java 高性能报表引擎，通过迭代单元格可以实现任意复杂的中国式报表。相较于 UReport2，Luck-Report 在技术架构上进行了全新升级，后端基于 SpringBoot 框架开发、前端采用 Vue 框架构建，技术选型贴合当下主流项目开发标准，可精准适配各类实际开发需求。
Luck-Report 提供了全新的基于网页的报表设计器，可以在 Chrome、Firefox、Edge 等各种主流浏览器运行（IE 浏览器除外）。使用 Luck-Report，打开浏览器即可完成各种复杂报表的设计制作。
Luck-Report 基于 Apache-2.0 开源协议开源
2、在线体验
- 体验地址：https://www.quzhe.top/luck-report/report/designer
- 源码地址：https://gitee.com/LuckyPools/luck-report
- 文档地址：https://www.quzhe.top/luck-report-blog/report
