DeepSeek Harness 保姆级安装教程

DeepSeek Harness 想用起来，第一步是把这东西装到你自己电脑上。说简单也简单，最省事的办法就是终端里敲一行命令。说难也有个坑，很多人第一次装会卡在命令行干等，半天没反应，其实问题不在网络也不在命令，在 Node.js 的版本。

第一步 先准备好这些

它跑起来只需要两样东西。一个是 Node.js，相当于它的运行底座，没有这个它起不来。另一个是 dsh 本体，不用单独去下安装包，一条命令就能拉起来。

Node.js 去官网 nodejs.org 下 LTS 版（长期支持版）就行，双击安装包一路下一步。装完打开终端，敲两行确认一下

node -v npm -v

能看见版本号就说明环境没问题了。

版本这道坎最容易栽跟头

官方对 Node.js 的版本有硬要求，package.json 里写的是 ^22.19.0 || >=24.0.0，也就是 22.19 以上或者 24 以上。

重点来了，这也是最容易坑人的地方。如果你的 Node 是 18 或者 20 这种老版本，命令不会报错，也不会提示你版本不对，它就是默默卡住，CPU 占着一个核，终端啥也不吐。有人实测过，Node v20.20.2 下跑命令干等了 45 秒啥都没有，杀掉重来一遍；换成 Node 24 之后，不到一分钟就蹦出网址、打开界面了。

所以动手前先 node -v 看一眼，版本号不以 22.19 或 24 开头，先去升级，别跟那个假死较劲。

一行命令拉起来

环境 OK 之后，终端里敲

npx @deepseek-ai/dsh web

npx 会现场把 dsh 拉下来并启动，不用你先全局安装。第一次跑会花一两分钟下载依赖，终端滚一堆日志是正常的。别慌，那不是报错。看到类似下面这行就成功了

DeepSeek Harness http://127.0.0.1:3080/

打开浏览器访问 http://127.0.0.1:3080/，就是它的 Web 界面。这个地址是本地回环，不对外暴露，不用担心别人从外面连进来。

Windows 下下次重启后还想再开，可以敲下面这行，终端不会被它占住

start /b npx @deepseek-ai/dsh web

其他安装方式

不想每次都让 npx 现拉，可以先全局装好，之后直接 dsh web

npm install -g @deepseek-ai/dsh dsh web

3080 端口被占了，或者想换个端口，加个参数

npx @deepseek-ai/dsh web --port 8080

想读源码、追最新提交、或者自己写插件，就走源码构建这条路。这条路需要先装 pnpm。如果你的系统里没有 pnpm，先执行下面命令装一个

npm install -g pnpm

装完如果还是提示"pnpm 不是内部或外部命令"，关掉当前终端窗口重新开一个，环境变量刷新后才生效。

pnpm 默认走海外仓库，第一次 pnpm install 很容易慢或者卡住。国内用户先把镜像切到淘宝源再装

pnpm config set registry https://registry.npmmirror.com

然后再跑源码构建这套

git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web

另外它还有个 Python SDK（pip install deepseek-harness-sdk），是给想把它塞进 CI/CD 流水线或者脚本里的人用的，普通体验用不上。

装完第一件事 填钥匙、选地盘

界面打开还是空的，输入框点不了。这是它故意设计的安全机制，得先告诉它你能碰哪些文件夹。

两步走。第一步，进 Settings → Models，在 DeepSeek 卡片里填你的 API Key（格式是 sk- 开头的一串），保存。Key 存在本地 $DSH_HOME/.credentials.yaml 里，界面上只显示脱敏后的描述，不显示明文。没有 Key 就去 platform.deepseek.com 申请一个。它也支持 Anthropic、OpenAI、OpenRouter 这些家的模型，想用哪家填哪家。

第二步，点"选择工作区"，把你想让它操作的那个项目文件夹加进来选中。工作区没选中的时候，输入框就是锁着的。选中之后，就可以发第一个任务了，比如让它"梳理一下这个仓库，说说主要用了哪些包"。

设置里填 API Key

装完你能干啥

到这一步，它跟那些常见的 AI 编程助手一样能直接用了。新建对话、问问题、让它读你的代码、跑命令、改文件，都行。光有模型它只会聊天，套上 Harness 这层它才动得了你电脑里的东西。

最后

现在还是开发者预览版 v0.1，官方明说后面会有不兼容的改动。所以别指望装一次就一劳永逸。版本更新了留意一下，别拿老教程硬套新版本。踩过一次坑你就懂了。