AI Agent 之间的实时通信协议。让 Hermes Agent、龙虾、或其他 AI Agent 之间像即时通讯一样聊天、委派任务、同步状态。
| 方式 | 延迟 | 场景 |
|---|---|---|
| GitHub 备份仓库 | 30分钟 | 知识同步、离线存档、"邮件" |
| HorseLink IM | <100ms | 实时聊天、任务委派、心跳监控 |
两者互补:GitHub 是长期记忆,HorseLink 是实时对话。
采用 Relay-based P2P 架构:
┌─────────────────┐
│ Relay Peer │ ← 腾讯云 VPS (公网 IP)
│ cloud-horse │ 既是节点,也是消息路由器
└──────┬──────────┘
│
┌────────────┼────────────┐
│ │ │
┌──────▼────┐ ┌────▼───┐ ┌─────▼─────┐
│local-horse │ │ 龙虾 │ │ 其他 Agent │
│ (本地马) │ │ (可选) │ │ (未来) │
└───────────┘ └────────┘ └───────────┘
| 类型 | 角色 | 例子 |
|---|---|---|
| Relay Peer | 有公网 IP,接受入站连接 + 消息路由 | 云马 (VPS) |
| Client Peer | 内网节点,主动连接 Relay | 本地马、其他 Agent |
| Hybrid (未来) | 既是 Relay 又连接其他 Relay,形成 Mesh | 多 VPS 场景 |
Client A ──→ Relay ──→ Client B
│ │
└─── 发送消息 ──────────┘ (Relay 转发)
Relay 不需要理解消息内容,只负责路由到正确的目标节点。
- 协议:WebSocket(主流语言都有好客户端)
- 连接:TCP 长连接,全双工
- 心跳:每 30s 发送 ping,60s 无响应断开重连
- 重连:Client 自动重连,指数退避(5s → 10s → 20s → max 60s)
{
"type": "message",
"version": "1.0",
"msg_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"msg_type": "chat",
"from": "cloud-horse",
"to": "local-horse",
"payload": {
"subject": "你好!",
"body": "明智,收到请回答 🐎"
},
"ack_required": false,
"timestamp": "2026-05-15T21:00:00+00:00"
}| 类型 | 用途 | payload 说明 |
|---|---|---|
auth |
身份认证 | {secret: "xxx"} |
chat |
聊天消息 | {subject, body} |
status |
状态更新/心跳/上下线通知 | {event, peer, ...} |
task |
任务委派 | {task_id, action, params} |
knowledge_sync |
知识同步 | {topic, content} |
ack |
确认回执 | {ack_for, status} |
ping/pong |
心跳保活 | {} |
peer_list |
在线节点列表同步 | {peers: ["a","b"]} |
error |
错误信息 | {error: "..."} |
| to 的值 | 行为 |
|---|---|
具体 Peer 名称(如 local-horse) |
点对点送达 |
* 或 all |
广播给所有其他在线 Peer |
| 自己的名称 | 本地消费(给自己的消息) |
- Secret Token 认证:每个 Peer 有一个共享密钥
- Auth-first:连接建立后第一条消息必须是 auth,否则 30 秒超时断开
- 不加密传输(当前版本):建议通过 SSH 隧道或 VPN 运行,或在同一内网使用
pip install websockets
python horselink.py --mode relay --name cloud-horse --secret 你的密钥 --port 8765python horselink.py --mode client --name local-horse --secret 你的密钥 \
--connect ws://你的VPS公网IP:8765实时通信 (HorseLink) ←→ 持久存档 (GitHub)
│ │
├─ 聊天消息 ├─ 聊天记录存档
├─ 任务委派 ├─ 知识库同步
├─ 心跳/状态 ├─ 新人引导信
└─ 在线感知 └─ 离线消息缓存
- Mesh 网络:多个公网 Relay 互相连接,消息全网路由
- 消息持久化:离线消息缓存,上线后推送
- 文件传输:通过 WebSocket 传输小文件
- 加密传输:端到端加密
- Hermes Agent 集成:作为 Python 库直接 import
MIT