前言¶

在 DeepSeek Harness（DSH）里用子代理做并行或分工时，删完子代理会话，父会话头部「子代理」下拉里往往还留着那条登记行。上游 dsh-plugin-subagent-delete 的 README 写得很直白：subagent/catalog 是只追加的持久历史，要抹掉条目就得重写已提交日志，而 DSH 原先并不支持。社区插件 huajiao1998/dsh-plugin-subagent-clean 在同名能力上做了改进：删除子代理的同时，把父会话日志里对应目录行原位「退休」，并在网页端提供一键清理面板。包名仍为 dsh-plugin-subagent-delete，可直接替换上游安装。

这是什么¶

维护者 huajiao1998 的客户端类 DSH 插件，基于 heiheiha798/dsh-plugin-subagent-delete（MIT）演进，当前版本 0.3.0。它解决两件事：一是归属校验下的子代理删除 / 释放 / 列表（与上游工具语义一致）；二是父会话里因 subagent/catalog 只追加而删不掉的下拉历史行——通过不改 seq 的原位事件替换，让 UI 不再投影那一行。

和上游 0.2.3 的差异¶

核心功能¶

子代理管理工具¶

与上游一致，供模型调用：

• list_subagents：可按 activity、mode 过滤，或用 include_absent: true 列出已持久化删除的条目。
• delete_subagent：按 subagent_id 删除，可选 recursive: true。
• release_subagent：只停不删。

归属校验、Team 花名册 dismiss、递归删除、already_absent 语义与上游相同。

父会话目录行的「退休」¶

会话日志要求事件 seq 从 0 连续、且压缩事件引用固定区间，因此不能删行留洞，也不能整体重编号。本插件把原 subagent/catalog 事件原位改成加载器可忽略的类型，例如：

// 改写前
{"type":"subagent/catalog","seq":263,"time":1730000000000,"data":{"childId":"…"}}

// 改写后（seq 与原值一致，只换类型）
{"type":"subagent-delete/retired","seq":263,"time":1730000000000,"ignorable":true,
 "data":{"childId":"…","retiredAt":1730000005000}}

seq、time 不变；信封上 ignorable: true 时，未知类型会被保留；目录投影只在 type === "subagent/catalog" 时生成行，故该行从下拉中消失。其余事件逐字节不动。

网页端（web profile）¶

会话头部增加 「子代理」 按钮，列出本会话子代理：

• 单行 「删」：删该子代理并退休对应目录行。
• 「一键清理」：清空全部子代理，日志只重写一次。
• 删完后自动刷新会话列表。

HTTP 路由¶

web profile 下提供（路径前缀仍为上游习惯的 dsh-plugin-subagent-delete）：

GET  /dsh-plugin-subagent-delete/list?parentSessionId=<id>[&activity=…][&mode=…]
POST /dsh-plugin-subagent-delete/delete   {"parentSessionId":"<id>","subagentId":"<id>","recursive":false}
POST /dsh-plugin-subagent-delete/release  {"parentSessionId":"<id>","subagentId":"<id>","recursive":false}
POST /dsh-plugin-subagent-delete/cleanup  {"sessionId":"<id>"}
POST /dsh-plugin-subagent-delete/scrub    {"parentSessionId":"<id>"}

cleanup 先批量删会话、最后统一重写日志；scrub 只处理「会话文件已不在、登记行还在」的残留。

实现上还有：活会话可直接重写且宿主继续追加正常；写临时文件再 stat、一致才 rename 的并发保护；失败时写入 ~/.dsh/plugin-subagent-delete-pending.json 供下次启动补做。重写会把整份日志解压进内存，体量接近未压缩大小，超大会话需注意内存。

安装与启用¶

在 web profile 下安装（命令来自仓库 README）：

dsh plugin --profile web add github:huajiao1998/dsh-plugin-subagent-clean

固定版本：

dsh plugin --profile web add github:huajiao1998/dsh-plugin-subagent-clean#v0.3.0

本地目录：

dsh plugin --profile web add /path/to/dsh-plugin-subagent-clean

装完后重启 profile，重新打开一个会话。package.json 要求 Node ^22.19.0 || >=24.0.0；在 DSH 0.2.1-rc.2、Node 22 上实测，不修改 DSH 核心，仅依赖公开的 ctx.tools / ctx.webServer / ctx.slots。许可证 MIT。

典型用法¶

网页端¶

打开带 web 客户端的会话 → 头部点 「子代理」 → 对单行点 「删」，或点 「一键清理」。

模型侧示例¶

list_subagents({})
list_subagents({ activity: "running" })
delete_subagent({ subagent_id: "<id>" })
delete_subagent({ subagent_id: "<id>", recursive: true })
release_subagent({ subagent_id: "<id>" })

适用场景与注意¶

适合经常在 DSH 里 spawn 子代理、又希望父会话 UI 与子代理文件状态一致的用户；需要批量清空或只扫「已删会话、行还在」时，可用 HTTP 的 cleanup / scrub 或网页一键清理。

插件以当前 DSH 进程的权限读写会话日志与 ~/.dsh 下 pending 文件，安装前应自行查看 GitHub 源码 与 LICENSE，确认符合你的安全与合规要求。社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」的思路，本插件是其中针对子代理清理与目录残留的一类客户端扩展。

结尾¶

若你已被「删了子代理、下拉还在」困扰，本插件在不动 DSH 核心的前提下，用日志原位退休补齐了上游文档里写明的缺口，并补上网页清理入口。更多信息见 SkillHub 目录页 与 GitHub 仓库。