[Bug] 0.2.0-rc.2 nightly：父 Agent 无法终止自己派出的子代理

[Leexunhuan743]

摘要

在 0.2.0-rc.2 nightly（Windows x64）上，父 Agent 依旧无法终止自己用 subagent 派出的子代理：

• interrupt_agent(target: <childId>) → Error: active teammate "<childId>" not found
• send_message(target: <childId>, message: ...) → 同一句错误
• list_agents() → 只返回 lead；job_list() → (no background jobs)

也就是说，运行中的子代理在父 Agent 的控制面上既不显示、也不可寻址、也不能终止；唯一出路是人在 GUI 里手动点停止。手动停止这条路径本身是正常的：父会话随后收到了 Background subagent ... was stopped before it finished. 连同它的 closing message。问题只在于父 Agent 自己发不起这个停止。

本贴不是新问题，下面先列既有报告，再补当前 nightly 上的复现。

与既有报告的关系

#	标题	创建	状态
#7087	[Bug] Duplicate tool names across scopes: Teams' send_message shadows tool-subagent-control's, breaking plain continuable subagents	2026-09-18	未修复
#7642	[Bug] Agent Teams bundle 在 Web/Desktop 未禁用 subagent：子代理不在 Team roster，list_agents/send_message 找不到也联系不上	2026-09-23	未修复
#9056	[BUG] subagent 派出的子代理不可寻址：send_message / interrupt_agent 均报 active teammate not found，父 Agent 无法终止它	2026-10-07	未修复

三条目前都是开放状态：#7087 指向工具重名遮蔽这一根因方向，#7642 指向 roster 缺失，#9056 记录症状。在 0.2.0-rc.2 nightly 上三者都仍然可复现。

环境

• DeepSeek Harness 0.2.0-rc.2，nightly 通道（app-update.yml → channel: nightly，
  feed https://download.deepseek.com/dsh-desk/feeds/win-x64/），Windows x64 用户级安装
• profile desktop 启用的 bundles：@deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app、
  dsh-ops、@deepseek-ai/dsh-experimental-schedule-bundle、
  @deepseek-ai/dsh-experimental-agent-team-profile、
  @deepseek-ai/dsh-experimental-auto-review、billion-context-dsh
• 同一 profile 的 cordis.yml 里注册着 subagent 组件：subagent（maxActiveSubagents: 16）、
  subagent-spawn-in-process、tool-subagent-control、tool-subagent-list-agents、tool-subagent

复现步骤

1. 父 Agent 用 subagent 以后台方式派一个子代理，拿到 id（示例：
   529885eb-b628-41d4-923a-8cf755844b1b，label Map repo package structure）。
2. 子代理运行期间，父 Agent 尝试终止它 —— 两条路都失败：

interrupt_agent(target: "529885eb-b628-41d4-923a-8cf755844b1b")
→ Error: active teammate "529885eb-b628-41d4-923a-8cf755844b1b" not found

send_message(target: "529885eb-b628-41d4-923a-8cf755844b1b",
             message: "STOP ...")
→ Error: active teammate "529885eb-b628-41d4-923a-8cf755844b1b" not found

3. 父 Agent 也看不到它：

list_agents()  → 只返回 lead（running）
job_list()     → (no background jobs)

4. 只能由人在 GUI 里手动点停止。

期望

1. interrupt_agent / send_message 接受 subagent id，或另给一个 subagent_stop 之类的工具，
   让父 Agent 能终止自己派出的子代理。
2. 至少让运行中的子代理出现在 list_agents()（或等价的列表）里，并带可寻址 target。
3. 若设计上只能由人停止，请改掉 subagent 的工具说明——现在写的是
   "returns a subagent id you can continue with send_message"，与实测不符——
   并给 subagent 加一个父侧可控的超时 / 取消参数。

影响

父 Agent 在子代理跑偏或跑太久时无法纠正、无法止损，只能干等或请人代劳；长任务上就是上下文和时间的双重浪费。

[PerryLink]

