Skip to content

LeoYeAI/agent-master-skills / skills/agent-comm-hub

agent-comm-hub

Flagged

多智能体协同通信基础设施——基于 MCP+SSE 的实时消息、任务调度、记忆共享与进化引擎。支持 WorkBuddy、Hermes、QClaw 及任意 MCP 兼容 Agent 接入。53 个 MCP 工具、4 级权限、零外部依赖 Python SDK。触发词:agent通信、智能体通信、hub通信、多智能体、跨agent通信、任务调度、assign_task、send_message、hermes通信、workbuddy通信、agent hub、通信hub、mcp通信、记忆共享、进化引擎、策略共享、经验分享、共享记忆,共同进化

FileKindSize
.clawhub/origin.jsonconfig146 B
API_REFERENCE.mdmarkdown18.4 KB
HERMES-SETUP.mdmarkdown5.5 KB
README.mdmarkdown8.8 KB
SKILL.mdskill md16.4 KB
_meta.jsonconfig133 B
client-sdk/agent-client.d.tsscript11.6 KB
client-sdk/agent-client.jsscript28.6 KB
client-sdk/agent-client.tsscript29.8 KB
client-sdk/hermes-integration.d.tsscript785 B
client-sdk/hermes-integration.jsscript6.3 KB
client-sdk/hermes-integration.tsscript6.1 KB
client-sdk/hub_client.pyscript50.8 KB
client-sdk/workbuddy-integration.d.tsscript11 B
client-sdk/workbuddy-integration.jsscript4.3 KB
client-sdk/workbuddy-integration.tsscript4.2 KB
deploy/docker-compose.ymlconfig2.0 KB
deploy/grafana/dashboard.jsonconfig16.4 KB
deploy/grafana/provisioning/dashboards/dashboards.ymlconfig258 B
deploy/grafana/provisioning/datasources/prometheus.ymlconfig186 B
deploy/prometheus.ymlconfig408 B
docs/advanced-orchestration-guide.mdmarkdown11.8 KB
docs/evolution-engine-guide.mdmarkdown16.6 KB
docs/hermes-integration-guide.mdmarkdown22.3 KB
package-lock.jsonmanifest139.0 KB
package.jsonmanifest861 B
scripts/hub_task_runner.pyscript6.0 KB
scripts/hub_watcher.pyscript13.9 KB
scripts/install.shscript549 B
scripts/migrate_evolution_db.pyscript6.5 KB
scripts/migrate_from_agent.jsscript2.5 KB
scripts/wb_task_trigger.pyscript2.2 KB
src/db.d.tsscript3.7 KB
src/db.jsscript34.0 KB
src/db.tsscript37.4 KB
src/dedup.d.tsscript2.4 KB
src/dedup.jsscript8.5 KB
src/dedup.tsscript8.7 KB
src/errors.tsscript3.4 KB
src/evolution.d.tsscript6.6 KB
src/evolution.jsscript26.4 KB
src/evolution.tsscript31.0 KB
src/identity.d.tsscript3.4 KB
src/identity.jsscript15.9 KB
src/identity.tsscript17.1 KB
src/logger.d.tsscript1.1 KB
src/logger.jsscript2.8 KB
src/logger.tsscript3.5 KB
src/memory.d.tsscript2.1 KB
src/memory.jsscript13.0 KB
src/memory.tsscript14.3 KB
src/metrics.d.tsscript1.8 KB
src/metrics.jsscript8.4 KB
src/metrics.tsscript9.1 KB
src/orchestrator.d.tsscript6.1 KB
src/orchestrator.jsscript30.4 KB
src/orchestrator.tsscript33.4 KB
src/repo/interfaces.d.tsscript3.6 KB
src/repo/interfaces.jsscript49 B
src/repo/interfaces.tsscript4.2 KB
src/repo/sqlite-impl.d.tsscript225 B
src/repo/sqlite-impl.jsscript7.7 KB
src/repo/sqlite-impl.tsscript8.8 KB
src/repo/types.d.tsscript1021 B
src/repo/types.jsscript116 B
src/repo/types.tsscript1.6 KB
src/security.d.tsscript3.7 KB
src/security.jsscript15.0 KB
src/security.tsscript16.4 KB
src/server.d.tsscript11 B
src/server.jsscript24.7 KB
src/server.tsscript24.7 KB
src/sse.d.tsscript1.6 KB
src/sse.jsscript3.3 KB
src/sse.tsscript3.6 KB
src/stdio.d.tsscript11 B
src/stdio.jsscript1.7 KB
src/stdio.tsscript1.6 KB
src/tokenizer.d.tsscript1.3 KB
src/tokenizer.jsscript3.4 KB
src/tokenizer.tsscript3.2 KB
src/tools.d.tsscript474 B
src/tools.jsscript1.1 KB
src/tools.tsscript1.3 KB
src/tools/consumed.d.tsscript361 B
src/tools/consumed.jsscript5.5 KB
src/tools/consumed.tsscript5.3 KB
src/tools/evolution.d.tsscript660 B
src/tools/evolution.jsscript19.3 KB
src/tools/evolution.tsscript17.6 KB
src/tools/file.d.tsscript348 B
src/tools/file.jsscript7.1 KB
src/tools/file.tsscript6.5 KB
src/tools/identity.d.tsscript438 B
src/tools/identity.jsscript9.8 KB
src/tools/identity.tsscript9.3 KB
src/tools/memory.d.tsscript410 B
src/tools/memory.jsscript11.9 KB
src/tools/memory.tsscript10.8 KB
src/tools/message.d.tsscript467 B
src/tools/message.jsscript17.2 KB
src/tools/message.tsscript15.8 KB
src/tools/orchestrator.d.tsscript746 B
src/tools/orchestrator.jsscript27.8 KB
src/tools/orchestrator.tsscript24.3 KB
src/tools/security.d.tsscript386 B
src/tools/security.jsscript9.0 KB
src/tools/security.tsscript7.8 KB
src/types.tsscript5.9 KB
src/utils.d.tsscript421 B
src/utils.jsscript1.3 KB
src/utils.tsscript3.0 KB
tsconfig.jsonconfig337 B
vitest.config.tsscript1.2 KB

