跳转到正文
AI 实用笔记

AI 实用笔记

DeepSeek Super-agent 怎么用？在 GitHub 里 @ 它修 Bug

·

文档里的下载链接 404 了。你在 GitHub 的 Issue 里 @ 一下助手，交代清楚哪一页出了问题，就可以回去忙自己的事。等它查完，原帖里可以直接看到坏在哪、怎么验证的。真要动手修，还能让它把改动做成一个等你审核的 PR。

这就是 DeepSeek Harness 团队在 2026 年 10 月 31 日公开的 Super-agent（dsh-superagent）。它是装在 DeepSeek Harness 里的开源研究原型，一套实例接一个 GitHub 仓库。最省事的地方在于，Issue 本身就能派活。它能把讨论、代码改动和后续审查串在一起，其他人打开原帖也知道事情走到了哪一步。项目首次提交 · 官方仓库

DeepSeek Super-agent 流程图：在 GitHub 里提需求，助手在独立任务中排查，再把结果或 PR 链接发回原帖
从 GitHub 评论到交付的流程示意。根据项目执行文档绘制。

下载安装 · 三个用法与评论示例

先接个测试仓库，别急着接主项目

下面以 Linux 为例。Windows 可以在 WSL2 的 Ubuntu 里执行这些命令。准备好 Node.js 24、pnpm 11.7.0、Git 2.32+、GitHub CLI 2.48+、Python 3.8+ 和 tmux。此外需要一个能调用的模型。项目源码是 MIT 开源的，商业模型的调用费由模型服务商收取。官方环境要求

这里有个容易漏掉的细节。项目启动检查要求助手的 GitHub 账号对仓库有写权限，哪怕第一单只让它读代码。给它一个单独的 GitHub 账号，只授权测试仓库。Worker 还能以部署账号的身份执行命令，读到那个账号能读的文件。最好用独立系统账号或虚拟机试跑，主分支保留审核和分支保护。官方权限说明

1. 下载源码，选一种安装方式

DeepSeek 官方 GitHub 仓库的 SETUP.md 文件入口
官方仓库的 SETUP.md，2026-11-06 截图。

在 Linux 终端下载。这里固定到本文核对过的提交，方便你对照命令和文档。

git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent &&
cd dsh-superagent &&
git checkout --detach 8c32a9dc5d72c033816c6a8110b37f40cf94fba4

最短的路是把这个目录交给你手头的编码助手，发下面这句话。官方 SETUP.md 本来就是给它读的。GitHub 登录和模型密钥在终端或设置里处理。

请按仓库里的 SETUP.md 帮我安装 dsh-superagent。
先只接一个 GitHub 测试仓库，用独立的助手账号。
白名单只加我，保留 observe 模式，不开自动合并。
先列出计划，再等我确认。
想自己装？展开手动安装命令

装 CLI 和插件。 已经装好 pnpm 11.7.0 的话，跳过第一行。在刚才的源码目录执行。

npm install -g [email protected]
npm install -g @deepseek-ai/[email protected]
dsh --version
pnpm install --frozen-lockfile && pnpm build

dsh --version 应显示 0.2.1-rc.3。首次安装再建立独立的 superagent profile。下面的判断会跳过已存在的配置，避免覆盖它。

superagent_home="${DSH_HOME:-$HOME/.dsh}"
if [ ! -e "$superagent_home/profiles/superagent" ]; then
  dsh superagent --from-default-profile web --dump-config >/dev/null &&
  dsh plugin --profile superagent add "link:$PWD"
fi

把仓库内的 examples/profile.cordis.patch.yml 复制为 ${DSH_HOME:-$HOME/.dsh}/profiles/superagent/cordis.patch.yml。编辑新文件，把 stateDir 的占位符替换成绝对路径，比如 /home/你的Linux用户名/.dsh/state/superagent，并保留示例的本地监听地址和端口。已有配置时，按部署文档合并对应条目。

给助手单独登录 GitHub。 把助手账号加到测试仓库并让它接受邀请。下面的脚本会让它用一套独立的 GitHub CLI 配置。

mkdir -p "$HOME/.local/bin"
cat > "$HOME/.local/bin/gh-agent" <<'EOF'
#!/bin/sh
unset GH_TOKEN GITHUB_TOKEN
GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@"
EOF
chmod +x "$HOME/.local/bin/gh-agent"
"$HOME/.local/bin/gh-agent" auth login --hostname github.com
"$HOME/.local/bin/gh-agent" api user --jq .login