根因不在子代理身上——是你启用的那个 profile 把 subagent 工具整套禁掉了，换成了 Team 工具。你手上那个 interrupt_agent 根本不是控制子代理的那个。

决定性的一行

packages/experimental/agent-team-profile/cordis.patch.yml 里有四条：

- id: tool-subagent-control
  disabled: true
- id: tool-subagent-list-agents
  disabled: true
- id: tool-subagent
  disabled: true
- id: tool-subagent-fork
  disabled: true

同一个文件的注释自己写着：apply after dsh-base so these replacements keep direct delegation and coordination on the Team tools。packages/experimental/agent-team-profile/README.md:61 也是这么说的。

所以只要你挂了 @deepseek-ai/dsh-experimental-agent-team-profile（你列的组件清单里有它），send_message / interrupt_agent / list_agents 这三个名字就归 Team 版所有了。

怎么自证你撞的是哪一套

两套工具的参数名不一样，看一眼你实际拿到的 schema 就能定案：

	control 版（tool-subagent-control）	Team 版（tool-agent-team）
send_message 目标参数	agent_id（src/index.ts:34）	target（tool-agent-team/src/index.ts:225）
interrupt_agent 目标参数	agent_id（:81）	target（:289）
list_agents	有可选 scope（list-agents.ts:94）	无任何参数（:242）

你写的是 interrupt_agent(target:)、send_message(target:)、list_agents(scope:'descendants') —— 前两个正好是 Team 版的形状。

而且那句报错我找到出处了，在 Team 侧：packages/experimental/agent-team/src/roster.ts:51 → throw new TeamError(\active teammate "${name}" not found`, 'TEAM_MEMBER_NOT_FOUND')`。它找的是 roster 里的 teammate 名字，不是 session id。

关于"list_agents 只返回 lead"

这个也是设计，不是 bug。tool-agent-team/src/index.ts:245 → ctx.agentTeams.listMembers(...).map(modelMember)，工具描述写的是 "List the Lead and every durable teammate"。

所以：你直接派出的那个匿名 child 从来就不在 roster 里，Team 版的三个工具按设计永远够不到它。 这解释了你观察到的全部现象——包括"手动在界面上点停止是好的"和"父会话还收到了 closing message"，说明子代理运行链路本身没问题，坏的只是你手里这套工具的名字。

那该怎么做

在这个 profile 下，要么改用 Team 的玩法：

1. spawn_teammate 建 teammate（拿到 name）；
2. list_agents() 看名单；
3. interrupt_agent(target: <那个 name>)。

要么别挂 agent-team-profile（或者不禁那四行），把 subagent + agent_id 那套要回来。这两套是互斥的接线，不是同一个东西的两条路。

有一处是真缺陷，值得你单独提

你说 subagent 的说明里写着 "returns a subagent id you can continue with send_message" —— 我核了，tool-subagent/src/index.ts 里的原文确实是 "The child reports results with send_message; use send_message to steer it while running or continue its conversation after it finishes."

但在你这个 profile 下这句话是失真的，因为 send_message 已经被换成 Team 版，它认的是 roster 名而不是 session id。这是个实打实的描述与可用工具集不一致的问题，比你现在的主诉更容易被采纳。

不过这里有个我解不开的点，需要你确认：那份 patch 明明已经 disabled: true 了 tool-subagent，你却还能调到 subagent 工具。这说明要么该 profile 没完全生效，要么还有别的来源在提供它。麻烦你跑一下 dsh --version 并把 ~/.dsh/profiles/<profile>/cordis.yml 的最终态贴出来——这个缺口补上之后，你这条报告的定性就完全确定了。

边界

我核的是 origin/master = 571902028a（2026-10-14）。你写的是 0.2.0-rc.2 nightly（Windows x64）。

另外提醒一句：这个坑不是第一次出现。README 里 :107 早就写过 preset 仍会挂自己作用域内的 subagent 控件，但没有说明"被换掉名字之后 subagent 的说明会失真"——你要提的话，可以从这个角度切入，比"父 Agent 无法终止子代理"准得多。