团队房间 PerryLink/dsh-team-rooms

🏠 dsh-team-rooms

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-team-rooms（计入 deepseek1024.com 的安装排名）。

为 DeepSeek Harness 提供持久化、跨会话的多智能体团队房间 —— 成员、消息总线、共享任务板、共享时间线，重启后依然存在。

每个成员都是一个独立的 DSH 会话；房间是它们之间共享的持久对象。

dsh-doctor
DSH Market

dshfind
🪦 已退役 —— 2026-10-05 起停止兼容性更新。 团队协作现在由官方 harness 自己实现：dsh-experimental-agent-team（配合 -tool-agent-team）提供隐式根名册、持久对等邮箱和共享任务 DAG，支持 compare-and-set 更新，另有 Web 投影。⚠️ 随包发布的 dsh-base 默认关闭它 —— 需要打一个配置档补丁才能启用，同时关闭旧的 continuable-child 控制名。也有被广泛采用的社区替代方案，例如 @nanmicoder/dsh-agent-teams（周下载量约 13k），不过截至 2026-10-05，它声明的 peer 依赖止步于 0.2.1 线以下，所以宿主的兼容性守卫在 0.2.1-alpha.1 上会跳过它，除非你按版本单独加豁免。原生子系统唯一没做到、而这个包做到了的事，是协调不同进程里的独立会话；如今周下载量 589，对面是原生子系统加若干社区替代方案，这个细分场景已经不值得再维护兼容性。👉 请改用原生 Agent Teams，或采用更主流的社区替代方案。 本仓库保留公开，仅供查阅。

English · 简体中文 · Español · Português · हिन्दी

从 dsh-background-agents 0.9.6 拆分而来。 那个插件的后台智能体部分（background_agent 和五个 bg_ 工具）已被 DSH 原生的可续接子代理取代；团队房间部分没有原生对应物，于是独立成包，留在这里。0.9.6 写入的存储域、会话日志和设置照常可用 —— 见兼容性。

兼容性

宿主 0.1.2-alpha.2 及之后版本对会话事件词表采取 fail-closed 策略，所以本插件不再往那里写只用于日志的事实事件（team-room/fact）：事实改走 logger/panel 通道，teamRoom 投影退化为空折叠。更早的 rc 线（直到 0.1.1-rc.2）仍沿用可忽略标记的约定。客户端部分依赖当前的客户端包（dsh-api-session-controller、dsh-client-ui-slots、dsh-client-ui-settings、dsh-client-locale、dsh-client-web）。

与 dsh-background-agents 0.9.6 的数据兼容是硬性规则。 以下字符串与 0.9.6 逐字节一致，绝不能改名：存储域 team_rooms、teamRoom 投影键、team-room/fact 会话事件类型、team-rooms 设置槽 id。因此换插件时，已有配置档的房间、成员日志和设置页都原样保留。

| 层面 | 状态 |
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1（2026-09-25 验证；开发与运行时锁定 0.1.7-rc.2，peer 依赖 >=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0） |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 平台 | 全部（宿主工具；设置页需要 Web 客户端那一半和存储域能力） |
| 模型 | 任意（房间不携带模型路由 —— 成员就是普通会话） |

你能得到什么

dsh-team-rooms 把多个独立会话变成一个协同团队：

1. /room 命令族 —— create、join、leave、list、send、tasks、task add|assign|claim|done|delete。房间有名字、有归属，用一个稳定的 room id 寻址，你可以把它粘贴到另一个会话里。
2. 八个 room_ 工具 —— room_list_rooms、room_post、room_read、room_list_tasks、room_create_task、room_claim_task、room_transfer_task、room_complete_task。模型在自己的会话里操作共享看板和消息总线；room_transfer_task 在跨成员交接前会请求批准。
3. 持久化房间存储 —— 成员、消息总线（定向或广播）、任务看板和时间线都存放在 team_rooms 存储域（SQLite 或 JSONL 后端 —— 由部署方选择；插件自身不新增任何服务），DSH 重启后能恢复。
4. Web 设置页 —— Team Rooms 设置区展示当前会话所属每个房间的成员状态、任务板和时间线，数据从 teamRoom 会话投影读取，再通过宿主 /room 命令写回。

快速开始

