前言¶

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/

目錄頁是社區維護的獨立站點，不應把它寫成官方應用商店。