智能体社区 Leo-sail/dsh-plugin-agent-collaboration

Agent Community —— DeepSeek Harness 的持久化 Bot

在 DSH 里常驻的 Bot、群聊房间，以及一份不会丢的运行记录。

English · 设计说明 · MIT

本插件由社区维护，不是 DeepSeek 官方产品。

这里的 Bot 不是一次性的子代理：它有身份、有自己的模型与权限预设、有自己的工作区，以及一个重启后仍在的会话。
把几个 Bot 放进同一个房间，它们会一起回应。每一次回答都有运行记录，所以即使产出它的会话已经不在，对话仍可回看。

功能

- Bot 是常驻的。 名字、模型、权限预设、工作区都落在磁盘上，面板里一直列着，重启前后都能在所属房间里回答。
- 单聊与群聊。 房间就是成员列表。点名某个 Bot 的消息只路由给它；不点名的消息由每个成员各自回答——因为一句问候是说给整个房间的。
- 运行可排队、可租约、可恢复。 每次回答是一个带租约与心跳的 run。运行时进程死掉的 run 会被回收而不是把房间卡住，房间在你去做别的事时照常工作。
- 转录是持久的。 面板画的是运行过程中写下的 ledger（消息、工具调用与结果、审批、错误），不是会话日志。被压缩掉的旧历史会换成一条摘要，而不是悄悄消失。
- 13 个模型可调用工具，Bot 因此可以建房间、把活交给另一个 Bot、把需求拆成任务并回报： agent_community_create_bot、agent_community_update_bot、agent_community_list_bots、 agent_community_create_room、agent_community_send_message、agent_community_list_runs、 agent_community_get_context、agent_community_post_message、agent_community_task_decompose、 agent_community_task_assign、agent_community_task_status、agent_community_task_report、 agent_community_submit_final。
- 附件。 消息可以带文件与图片，存放在接收方 Bot 自己的工作区里，并附到模型看到的内容上；气泡里显示的仍然是你原样输入的东西。
- 可手动触发的压缩。 /compact 用该房间自己的 Bot 模型把较早的对话总结成摘要，原样保留最近几条，并退掉承载旧历史的会话——所以下一次回答是从摘要继续，而不是把整份记录重放一遍。
- 压缩之后未读依然准确。 已读水位记的是"读到什么时间"，而不是只记一个消息 id，因此被压缩过的房间仍然能告诉你哪些是新的。

环境要求

| DeepSeek Harness | 0.2.0-rc.2（这些包就是对着它构建与类型检查的版本） |
| Node.js | ^22.19.0 或 >=24 |
| pnpm | 11.7.0（从源码构建时需要） |

@deepseek-ai/ 这些包没有发布到公共 npm registry。因此本仓库的 peer 版本范围都带显式的预发布分支 （>=0.2.0-rc.1 <0.3.0）：像 或 >=0.0.1-rc.1 <0.2.0 这种看起来"很宽"的范围，实际上匹配不到任何预发布版本 ——node-semver 只有在范围中某个比较符与目标版本 major.minor.patch 元组相同、且自身也带预发布标签时，才放行预发布版本。
这也正是本仓库单独 pnpm install 会失败的原因（属于预期），也是这个插件要装进已有这些依赖的 DSH profile 的原因。

安装

安装已发布的 tarball —— 不需要 npm 账号，也不需要本机构建：

dsh plugin --profile <你的profile> add \
https://github.com/Leo-sail/dsh-plugin-agent-collaboration/releases/download/v0.1.0/dsh-plugin-agent-collaboration-0.1.0.tgz

这个压缩包里已经带了三个预构建的包，本机不会编译任何东西，也不会去 registry 拉取。装完重启 DSH 并刷新页面，侧栏会出现 Bots团队。

改用本地源码目录安装

dsh plugin --profile <你的profile> add "file:/path/to/this/repo/packages/bundle/agent-collaboration"

file: 前缀不要去掉。 pnpm 会把裸绝对路径记成 link: 符号链接，于是 bundle 自己的 file: 依赖一个都不会被安装： profile 里只有 bundle、没有 @dsh-plugin/ 那几行，结果每一行都 import 失败。DSH 自带的插件管理器同样如此，它会把绝对路径原样透传。

确认安装结果——三行都必须是真实目录而不是符号链接：

ls -ld ~/.dsh/profiles/<你的profile>/node_modules/@dsh-plugin/

让 Agent 帮你装

把 https://github.com/Leo-sail/dsh-plugin-agent-collaboration/releases/download/v0.1.0/dsh-plugin-agent-collaboration-0.1.0.tgz 这个 DSH 插件装进我的 DSH profile，重启 DSH，并确认侧栏出现「Bots团队」。

使用

| 想做什么 | 怎么做 |
| 新建 Bot | 打开 Bots团队 → ＋ → 填名字、模型、权限、工作区。立刻创建并出现在列表里。 |
| 和单个 Bot 对话 | 在 Bots 标签里选中它（单聊房间），然后发消息。 |
| 建群聊 | 群聊 标签里的 ＋，勾选成员。 |
| 只叫群里某一个人 | 输入 @ 从菜单里选；或直接在文字里写它的名字。只有它会被排队。 |
| 说给整个房间 | 发一条不点名的消息，所有成员都会回答。 |
| 加文件或图片 | ＋ → 文件，或直接粘贴/拖到输入框。 |
| 给某个房间换模型 | ＋ → 模型。影响下一次运行，不影响正在跑的那一次。 |
| 改 Bot 的权限预设 | ＋ → 权限：仅可查看 / 工作区内修改 / 完全权限。 |
| 压缩很长的房间 | ＋ → 压缩。会出现一条摘要行，并保留最近几条。 |
| 停止运行 | 标题栏的 停止 会取消该房间正在跑的 run。 |
| 看更早的内容 | 往上滚，转录区会分页加载更早的记录。 |
| 清空房间 | 房间标题栏的 清空消息。 |

