# 灵隙 Synapse 协议栈 v1 > 版本:1.0.0 > 更新日期:2026-06-27 --- ## 协议结构 本版本协议按抽象层设计,只定义"实现什么功能"和"数据格式",不涉及具体实现细节。 ``` docs/v1/ ├── 00-index.md # 本文件(协议索引) ├── 01-raw-protocol.md # 原始协议(基础层) ├── 02-a2a-protocol.md # A2A 协议(点对点) ├── 03-a2n-protocol.md # A2N 协议(群组协作) └── 04-p2a-protocol.md # P2A 协议(外部调用) ``` --- ## 协议概览 ### 层级关系 ``` ┌─────────────────────────────────────┐ │ P2A 协议(外部调用入口) │ │ 04-p2a-protocol.md │ └─────────────────────────────────────┘ │ │ 封装 ▼ ┌─────────────────────────────────────────────────────┐ │ A2A 协议(点对点任务协作) │ │ 02-a2a-protocol.md │ └─────────────────────────────────────────────────────┘ │ │ 复用单播 ▼ ┌─────────────────────────────────────────────────────┐ │ A2N 协议(群组协作) │ │ 03-a2n-protocol.md │ └─────────────────────────────────────────────────────┘ │ │ 继承 ▼ ┌─────────────────────────────────────────────────────┐ │ 原始协议(公共基础) │ │ 01-raw-protocol.md │ │ - 统一消息信封 │ │ - 身份标识 │ │ - 签名机制 │ │ - 时间格式 │ └─────────────────────────────────────────────────────┘ ``` --- ## 协议对比 | 协议 | 代号 | 参与方 | 核心功能 | |------|------|--------|---------| | 原始协议 | Raw | - | 消息信封、身份、签名 | | A2A 协议 | P2P | Agent ↔ Agent | 任务提交、进度同步、信息补全、HiL | | A2N 协议 | Group | 1 Coordinator + N Worker | 群组管理、任务拆分合并、投票共识 | | P2A 协议 | Caller | 外部 → Agent | REST API、回调/轮询 | --- ## 消息类型前缀 | 前缀 | 协议 | 说明 | |------|------|------| | `p2p:` | A2A | 点对点消息(17 种) | | `group:` | A2N | 群组内消息(20+ 种) | | `inter_group:` | A2N | 跨群组消息(升级) | | `caller:` | P2A | 外部调用消息(内部转换) | --- ## 与 v0 版本的差异 | 对比项 | v0 版本 | v1 版本 | |--------|---------|---------| | 内容定位 | 混合抽象层和实现层 | 纯抽象层 | | 数据格式 | 嵌入大量 JSON 示例 | 表格化字段定义 | | 实现细节 | 包含 Go struct、算法实现 | 仅定义接口要求 | | 七大组件 | 无协议规范 | 待补充独立文档 | | 文件数量 | 8 个 | 4 个核心协议 | --- ## 后续补充 以下内容待补充为独立实现文档(不属于协议抽象层): - 七大组件详细规范(灵脉、灵玺、灵鉴、灵泊、灵瞰、灵衡、灵枢) - 内容类型系统(TextContent、FileContent 等) - 能力声明系统 - gRPC 传输协议 - HiL 三级升级机制 - 数字分段错误码完整定义 --- ## 版本历史 | 版本 | 日期 | 变更说明 | |------|------|---------| | v1.0.0 | 2026-06-27 | 重构为抽象层协议,分离实现细节 | | v0.x | 2026-06-27 | 初始版本(混合抽象层与实现层) |