前言¶
在使用 dsh（DeepSeek Harness）构建 Agent Teams 时，随着成员与任务积累，名册和任务列表会变得杂乱。上游 dsh 没有提供批量清理、倒序显示或成员改名的能力，需要手动维护。dsh-agent-team-roster 是一个 Cordis bundle 插件，在不修改上游代码的前提下，为名册管理提供了倒序显示、批量清理、改名与删除等实用工具。
这是什么¶
dsh-agent-team-roster 是一个用于 dsh Agent Teams 名册管理的插件，由维护者 yezitotempeace 开发。它通过扩展投影单元（projection unit）和视图包装，为名册、任务板和子智能体对话目录增加倒序显示、批量清理和成员改名/删除功能。插件适配 dsh 0.2.0-rc.2，采用 MIT 许可证。
核心功能¶
命令工具¶
| 工具 | 作用 |
|---|---|
rename_teammate { target, new_name } |
原地改名：保留历史、会话、任务与未投递消息；新名字成为它的地址 |
delete_teammate { target } |
结束该成员当前回合、释放运行时、释放其未完成任务、丢弃未投递消息、释放名字 |
cleanup_team { scope } |
批量清理，scope 为 teammates / tasks / all |
批量清理语义¶
已结算（inactive/failed）成员会被删除；已完成任务会被删除。以下会被跳过并报告在 skipped[]（含原因），不会被误删：
- 运行中的成员
- 仍在 provisioning 的成员
- 未完成的任务
- 仍阻塞着别的任务的任务
只有 Team Lead 能调用以上三个工具。
显示顺序¶
团队名册、共享任务板、子智能体对话目录均为最新在最上；Lead 行固定第一（它是当前会话的锚点，不是子成员）。
实现方式¶
插件不修改上游代码，通过扩展投影单元和包装视图来实现功能：
改名 / 删除：扩展已注册的 agentTeam 投影单元的 def.apply，把两种变更表达为既有 team/member 事件的新取值（renamedTo 字段 / phase: "removed"），因此名册、邮箱、任务板、工具、客户端视图全部照常读到变更。
显示顺序：包装 agentTeam 与 subagentCatalog 的 def.wire.view——那是客户端实际收到的值。有序值以打包视图的引用为键做 WeakMap 记忆化，保持上游「单元自身忽略的变化不重复发布」的契约。
不变量：投影状态、stateVersion、存储值、以及面向模型的服务契约（list_agents / team_task_list）仍按上游顺序返回；倒序只影响客户端可见视图。
安装与启用¶
插件通过 dsh profile 安装，步骤如下：
- 把本仓库放到任意目录，例如
/root/dsh-agent-team-roster - 在 profile 的
package.json依赖中加入：
"dsh-agent-team-roster": "link:/root/dsh-agent-team-roster"
- 在该 profile 的 bundle 插件列表中加入
"dsh-agent-team-roster" - 若该 profile 是
patchReload: startup，重启 dsh 服务后生效
典型用法¶
Team Lead 可以使用以下命令进行名册管理：
# 原地改名
rename_teammate { target: "member1", new_name: "new_name" }
# 删除成员
delete_teammate { target: "member1" }
# 批量清理
cleanup_team { scope: "all" } # 清理成员和任务
cleanup_team { scope: "teammates" } # 仅清理成员
cleanup_team { scope: "tasks" } # 仅清理任务
适用场景与注意¶
适合需要维护 Agent Teams 名册和任务列表的团队。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
边界说明：
- 已删除成员的子会话无法物理删除：dsh 没有会话删除 API。清理覆盖名册行与共享任务；子智能体目录只有顺序生效。
- 倒序只作用于客户端可见视图；面向模型的 list_agents / team_task_list 保持上游顺序。
- 仅适配 dsh 0.2.0-rc.2。上游结构变化时插件会在激活阶段显式报错，而不是静默降级。
结尾¶
dsh-agent-team-roster 为 Agent Teams 提供了实用的名册管理能力，通过倒序显示和批量清理，简化了团队维护工作。插件经过独立第三方智能体两轮验收，功能主张均已证实。
- 目录页：https://www.skillhub.cn/plugins/yezitotempeace/dsh-agent-team-roster
- GitHub：https://github.com/yezitotempeace/dsh-agent-team-roster