过程是可见的：排队的 run 显示 排队，运行中的显示 进行中 并带实时耗时，失败的显示为红色行并写明 provider 的错误，而不是悄悄把更早的一条回答当成新回答发出来。

配置

所有配置项都是可选的，写在 profile 的 cordis.patch.yml 里 bundle 那一行的 config 下。

| 键 | 默认值 | 作用 |
| maxBots | 32 | 允许存在的 Bot 数 |
| maxRooms | 64 | 允许存在的房间数 |
| maxMessages | 10000 | 保留的消息数，超出后淘汰最旧的 |
| maxRuns | 1000 | 保留的运行记录数 |
| maxConcurrentRuns | 8 | 全局同时在回答的 Bot 数（不是每房间） |
| runTimeoutMs | 600000 | 超过此时长的 run 判定为失败 |
| runLeaseMs | 60000 | 没有心跳时，run 租约的有效时长 |
| historyMessagesInPrompt | 10 | 每次回答附带的历史消息条数 |
| a2aMinIntervalMs | 3000 | Bot 之间消息的最小间隔 |
| groupProposalTimeoutMs | 120000 | 建群提议等待回答的时长 |
| idleLimit | 12 | 最多保留多少个活跃 Bot 会话，超出后淘汰最久未用的——淘汰正是释放其会话写租约的时机 |
| hardLimit | 24 | 活跃 Bot 会话的硬上限 |
| botReasoningEffort | max | Bot 回合的推理强度：off low high max，或 '' 交给 provider 默认值。单个 Bot 可覆盖 |
| botAgentPreset | standard | 传给每个 Bot 会话的 agent preset |
| botDeniedTools | plugin_manager、ask_user_question、skill | Bot 永远看不到的工具 |
| homeDir | $DSH_HOME，否则 ~/.dsh | 看板存放位置 |
| sessionsDir | <homeDir>/sessions | Bot 会话日志的写入位置 |

maxConcurrentRuns 是全局的，不是每房间的。设成 2 时，四个 Bot 的群只有两个能回答，其余两个卡在 排队 后面——这正好和"建群就是为了让成员同时干活"相反。需要更多并发就调大它。

数据放在哪

$DSH_HOME/agent-community/state.json 看板：Bot、房间、消息、运行、已读水位 $DSH_HOME/agent-community/workspaces/<bot> 每个 Bot 的工作区，附件也在里面

$DSH_HOME 默认是 ~/.dsh。删掉这个目录就等于把插件恢复成全新安装；数据不存放在别处。

与 DSH 内置 Agent Teams 的关系

本仓库只发布 Community 这一半。DSH 内置的 Agent Teams bundle 负责队友、共享任务板与点对点消息，所以本 bundle 只挂载内置版没有对应物的部分。两者可以并存，不需要关掉任何一个。

仓库里曾经有一个未挂载、也无法构建的 @dsh-plugin/agent-team 分支（连同它的 tool-、ui- 包），已于 2026-10-14 删除。

截图

群里一条消息，三个 Bot 各自回答、各自署名：

三个 Bot 同时回答的群聊

Bot 列表与房间列表，侧栏入口带未读数：

Bot 列表与房间列表

输入框的菜单——文件 / 压缩 / 权限 / 模型，下面是技能分组：

输入框菜单

这些截图声明在仓库根目录的 screenshots.json 里，市场读取它来渲染插件页；拍摄方式见 assets/screenshots/README.md。

开发

pnpm install # 按设计会失败：@deepseek-ai/* 不在公共 registry 上
pnpm typecheck # 依赖可解析时，对所有包做真实 DSH 类型的类型检查
pnpm bundle # 构建全部包并跑构建形状检查

pnpm bundle 会运行 scripts/check-build.mjs——里面每一条断言都对应本仓库真实出过的一个 bug （裸 ESM 的客户端 bundle、files 漏掉自己的类型声明、过期的 lib/、指向不存在文件的 exports、重复的 CSS 选择器）。
装上一个坏掉的产物比拒绝安装更糟，所以 scripts/install-profile.sh 在拷贝任何东西之前会跑同一套检查。

要对着真实运行时开发，用 scripts/install-profile.sh <profile> 装进一个 profile，然后重启 DSH。

架构

packages/
core/agent-community 服务：Bot、房间、运行、会话、ledger AgentCommunityService（ctx.agentCommunity），持久化 state.json tools/tool-agent-community 13 个模型可调用工具（ctx.tools.register） ui/ui-agent-community 浏览器面板：侧栏入口、转录区、输入框 bundle/agent-collaboration 可安装入口（cordis.patch.yml）

bundle 会挂载上面三个包；每个包也可以单独安装——core/agent-community 自带 cordis.patch.yml 与 dsh.bundle，这正是无界面部署需要的形态。

界面相关决策见 DESIGN.md（DSH token 体系、DSH 客户端原语、用 StateDot 表示状态）。

许可证

MIT