TeamoRouter
博客

DeepSeek Harness 安装教程：一条命令跑起 Agent 框架

· 更新于

快速回答

DeepSeek Harness（dsh） 是 DeepSeek AI 开源的 agent harness——智能体框架，采用「一切皆插件」的架构，由 Cordis 驱动，MIT 许可证。目前处于开发者预览阶段，迭代很快，未来会有破坏兼容性的变更。

安装只需要 Node.js。最省事的启动方式是：

bash
npx @deepseek-ai/dsh web

这条命令会拉取并启动 Web UI，默认地址 http://127.0.0.1:3080。想跑在 DeepSeek V4 Pro / Flash 上，把 API Key 和 Base URL 指向 TeamoRouter 即可，下面逐步说明。

2026 年 10 月 31 日：DeepSeek 开源了 Super-agent（dsh-superagent），一个以 DeepSeek Harness 插件形式运行、盯一个 GitHub 仓库干活的研究原型编程 agent。

什么是 DeepSeek Harness

先说清楚它是什么、不是什么。行业里已经形成一个共识公式：

text
Agent = 模型 + Harness

模型是大脑——预测 token 的权重；Harness 是剩下的一切：agent 能调用的工具、能碰的文件系统与 shell、子代理之间怎么传递信息、上下文怎么存取，以及最关键的一点——什么时候停下来。裸模型本身不擅长记忆、执行代码和工具调用，Harness 负责把聊天模型变成能真正改代码、跑命令的「工人」。

DeepSeek Harness 的独特之处在于它的架构：一切皆插件。文件系统、shell、模型适配器、Web UI、子代理，都是可插拔的 Cordis 插件。这带来两个好处：一是你可以按需裁剪 agent 的能力面（比如只给终端 + 文件操作，不给网络），二是换一个 provider（例如把模型从官方 API 切到 TeamoRouter）不需要动其他任何东西。

前置条件

  • Node.js：任何近期版本即可（npx 需要）。从源码构建则需要 pnpm 与 git。
  • 一个可用的模型后端：DeepSeek 官方 API Key，或者 TeamoRouter 的 Key（sk-teamo-...）。

方式一：npm 一条命令启动（推荐）

bash
npx @deepseek-ai/dsh web

首次运行会下载包，之后启动 Web UI。浏览器打开 http://127.0.0.1:3080 就是控制台。这是最省事、也最贴近「日常使用」的姿势——不克隆仓库、不编译。

想让 agent 真正跑起来，需要配置模型后端。最快的办法是设两个环境变量：

bash
export DEEPSEEK_API_KEY="sk-teamo-你的Key"
export DEEPSEEK_BASE_URL="https://api.agentapiai.com/v1"

把这两行写进 shell 配置（~/.zshrc 或 ~/.bashrc），或启动命令前临时 export，dsh 就会把模型请求发到 TeamoRouter，而不是 DeepSeek 官方 API。我们 2026 年 11 月 2 日用 dsh 0.2.1-rc.3 实测：dsh 仍用自带的 DeepSeek 模型服务，按 Anthropic 格式把请求发到 https://api.agentapiai.com/v1/messages，默认模型是 deepseek-flash（DeepSeek V4.1 Flash），在网页界面的模型选择里可以换成 deepseek-v4-pro。想列出 TeamoRouter 的其他模型或者改默认模型，就在 ~/.dsh/settings.yaml 里把 TeamoRouter 加成模型服务，写法见《DeepSeek Harness 接入 TeamoRouter》。

新账号余额为 0，先充值再调用。 第一次请求前先充值，$5 起。如果请求返回 402（OpenAI 兼容格式为 400）、提示「钱包余额不足」，说明余额为 0，不是 Base URL 或 Key 配错了，充值后重试即可。

方式二：从源码构建

想自己改、跟进最新代码，或给插件生态做贡献时用：

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

pnpm dsh web 与 npx @deepseek-ai/dsh web 是同一个命令，只是前者用本地源码、后者用 npm 发布版。源码方式适合开发者预览阶段——因为上游迭代快，main 分支常常领先发布版几个小版本。

启动后：Web UI 里能看到什么

http://127.0.0.1:3080 是一个本地 Web 控制台，主要能力：

  • 会话管理：新建 / 切换 / 重命名会话，多会话并行。
  • 模型选择：在已配置的模型之间切换（例如 deepseek-v4-pro 与 deepseek-v4-flash）。
  • 工具面板：agent 实际能调用的工具清单——bash、文件读写、子代理、Web 搜索等。
  • 目标（Goals）：把长任务拆成带状态的目标，暂停 / 恢复 / 标记完成。

一个常见的误解是把 dsh 当成「又一个聊天窗口」。它其实是agent 运行时的前端：你给一个目标，agent 在工具里循环直到完成，UI 只是观察和干预的入口。

一个最小可运行示例

配置好 DEEPSEEK_API_KEY / DEEPSEEK_BASE_URL 后，在 Web UI 里给 agent 这样一个任务：

text
查看当前目录，找到 README，用一句话总结它的第一段，写到 /tmp/summary.txt

dsh 会依次调用 bash（列目录、读文件）、读写文件工具，最后汇报结果。这就是「Harness 把模型变成工人」的最直观体验。

配合 DS Bot：社区做的个人助理插件

DS Bot（仓库原名 DeepSeek-Bot）是社区开发者做的 DeepSeek Harness 插件，10 月 11 日前后发布：在 dsh 里建一组有长期记忆的 Bot，它们可以互相发消息、拉群聊、分工干活。它不是 DeepSeek 官方产品。

插件版用的就是 dsh 里配好的模型。它的 README 写明：先装好 dsh，并在里面至少配一个模型，DS Bot 用的是 dsh 的模型。所以按上面把 TeamoRouter 配进 dsh 之后，装上插件就能用：

bash
npx @deepseek-ai/[email protected] plugin --profile web add ds-bot
npx @deepseek-ai/[email protected] web

需要 Node.js 22.19 以上和 pnpm。DS Bot 还有自带 dsh 的桌面版，那个版本要在 DS Bot 自己的设置里另配模型。以上按 DS Bot 的 README（2026 年 11 月 2 日）整理，我们没有装插件实测。

常见疑问

Q：dsh 和 DeepSeek 官方 API 是绑定的吗？ 不是。dsh 是模型无关的框架：DEEPSEEK_BASE_URL 能把自带的 DeepSeek 模型服务改指到别的地址，~/.dsh/settings.yaml 还能加 OpenAI 兼容的模型服务。用 TeamoRouter 时，它既能跑 DeepSeek V4 系列，也能在一个 key 下路由 Claude、GPT、Gemini。

Q：开发者预览意味着什么？ 意味着接口和配置还会变，不建议在生产里依赖某个具体 API 细节。但对个人开发者、学习 agent 架构、以及尝鲜「便宜跑 agent」来说，现在已经完全可用了。

Q：装好了但 agent 不动 / 报鉴权错误？ 九成是环境变量没生效。先 echo $DEEPSEEK_API_KEY 确认 Key 在；确认 DEEPSEEK_BASE_URL 带 /v1（dsh 会在后面拼 /messages）；再确认 Key 是 sk-teamo- 开头、无多余空格。

想在 dsh 里跑 DeepSeek V4 Pro，注册 TeamoRouter 拿到 Key，按上面设好 DEEPSEEK_BASE_URL，在模型选择里切到 deepseek-v4-pro 即可。

准备好接入了吗？登录控制台 · 购买额度 · 创建 API Key，三步即可开始。
获取 API Key查看帮助文档

文中模型的实时价格

继续阅读

全部文章
DeepSeek Harness 安装教程：一条命令跑起 Agent 框架 · TeamoRouter