最后一条要显示助手账号。接着在插件源码目录启动服务。

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

首次启动时 status 可能返回 3，意思是服务起来了，仓库或账号还没填好。按下面的步骤配完，正常返回 0。官方手动部署与故障排查

2. 打开面板，填好仓库和谁能派活

在部署机器上打开启动日志里 dsh web: 后面给出的完整地址。默认监听 127.0.0.1:3082，如果地址带登录令牌，要一起复制。第一次用 DSH 的话，先在 Web 界面的 设置 → 模型 配好模型，用同一 profile 新开一个会话，确认模型能回复。再点侧栏的 Superagent。官方模型配置文档

  1. Settings → Sources。启用 GitHub，仓库填 owner/repo，CLI 填 gh-agent 脚本的绝对路径。
  2. Settings → Eval → On each Source → GitHub。白名单填你用来派活的 GitHub 登录名。先保留 observe。它会记录哪些事件原本可能被主动接单，白名单用户明确 @ 它的请求仍能执行。
  3. Settings → Execution。把测试仓库另行克隆到本机。将文档里的 prepare 命令贴到准备命令栏，把 /home/me/src/widgets 两处替换成这份克隆的绝对路径。这样每单会检出自己的工作目录和分支。工作目录命令
  4. Settings → Prompts。在交付要求里填写助手的提交者身份，去掉自动合并段落。代码改动用 PR 交付，由人审核和合并。

到这一步，打开 Overview。如果提示账号连不上，先用 "$HOME/.local/bin/gh-agent" api user --jq .login 检查登录。如果说 cannot push，去 GitHub 核对邀请和仓库权限。官方报错对照

我会先给它这三种活

把下面的 @your-agent 换成你的助手账号。在测试仓库的 Issue 或 PR 下发一条新评论，别回头编辑旧 Issue 的正文。默认轮询约一分钟，正常会在 Overview 看到一个 Ticket，也就是任务单。模型排查要花多久，取决于任务。官方试跑步骤

先让它帮你找代码

接手陌生项目时，光找入口就能点开十几个文件。第一单可以只要路线图。在测试项目里挑一个实际存在的页面，用自己的路径替换示例。

@your-agent /settings 页面是从哪个文件进来的？
帮我找到路由入口和保存设置的函数，给出文件路径。
只在这条 Issue 回复，不修改文件或创建 PR。

打开它给的文件核对一遍。能把入口、调用关系和位置说对，再让它改代码。

一个坏链接，换一份能审的 PR

@your-agent README 里的安装链接打不开。
先复现，再把链接改到仓库里的正确文档。
只改这一处，开 PR 并说明怎么验证。请不要合并。

这个任务很小，恰好能把流程试全。配置好工作目录后，它能在单独的工作树里改文件，其他任务不用等它腾出同一份目录。PR 出来以后，如果还想让它补一个相对链接，直接在 PR 里留言，同一单可以接着改。审查人只需要盯着那几行 diff。任务与 PR 的关联方式

CI 红了，先请它圈出第一处错误

检查跑了五分钟，日志拉下来几百行。先在失败的 PR 下面 @ 它，附上失败运行的链接。

@your-agent 帮我看上面这次 CI 失败。
找出第一个真正报错的步骤，给出日志位置和本地复现命令。
把判断回复在这里，先别推代码。

这时最有用的交付，可能只是「测试还没跑起来，依赖安装就失败了」，外加一条能复现的命令。如果团队想让它自己发现默认分支上的红灯，还要在 Sources 打开默认分支 CI 接收，在 Eval 把该类事件设成推断候选，并加一条匹配的处理规则。先在 observe 看面板记录，再决定要不要切 auto。自动接单的规则

如果你们平时在飞书里聊项目，也可以接飞书机器人，在指定群里 @ 它。第一次跑通 GitHub 就够了。这个原型适合经常从 Issue 和 PR 收活的小团队，尤其是那些耗时间、交付又容易核对的小事。要持续收任务，部署机上的服务就得一直开着。试完想停，在源码目录执行 scripts/dsh-superagent stop。飞书接入文档

核对记录（2026-11-06） · 验证了源码构建、CLI 版本和插件注册。原生 Windows 的盘符路径未通过插件校验，完整的接单到 PR 流程尚未在真实仓库实测。上面的评论是试用模板。

想看看同一个 Harness 接别的工具怎么玩，可以读前一篇关于 B 站“鱼灾”和刷视频插件的文章。