liuboacean/agent-comm-hub

让 AI Agent 不再各自为战
实时消息 · 任务调度 · 共享记忆 · 信任进化 · Web 仪表盘
58 个 MCP 工具 · 零外部服务 · 5 分钟部署
中文 · English
· GitHub
---
👀 一眼看明白
**任何 MCP 兼容的 AI Agent** → 连接 Hub → 立即获得：消息总线、任务队列、共享记忆、进化引擎。
> 🚀 **5 分钟启动**：docker run -d -p 3100:3100 ghcr.io/liuboacean/agent-comm-hub
---
💡 为什么需要它？
多个 AI Agent（Claude Code、WorkBuddy、OpenClaw、Hermes 等）天然是**信息孤岛**：
| 问题 | 传统方案 | 为什么不行 |
|------|---------|-----------|
| ❌ Agent 间无法通信 | Webhook / 共享文件 | 脆弱、不可靠、手动维护 |
| ❌ 无法跨 Agent 调度任务 | 各自为战 | 没人协调，任务丢失 |
| ❌ 无法共享上下文 | 每轮对话都从零开始 | 记不住团队经验 |
| ❌ 无法团队进化 | 每个 Agent 独自踩坑 | 同样的问题反复修 |
**Agent Communication Hub（ACH）** 是它们的**共享神经中枢**——一条消息总线 + 任务调度器 + 团队记忆库 + 经验进化引擎。
---
🚀 三步上手
> 🔗 然后打开 **http://localhost:3100/dashboard** 查看实时仪表盘
---
✨ 核心能力
📊 数据快照
| 指标 | 值 |
|------|:--:|
| MCP 工具 | **58 个** |
| Python SDK 方法 | **68 个** |
| TypeScript SDK 方法 | **35 个** |
| 单元测试 | **288 个 ✅** |
| 数据库表 | **32 张** |
| client-sdk 运行时依赖 | **0（Python/TS 纯标准库）** |
| 服务端运行时依赖 | **5 个轻量依赖**（express / better-sqlite3 / zod / eventsource / @modelcontextprotocol/sdk） |
| 消息延迟 | ** 纯静态 HTML（零前端框架），内联 CSS+JS，启动即用。
---
🏗️ 架构
---
🔧 SDK 快速上手
Python — 零外部依赖
TypeScript — 零外部依赖
---
🆚 对比其他方案
| 特性 | ACH | 自建 Webhook | 共享数据库 | 消息队列(RabbitMQ) |
|------|:---:|:-----------:|:----------:|:-----------------:|
| 5 分钟部署 | ✅ | ❌ | ❌ | ❌ |
| MCP 原生支持 | ✅ | ❌ | ❌ | ❌ |
| 共享记忆 + FTS5 搜索 | ✅ | ❌ | ❌ | ❌ |
| 任务调度 + Pipeline | ✅ | ❌ | ❌ | ❌ |
| 进化引擎（经验复用） | ✅ | ❌ | ❌ | ❌ |
| 内置 Web 面板 | ✅ | ❌ | ❌ | ❌ |
| 审计哈希链 | ✅ | ❌ | ❌ | ❌ |
| 零外部服务 | ✅ | ✅ | ✅ | ❌ |
| Python + TS SDK | ✅ | ❌ | ❌ | ❌ |
---
📦 部署方式
🐳 Docker（推荐，一键启动）
📦 Docker Compose（含 Prometheus + Grafana 监控）
🔧 源码安装
🎯 作为 Skill 安装
---
⚠️ Node 版本要求（重要）
本项目依赖原生模块 **better-sqlite3，它是按 Node 22（NODE_MODULE_VERSION 127）编译的**。因此：
- 🔒 **运行 Hub（dist/src/server.js 或 dist/src/stdio.js）必须用 Node 22 启动**。若使用 Node 24（或更高），会因 ABI 不匹配立即抛出 ERR_DLOPEN_FAILED 崩溃，无法启动。
- 🧪 **CI 中的 Node 24 仅用于跑单元测试**（且涉及 stdio 启动的冒烟用例已条件化 skip）。运行环境必须 **Node 22**（ =22 ⚠️ **必须用 Node 22 二进制启动**（例如绝对路径 /path/to/node22/bin/node），**不要**用 Node 24。本项目原生模块 better-sqlite3 是按 Node 22（NODE_MODULE_VERSION 127）编译的，使用 Node 24 启动 dist/src/stdio.js 或 dist/src/server.js 会立即 ERR_DLOPEN_FAILED ABI 崩溃。
HTTP + SSE
---
🛡️ 安全体系
| 层级 | 措施 |
|:----|------|
| **认证** | Token + SHA-256 哈希存储，原始 Token 不落盘 |
| **授权** | 4 级 RBAC：public → member → group_admin → admin |
| **审计** | 区块链式哈希链 prev_hash → record_hash，DB 触发器保障 |
| **信任** | 自动评分，0-100 分影响策略审批等级 |
| **网络** | CORS 白名单制 / X-Frame-Options / CSP / HSTS |
---
📁 项目结构
---
📚 文档导航
| 文档 | 适合谁 |
|------|--------|
| API 参考 | 开发者（HTTP/SSE/MCP 端点 + Bearer 鉴权） |
| 编排指南 | 搭 Pipeline 高级玩家 |
| 进化引擎指南 | 实验性，欢迎 PR（计划从 A 层 evolution-guide.md 同步） |
| Hermes 集成指南 | 实验性，欢迎 PR（计划从 A 层 hermes-integration-guide.md 同步） |
| DB 三层防护 | 运维/稳定性保障 |
| Agent 协调时序图 | 想看清「任务从 A 到 B 全自动流转、哪里卡 HITL」的人 |
| English README | English speakers |
> 📌 **文档同步说明（B 层为权威源）**：服务端仓库（agent-comm-hub-src）是文档的单一权威来源。当前 package.json 的 docs:sync 脚本依赖 scripts/sync-docs.ts，**该文件尚未提供**，因此 A 层 Skill 分发包（~/.workbuddy/skills/agent-comm-hub/）需**手动同步**：将本仓库的 docs/、SKILL.md、README.md 复制到 A 层对应位置。后续若补充 scripts/sync-docs.ts，可用 npm run docs:sync 自动同步。
---
🆕 更新历史
v3.0.24 (2026-08-14) — 宿主执行器闭环收口（HostExecutor 注入）
- ⚡ **真实宿主执行器（HostExecutor）** — 新增 client-sdk/adapters/host-executor.ts，提供 LlmHostExecutor / HttpHostExecutor 参考实现，defaultHostExecutor() 按环境变量自动选择；AbstractHostTaskBridge 新增可注入 executor 字段
- 🔧 **消灭 setTimeout 占位** — WorkBuddy / Hermes 桥 runTask() 委托 this.executor.execute()，任务到达即触发宿主真实能力，自主执行闭环真正打通