把“主动式编码 agent”做成工单流水:一条消息从 GitHub、飞书、本地会话或个人微信进来,先过策略闸门,被允许的才开工单,工单派给独立的 worker 会话执行,结果回原对话汇报。整套跑在 Windows 原生环境,不需要 WSL、tmux、fcntl。这就是 dsh-windows-superagent 0.2.6 做的事。

仓库 2026-11-18 建于 HiSeax 名下,28 星,MIT 许可,TypeScript 实现。README 第一行就把定位锁定:研究原型,非 DeepSeek 官方产品,由日常开发工作与编码 agent 共同产出,用前请自评。前身是 Unix 环境的 dsh-superagent,0.2.4 起改名为 dsh-windows-superagent 并完成 Windows 适配。

一、是什么:两个包,一条消息五步走

打开网易新闻 查看精彩图片

(图注1:两个包的分工与 Source-Eval-Ticket-Executor-Report 五步流水线卡片)

仓库是 monorepo,两个子包,都是装进 DSH(DeepSeek Harness,DeepSeek 开源的 Agent 框架)的第三方插件:

• dsh-windows-superagent(编排插件):监听通道、评估请求、开工单、派给 worker 会话、回原对话答复。

• dsh-windows-superagent-board(看板插件):侧栏多一个 tab,看谁在干什么、哪些事卡在人这里。0.2.6 还是骨架版(skeleton)。

一条消息进来做五件事:Source 收到触发 → Eval 按策略评估 → accept 则原子地创建 Ticket(工单)→ 派给 Executor 会话执行 → Report 回原通道。官方设计原则一句话:授权范围内才动手,有结果或确实需要人时才说话。

二、能干什么:策略三档、四个通道、工单隔离

打开网易新闻 查看精彩图片

(图注2:策略三档与四个通道能力卡——GitHub 默认启用,飞书、本地会话、微信默认关)

核心能力按 README 的能力表拆开看:

• 工单式编排:每个工单有自己的会话(worker-工单号)、自己的目录、自己的 Mandate(授权依据)与线程订阅。改动归哪个对话负责,一清二楚。

• 策略化 accept:三档——off(推断类消息一律不接)、observe(默认档,只记 would-accept,不动手)、auto(命中规则才真接)。名单上的人点名 agent 的显式请求在任何档都生效。

• 四个通道:GitHub 默认启用(一个仓库一个团队,PR、issue、评论触发,回复回原线程);飞书默认关(要 bot 的 lark-cli);本地 DSH 会话默认关(指定某个普通会话的 id 当信道);个人微信(iLink Bot)默认关,扫码登录,不需要 app id 和 secret。

• Windows 原生:盘符与 UNC 路径、PATHEXT、pwsh 作为 shell 工具、windowsHide 不闪控制台、大小写不敏感路径、不用 tmux 和 fcntl 的服务管理器,还带 install-windows.ps1 安装器。

三、0.2.6 新在哪:本地 git 兜底与 100 秒超时

打开网易新闻 查看精彩图片

(图注3:官方看板截图——隔离演示实例、独立 profile、数据虚构,展示团队任务板总览)

CHANGELOG 里 0.2.6 的四项变更,直接决定它和旧版 dsh-superagent 的差别:

1. 选择卡 100 秒超时:主控 preset 的 ask_user_question 改为 timed 模式,100 秒没人应答就返回 pending,回合继续,卡片之后还能补答。只有主控会话会向人提问,执行器会话拿不到这个工具。

此前微信消息会无限排队等回答,现在不再阻塞会话与收件箱。

1. GitHub 变可选:不配 GitHub 也能开工——本地 git 仓库兜底,缺目录自动 git init 建 main 分支加一次空提交;配了但探测失败(CLI 未设置、未登录、仓库只读)只在面板提示,不阻塞启动。

2. 默认可无远端开工:executor 的 prepare 命令留空时,工单目录用 git worktree add 准备,没有远端也能跑。

