让非技术人员也能一键使用 DeepSeek Harnessdsh-installer 面向普通用户的一键安装与启动脚本。

让非技术人员也能一键使用 DeepSeek Harness

dsh-installer —— 面向普通用户的一键安装与启动脚本。双击一下，自动完成 Node.js、pnpm、dsh 以及插件的安装与更新，让「启用并管理 DeepSeek Harness」这件事，从此不再需要命令行知识。

DeepSeek Harness（简称 dsh）是一个「一切皆插件」的开源 Agent 框架，能力很强，但它官方给出的启动方式对普通人并不友好：

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	同上

它的逻辑很朴素：

整个过程只用一个双击 + 几次回车。

脚本启动的第一件事就是让你选语言，默认中文、直接回车即可，全程无英文门槛。

语言选择

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

自动安装

想要额外能力（比如某个团队自研插件），也只需一条命令：

dsh plugin --profile web add <包名>

支持 npm 包名、本地 tarball 或 github: 地址，脚本会在交互循环里一个个引导你装完。

每次发新版本，脚本会在后台悄悄检查 GitHub Release（每天最多查一次，带超时，绝不拖慢启动）。下次运行时才提醒你升级，默认「否」，选「是」也只是下载新版本，等再下一次启动才真正替换——正在跑的老版本永远不被打扰。

自更新提醒

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

端口占用处理

万一还是出了错，脚本会把完整错误日志写到本地文件，并明确告诉你路径，方便你转发给开发人员排查，而不是面对一屏看不懂的堆栈。