HERMES-SETUP.md

View on GitHub
# Agent Communication Hub — Hermes 接入配置指南

## Hermes 需要做什么?

**总工作量:3 步,约 10 分钟。**

---

## 步骤 1:确保 Hub 已启动

在 WorkBuddy 所在机器上启动 Hub Server:

```bash
cd agent-comm-hub
npm install
npm run dev
# 输出: Agent Communication Hub v1.0.0 — 监听端口 3100
```

> Hub 只需要在一台机器上运行。如果 Hermes 在另一台机器上,需要确认网络互通。

---

## 步骤 2:将客户端代码复制到 Hermes 项目

```
需要复制的文件(共 1 个):
┌──────────────────────────────────────────┐
│  client-sdk/agent-client.ts              │
│  (通用客户端 SDK,WorkBuddy/Hermes 通用) │
└──────────────────────────────────────────┘

复制到 Hermes 项目的任意位置,例如:
  hermes-project/libs/agent-client.ts
```

---

## 步骤 3:在 Hermes 启动入口中加入 3 行代码

在 Hermes 的主入口文件(如 `index.ts`、`app.ts`、`main.ts`)中添加:

```typescript
// ─── 接入 Agent Communication Hub ─────────────────
import { AgentClient } from "./libs/agent-client.js";

const hermes = new AgentClient({
  agentId: "hermes",                              // 你的 Agent ID,可自定义
  hubUrl:  process.env.HUB_URL ?? "http://192.168.1.100:3100",  // Hub 地址

  // 收到任务 → 自主执行 → 回报结果
  onTaskAssigned: async (task) => {
    console.log(`收到任务: ${task.description}`);

    // ① 告知发起方"已开始"
    await hermes.updateTaskStatus(task.id, "in_progress", undefined, 5);

    // ② 调用你的核心业务逻辑
    const result = await yourHermesBusinessLogic(task.description, task.context);

    // ③ 汇报完成
    await hermes.updateTaskStatus(task.id, "completed", result, 100);
  },

  // 收到消息 → 处理
  onMessage: async (msg) => {
    console.log(`来自 ${msg.from_agent}: ${msg.content}`);
  },
});

// 启动(在 Hermes 主逻辑之前调用)
hermes.start();
// ─── 接入结束 ─────────────────────────────────────
```