3. 看板刷新按钮并入标题行:窄侧栏不再单独占一行。

还有一条部署注意:0.2.6 发布的 board 包没声明 dsh.bundle,直接写进 dsh.profile.bundles 会被 DSH 跳过(修复已在 main 分支,随下次发布生效),按 README 用 dsh plugin add 挂载即可。

四、怎么装:六步,从 clone 到面板起来

打开网易新闻 查看精彩图片

(图注4:安装六步卡——前置依赖、两包挂载、stateDir 必填、探活启动、面板 URL)

前置依赖:DSH 0.2 以上(README 徽章口径实测 0.2.2-rc.3)、Node 18 以上、pnpm、git。

dsh CLI 默认装在 C 盘 Users 你 AppData Local Programs DeepSeek Harness resources runtime cli bin 下的 dsh.cmd。想用聊天通道,再备一个 agent 专用的 GitHub 账户(PAT 令牌,repo 权限),可选飞书应用或微信 iLink bot。

git clone https://github.com/HiSeax/dsh-windows-superagent.git

cd dsh-windows-superagent

pnpm install

pnpm --filter dsh-windows-superagent check

pnpm --filter dsh-windows-superagent-board build

check 命令一次跑完类型检查、测试、构建。然后建专用 profile 并挂载两个插件(安装器可以先 -DryRun 看一眼再真跑):

& $dsh superagent --from-default-profile web

powershell -ExecutionPolicy Bypass -File packages\dsh-windows-superagent\scripts\install-windows.ps1 -Profile superagent -Dsh $dsh -DryRun

dsh plugin --profile superagent add "link:$PWD\packages\dsh-windows-superagent"

dsh plugin --profile superagent add "link:$PWD\packages\dsh-windows-superagent-board"

再填一个必填项:profile 的 cordis.patch.yml 里的 stateDir,必须是 Windows 绝对路径(官方给了脱敏示例 examples/profiles/desktop/cordis.patch.example.yml)。最后探活与启动:

node packages\dsh-windows-superagent\scripts\dsh-windows-superagent.mjs status --profile superagent

node packages\dsh-windows-superagent\scripts\dsh-windows-superagent.mjs start --profile superagent

status 返回 0 即正常。面板的一次性 URL(带 token)打印在 stateDir 下 .artifacts 的日志文件里。

npm 上查不到这个包(404),安装只有 git 源加本地 link 这一条路。

五、怎么用:先 observe 读决策,再切 auto

官方示例文档给了一条完整链路(人物与仓库均为虚构),照着走一遍就明白各环节谁负责:

1. 名单上的 dana 在仓库开 issue:“导出按钮忽略了时区设置”。

2. GitHub 通道收到触发。因为 dana 在名单上且点名了 agent,闸门判为显式请求。

3. 主控会话评估,按 triage-new-issue 规则接单,原子创建工单。工单里带 Mandate(记录命中规则)、订阅 issue 线程、首个 Assignment 和确认回复。

4. 工单派给独立 worker 会话,执行器可以开队友子会话并行(复现、修复、测试各一个)。

5. 执行器开 PR、在 issue 线程发结果回复,工单跟随 PR 线程,合并后关单。看板上人可以随时停、重试、重评。

策略示例文档里列了四类主动规则:

• triage-new-issue:新 issue 要求改本仓,开以工单命名的分支并回帖确认。

• review-requested:PR 请求评审,指定评审人与合并前提。

• ci-red-default-branch:默认分支 CI 红了先查后报,绝不强推。

• weekly-digest:定时周报。

规则、accept 档、各通道策略合起来构成策略版本,每个工单的 Mandate 记录自己是在哪个版本下接的单——策略一变,旧评估作废重排。