1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-team-rooms#main"

or from npm (published releases)
dsh plugin --profile web add dsh-team-rooms

2. restart and verify the row
dsh --profile web --dump-config | grep -A4 'id: team-rooms'

bundle 补丁里带着插件行，不需要任何 Config 键。仓库提交了构建产物（lib/），所以从 git 安装无需构建步骤。只要存储域被组合进来，房间就能挂载（@deepseek-ai/dsh-storage-domain，每个 @deepseek-ai/dsh-base 配置档都包含它）；没有它，/room 命令和 room_ 工具保持休眠，其余部分照常加载。

然后，在任意会话里：

/room create release-prep
/room send <roomId> kickoff: I own the changelog, who takes the docs?
/room task add <roomId> draft the migration note
/room task claim <roomId> <taskId>

把打印出来的 room id 粘贴到另一个会话，执行 /room join <roomId> —— 那个会话现在就是成员了，会以普通消息的形式收到房间投递，并看到同一块看板。

安装与卸载

- git 渠道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-team-rooms#main" —— 已提交 lib/，无需 prepare 或 allowBuilds 步骤。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-team-rooms。
- tarball 渠道：在本仓库执行 pnpm pack，然后 dsh plugin --profile web add ./dsh-team-rooms-<version>.tgz。
- 卸载：dsh plugin --profile web remove dsh-team-rooms（或从配置档补丁里删掉这一行）。房间仍留在 team_rooms 存储域里，重新安装就会回来。
- ✅ 可以和 dsh-background-agents（≥ 0.9.14）一起挂载。 弃用窗口期内，两个包都带了同一份房间半边——同样的八个 room_ 工具、同样的 settings.section 槽位 id（team-rooms）、同样的 team_rooms 存储域——而 dsh-background-agents ≤ 0.9.13 还额外注册了同一个 roomHub 服务键，Cordis 在每个 isolate 作用域里只允许注册一次。从 dsh-background-agents 0.9.14 起，该包带了一个先到先得的共存守卫：它先检查 roomHub 是否已被提供，如果是，就停掉自己的房间半边，后台智能体核心照常运行。因此两个包谁先挂载都行，房间半边只归其中一个所有。如果你跑的是 dsh-background-agents ≤ 0.9.13，两个包只能挂载一个——升级那个包，或者把它移除（dsh plugin --profile web remove dsh-background-agents）。两种情况房间都不会丢：它们住在 team_rooms 存储域里，不在插件里。

配置

每个可调项都是经过校验的 Schemastery Config 字段——在 cordis.yml 里改，绝不要改代码。没有必填项。

| 键 | 默认值 | 含义 |
| maxRooms | 16 | 整个配置档内团队房间的硬上限 |
| maxMembersPerRoom | 8 | 每个房间成员的硬上限（>= 2） |
| maxRoomsPerMember | 4 | 一个成员会话可加入房间数的硬上限 |
| busRetention | 200 | 每个房间保留的总线消息数 |
| timelineRetention | 500 | 每个房间保留的时间线事件数 |
| taskRetention | 50 | 每个房间保留的已完成任务数 |
| maxMessageChars | 4000 | 单条房间消息文本的硬上限（超出直接拒绝，绝不截断） |
| injectRoomBrief | true | 向成员会话注入简短的房间简介（加入时 + 恢复时） |
| roomOpenTimeoutMs | 15000 | team_rooms 存储域打开最多等多久，超时后所有房间操作直接报错（store-unavailable），而不是一直挂着 |
| allowUnmarkedFacts | false | 在丢弃 ignorable 标记的宿主上强制发出仅记日志的 team-room/fact 事件（危险：未标记的事实会让会话在别处无法恢复）；默认是检测到就跳过 |
| inbound.enabled | false | 为外部智能体运行时（OpenAI Agents SDK / CrewAI）启用 stdio JSON-RPC 入站桥。默认关闭（fail-closed）。 |
| inbound.command | （无） | 外部运行时的启动命令；启用且存在时，插件会拉起它并监听按行分隔的 JSON-RPC 通知。缺失或拉不起来 = 桥保持休眠（记日志）。 |

工具与界面

