4.5 KiB
4.5 KiB
灵隙 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 | 初始版本(混合抽象层与实现层) |