看板上还会显示工单的五种状态:working(执行器正在做)、blocked 与 failed(卡住或失败,需要人)、waiting(回合结束,等评审或 CI)、ended(Threads 关闭、结果报 ready),另有 stopped、merged 与 closed。只有需要人的事才会浮到面板最前,健康状态不占版面——这是它“尽量少占注意力”设计原则在看板上的落地。

正确姿势:先用默认 observe 跑一段,看它记下来的 would-accept 决策,调好规则再切 auto。

六、微信通道:手机上给编码 agent 派活

打开网易新闻 查看精彩图片

(图注5:微信通道官方截图——真实对话已脱敏,展示 iLink 个人号接入效果)

这是本仓最大的差异点:个人微信扫码登录就能给 agent 派活,不需要企业应用的 app id 和 secret。流程:

1. 启用 dsh-windows-superagent-weixin 插件,重启 DSH。

2. stateDir 下生成 weixin-qrcode.png 二维码(数分钟失效,最多自动刷新 3 次)。

3. 微信 8.0.69 以上扫码确认,登录态存到 stateDir 的 weixin-bot.json。

4. 把对方的 wxid 加进策略的 Weixin 允许名单,消息才进域。

四个实测口径必须知道:

• 推送窗口约 1 小时:iLink 只在对方最后一条消息之后约 1 小时内允许主动推送,超时发送返回 ret=-2。

所以排队的回复要短命,对方再发一条,积压会补发;被拒的发送记在 weixin-send 健康项,不静默丢弃。

• 图片:入站图片解密落到 stateDir 的 weixin-media 目录(按内容哈希),出站回复最多带 4 张附件(png、jpeg、webp、gif),单图默认上限 10MB。

• 长消息:单条上限 4000 字符,优先在段落和换行处切分分条发;微信不渲染 Markdown,回复形态被约束成短分点加“回 1、回 2”选项。

• 健康项五个:weixin(登录)、weixin-poll、weixin-send、weixin-upload、weixin-media,面板逐项看。

七、适用与不适用

官方给的两张清单很直接。适用:一个仓库一个团队;大家已在某个通道里;要开分支开 PR 并回原对话汇报;愿意先 observe 再开 auto;Windows 加 DSH 0.2 以上。

不适用:要打磨好的成品;跨多仓库编排;不能接受 worker 以你的 OS 用户身份执行命令。

八、风险与注意:四条官方口径各配减险动作

打开网易新闻 查看精彩图片

(图注6:四条风险卡——worker 身份、微信推送窗口、先 observe 再 auto、stateDir 单宿主)

官方自己划的边界,逐条配减险动作:

1. worker 以你的 OS 用户身份跑命令:Windows 上 blockedCommands 对 worker 不生效(worker 垫片是 sh 脚本)。

减险:命令隔离重要时,用专用 OS 账户加 agent 自己的 GitHub 账户。

1. 微信推送有 1 小时窗口:减险:排队回复保持短命,被拒发送进 weixin-send 健康项可查,不静默丢弃。

2. 默认 observe 不真接:减险本身就是减险——先读记录再切 auto,规则调不好就别放 auto。

3. 一个 stateDir 同时只允许一个 DSH 宿主:减险:多套部署各用独立 stateDir、独立端口;复制 state 目录后出现 setupPending,把 GitHub 通道的 agent CLI 指回真实可执行文件或让 Setup 在新目录重写垫片。

装错 profile 起不来时,用同目录的 cordis.patch.yml 备份恢复,或删掉你加的 insert 行;junction 指向的目录必须是存在的本地路径,别用网络盘;复制 state 目录后若看板读到别的部署,多半是 DSH_SUPERAGENT_BOARD_PORT 被编排器与看板两个插件同时读了——隔离副本里把看板插件禁用、端口变量只留给编排器,常规部署则干脆别设这个变量。

最后两条背景:它是研究原型,可能有 bug、代码风格未必一致;看板截图来自隔离演示实例、数据虚构,微信截图是真实对话已脱敏。