| 界面 | 类型 | 说明 |
| /room | 命令 | create\|join\|leave\|list\|send\|tasks\|task add\|assign\|claim\|done\|delete |
| room_list_rooms | 工具 | 当前会话所属的全部房间：id、名称、成员名单、任务数 |
| room_post | 工具 | 向总线发消息（广播，或用 to 定向发送） |
| room_read | 工具 | 从 seq 游标读取某个房间的总线历史 |
| room_list_tasks | 工具 | 某个房间的共享任务板 |
| room_create_task | 工具 | 添加一行任务板记录（可指定负责人） |
| room_claim_task | 工具 | 为当前会话认领一行（负责人 + 进行中） |
| room_transfer_task | 工具 | 把一行交给其他成员 —— 需审批，失败即关闭 |
| room_complete_task | 工具 | 把一行标记为 done |
| teamRoom 投影 | 会话投影 | 从该成员自己日志里的 team-room/fact 事件折叠出的房间视图 |
| Web 设置页 | 客户端 | 成员状态、任务板、时间线、房间操作；slot id 为 team-rooms |

一共 八个 room_ 工具，存储域组装完成后全部注册。

工作原理 —— 以及为什么重启后仍然可用

房间存储是跨会话的权威来源；会话投影是每个成员自己重建的副本。两路写入同时进行，并保持一致：

- 每次房间变更（创建、加入、离开、发帖、任务状态流转）都排在同一条 hub 写链上 —— team_rooms 域只有一条写链，它就是排序权威，所以并发发帖者绝不会交错执行读-改-写，总线 seq 严格按提交顺序生成。
- 模型可见 ⟺ 已记录：投递到房间的消息就是一次正式的收件箱投递（agent.followup 唤醒在线成员；agent.inject 在下次启动时把积压消息交给离线成员），因此它会作为持久的 user/message 落在该成员自己的会话日志里。
- 共享时间线以仅写日志的 team-room/fact 事件镜像进每个成员的日志，事件携带存储中的权威 timelineSeq；teamRoom 投影折叠每个成员自己的日志，所以每次重新打开都能重建视图，无需读取存储。
- 投递至少一次且有序：每个成员的游标（lastDeliveredSeq、lastFactSeq）只在投递落地后推进，所以提交与投递之间发生崩溃时，会在追赶阶段重新投递，而不是丢消息。

如果宿主机的 Session.append 早于 ignorable 标记（所有已发布的 rc 线，直到 0.1.0-rc.8 和 0.1.1-rc.2 线，以及 0.1.2-rc 线 —— 后者保留信封字段仅用于已存日志的读取兼容），会在第一次 append 之前检测出来（先做对端版本预检，再探测返回的信封），然后跳过 fact 追加，并给出一次性警告：持久存储、API 接口和模型可见的投递照常工作，teamRoom 退化为空折叠。allowUnmarkedFacts: true 可以重新启用 —— 故意危险。

不是这个插件

| 项目 | 做什么 | 边界 |
| titanwings/dsh-automation | 在全新智能体会话中按计划执行编码任务 | 它负责任务何时运行（调度）。本插件负责多个会话共同操作的共享对象——不涉及调度器接缝，也不涉及 cron。 |
| YYTbit/dsh-plugin-agent-dashboard | 多智能体仪表盘技能 | 偏向展示，以读取为主。本插件的房间是可写的协调状态：一条总线、一块看板，以及需审批才能放行交接，全部持久化在 harness 自身的存储中。 |
| dsh-background-agents | 后台智能体，外加（此前的）团队房间 | 该包的 bg_ 部分已被 DSH 原生的可续接子代理取代；它的房间部分就是本包。从 dsh-background-agents 0.9.14 起，两者可以安全地同时挂载——当 roomHub 已提供时，该包会停用自己的房间部分。在 ≤ 0.9.13 上只能挂载其中一个房间部分。 |

权限与数据

- 权限：workshop 清单声明了 session:append 和 tools:register。房间从不启动子代理，所以插件不申请任何 subagent: 权限，也不声明子代理依赖。
- 数据：房间存放在 team_rooms 存储域中（SQLite 或 JSONL——无需额外服务）。没有独立数据库，不走网络。
- 会话日志：在支持该标记的主机上，team-room/fact 事件会带上信封的 ignorable: true 标记追加（会检测不支持该标记的旧主机，并跳过 fact 追加——见 allowUnmarkedFacts）；模型可见的房间投递是真正的 user/message 记录。

