DeepSeek Harness 怎么安装？npx 一键安装到源码构建全流程
一、安装前的准备
在动手之前，先确认两件事：
1. 安装 Node.js
官方 README 的要求很简短：安装 Node.js 即可。建议使用较新的 LTS 版本，命令行验证：
node --version能输出版本号就说明 Node.js 环境就绪。
2. 准备 API 密钥
需要一个 DeepSeek 兼容的 API 密钥，安装后配置模型时会用到。
系统支持 macOS、Linux、Windows。Windows 下 dsh 会自动使用 PowerShell 执行环境，无需额外配置。
二、方式一：npx 一键安装（推荐新手）
这是官方主推的方式，一条命令搞定：
npx @deepseek-ai/dsh web执行后会发生什么：
- npx 自动下载 @deepseek-ai/dsh 包
- 启动 Web UI，浏览器打开默认地址 http://127.0.0.1:3080
- 首次使用会在 $DSH_HOME（默认 ~/.dsh）下自动初始化配置目录
看到浏览器出现界面，就说明安装成功了。升级也很简单：重新执行上面这条命令，npx 会拉取最新版本。
三、方式二：从源码构建（适合开发者）
想自己改源码、或参与贡献，可以走这条路：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web需要提前装好 pnpm（包管理器）。升级时进入目录执行 git pull 后重新构建即可。
注意：dsh 目前处于开发者预览阶段，官方提示未来可能有破坏兼容性的变更，升级前建议看看 Release 说明。
四、方式三：安装 Python SDK（适合程序化调用）
不想用界面，想在代码里调用同一套能力？官方提供了 Python SDK：
前置要求：Python 3.10 或更高版本、Git、Linux x64/arm64 或 macOS 14+ 的 arm64 系统。
克隆仓库并安装：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk装好后运行时自带，不需要系统再装 Node.js，对 CI 环境很友好。
五、安装后第一件事：配置模型
装好只是第一步，还得让 agent 能连上模型。Web UI 里操作：
- 打开 设置 → 模型
- 在 DeepSeek 卡片里粘贴 API 密钥并保存
- 点击 选择工作区，选中项目目录
- 输入任务，开始使用
密钥是只写存储的，明文存放在 $DSH_HOME/.credentials.yaml，界面只保留脱敏引用，不用担心被截图泄露。
六、常见安装问题
- Q：npx 命令找不到包？
确认网络能访问 npm 源，可以换用国内镜像源后重试。 - Q：启动后浏览器打不开？
确认端口没被占用。默认是 http://127.0.0.1:3080，如果被占用可换端口启动。 - Q：提示需要更高版本 Node.js？
升级 Node.js 到最新 LTS 版本后重试。
总结
DeepSeek Harness 的安装并不复杂：普通用户执行 npx @deepseek-ai/dsh web 一条命令即可启动 Web UI（默认 http://127.0.0.1:3080）；开发者可以从源码构建；需要程序化调用就装官方 Python SDK。装好后配置好 API 密钥和工作区，就能开始使用了。
