最近 DeepSeek 开源了他们的 Agent 框架 DeepSeek Harness（简称 DSH），上线 12 小时就突破 5 万 Star，堪称 AI 圈的"现象级爆款"。

它的核心理念是"一切皆插件"——模型、工具、界面、审批策略，甚至主循环本身都可以替换。也就是说，你可以把它理解为 Agent 界的 Android：一个开放的框架，等你动手组装。

本文记录我从源码安装到成功运行的全过程，包括踩过的坑，希望能帮你少绕弯路。

---

1DeepSeek Harness 是什么

先简单介绍一下。DSH 不是云端服务，而是本地运行的 Agent 框架。装好后在你的电脑上敲一行命令，浏览器打开本地端口，就是一个完整的 AI 编程助手界面。

它能做什么？

• 读写编辑你工作区里的代码文件

• 通过 PowerShell / Bash 执行命令、运行测试、操作 Git

• 按文件名或内容搜索代码

• 把独立任务派发给后台子代理并行处理

• 查询网络信息并给出来源链接

简单说，它就是一个能动手干活的 AI，而不是只会聊天的机器人。

---

2环境准备：Node.js + Git + pnpm

DSH 采用"插件化架构"，源码是一个巨大的 Monorepo（包含 238 个子项目），所以对环境有一定要求：

• Node.js

  ：版本要求 ^22.19.0 或 >=24.0.0

• Git

  ：用来克隆仓库

• pnpm

  ：项目强制使用 pnpm 11.7.0 管理依赖

如果你电脑上已有 Node.js 22+，可以直接检查版本：

git --version
node --version
npm --version

我本地的环境是 git 2.54 / node 22.22.3 / npm 10.9.8，完全满足要求。

坑点提醒：Windows CMD 下可能找不到 pnpm。如果你用 npm 全局安装 pnpm 后，CMD 提示"pnpm 不是内部命令"，多半是因为全局包路径没同步到 CMD 的 PATH。关掉 CMD 重新开窗口，或者用系统级 npm 重新安装一次即可。

---

3源码安装：克隆、安装依赖、构建

如果你不想用 npx @deepseek-ai/dsh web 这种快捷方式，而是想从源码深度定制，步骤如下：

3.1 克隆仓库

git clone --depth 1 https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

仓库大概 7412 个文件，包含 apps（应用）、packages（核心包）、docs（文档）、website（官网）等目录。

3.2 安装 pnpm（如果还没有）

npm install -g pnpm@11.7.0

3.3 安装依赖

pnpm install

这一步需要下载 923 个包，大约 5-8 分钟。部分依赖会出现平台不兼容的警告（比如 Linux ARM64 包在 Windows 上跑不了），不影响主功能，直接忽略即可。

3.4 构建项目

pnpm run build

构建分为两步：build:lib（编译核心库）+ build:web（构建前端界面）。

成功后会看到类似这样的输出：

dist/assets/index-Dqw48FrP.js  442.71 kB
✓ built in 8.47s

至此，DeepSeek Harness 已经完整安装到你的电脑上了。

---

4配置 API Key： DeepSeek 官方 or OpenRouter

DSH 本身开源免费，但它背后需要调用大模型 API，这部分是按 token 计费的。

4.1 首次启动

pnpm dsh web

运行后浏览器打开 http://127.0.0.1:3080，会看到如下界面：

4.2 获取 DeepSeek API Key

推荐直接去 DeepSeek 官方平台（https://platform.deepseek.com）注册账号、创建 API Key。新用户通常有10 元免费体验额度。

在 DSH 设置页面填入 Key，保存即可。

4.3 余额不足怎么办

如果你看到这种报错：

说明你的 DeepSeek 账户余额为 0。两个解决方案：

• 方案 A（推荐）

  ：直接在 DeepSeek 平台充值。进入"用量信息"页面，点击充值，充 10 块钱够用很久。以 deepseek-v4-flash 模型为例，一次 8000+ tokens 的对话花费不到 1 分钱。

• 方案 B

  ：换成 OpenRouter、硅基流动等第三方平台。注册后创建 Key，在 DSH 里配置自定义 provider（Base URL + API Key）。OpenRouter 支持多家模型，一个 Key 通用。

省钱提示：DeepSeek 的 API 是目前市面上最便宜的之一，V3 模型约 0.5-2 元/百万 tokens。充 10 元足够跑几百次对话。如果只是想尝鲜，先用官方送的免费额度就够了。

---

5启动验证：你的 AI 助手已经就位

充值完成后，刷新 DSH 页面（或重启服务），直接发一条消息测试：

你会做什么

如果一切正常，DSH 会返回一大段自我介绍，告诉你它能做编程与文件操作、复杂任务编排、网络搜索、子代理并行处理等。

底部状态栏还会显示实时消耗：输入 8.3K tokens，输出 519 tokens，让你对每次对话的成本心中有数。

---

6常见问题速查

Q1：pnpm 命令找不到

原因：pnpm 装到了沙箱或某个 npm 实例的全局目录，而当前 CMD 的 PATH 里没有这个路径。

解决：用系统级 npm 重新安装 npm install -g pnpm@11.7.0，或关掉 CMD 重新打开窗口。

Q2：Insufficient Balance（余额不足）

原因：DeepSeek 账户余额为 0。API Key 是对的，但账号没钱。

解决：在 DeepSeek 平台充值；或换 OpenRouter 等第三方 Key。

Q3：pnpm install 出现平台警告

原因：部分原生依赖（如 landlock-run）有平台限制（Linux-only）。

解决：直接忽略，不影响主功能。

Q4：DSH 启动后页面空白或报错

原因：可能构建不完整，或端口被占用。

解决：确保 pnpm run build 成功完成；检查 3080 端口是否被其他程序占用。

---

7总结

DeepSeek Harness 的安装流程可以归纳为四步：

1. 环境准备

   ：Node.js 22+ + Git + pnpm 11.7.0

2. 源码安装

   ：git clone → pnpm install → pnpm run build

3. API 配置

   ：去 DeepSeek 平台创建 Key，充值（10 元起步）

4. 启动验证

   ：pnpm dsh web，浏览器访问 3080 端口

整个过程大约 15-20 分钟，主要耗时在 pnpm install 和 build 上。

DSH 目前处于开发者预览版阶段，官方文档也明确说了"未来将出现破坏兼容性的变更"。但对于想提前体验 Agent 框架、甚至动手开发插件的开发者来说，现在正是入局的窗口期。

如果你成功跑起来了，欢迎去 GitHub 给官方点个 Star，或者加入他们的开发者社群交流。Agent 时代已经来了，工具就在你手里。

---

本文基于 DeepSeek Harness v0.1.0-rc.5 实测撰写，Windows 11 + Node.js 22.22.3 环境。