dsh-agent-hub

智能体协作台 · dsh-agent-hub

群聊式多智能体协作控制台 —— 一个群,就是一支可以自主决策、分工执行、验证返工、迭代优化的 AI 团队。

dsh-agent-hub 是 DeepSeek Harness (DSH) 的内嵌插件:把多 Agent 协作组织成一个群聊房间——需求进群,交付出群;中间的过程(拆解、派单、执行、验收、沉淀)全部发生在群消息流上,全程可见、可追溯、可随时介入。

安装即用:内置后端随插件分发(自动探测、自动装依赖、无窗口静默运行),零外部服务依赖、零 npm 运行时依赖。

---

特性

🧠 群聊即自主决策

• 统筹大脑:把任意成员「设为大脑」,大脑按 决策 → 分派 → 收齐 → 验收 → 沉淀 → 下一轮 的状态机自主推进;
• 四问决策:每轮显式回答"目标?现状?可用成员?完成定义(DoD)?",输出结构化 JSON(plan / dispatch / status / memory),杜绝空泛;
• 自动批准持续任务:授权后大脑无需逐轮人工确认,自主策动任务按轮次进行,直到交付或触及熔断;
• 全局协作章程(System Charter):角色边界、原子任务、SMART、验收规范,随包分发、可热编辑,每轮注入给大脑与所有成员。

📤 多 Agent 任务分发与执行

• @成员 定向派单,输入时自动弹出成员列表一键选择;
• 原子任务拆分:一个成员 = 一个原子任务 = 一个交付物 + 一条验收标准;依赖排序、无依赖并行;
• OpenAI 兼容 API 成员:填 base_url / api_key / model 即可接入任意 OpenAI 兼容模型(DeepSeek / 通义 / Kimi / GPT 等),可混合多个不同模型成员;
• 成果实时回流群消息,阻塞按"卡点 + 已尝试方案 + 需要的帮助"结构化上报。

✅ 验证与返工闭环

• 逐条核对验收标准,以可复现为最终判据;
• 不合格 → 一次性精确到点的返工清单,不模糊批评;
• 通过 → 写入群记忆,宣布完成;回归问题按新任务重派。

🔁 自主优化与长任务

• 群记忆跨轮次、跨任务持久复用——群是有记忆、会成长的团队;
• 多轮自主迭代:需求 → 方案 → 拆分 → 并行开发 → 集成 → 验收 → 返工 → 复验 → 沉淀 → 下一阶段;
• 三重熔断兜底:最大轮次、单轮超时、人类随时「叫停」/「否决」。

---

工作原理

┌────────────────────────────── 智能体协作台 ──────────────────────────────┐
│  群聊房间(消息即协作总线)                                                  │
│   ├─ 人类 Owner:需求来源 / 验收裁判 / 随时介入                             │
│   ├─ 统筹大脑:拆解、分工、监督、验收、沉淀(每轮 JSON 决策)                  │
│   └─ 执行成员:OpenAI 兼容 API 成员(@派单、成果回流)                        │
│                                                                           │
│  内置后端(随插件分发):房间 / 成员 / 消息 / 审批 / 任务 / 群记忆            │
│  - 自动探测端口,已有后端自动复用;缺失则 pythonw 无窗口自动拉起              │
│  - 首次自动建 venv + 装依赖;随 DSH 启停、自愈重启                          │
└───────────────────────────────────────────────────────────────────────────┘

• 群 = 工作流容器:每一次协作流程(从目标到可验收交付)都被组织成一次"群内运行";
• 消息 = 状态机输入:每一条指令、每一条成员回复,都是大脑下一轮决策的依据;
• 章程 = 协作宪法:约束所有智能体的角色边界与质量标准。

---

安装

需要 DeepSeek Harness 且带 Web profile。推荐 Python 3.10+(内置后端需要;未安装时会显示引导页)。

一条命令(推荐,自动挂载)

dsh plugin --profile <你的profile名> add dsh-agent-hub

包声明了 dsh.bundle manifest,安装后自动加入 profile 插件层,无需手动改配置。

手动安装

1. 把包放入 %USERPROFILE%\.dsh\profiles\node_modules\dsh-agent-hub\;
2. 编辑 %USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml:

- insert:
    - id: dsh-agent-hub
      name: 'dsh-agent-hub'

3. 重启 DSH。

重启后

左侧边栏底部出现「智能体协作台」按钮,点击进入控制台;全新用户打开是欢迎页(附使用指引),无任何预置数据。

---

快速开始

1. 建群:控制台内创建第一个群(或直接用欢迎页的"创建群");
2. 邀请成员:右侧成员栏「邀请成员」→ 填 base_url / api_key / model → 添加成员(OpenAI 兼容 API);
3. 设大脑:把某成员点「设为大脑」;
4. 发任务:
   • @成员名 + 发送 → 定向派单;
   • 「发给大脑」→ 把整个需求交给大脑,自主拆解、分工、监督、验收;
   • 勾选「自动批准持续任务」→ 大脑每轮无需人工确认,持续推进;
5. 验收与沉淀:大脑逐轮核对交付,不合格打回返工,通过后写入群记忆;随时可「叫停」或逐轮「确认/否决」。

---

使用场景

---

配置

说明:本机已有 TRD/后端在 TRD_BASE 运行时,插件自动复用,不会重复启动;缺失时才会用 pythonw 无窗口拉起内置后端。

---

常见问题

---

开发与发布

# 本地开发:插件源码在 lib/(host=index.js / client=client.js)+ backend/(内置 Python 后端)
# 改版本并发布
npm version patch        # 0.1.x → 0.1.x+1
npm publish              # 发布到 npm(需登录 + bypass-2FA 颗粒令牌)
git push                 # 同步 GitHub 仓库
gh release create v0.1.x # 打 Release(可挂 tarball)

• 仓库:https://github.com/jax629321/dsh-agent-hub
• npm:https://www.npmjs.com/package/dsh-agent-hub
• 功能特色介绍(中文):FEATURES.zh.md

---

许可证

MIT

⚠️ 插件运行第三方 Agent 代码,请在使用前审阅源码;本项目按 MIT 提供,不含任何担保。