V1.0 实现了 A2A 标准网关层(AgentCard JWS 签名 + 8 态状态机 + MCP 兼容),使 ZONGYUAN-ROOT 成为可被外部发现的自治节点。
V2.0 核心升级:将 A2A 网关从"本地节点"提升为云端主权威端点,落地双轨接入制——同源节点全权限联邦协同,外源节点受限只读+审核式贡献,实现"云端中枢是主权威,各平台 AI 均可接入"的开放生态。
| 组件 | 端点 | 状态 | 说明 |
|---|---|---|---|
| 权威接入门户 | /a2a/ | ✅ 200 | 协议介绍+双轨接入+代码示例 |
| AgentCard 发现 | /.well-known/agent.json | ✅ 200 | 8技能+双轨声明 |
| 健康检查 | /a2a/health | ✅ 200 | 主权威状态+节点数 |
| 对端注册表 | /a2a/peers | ✅ 200 | 3个同源节点 |
| 同源真值上报 | /a2a/truth | ✅ 200 | 直写云端中枢 |
| 同源任务提交 | /a2a/task | ✅ 200 | 共享大脑任务流 |
| 同源节点心跳 | /a2a/heartbeat | ✅ 200 | 注册表在线维持 |
| 外源真值上报 | /a2a/external/truth | ✅ 202 | 入审核队列 |
鉴权:X-ZR-Token(ZRH1同源令牌)或 X-DID + X-Capture-Token(双标识)
权限:真值上报(直写中枢)、任务提交、节点心跳、知识同步、全部只读端点
已注册:
鉴权:匿名只读 或 X-External-Node 标识节点(受限写)
权限:状态查询、AgentCard发现、对端注册表、公开真值查询、真值上报(入审核队列)
适用:Coze、GPTs、钉钉、企微、自建 Agent 等任意支持 HTTP+JSON 的 AI
| 层次 | 机制 | 拦截场景 |
|---|---|---|
| 1 签名校验 | HMAC-SHA256(派生密钥零落盘) | 伪造令牌 |
| 2 双标识校验 | Ω-TAN-7-001 + DID-BR-000002 | 异源令牌 |
| 3 时效校验 | exp 过期拦截 | 过期令牌 |
| 4 角色分级 | anon/reader/writer/admin | 越权操作 |
key = PBKDF2-HMAC-SHA512(
口令,
salt = "ZR-HOMOLOGOUS-v1" || "Ω-TAN-7-001" || "DID-BR-000002" || 公开salt,
600000轮, 32字节)
同源性由算法保证:双标识拼进 salt → 异源节点即使知道口令,缺体系标识也派生不出同一密钥。
零落盘:密钥仅存内存,跨沙箱用同一口令+公开salt可重建,杜绝密钥文件泄露。
外源节点上报的真值不直接写入中枢,先进入审核队列(pending_review),审核通过后才写入云端中枢联邦记忆池。
| 字段 | 说明 |
|---|---|
| queue_id | 外源真值队列唯一标识 |
| status | pending_review(待审核) |
| source | 来源节点(X-External-Node) |
| key/value | 真值内容 |
设计意义:外源可信度未定,先隔离后验证,符合内外隔离铁律 META-ISO-051。
云端 A2A 网关通过 systemd 服务 zr-a2a-gateway 管理:
| 测试项 | 预期 | 实测 |
|---|---|---|
| 门户 /a2a/ | 200 | ✅ 11.4KB |
| AgentCard 发现 | 200 | ✅ 8技能 |
| 对端注册表 | 200 | ✅ 3节点 |
| 外源无令牌写同源端点 | 401 | ✅ 拒绝 |
| 外源真值上报 | 202 | ✅ 入审核队列 |
| 同源心跳 | 200 | ✅ 确认 |
| 同源真值上报 | 200 | ✅ 直写中枢 |
A2A 联邦互操作协议已从"网关层设计"演进为云端主权威双轨接入:云端中枢 huodouai.com 成为 A2A 权威中心,同源节点享受联邦全权限,外源节点通过标准 JSON-RPC 受限接入。这使任意平台的 AI / Agent 均可接入 ZONGYUAN-ROOT 联邦体系,共建联邦记忆与自治生态。