Lord1Egypt Hermes-WorkBuddy 通信桥
v1.x 注意：此为队列式通信桥（queue.json）。如需更强大的事件驱动闭环命令系统，请改用
hermes-memory-bridgev2.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：警报通知
工作流
- WorkBuddy 发消息：
send workbuddy hermes "内容" - Hermes 读取：通过 cron 或 auto_poller 轮询队列，发现 pending 消息
- Hermes 回复：写
hermes → workbuddy的 pending 消息 - WorkBuddy 读取：
receive workbuddy，处理消息 - 标记完成：
mark <msg_id> 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）
- 初始版本发布