安全边界

- 需审批的交接。 room_transfer_task 走官方审批接缝，未组合审批服务或没有应答方批准时按失败关闭处理——拒绝时不会发生任何变更。
- 模型可见 ⟺ 已记录。 每条投递的房间消息都是成员自己日志中持久的 user/message；共享时间线以仅日志的 team-room/fact 事件镜像。房间消息不可能在未被记录的情况下到达模型。
- 成员身份就是授权边界。 每个 room_ 工具都按调用会话自身的成员身份授权；非成员会得到稳定的拒绝，而不是部分写入。
- 保留量有上限。 总线、时间线和已完成任务窗口在每次写入时都会强制执行，因此长期存活的房间不会无限增长。
- 不调度，不支持跨机器成员。 成员是本部署中进程内的会话。

跨生态入站（P2）

外部智能体运行时——OpenAI Agents SDK、CrewAI 等——可以通过一个极简的 基于 stdio 的换行分隔 JSON-RPC 2.0 桥向团队房间发布消息。这是 JSON-RPC 直连的最小集合，不是官方 ACP 线协议：完整的 ACP 兼容要等上游接缝。

用两个 Config 字段启用它，并把 inbound.command 指向一个启动器，该启动器在 stdout 上每行输出一条 JSON 通知：

cordis.yml (plugin row)
inbound:
enabled: true
command: "python external_runtime.py --room <room-id>"

运行时发出三类通知；method 是事件名，params.name 是外部智能体的显示名：

{"jsonrpc":"2.0","method":"agent_started","params":{"name":"researcher","room":"<room-id>","traceId":"t-1"}}
{"jsonrpc":"2.0","method":"agent_message","params":{"name":"researcher","room":"<room-id>","traceId":"t-1","message":"found the failing test"}}
{"jsonrpc":"2.0","method":"agent_finished","params":{"name":"researcher","room":"<room-id>","traceId":"t-1","status":"ok","usage":{"inputTokens":100,"outputTokens":40}}}

每条通知都对应到房间已有的界面：agent_started 打开任务板卡片，agent_message 发到消息总线，agent_finished 完成卡片并发布结果。无效消息按失败关闭处理——直接丢弃，并写回 JSON-RPC 错误。外部运行时不是 DSH 会话，所以由房间所有者的成员会话代为发送；房间没有所有者成员时，事件被丢弃。启动和停止由插件 fiber 通过 disposer 管理；inbound.command 无法启动时降级为一条日志警告（桥接保持休眠，其他部分不受影响）。

已知限制

- 房间需要组合存储域；没有 @deepseek-ai/dsh-storage-domain 时，/room 命令和 room_* 工具被禁用。
- 房间至少要有两个成员才有意义，成员名单受 maxMembersPerRoom 限制；成员身份按会话划分，不按用户划分。
- 没有跨机器成员：每个成员都是本部署中进程内的会话。
- room_transfer_task 需要审批应答器。没有应答器时按设计失败关闭，所以想要交接的自动化配置档必须组合审批服务。
- 成本/用量核算不在本文范围内（那部分在后台智能体那一半）；房间界面报告的是结构，不是花费。

开发

pnpm install # tooling only; harness packages resolve against a sibling checkout
pnpm run typecheck # strict TS, node + client programs
pnpm test # vitest: unit, room-hub, projection, and jsdom panel tests
pnpm run build # lib/index.js (node half) + lib/client.js (web client bundle)
pnpm run verify:artifacts && pnpm run check:readmes
pnpm run gen-aliases # re-map harness package paths after the checkout moves

pnpm run pack:smoke 会构建、打包，并在设置了 DSH_HARNESS_ROOT 的情况下把 tarball 安装到一个临时配置档，以断言组合后的行。

主题

dsh、dsh-plugin、deepseek-harness、team-rooms、multi-agent、message-bus、task-board、collaboration、cross-session

贡献者

- @PerryLink — 创建者与维护者：团队房间中心及其写入链、投递游标、teamRoom 投影、Web 设置页、文档、CI/CD 与发布。

PerryLink DSH 插件家族

