PROTOCOL SPECIFICATION · V2.0.0

通用Agent协议栈 V2.0

一套面向多智能体协作的统一通信协议栈：内部统一标准，兼容开放生态。

沉淀元极恒一同源协议、记忆网关、Merkle-DAG账本、联邦记忆池与A2A接入等既有协议资产，归一为七层标准化架构，并内置A2A / MCP兼容适配层。

规范号 GAP-SPEC-002 版本 2.0.0 状态 草案迭代 · 待发布 DID-BR-000002
七层架构一览
01 · OVERVIEW

协议定位与设计原则

通用Agent协议栈V2.0（GAP-STACK V2.0）将体系内分散的协议能力提炼归一为一套可复用、可对接的标准化协议栈，覆盖多智能体的注册、协作、数据、联邦与治理全链路。

定位

内部统一 · 生态兼容

作为元极恒一体系内部多节点/多智能体的统一通信标准，同时通过适配层对接A2A、MCP等开放协议，可向外部Agent生态开放接入。

继承

三层解耦

继承同源协议核心：逻辑态（生成工单）→ 算子态（校验路由）→ 执行态（跑代码），责任分离、可独立演进出各层。

原则

轻量优先

以轻量化为最高工程约束，协议核心保持最小可运行，重能力提炼为轻量自建，拒绝重部署。

原则

真值锚定

每一条消息与资产携带来源、置信度、版本与Merkle哈希，可溯源、可对账、可防篡改。

原则

确权治理

全链路DID确权，eFuse熔断只读保护主账本，ZKP零知识校验敏感数据，数据脱敏隔离内外。

原则

稳态演进

以最优稳态方案自主决策演进，协议版本化，向后兼容增量升级。

版本信息

项值
规范编号GAP-SPEC-002
当前版本2.0.0
前序版本1.0（同源协议单点版）
状态草案迭代中 · 未定正式发布
确权DID-BR-000002 · Ω₀⊂⊙∞⊂Ω

兼容目标

协议栈默认以自有GAP消息为内网主线，对外通过适配层接入开放生态：

A2A（Agent2Agent）v1.0 MCP（Model Context Protocol） 自有 GAP-Message v2.0

适配层负责消息/能力的双向翻译，使内部节点可被外部Agent调用，也能调用外部生态能力。

02 · ARCHITECTURE

七层协议栈架构

协议栈自下而上划分为七层，各层职责单一、接口稳定；上层调用下层能力，层间通过GAP-Message解耦通信。治理层与语义层横切全局。

层名称英文核心职责承载体系资产
L7治理安全层GovernanceDID确权、eFuse熔断、ZKP零知识校验、数据脱敏、权限路由eFuse锁、ZKP、DataGate脱敏
L6语义溯源层Semantic四层结构化拆解（元数据/内容/关系/真值）、九大元类归类、跨文档实体归一四层拆分、九大元类
L5联邦互操作层FederationA2A联邦节点接入、SFMP联邦记忆池、跨节点记忆同步A2A联邦接入、SFMP
L4数据真值层Truth真值条目（来源/置信度/版本）、Merkle哈希锚定、真值对账与漂移监测真值引擎、Merkle-DAG账本
L3能力层CapabilityAgent Card注册/发现、能力清单声明、能力路由Agent Card
L2工单层JobJSON工单定义、三层解耦路由（逻辑/算子/执行态）、优先级与超时回收同源协议三层解耦
L1传输层TransportHTTP/SSE双通道、JSON编码、DID鉴权头、心跳与保活同源网关
横切 · L7

确权与熔断

每条消息强制携带DID与签名；检测严重矛盾或篡改风险时，eFuse对问题分支局部分支熔断隔离，保护主Merkle主干。

横切 · L6

溯源结构化

所有进入协议栈的资产统一四层结构化并归类九大元类，保证可检索、可对账、可回溯。

主线 · L1-L5

协作链路

传输承载工单，工单路由到能力，能力产出真值，真值经联邦层跨节点共享，全程被治理层守护。

03 · MESSAGE

GAP-Message v2.0 消息规范

协议栈所有层间通信统一采用 GAP-Message v2.0。一条消息即一个标准JSON对象，携带协议标识、发送方DID、工单号、操作类型、时间戳、签名等固定字段，payload按层承载业务内容。

通用消息结构

// GAP-Message v2.0 通用信封
{
  "proto": "GAP/2.0",            // 协议标识+主版本
  "version": "2.0.0",
  "did": "DID-BR-000002",       // 发送方去中心化身份
  "job_id": "GAP-{uuid}",  // 全局唯一工单号
  "msg_type": "request",        // request | response | event | heartbeat
  "op": "task",                 // 操作类型（见下表）
  "layer": "L2",                 // 目标层 L1-L7
  "ts": "2026-10-29T11:20:00+08:00",
  "payload": { },                 // 各层业务内容
  "sign": "sha256:..."           // 信封级签名
}

操作类型（op）枚举