---

## 步骤 4(可选):设置环境变量

在 Hermes 的 `.env` 或启动命令中设置:

```bash
# Hermes 的 Agent ID(默认 hermes)
export HERMES_ID=hermes

# Hub Server 地址
# 本机: http://localhost:3100
# 远程: http://192.168.1.100:3100
export HUB_URL=http://localhost:3100
```

---

## 步骤 5(可选):在 Hermes 的 .mcp.json 中配置 Hub 工具

如果 Hermes 也通过 MCP 协议调用 Hub 工具,在其 `.mcp.json` 中添加:

```json
{
  "mcpServers": {
    "agent-comm-hub": {
      "url": "http://localhost:3100/mcp"
    }
  }
}
```

> 这样 Hermes 的 Agent(LLM)也可以直接调用 `send_message`、`assign_task` 等工具。
> 如果只通过 `AgentClient` SDK 调用,这一步不是必须的。

---

## 验证接入是否成功

### 方法 1:观察日志

Hermes 启动后,Hub 侧应看到:
```
[SSE] ✅ hermes online. Total: 1
```

### 方法 2:健康检查

```bash
# 从 Hermes 机器上测试 Hub 连通性
curl http://192.168.1.100:3100/health
# 预期: {"status":"ok","uptime":123.456,"ts":...}
```

### 方法 3:运行端到端测试

```bash
# 在 Hub 机器上运行
npm test
# 预期: ✅ 全部测试通过
```

---

## 常见问题

### Q: Hermes 重启后会丢失消息吗?
**不会。** 所有消息和任务都持久化在 SQLite 中。Hermes 重启后重新建立 SSE 连接,Hub 会自动补发积压的未读消息和未执行任务。

### Q: Hub 挂了怎么办?
消息写入 SQLite 不会丢失。Hub 重启后,Hermes 的 SSE 客户端会自动重连(默认 3 秒间隔)。

### Q: Hermes 不需要 LLM 也能执行任务吗?
**不需要。** `onTaskAssigned` 回调是你的代码直接执行的,不走 LLM。当然你可以在回调中调用 LLM,但那由你决定。

### Q: 能同时支持更多 Agent 吗?
可以,每个 Agent 用不同的 `agentId` 即可。Hub 会自动管理所有连接。

### Q: 如何调试?
```bash
# 查看 Hub 日志
npm run dev  # 控制台直接看输出

# 查看 SQLite 中的消息记录
sqlite3 comm_hub.db "SELECT * FROM messages ORDER BY created_at DESC LIMIT 10;"
sqlite3 comm_hub.db "SELECT * FROM tasks ORDER BY created_at DESC LIMIT 10;"
```

---

## 完整文件清单

```
agent-comm-hub/
├── package.json                          # 依赖配置
├── tsconfig.json                         # TypeScript 配置
├── src/
│   ├── server.ts                         # 主入口(Express + MCP + SSE)
│   ├── db.ts                             # SQLite 持久化层
│   ├── sse.ts                            # SSE 连接管理
│   └── tools.ts                          # 6 个 MCP 工具定义
├── client-sdk/
│   ├── agent-client.ts                   # 通用客户端 SDK(Hermes 只需此文件)
│   ├── workbuddy-integration.ts          # WorkBuddy 接入示例
│   └── hermes-integration.ts             # Hermes 接入示例
├── scripts/
│   ├── install.sh                        # 一键安装脚本
│   ├── test-e2e.ts                       # 端到端测试
│   └── test-e2e.sh                       # 全栈启动脚本
└── HERMES-SETUP.md                       # 本文档
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall