前言¶

DSH 把很多能力拆成插件，Web 客户端扩展也可以进入同一个 profile。做智能体协作时，常见需求不是再造一个团队看板，而是让几个仍然独立运行的 Session 能被一个 leader Session 组织起来：消息可以点名或广播，协调元数据有边界，成员各自的上下文和生命周期不被合并。dsh-agent-team-room 就是面向这个需求的 DSH 插件。

这是什么¶

dsh-agent-team-room 由 ishuowang 维护，许可证为 MIT，当前版本为 v0.6.0。它提供原生 Room，用于连接独立 Sessions 和 provider-backed AI members，不捆绑内置角色或场景。

它不提供内置角色、场景或任务板。Room 的核心是把多个成员放入一个 leader-authorized 的协作边界：成员保持自己的上下文和生命周期，Room 核心负责 direct message、broadcast，以及记录 bounded coordination metadata，不复制 Session transcripts。

核心能力¶

原生 DSH Web 入口¶

插件通过官方 typed slots conversation.session.header.actions 和 sidebar.footer.action 扩展 DSH Web，并提供原生 Room modal。入口位于 DSH Web 中，不依赖 standalone dashboard。

消息路由与元数据¶

Room 核心会把 direct message 或 broadcast 路由给成员自己的 provider，同时记录 bounded coordination metadata。它不复制 Session transcripts。

Room 不提供以下内容：

• role catalogs
• prompts
• skills
• tool policy
• built-in team scenarios
• task planning / assignment / completion / kanban state
• Session transcripts
• hidden shared context

原生 @ 提及¶

从当前 Session lead 的 open Room 中，可以在原生 composer 输入 @，由 Room 提供 Room members source。候选只包含当前 Session 所 lead 的 open Room 中的 non-removed members。

选择成员后，消息走 leader-authorized /room send 路径。写操作会回到 /room，Host 会做 leader ownership checks。v0.6 中 Room mentions 是 leading-only。

/room 命令¶

插件支持 Host-native /room 命令，用于 leader-authorized writes。已给出的命令示例包括：

• /room create
• /room list
• /room attach
• /room send

具体参数见下文“典型用法”。

Provider 与 RoleHub¶

插件支持 optional trusted host provider registration，也支持 RoleHub bridge，用于接入 verified role Sessions。添加角色时使用独立 RoleHub bridge，而不是把角色内置到 Room。

只读快照端点¶

UI 从一个 same-origin GET endpoint 读取 field-whitelisted membership snapshot。该端点不接受 mutations，并省略 provider addresses、profile digests、event history、message bodies 和 Session transcripts。所有写操作通过 /room 进行，Host 做 leader ownership checks。

安装与启用¶

运行要求：

• Node.js ^22.19.0 || >=24
• DeepSeek Harness 0.1.0-rc.6

该包尚未发布到 npm。版本化 GitHub 安装命令会从已安装的 GitHub checkout 中读取 bundle 和 client manifest。

dsh plugin --profile web add github:ishuowang/dsh-agent-team-room#v0.6.0
dsh web

安装命令指定 web profile。启动 dsh web 后，即可在 DSH Web 中查看 Room 入口。

典型用法¶

创建和查看 Room¶

Room 不会自动生成角色，也不会注入 prompt。先创建 Room，再列出已有 Room：

/room create --name "Release room" --topic "Coordinate the v0.4 release"
/room list

挂载已有 Session¶

先使用 DSH 创建一个 continuable child Session，然后把该已有 direct child 挂到 Room：

/room attach <room-id> --session <child-session-id> --name "Reviewer"

发送消息¶

向指定成员发送消息：

/room send <room-id> <member-id> -

在输入框中选择成员¶

如果当前 Session 领导一个 open Room，可以在原生 composer 中以 @ 开始草稿，从 Room members 源里选择成员。

适用场景与注意事项¶

适合谁¶

如果你希望把多个独立 DSH Sessions 放入一个 leader-authorized 协作边界，同时保持它们各自的 transcript 和生命周期，dsh-agent-team-room 是一个直接的扩展。它适合需要原生 Web 入口、@ 成员选择、/room 写路径，且不想引入内置角色、场景、任务板的场景。

版本与升级注意¶

• v0.4 reset 移除了 built-in scenarios、embedded roles、tracked tasks 和 standalone dashboard；角色添加入口使用独立 RoleHub bridge。
• Room 不拥有 role catalogs、prompts、skills、tool policy、built-in team scenarios、task planning / assignment / completion / kanban state、Session transcripts 或 hidden shared context。
• 成员快照端点不接受 mutations，并省略 provider addresses、profile digests、event history、message bodies 和 Session transcripts。
• Room mentions 在 v0.6 中是 leading-only。
• 从 v0.3 或更早版本升级时，首次 v0.4 start 前应备份 Room storage file。schema v1 到 v2 的迁移会删除旧 task-board records，但不会删除 backing DSH Sessions。

安全与许可¶

插件会以当前 DSH 进程的权限运行。安装前建议检查源码、依赖和许可证。该插件许可证为 MIT。

链接¶

• GitHub：https://github.com/ishuowang/dsh-agent-team-room
• 社区目录：https://awesome-dsh-plugin.com/p/ishuowang/dsh-agent-team-room/

目录页是社区维护的独立站点，不应把它写成官方应用商店。