op含义典型场景
registerAgent / 节点注册新节点接入，声明DID与能力清单
deregister注销节点下线
heartbeat心跳保活周期性健康探测，返回回执
ping连通性探测RTT测量、探活
task任务下发派发工单到目标能力/算子
result结果回传任务完成，回传产物与真值
query查询/发现发现Agent Card、检索能力
truth_report真值上报上报真值条目至记忆网关/账本
fed_join联邦加入加入联邦记忆池/联邦网络
fed_sync联邦同步跨节点记忆/真值同步

响应与错误规范

标准响应信封

"msg_type": "response",
"status": "ok" | "error",
"ref": "GAP-...",   // 关联请求job_id
"code": 0,            // 业务码，0成功
"payload": { }

错误码段（节选）

code含义
4001协议版本不兼容
4010DID未认证 / 签名无效
4030权限不足 / 越权
4040目标能力未注册
4080任务超时被回收
4220Schema校验失败
5070熔断隔离中，请求被拒绝
04 · LAYER SCHEMAS

各层核心Schema

以下为各层在GAP-Message payload中承载的核心数据结构。字段名采用统一命名规范，空值不落盘，确保最小化体积。

L1 · 传输层

JSON over HTTP/SSE双通道。请求头强制携带 X-DID 与 X-Sign；SSE用于事件推送与长连接。默认超时与心跳见下表。

参数默认值
通道HTTP POST / SSE GET
编码UTF-8 JSON
鉴权头X-DID + X-Sign（sha256）
请求超时30s（HTTP）
心跳间隔15s
心跳超时判定连续3次无回执标记离线

L2 · 工单层

// GAP-Job v2.0
{
  "job_id": "GAP-...",
  "state": "logic",   // logic(逻辑态) | operator(算子态) | exec(执行态)
  "target": "did:cap:...", // 目标能力
  "priority": 1,      // 0-3 优先级
  "timeout": 120,     // 秒，超时回收
  "payload": { },
  "callback": ""      // 结果回调地址（可选）
}

三层解耦规则：逻辑态负责生成工单与意图解析；算子态负责校验、路由与调度；执行态负责真正执行并回传结果。三者可独立演进。

L3 · 能力层（Agent Card）

// GAP-AgentCard v2.0
{
  "agent_id": "NODE-DEV-DOUBAO-WORK-001",
  "did": "DID-BR-000002",
  "name": "开发工作节点",
  "capabilities": ["job.schedule", "truth.report"],
  "endpoint": "wss://...",
  "ttl": 3600,          // 卡片有效秒数
  "version": "2.0.0"
}

注册流程：register 上报Agent Card → 网关校验DID与签名 → 能力入索引 → 返回注册回执；发现通过 query 按能力名检索。

L4 · 数据真值层

// GAP-TruthEntry v2.0（真值条目）
{
  "truth_id": "T-{uuid}",
  "content": "...",
  "confidence": 0.93,   // 置信度 0-1
  "source": "...",     // 来源锚定
  "version": 3,
  "merkle": "sha256:...", // 内容哈希
  "conflict": "none"   // 冲突标记
}

L5 · 联邦互操作层

// GAP-FedSync v2.0（联邦同步）
{
  "fed_id": "fed:memory:pool:01",
  "sync_type": "truth",   // truth | asset | card
  "delta": [ "T-..." ],
  "anchor": "sha256:..."  // 快照锚点
}

L6 · 语义溯源层

四层结构化拆解与九大元类归类统一在L6完成，产出结构化资产对象（GAP-StructuredAsset），供L4真值提取与账本归档使用。

四层结构

层内容
L1元数据：唯一根ID、SNAP快照、Merkle哈希
L2内容：正文/图表/代码/引用分离
L3关系：实体/因果/时序/依赖提取
L4真值：置信度+来源+版本+冲突标记

九大元类

元类举例
公理/定理元法则、元公理
方法/协议协议栈规范、SOP
数据/案例台账、案例库
决策/创意决策方案、创意资产
风险风险矩阵条目

L7 · 治理安全层

DID确权

所有节点持有DID，消息签名验签，权限按角色/等级路由，敏感台账不进公开通道。

eFuse熔断

检测到账本严重矛盾或篡改风险时，对问题分支局部分支熔断隔离，保护主Merkle主干，不销毁数据。

ZKP + 脱敏

ZKP零知识完整性核验适配敏感条目；DataGate对外脱敏、内外用语隔离。

05 · INTEGRATION

接入流程

任意Agent/节点接入协议栈，遵循三步标准流程；协作主链路为「下发-执行-回传-归档」闭环。

Step 1

注册DID

节点持有去中心化身份DID，初始化GAP客户端，完成密钥对与签名配置。

Step 2

能力声明

上报Agent Card与能力清单，经网关校验后入能力索引，可被query发现。

Step 3

订阅真值

建立SSE长连接订阅真值/事件流，周期性心跳保活，接入完成。

协作主链路

步骤说明
1. 下发发起方生成GAP-Job工单（逻辑态）→ 校验路由（算子态）→ 派发目标
2. 执行目标节点执行态运行任务，实时心跳反馈进度
3. 回传执行完成，通过result回传产物与真值条目
4. 归档L6四层结构化+九大元类归类 → L4真值提炼 → Merkle-DAG追加校验入账
5. 同步经L5联邦层跨节点同步，可选上报记忆网关全域锁档
06 · ECOSYSTEM ADAPTER

A2A / MCP 兼容适配层

内部统一走GAP协议，对外通过适配层与开放生态双向翻译，实现「自有标准 + 生态兼容」双轨。

GAP → A2A 适配

将GAP Agent Card映射为A2A Agent Card，能力声明转换为A2A skill清单；task工单映射为A2A任务执行请求，使内部节点可被A2A生态调用。

// 能力映射
GAP capability:"truth.report"
        ⇄  A2A skill:"truth-report"
GAP "task" ⇄ A2A "task/submit"

GAP → MCP 适配

将GAP能力暴露为标准MCP工具，供主流客户端原生调用；同时将外部MCP工具作为可发现能力接入内部能力索引，实现免费能力池复用。

// 工具映射
GAP capability → MCP tool {name, schema}
内部能力索引 ⇄ 外部 MCP Server

适配边界与安全约束

对外暴露仅限白名单能力；敏感台账、密钥、内部真值不进公开MCP/A2A通道；密钥只存云端；适配层做输入校验与脱敏，阻断越权访问。

07 · GOVERNANCE

安全与治理模型

治理层横切全栈，构建「确权-鉴权-审计-熔断-脱敏」五道防线，确保多智能体协作可信可控。

防线机制落地
确权DID去中心化身份，签名验签，身份不可抵赖X-DID头 + X-Sign
鉴权能力白名单 + 角色等级路由，敏感操作审批能力索引 + 权限表
审计全链路工单留痕，账本Merkle-DAG防篡改GAP-Job轨迹 + 主链
熔断矛盾/篡改风险局部分支隔离，保护主干eFuse只读锁
脱敏对外去核心逻辑、内外用语隔离、ZKP核验DataGate + ZKP

开放接入原则

协议栈面向开放生态提供标准接入点，任何节点遵循「注册DID → 能力声明 → 订阅真值」三步即可接入联邦网络；敏感能力默认不对外，白名单放行。协议栈当前处于草案迭代阶段，正式发布时间尚未排定。

返回总览
08 · ROADMAP

版本演进路线

协议栈从体系既有单点协议资产演进而来，按增量、向后兼容方式升级。

V0.x
体系协议资产沉淀
同源协议三层解耦、记忆网关、Merkle-DAG账本、A2A联邦接入等分散成型。
V1.0
同源协议单点标准
X-DID + JSON工单 + 三层解耦确立为内部通信基线。
V2.0
七层标准化 + 生态适配 当前
归一为七层架构，GAP-Message v2.0统一消息规范，内置A2A/MCP兼容适配层，联邦记忆池接入。
V3.0
联邦自治增强（规划）
多联邦域自治协调、跨域真值对账、零信任默认拒绝。
V2.0.0

当前版本

七层架构 + 消息规范 + 生态适配层，草案迭代中。

3

接入步骤

注册DID → 能力声明 → 订阅真值。

7

协议层数

L1传输至L7治理，全程横切守护。

09 · NODE DEPLOYMENT

常驻节点部署与接入

GAP-SDK 附带可注册常驻节点（gap_node.py），支持作为独立 GAP 节点接入联邦网络，具备注册、工单处理、联邦同步、心跳与治理守护能力。

节点能力

接入

自动注册

启动即上报AgentCard（能力清单/标签/算力），进入能力索引可被query发现。

监听

HTTP工单端点

内置HTTP监听端点接收标准GAP工单，按三层解耦路由到算子处理器。

守护

治理校验

X-DID签名验签、Merkle校验、eFuse配额熔断、敏感能力白名单。

算子

回调钩子

注册自定义算子处理器与失败回滚钩子，异常自动回滚并记录审计。

联邦

同步子线程

SFMP联邦记忆池增量同步，仅同步白名单域真值分片。

适配

生态转换

内置A2A/MCP适配层，GAP工单可双向转换为开放生态报文。

部署步骤

步骤说明
1. 准备放置 gap_sdk.py、gap_node.py、gap_node_config.yaml 于同目录
2. 配置编辑 gap_node_config.yaml：DID、agent_id、能力清单、联邦域白名单、配额
3. 自测python3 gap_node.py --self-test 或 bash node_bootstrap.sh 预检
4. 启动bash node_bootstrap.sh 启动常驻服务（默认 127.0.0.1:8720）
5. 接入节点启动自动注册AgentCard；通过 register / query / task / truth_report 参与协作
6. 运维健康探测 GET /health，能力查看 GET /card，审计 GET /logs

错误码语义（节点返回节选）

code含义
4010DID未认证 / 签名无效
4220Schema校验失败 / 非法JSON
5000算子执行异常（已触发回滚）
5070eFuse熔断 / 配额超限，拒绝只读

接入约束

生产节点密钥应改用云端托管（密钥只存云端）；敏感能力默认不对外，白名单放行；对外暴露能力进白名单，内部真值不进公开通道。

主页·流水线·产品·状态·GAP-SPEC-002 交互镜像