DSH Agent Teams 补丁包：退休 · 每成员模型 · 团队面板

给 DSH 桌面版的 Agent Teams 补三件事：

队友能退休 —— 退场后不再占席位、名字可复用，但 durable 名册 / 任务归属 / 消息历史保留；
每个队友单独选模型 —— 面板里每人一行下拉，加人时也能指定 provider/model；
会话标题栏的团队面板 —— 名册（状态、当前模型、退休按钮）、任务板、加人表单（名字 / 任务 / 模型 / --fork）。

适用范围：DSH 桌面版，@deepseek-ai/* 版本必须是 0.2.0-rc.2。这是对发行代码（resources/app/node_modules）的热补丁，DSH 升级后失效（重新生成见第 7 节）。正确的修法在上游，见 ISSUE.md。

给 agent 的指令（可整段复制）：克隆本仓库，先跑 node apply.mjs --check。输出里必须同时有 PATCHED 和 WIRED（exit 0）；若不是或报 drift，把完整输出贴回来，不要加 --force。确认后跑 node apply.mjs，然后让用户完全退出 DSH 再打开。

安装（插件方式，推荐）

这个仓库本身就是一个 DSH 插件包 —— 根目录的 package.json 声明了 dsh.bundle：

dsh plugin add https://github.com/ExpertKT/dsh-agent-team-patch
# 加完在插件列表里启用它（启用会把它写进 profile 的 dsh.profile.bundles），然后重启 DSH

它给的是会话标题栏的团队面板：看当前小队名册、加队友（名字 / 任务 / --fork / 可选模型）、给每个队友换模型。前提是你的 DSH 里已有官方那三个实验包（Agent Teams）。

这一半不含「退休」：退休要改官方名册的状态机，那是下面热补丁那一半的事（也在向上游提 issue），所以这个面板里没有退休按钮。

改动就是四个文件：package.json、cordis.patch.yml（关掉官方同名 UI、插入本包）、lib/panel/index.js（宿主侧注册 /teammates 命令）、lib/panel/client.js（浏览器侧面板，由 tools/build-plugin.mjs 从 patched/ 生成）。

1. 安装（热补丁方式）

cd 
node apply.mjs --check     # ① 自检，只读不写盘
node apply.mjs             # ② 装：7 个文件 + profile 接线，都会留备份
                           # ③ 完全退出 DSH，再打开（服务端插件没有热重载）

装完在任意会话里，鼠标移到标题栏右侧：出现「团队」入口 → 点开就是面板。

apply.mjs 的参数（通常一个都不用给）：

参数	什么时候需要
`--root`	自动探测失败，或机器上有多个安装
`--dsh-home`	你的 DSH 家目录不是 `~/.dsh`
`--profile
`	profile 不在 `/profiles/`
`--check` / `--revert` / `--force`	自检 / 卸载 / 明知文件被改过仍要覆盖

安装位置自动探测顺序：$DSH_APP_ROOT → %LOCALAPPDATA%\Programs\* → %ProgramFiles%\* → %ProgramFiles(x86)%\* → C:\DSHDesktop\*、D:\…、E:\…、F:\DSHDesktop\*（每个基目录只看一层，认 package.json 里 name 以 dsh-plugin-desktop 开头的那个）。找到第一个就用，并把其余候选打印出来。

2. 卸载

node apply.mjs --revert    # 还原 7 个文件 + profile 里加的那一行
# 重启 DSH

3. 装不上时（一律明确拒绝，不会只做半套）

输出	含义	处理
`[FAIL] N 个包版本不符`，exit 2	你的 DSH 不是 `0.2.0-rc.2`	这份补丁不适用；按第 7 节用你的版本重新生成
逐文件 `drift`，`apply` 拒绝，exit 2	目标文件不是这份构建的原始字节（升级过/换过构建）	同上。别用 `--force` 蒙
`profile (unresolved …)`	找不到 profile	用 `--dsh-home` / `--profile` 指过去

三条门槛里前两条是「这份补丁不适用」的硬信号，第三条只是路径提示。

4. 装完没变化？按顺序排查

重启了吗：服务端插件没有热重载；客户端插件至少 Ctrl+F5；
node apply.mjs --check 是否 PATCHED + WIRED；
入口在会话标题栏右侧，面板只列当前会话自己那支小队（在队友的会话里看到的是那支队友的小队）；
模型下拉是空的：说明那台机器的 provider 没配（面板照 host 报上来的模型目录列，不做白名单）；
还是不行：Ctrl+F5 后看 agent-team: … 那行字（面板的错误边界会把渲染异常显示出来，而不是默默消失）。

5. 这个补丁改了什么（7 个文件 / 3 个包）

包	文件	改动
`dsh-experimental-agent-team`	`lib/index.js`	相位加 `retired`；`active\|failed → retired` 守卫；席位只数非 retired；名字唯一性只在在役范围；名册/投影跳过退休成员；Lead-only `retire()`；`spawnAdmitted` 转发 `agentOptions`（选模型）
同上	`lib/invariant.js`、`lib/types/index.js`、`lib/types/projection.js`、`lib/types/roster.js`	同源拷贝，为语义一致一起改（发行包内无 importer，但 `exports` 里有）
`dsh-experimental-tool-agent-team`	`lib/index.js`	注册 `retire_teammate`；`spawn_teammate` 加可选 `model`（`provider/model`）；新增 `/team` 命令（`list \| retire \| add [--fork] [--model p/m] --
`）
`dsh-experimental-client-ui-agent-team`	`lib/client.js`	团队面板（名册 / 任务卡 / 加人表单 / 每成员模型下拉 / 退休按钮）；Remote 命名空间统一走 `ctx.get`；面板外包错误边界

package.json 不补（registry 安装只改了依赖键顺序，是噪声）。逐行 diff 见 patches/*.patch，完整哈希见 manifest.json。

6. 它怎么被验证的

7 个离线检查，全部 exit 0（node checks/.mjs）：

检查	覆盖
`retire-check` / `retire-event-check` / `reuse-check`	退休可写入、投影隐藏、三条非法转换仍被拒；同名重建重放不报 failure（7/7）
`team-command-check`	`/team` 的 list / add / retire、`--model`、`--` 后原文照传、各类畸形输入不抛（37/37）
`team-ui-check`	面板动作的调用契约 + 真渲染烟囱（假 react hooks 直接调组件）覆盖「新队友还没选模型」这条崩溃
`remote-namespace-check`	用发行包里的真 Cordis 复刻命名空间形状，实测 `ctx.get` 无需声明、`ctx.remote.` 未声明会抛
`profile-wiring-check`	临时 fixture 里跑完 `--check → apply → --check → --revert`，含「不重写 app 文件」「逐字节还原」「自动探测安装位置」(18/18)
`bundle-check`	插件那一半：`dsh.bundle`/`dsh.client` 清单、bundle patch 的形状、宿主插件注册 `/teammates` 并真的跑一次 add（含"宿主忽略模型时不静默"分支）、浏览器 bundle 能按 `__ModuleLoader__` 契约加载、且生成物与 `tools/build-plugin.mjs` 一致

端到端对照（tools/build-verify-root.mjs 造一个「未打补丁但依赖可解析」的根）：

根目录状态	`apply.mjs --check`	6 个补丁检查
未打补丁	`NOT-PATCHED pristine=7` + `NOT-WIRED`，exit 1	5 个失败
`apply` 之后	`PATCHED` + `WIRED`，exit 0	全部 exit 0
`--revert` 之后	回到 `NOT-PATCHED` + `NOT-WIRED`，exit 1	又失败

patched/ 的字节可以从公开 npm tarball（@deepseek-ai/*@0.2.0-rc.2）+ 一个派生基线精确复现（远端 tree 与本地 tree 相同）。真机上还实测过：加人、退休、每成员模型下拉、队友用 send_message 给 Lead 发消息。

保留（没有独立坐实的部分，请当待验证）：满员 → 退休 → 再 spawn 的端到端（离线证明，未在满员团队上复跑）；client.js 的 pristine 是派生基线（桌面 app 自带的是另一次构建，只差生成型 CSS 脚手架）；本仓库没有在第二台机器上跑过（能否适用由第 3 节的两条硬门槛把关）。

7. DSH 升级后重新生成

$v = '0.2.0-rc.2'   # 换成你的版本
foreach ($p in 'dsh-experimental-agent-team','dsh-experimental-tool-agent-team','dsh-experimental-client-ui-agent-team') {
  Invoke-WebRequest "https://registry.npmjs.org/@deepseek-ai/$p/-/$p-$v.tgz" -OutFile ".cache\$p.tgz"
  New-Item -ItemType Directory ".cache\pristine\$p" -Force | Out-Null
  tar -xzf ".cache\$p.tgz" -C ".cache\pristine\$p"
}
node tools\build-manifest.mjs          # 先看报告：应当只有 7 个文件、package.json 被跳过
node tools\build-manifest.mjs --write  # 重写 manifest.json / patched / baseline / patches
node tools\build-verify-root.mjs       # 造未打补丁的根，跑上面第 6 节的对照

8. 目录

路径	作用
`package.json` / `cordis.patch.yml` / `lib/panel/`	插件那一半：`dsh.bundle` 清单、组合补丁、宿主侧 `/teammates`、浏览器侧面板
`tools/build-plugin.mjs`	由 `patched/` 生成 `lib/panel/client.js`（`--check` 可验证生成物是否过期）
`apply.mjs`	安装/卸载器：版本 + sha256 双闸门、幂等、带备份、自动探测安装位置、profile 接线
`manifest.json`	7 个文件的 pristine / patched sha256（`apply.mjs` 的唯一依据）
`patched/`	补丁后的字节快照（`apply.mjs` 拷贝的源）
`patches/*.patch`	三份 unified diff（给人看 / 给上游）
`baseline/`	只放不能从 npm 得到的基线：桌面 app 自带那次构建的 `client.js`
`checks/`	7 个离线检查（外加 `who-runs-what.mjs` 机器状态探针）
`tools/`	`build-manifest.mjs` 重生成补丁集；`build-verify-root.mjs` 造验证根
`README.md` / `ISSUE.md` / `HANDOFF.md`	本文 / 上游 issue 草案（A–D）/ 原始现场笔记
`.cache/`、`wip/`	构建脚手架与临时快照（已 gitignore）

9. 已知限制

热补丁会被 DSH 升级覆盖（--check 会因此 exit 1，不会静默出错）；
必须重启 DSH 才生效；客户端插件至少 Ctrl+F5；
--revert 依赖 .dsh-retire.bak / profile 的 .dsh-team.bak；
退休成员在客户端不可见（服务端投影过滤，这是有意选的兜底）；
队友在会话树里是 Lead 的 continuable 子会话（上游设计），所以会话列表里它看起来像子智能体；把它和普通子智能体区分开的唯一界面是团队面板；
模型下拉的选项来自 host 报上来的模型目录，取决于那台机器自己的 provider 配置；
checks/team-ui-check.mjs 是「假 react hooks + 直接调组件」的渲染，不是真 React 渲染：能抓渲染期抛错，抓不到 DOM/样式问题。

10. 许可与出处

补丁改的是 DeepSeek Harness 的 @deepseek-ai/* 包（各包自带 MIT LICENSE），patched/ 与 baseline/ 里保留其产物只为可复现；本仓库只提供补丁、安装器和验证脚本。

dsh-agent-team-panel

설치

문서