◆ 博主名称： QuZhengRong
AI俘虏，样式苦手
目录
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：
如果 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 装最新的
nvm install 22.19.0
# 切换到该版本，会提示需要管理员权限，用管理员身份打开终端即可
nvm use 22.19.0
# 验证
node -v # 输出 v22.19.0
npm -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 代理地址即可加速
git clone https://gh-proxy.com/https://github.com/deepseek-ai/deepseek-harness.git
实测走代理后几 MB/s，很快就拉完了。进入项目目录：
cd deepseek-harness
三、安装依赖并启动项目
1、安装 pnpm
源码构建需要 pnpm，直接用 npm 全局安装：
# 全局安装 pnpm
npm install -g pnpm
# 验证，能看到版本号就说明装好了
pnpm -v
2、安装依赖并构建
# 安装依赖
pnpm install
# 构建前端产物，这一步不能省，跳过会导致 Web 界面异常
pnpm run build
3、启动项目
# 源码模式启动 Web UI
pnpm dsh 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 dsh
pnpm dsh plugin --profile web add <npm包名>
# 也可以直接从 GitHub 仓库安装
pnpm dsh plugin --profile web add git+https://github.com/<作者>/<仓库>.git
# 查看已安装的插件
pnpm dsh plugin --profile web list
# 添加一个皮肤插件
pnpm dsh plugin --profile web add https://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 开源协议 开源
