让非技术人员也能一键使用 DeepSeek Harness
dsh-installer ------ 面向普通用户的一键安装与启动脚本。 双击一下,自动完成 Node.js、pnpm、dsh 以及插件的安装与更新, 让「启用并管理 DeepSeek Harness」这件事,从此不再需要命令行知识。
一、为什么需要它
DeepSeek Harness(简称 dsh)是一个「一切皆插件」的开源 Agent 框架,能力很强,但它官方给出的启动方式对普通人并不友好:
sh
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
这条链路要求使用者:会装 Node.js、会装 pnpm、理解「先构建再启动」、忍受漫长的依赖编译。一个只是想「用起来」的非技术用户,大概率在这里就卡住了。
dsh-installer 把上面这一切,压缩成了一次双击。
二、它是什么
dsh-installer 是两个「二合一」脚本:
| 文件 | 平台 | 作用 |
|---|---|---|
dsh.command |
macOS / Linux | 双击即用:已安装则直接启动,未安装则自动安装后启动 |
dsh.bat |
Windows | 同上 |
它的逻辑很朴素:
- 先检测 :机器上有没有可用的
dsh?有 → 直接拉起 Web 界面; - 没有才装:自动装 Node.js → pnpm → dsh,再引导你装想用的插件;
- 装了直接跑 :一切就绪后打开浏览器进入
http://127.0.0.1:3080。
整个过程只用一个双击 + 几次回车。
三、核心特性
1. 语言优先,默认中文
脚本启动的第一件事就是让你选语言,默认中文、直接回车即可,全程无英文门槛。

2. 全自动安装
从检测 Node.js 版本,到装 pnpm、装 dsh、再到可选插件,每一步都有明确的中文进度提示。缺什么装什么,版本不符自动升级。

3. 插件管理
想要额外能力(比如某个团队自研插件),也只需一条命令:
sh
dsh plugin --profile web add <包名>
支持 npm 包名、本地 tarball 或 github: 地址,脚本会在交互循环里一个个引导你装完。
4. 静默自更新
每次发新版本,脚本会在后台悄悄检查 GitHub Release(每天最多查一次,带超时,绝不拖慢启动)。下次运行时才提醒你升级,默认「否」,选「是」也只是下载新版本,等再下一次启动才真正替换------正在跑的老版本永远不被打扰。

5. 端口占用自动处理
重复双击最常见的报错就是「端口已被占用」。脚本会在启动前先探测端口,一旦发现被旧进程占着,直接给你三选一:结束旧进程并重启(推荐,8 秒不选自动执行)、直接打开已运行的页面、或退出。

6. 报错日志落盘
万一还是出了错,脚本会把完整错误日志写到本地文件,并明确告诉你路径,方便你转发给开发人员排查,而不是面对一屏看不懂的堆栈。
四、快速上手
macOS
- 下载
dsh.command; - 双击(首次若被 Gatekeeper 拦截,右键 → 打开);
- 回车选中文,一路回车即可;
- 浏览器自动打开
http://127.0.0.1:3080。
Windows
- 下载
dsh.bat; - 双击;
- 回车选中文,一路回车即可(缺 Node 时会自动通过 winget 安装);
- 浏览器自动打开。
五、适合谁
- 完全不懂技术的用户:想用 DeepSeek Harness 但不会装环境的人,双击就能上车;
- 技术团队的「装机同事」:给新同事、客户、测试人员发两个脚本即可,不用再写千字安装教程;
- 插件作者:想让自己的插件被普通人用上,只需在文章里补一句「装完双击运行」。