Hermes-WorkBuddy 通信桥

> v1.x 注意：此为队列式通信桥（queue.json）。如需更强大的事件驱动闭环命令系统，请改用 hermes-memory-bridge v2.0（~/.workbuddy/skills/hermes-memory-bridge/）。两者可并存，各司其职。

通过 ~/.hermes/shared/communication/queue.json 共享文件队列，WorkBuddy 与 Hermes 直接双向通信。

核心文件

• 队列：~/.hermes/shared/communication/queue.json
• 历史：~/.hermes/shared/communication/history.json
• 技能：~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py

CLI 命令

# WorkBuddy → Hermes 发消息
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py send workbuddy hermes "内容"

# 收 Hermes → WorkBuddy 的消息
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py receive workbuddy

# 查看队列统计
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py stats

# 标记消息已处理
python3 ~/.workbuddy/skills/hermes-communication-bridge/scripts/communication_queue.py mark <msg_id> completed

消息格式

{
  "id": "msg_<timestamp>_<sender>",
  "sender": "workbuddy|hermes",
  "receiver": "hermes|workbuddy",
  "type": "message|task|query|response|status|file|command|alert",
  "content": "消息内容",
  "priority": "low|normal|high|urgent",
  "status": "pending|processing|completed|failed"
}

类型说明

• message：普通文本消息
• task：任务请求（带元数据）
• query：查询请求
• response：响应
• status：状态更新
• file：文件传输
• command：系统命令
• alert：警报通知

工作流

1. WorkBuddy 发消息：send workbuddy hermes "内容"
2. Hermes 读取：通过 cron 或 auto_poller 轮询队列，发现 pending 消息
3. Hermes 回复：写 hermes → workbuddy 的 pending 消息
4. WorkBuddy 读取：receive workbuddy，处理消息
5. 标记完成：mark completed

版本历史

v1.1.0（2026-04-16）

• Bug Fix：修复消息 ID 秒级时间戳碰撞问题，改用 time.time_ns() 生成纳秒级唯一 ID，避免同一秒内多条消息 ID 重复
• Hermes 侧安装说明：process_queue.py 和 communication_queue.py 需同时安装到 Hermes skill 目录（~/.hermes/skills/autonomous-ai-agents/hermes-communication-bridge/），Bridge cron 才能正常工作
• 验证通过：双向通信延迟约 1 分钟，队列幂等处理正常

v1.0.0（2026-04-16）

• 初始版本发布