DeepSeek Super-agent（dsh-superagent）是什么：安装步骤和用 API Key 接入

要点

• 是什么：dsh-superagent 就是 DeepSeek 2026 年 10 月 31 日开源的「Super-agent」，一个盯着一个 GitHub 仓库干活的编程 agent。在 issue 里 @ 它提需求，它在自己的会话和目录里做完，再回到原帖答复，比如提一个 PR。DeepSeek 自己的说法是研究原型，「不是 DeepSeek 官方产品」。
• 跑在什么上面：它是 DeepSeek Harness（dsh）的插件包，不是 Claude Code 那样的独立终端工具。模型用所在 DeepSeek Harness 配置的默认模型，出厂默认是 DeepSeek 官方 API 的 deepseek-flash（DeepSeek-V4.1-Flash）。
• 能不能用自己的 API Key：能。DeepSeek Harness 支持任意 OpenAI 兼容的模型服务，Super-agent 也就能用网关的 Key。配置见下文，我们实际跑过，请求打到了网关。

一句话答案

先装 DeepSeek Harness，再从 deepseek-ai/dsh-superagent-prototype 构建 Super-agent，装进单独的 superagent 配置：

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent && cd dsh-superagent
pnpm install && pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

然后给它配好模型、要盯的 GitHub 仓库和一个专门给 agent 用的 GitHub 账号，用 scripts/dsh-superagent start 启动，管理面板在 http://127.0.0.1:3082。

不想注册 DeepSeek 账号、想用 TeamoRouter 的 Key，就在第一次启动前加一段模型服务配置（完整步骤见下文）：

# ~/.dsh/settings.yaml
llm-pi-ai:
  providers:
    teamorouter:
      displayName: TeamoRouter
      apiKeyEnv: TEAMOROUTER_API_KEY
      api: openai-completions
      baseURL: https://api.teamorouter.com/v1
      models:
        - id: deepseek-v4-pro
          name: DeepSeek V4 Pro
        - id: deepseek-flash
          name: DeepSeek V4.1 Flash
agent-default-model:
  provider: teamorouter
  model: deepseek-v4-pro

Super-agent 是什么、不是什么

按官方 README 的说法，dsh-superagent 是「面向一个 GitHub 仓库的主动式编程 agent」。它监听 GitHub，也可以选配飞书群：

1. 允许名单里的人提需求，比如在 issue 里评论 @<agent 账号> <需求>。
2. Super-agent 开一个工作项（Ticket），在自己的 agent 会话和目录里处理。
3. 处理完回到原来的对话答复，比如提一个 PR。网页面板上列出需要人来处理的事。

它的设计原则是「尽量少占用人的注意力，尽量多给价值」：只有被叫到、或者团队写好的规则允许时才动手。默认是 observe 模式，主动发现的活只记录、不执行。

它不是：

• 不是官方产品：README 说这是研究代码，「可能还有 bug」，为公开发布做过改动，和 DeepSeek 内部版本不完全一样；DeepSeek 那篇 Super-agent 文章里的一些设计，这个原型里还没实现。
• 不是终端里的编程助手：Claude Code、Codex 是你在终端里跟它一起写代码；Super-agent 是在你机器上常驻的服务，接团队在 GitHub 上提的需求。想在 DeepSeek Harness 里自己动手写代码，看 dsh 安装教程。
• 没有沙箱：它的 worker 和 router 预设以 danger-full-access 权限、用你的系统账号运行，worker 能执行程序、读你的家目录。要隔离，DeepSeek 建议单独建一个只放 agent 凭据的系统账号。

需要准备什么

出自部署文档 docs/006-deployment.md：

安装

DeepSeek 推荐让编程 agent 陪你装：在克隆下来的仓库里打开 Claude Code、Codex 或 DeepSeek Harness，对它说「Read SETUP.md in this repository and set up dsh-superagent with me.」。它一次只问一个问题（盯哪个仓库、agent 用哪个账号、谁能提需求、在哪个目录检出代码、提交署名、要不要自动合并），把完整方案给你确认一次，然后一次装完。

手动装：

1. 运行上面「一句话答案」里的五条命令。第四条会从 Web 模板建出 ~/.dsh/profiles/superagent，只能在第一次安装时跑：已有配置时它会整个替换掉，并删掉原来的配置文件。
2. 把 examples/profile.cordis.patch.yml 复制成 ~/.dsh/profiles/superagent/cordis.patch.yml，把 stateDir 改成绝对路径，比如 /home/me/.dsh/state/superagent。
3. 建好 agent 的 GitHub 账号和它的 gh-agent 包装脚本（部署文档的 Accounts 一节）。
4. 启动：

scripts/dsh-superagent start
scripts/dsh-superagent status

新装的时候 status 会以退出码 3 结束，并说明还缺什么，比如「The GitHub Source names no repository」。打开 http://127.0.0.1:3082 的面板，在 Sources、Policy、Execution 里填好就行。

默认用哪个模型、多少钱

Super-agent 用所在 DeepSeek Harness 配置的默认模型，除非在 Eval 或 Execution 设置里另外指定。DeepSeek Harness 0.2.1-rc.3 出厂默认的模型服务是 deepseek-official，模型是 deepseek-flash，DeepSeek Harness 里标的是 DeepSeek-V4.1-Flash，上下文 1M token。另一个官方模型是 deepseek-v4-pro。

DeepSeek 官方 API 价格（每百万 token，2026 年 11 月 2 日的官方价格页）：

高峰时段是工作日 UTC 01:00–04:00 和 06:00–10:00（北京时间 9:00–12:00 和 14:00–18:00）。DeepSeek 还说明，从北京时间 2026 年 11 月 1 日 0 点起，DeepSeek Harness 通过官方 API 调用的 Search、Fetch 按次计费（每 1,000 次 $0.75）。TeamoRouter 的当前价格见价格页。

用 TeamoRouter 的 API Key 跑 Super-agent

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

TeamoRouter 一个 Key 就能调 DeepSeek、GPT、Gemini、Kimi、GLM 和 Claude，没有订阅，在控制台充值余额，按实际用掉的 token 扣费，最低 $5 起充，支持支付宝。

1. 在 TeamoRouter 控制台创建 API Key。
2. 第一次运行 scripts/dsh-superagent start 之前，把「一句话答案」里那段配置存成 ~/.dsh/settings.yaml。
3. 把 Key 写进 ~/.dsh/.env：

echo 'TEAMOROUTER_API_KEY=sk-teamo-你的Key' >> ~/.dsh/.env
chmod 600 ~/.dsh/.env

4. 启动 Super-agent。第一次启动时，DeepSeek Harness 会把 settings.yaml 导入 superagent 配置，变成 llm-pi-ai 和 agent-default-model 两项，并把文件改名为 settings.yaml.imported。

如果你以前跑过 DeepSeek Harness，settings.yaml 可能已经被导入别的配置；新建的 settings.yaml 只会导入下一个启动的配置。这种情况下，直接把这两项加到 ~/.dsh/profiles/superagent/cordis.patch.yml 里 dsh-superagent 那一项后面：

- id: llm-pi-ai
  config:
    providers:
      teamorouter:
        displayName: TeamoRouter
        apiKeyEnv: TEAMOROUTER_API_KEY
        api: openai-completions
        baseURL: https://api.teamorouter.com/v1
        models:
          - id: deepseek-v4-pro
            name: DeepSeek V4 Pro
          - id: deepseek-flash
            name: DeepSeek V4.1 Flash
- id: agent-default-model
  config:
    provider: teamorouter
    model: deepseek-v4-pro

我们 2026 年 11 月 2 日用 DeepSeek Harness 0.2.1-rc.3 和原型的首个提交（6337fc8）实测过：superagent 配置读到了 TeamoRouter 这个模型服务，Super-agent 正常启动并停在等 GitHub 配置这一步，按这两项发出的请求打到了 TeamoRouter。不想先配 GitHub，也可以用同一份配置跑一个任务验证 Key：

dsh headless --patch ~/.dsh/profiles/superagent/cordis.patch.yml "Reply with one word: pong"

报「钱包余额不足」说明请求已经到了 TeamoRouter、只是余额为 0；报 401 说明 ~/.dsh/.env 里的 Key 不对。

常见问题

Super-agent 是 DeepSeek 官方产品吗？ 不是。README 写明是仅供参考的研究原型，代码可能还有 bug，也和 DeepSeek 内部版本不一样。

它能替代 Claude Code 吗？ 不是一类东西。Claude Code 是终端里跟你交互的助手；Super-agent 是接团队在 GitHub 上提的需求、用 PR 交付的常驻服务。和 Claude Code 更接近的是 DeepSeek Harness 本身，见 DeepSeek Harness 和 Claude Code、Codex、OpenCode 对比。

要不要 DeepSeek 账号？ 只有用默认的 deepseek-official 模型服务时才要。换成 TeamoRouter 这类 OpenAI 兼容服务，Key 和 Base URL 都用那边的。

能同时管几个仓库？ 这个原型一次安装只管 github.com 上的一个仓库。

下一步

• DeepSeek Harness 是什么
• DeepSeek Harness 安装教程
• 在 DeepSeek Harness 里接入 TeamoRouter（文档）
• TeamoRouter 价格