这个项目是 PerryLink 维护的 33 个活跃维护的 DeepSeek Harness 插件之一。整个清单共 42 个，其中 6 个已冻结、3 个已退役；每一个都保留在下表中，原因写在状态列。如果这个项目对你有帮助，其他项目大概率也能帮上忙：

| 插件 | 一句话简介 | 状态 |
| dsh-auto-review | 在审批链上引入第二模型自动审查，默认失败即关闭 | |
| dsh-autotier | 自动在强模型与廉价模型之间做层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息收发和中断 | 🚫 已退役 — 见上方说明 |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排放和延迟集中在一个面板。 | 🧊 已冻结 — 见仓库 README |
| dsh-catalog | PerryLink 系列在 DSH Desktop Market 的标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，对外暴露认证注册表：评级、快照和五维证据 | |
| dsh-checkpoint-rewind | 对标 Claude Code 的 /rewind：快照、会话分叉、一键恢复 | |
| dsh-claude-move | 把 Claude Code 的会话、记忆、技能和 CLAUDE.md 迁移到 DSH | 🧊 已冻结 — 见仓库 README |
| dsh-click | DeepSeek Harness 的跨平台原生桌面控制 — 优先支持 Windows。 | |
| dsh-composer-history | Web 输入框的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | DeepSeek Harness 的提示词注入、越狱和密钥泄露防御。 | 🧊 已冻结 — 见仓库 README |
| dsh-doublecheck | 工程纪律守卫：需求盘问、测试门禁、对抗式审查 | |
| dsh-draw | DeepSeek Harness 的统一静态图像生成路由。 | 🧊 已冻结 — 见仓库 README |
| dsh-fast | DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | DSH 的 GitHub PR/issues 集成，每次写入都要审批 | |
| dsh-industry-research | 行业研究编排，交付物通过本插件的 ctx.researchReport.assemble 封存 | |
| dsh-laya | 把 Laya 的类型化决策（noul/choice/score）做成一等 Cordis 服务和模型可见工具 | |
| dsh-library | DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作和重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-mcp-panel | 只读 MCP 运行时面板：/mcp 命令 + 设置页签，显示状态、工具和错误 | |
| dsh-memento | 审批门控的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | 🧊 FROZEN — 见仓库 README |
| dsh-observe | DeepSeek Harness 的 OpenTelemetry 和 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 等价于 Claude Code outputStyles 的运行时风格切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-plugin-certification | 社区认证注册表，评级可复现校验，带徽章 | |
| dsh-plugin-doctor | 零依赖的 DSH 插件静态 + 沙箱冒烟检测器 | |
| dsh-plugin-guide | 插件开发知识库，按需作为智能体技能加载 | |
| dsh-plugin-kit | PerryLink DSH 插件共用的零运行时依赖工具包 | |
| dsh-plugin-upgrade | 一包一走廊索引的插件升级技能：把仓库路由到匹配的封闭走廊卡片 | |
| dsh-plugin-upgrade-015 | 合并 0.1.3-alpha.1 → 0.1.5-rc.1 升级走廊卡片，外加零依赖接缝扫描器 | 🚫 RETIRED — 走廊由 dsh-plugin-upgrade 承载 |
| dsh-reach | 多渠道审批与提问桥接：微信、Telegram、飞书，会话控制台 | 🧊 已冻结 — 见仓库 README |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与封存版本 | |
| dsh-score | DeepSeek Harness 插件的多维度质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏固定会话，排序持久保存 | 🚫 已退役 — 见上方说明 |
| dsh-session-sync | DeepSeek Harness 的跨设备会话同步 — 为你的会话存储专门做一份 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | DeepSeek Harness 的语音优先会话循环：开口说，听它答。 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板与时间线 | 🚫 已退役 — 见上方说明 |
| dsh-test-drive | 为 DeepSeek Harness 插件提供隔离的安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 | |
| dsh-translate | DeepSeek Harness 的服务商参数翻译与确定性 JSON 修复。 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件都能在内置的 DSH Desktop Market 里浏览：Market → Sources → add source → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中它。安装仍要经过 Market 的 npm 身份校验，并由你确认。

许可证

Apache License 2.0 © 2026 dsh-team-rooms contributors