dsh-agent-team-panel
Conversation-header Agent Teams 面板：实时成员列表、添加队友，以及切换每位队友所使用的模型。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ExpertKT/dsh-agent-team-patch#4d3846988b091f23bbb8407447dc2d3d86837285Agent Team Panel 以 dsh-agent-team-panel 发布，当前版本为 0.2.0-rc.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH 桌面版的 Agent Teams 补三件事：
provider/model（/team add … --model p/m）。队友已经在跑之后换模型 = 退休 + 同名重建：新会话用新模型，旧会话作为只读历史留下 —— 子会话的模型在创建时就被写进 descriptor，事后改不了（详见 ISSUE.md 的 Issue B）；--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/ 生成）。
cd <本仓库目录>
node apply.mjs --check # ① 自检，只读不写盘
node apply.mjs # ② 装：7 个文件 + profile 接线，都会留备份
# ③ 完全退出 DSH，再打开（服务端插件没有热重载）
装完在任意会话里，鼠标移到标题栏右侧：出现「团队」入口 → 点开就是面板。
apply.mjs 的参数（通常一个都不用给）：
| 参数 | 什么时候需要 |
|---|---|
--root <DSH 的 resources/app> | 自动探测失败，或机器上有多个安装 |
--dsh-home <DSH_HOME> | 你的 DSH 家目录不是 ~/.dsh |
--profile <profile 目录> | profile 不在 <DSH_HOME>/profiles/<名字> |
--check / --revert / --force | 自检 / 卸载 / 明知文件被改过仍要覆盖 |
安装位置自动探测顺序：$DSH_APP_ROOT → %LOCALAPPDATA%\Programs\* → %ProgramFiles%\* → %ProgramFiles(x86)%\* → C:\DSHDesktop\*、D:\…、E:\…、F:\DSHDesktop\*（每个基目录只看一层，认 package.json 里 name 以 dsh-plugin-desktop 开头的那个）。找到第一个就用，并把其余候选打印出来。
node apply.mjs --revert # 还原 7 个文件 + profile 里加的那一行
# 重启 DSH
| 输出 | 含义 | 处理 |
|---|---|---|
[FAIL] N 个包版本不符，exit 2 | 你的 DSH 不是 0.2.0-rc.2 | 这份补丁不适用；按第 7 节用你的版本重新生成 |
逐文件 drift，apply 拒绝，exit 2 | 目标文件不是这份构建的原始字节（升级过/换过构建） | 同上。别用 --force 蒙 |
profile (unresolved …) | 找不到 profile | 用 --dsh-home / --profile 指过去 |
三条门槛里前两条是「这份补丁不适用」的硬信号，第三条只是路径提示。
Ctrl+F5；node apply.mjs --check 是否 PATCHED + WIRED；Ctrl+F5 后看 agent-team: … 那行字（面板的错误边界会把渲染异常显示出来，而不是默默消失）。| 包 | 文件 | 改动 |
|---|---|---|
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 <name> | add <name> [--fork] [--model p/m] -- <prompt>，以及 model <name> <p/m> = 退休 + 同名重建） |
dsh-experimental-client-ui-agent-team | lib/client.js | 团队面板（名册 / 任务卡 / 加人表单 / 每成员模型下拉 / 退休按钮）；换模型先弹确认，确认后走 /team model（旧会话退役、同名新建）；Remote 命名空间统一走 ctx.get；面板外包错误边界 |
package.json 不补（registry 安装只改了依赖键顺序，是噪声）。逐行 diff 见 patches/*.patch，完整哈希见 manifest.json。
7 个离线检查，全部 exit 0（node checks/<名字>.mjs）：
| 检查 | 覆盖 |
|---|---|
retire-check / retire-event-check / reuse-check | 退休可写入、投影隐藏、三条非法转换仍被拒；同名重建重放不报 failure；Lead agent 不活跃时队友仍解析到本队（9/9） |
team-command-check | /team 的 list / add / retire / model、--model、-- 后原文照传、各类畸形输入不抛（全绿） |
team-ui-check | 面板动作的调用契约（含「下拉改成先确认、确认后才发 /team model」）+ 真渲染烟囱（假 react hooks 直接调组件）覆盖「新队友还没选模型」这条崩溃 |
remote-namespace-check | 用发行包里的真 Cordis 复刻命名空间形状，实测 ctx.get 无需声明、ctx.remote.<ns> 未声明会抛 |
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 相同）。真机上实测过：加人（含 --fork）、退休、面板每成员模型下拉显示当前模型、队友用 send_message 给 Lead 发消息。
尚未真机验证：换模型的「确认 → 退役 → 同名重建」这条新路（离线全绿，等重启后复跑）；「下拉里选一下就能热切模型」做不到——子会话模型创建即冻结，这也是要上游化的那个 issue。
保留（没有独立坐实的部分，请当待验证）：满员 → 退休 → 再 spawn 的端到端（离线证明，未在满员团队上复跑）；client.js 的 pristine 是派生基线（桌面 app 自带的是另一次构建，只差生成型 CSS 脚手架）；本仓库没有在第二台机器上跑过（能否适用由第 3 节的两条硬门槛把关）。
$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 节的对照
| 路径 | 作用 |
|---|---|
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） |
--check 会因此 exit 1，不会静默出错）；Ctrl+F5；--revert 依赖 .dsh-retire.bak / profile 的 .dsh-team.bak；checks/team-ui-check.mjs 是「假 react hooks + 直接调组件」的渲染，不是真 React 渲染：能抓渲染期抛错，抓不到 DOM/样式问题。补丁改的是 DeepSeek Harness 的 @deepseek-ai/* 包（各包自带 MIT LICENSE），patched/ 与 baseline/ 里保留其产物只为可复现；本仓库只提供补丁、安装器和验证脚本。