DeepSeek Harness npx 安装和源码安装的区别：两种部署方式全对比
2026-08-23 18:05:27阅读 6
DeepSeek Harness（简称 dsh） 是 DeepSeek 开源的 Agent 运行框架，核心设计是“一切皆插件”。目前提供两种主要安装方式：npx 一键启动和源码构建。两者的核心区别在于：npx 是把包放进 npm 缓存，适合快速体验；源码方式是把程序放在 clone 出来的本地目录里，适合开发和深度定制。
一、npx 一键安装：最快上手
这是官方主推的方式，适合绝大多数用户。只需一条命令即可启动 Web UI：
npx @deepseek-ai/dsh web执行后，npx 会自动从 npm 源下载 @deepseek-ai/dsh 包，启动 Web UI 并打开默认地址 http://127.0.0.1:3080。首次使用会在 ~/.dsh 下自动初始化配置目录。
特点：
- 零配置：无需克隆代码、无需安装额外工具
- 自动更新：重新执行命令即可拉取最新版本
- 程序位置：包存放在 npm 缓存中，与个人数据（
~/.dsh）分离 - 适合人群：普通用户、快速体验、不想折腾配置的人
如果想固定版本或离线使用，也可以全局安装：
npm install -g @deepseek-ai/dsh
dsh web二、源码构建：深度定制
适合需要修改源码、深度定制或参与贡献的开发者。步骤如下：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web源码版本需要提前安装 pnpm（通过 npm install -g pnpm）和 Git。
特点：
- 可修改源码：程序就在 clone 出来的目录里，可随时修改
- 手动更新：升级需执行
git pull→pnpm install→pnpm run build - 适合人群：开发者、需要最新功能、参与贡献的人
三、两种方式的核心区别
| 对比维度 | npx 一键安装 | 源码构建 |
|---|---|---|
| 程序本体位置 | npm 缓存中 | clone 出来的本地目录 |
| 是否需要 Git | ❌ 不需要 | ✅ 需要 |
| 是否需要 pnpm | ❌ 不需要 | ✅ 需要 |
| 升级方式 | 重跑 npx @deepseek-ai/dsh web | |
| 能否修改源码 | ❌ 不能 | ✅ 能 |
| 适合人群 | 普通用户、快速体验 | 开发者、深度定制 |
四、重要提醒
无论哪种安装方式，个人数据（配置、会话、凭据）都不在程序目录里，而是统一存放在 ~/.dsh 目录下。程序目录和工作区也是完全独立的——升级程序不会碰你的工作区文件。
DeepSeek Harness 目前仍处于开发者预览阶段，正在快速迭代，官方明确提示未来将有破坏兼容性的变更。如果追求稳定，建议关注官方 Release 说明中的“破坏性变更”标记再决定是否升级。
五、总结
- npx 安装：一条命令跑起来，升级零成本，适合大多数用户快速体验
- 源码安装：需要 Git + pnpm，适合需要修改源码、深度定制的开发者
如果只是想体验 Harness 的能力，选 npx 就够了；如果想自己改插件、调逻辑，或者需要追最新的未发布功能，选源码方式。两者可以同时存在，互不干扰。
