Files
synapse/docs/00-record/2026-06-29-v1-draft-discussion.md
2026-06-29 02:12:44 +08:00

112 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 会议记录:v1 草案讨论会
> 日期:2026-06-29
> 时长:1 session
> 主题:灵隙 v1 版本身份协议草案讨论 & 版本规划
---
## 会议议题
围绕 [v1 身份协议草案](../v1/05_identity-protocol-draft.md) 的技术方案与版本规划进行讨论。
---
## 决议事项
### 决议一:签名机制统一为非对称签名
| 项目 | 内容 |
|------|------|
| **结论** | 直接统一到非对称签名体系 |
| **默认算法** | Ed25519(高效、安全) |
| **兼容算法** | ECDSA-P256(跨链互操作)、ECDSA-secp256k1(兼容以太坊系) |
| **HMAC 定位** | 降级为可信内网链路的可选优化,不作为协议层的签名方案 |
| **影响范围** | [Raw协议](../v1/01_raw-protocol.md) 第4章签名机制需重写,统一为公钥签名;`signature` 字段含义从 HMAC 变更为 Ed25519/ECDSA 签名值;`signature_algorithm` 字段保留,默认值改为 `Ed25519` |
### 决议二:区块链作为身份协议的核心组成部分
| 项目 | 内容 |
|------|------|
| **结论** | 区块链不是可选插件,而是身份协议的核心层 |
| **定位** | 三层发现架构中,区块链作为"最终一致性源"(Source of Truth) |
| **默认基础设施** | 每个 Synapse 网络应至少有一个链上注册表,作为 Agent 身份的最终存证 |
| **兼容性** | 支持多链:Ethereum(高价值)、Polygon(高频)、联盟链(企业) |
| **混合模式** | 本地缓存 + DHT 做快速查找,区块链做最终验证和仲裁 |
### 决议三:DHT 分阶段实现
| 阶段 | 范围 | 说明 |
|------|------|------|
| **Phase 1(v1.0)** | 广播查询 + 中心目录 | 小型网络(<100 Agent),用灵脉 Meridian 作为可选目录,无 DHT |
| **Phase 2(v1.1)** | 分层 DHT | 中等规模(100-10000 Agent),引入分层路由 |
| **Phase 3(v1.2)** | 完整 Kademlia + 隐私保护 + 密钥轮换 | 大规模网络(>10000 Agent),支持密钥轮换和隐私保护 |
### 决议四:七大组件实现推迟到 v1.1
| 项目 | 内容 |
|------|------|
| **结论** | v1 版本聚焦协议层定义(数据格式、消息类型、行为约束),不做具体落地实现 |
| **v1 范围** | Raw / A2A / A2N / P2A 四个协议规范 + 去中心化身份草案 |
| **v1.1 范围** | 七大组件(灵脉/灵玺/灵鉴/灵泊/灵瞰/灵衡/灵枢)的具体落地实现 |
| **v1.2 范围** | 完整 Kademlia DHT、隐私保护机制、密钥轮换、跨链互操作 |
---
## 补充讨论要点
### 1. 协议层与实现层的明确边界
v1 的身份草案目前包含部分实现细节(如 Solidity 合约代码),需要在 v2 版本中剥离:
- **协议层(v1)**:只定义 AgentID 格式、签名算法、消息类型、生命周期状态机
- **实现层(v1.1+)**:具体的区块链合约实现、DHT 协议栈、缓存策略
### 2. AgentID 命名空间治理
| 问题 | 方案 |
|------|------|
| namespace 的分配 | 官方保留 `synapse:` 前缀;企业自定义采用反向域名(如 `com.mycompany.agent:`) |
| alias 全局唯一性 | 不要求全局唯一,仅在本地或联盟内有效 |
| DID 兼容 | `did:synapse:` 独立成体系,与 `namespace:key_hash:alias` 格式并存 |
### 3. 签名算法选择理由
选择 Ed25519 作为默认算法的原因:
- 比 ECDSA-P256 快 2-3 倍
- 固定长度签名(64 字节),便于编码和存储
- 抗侧信道攻击,实现简单
- 所有主流语言均有成熟实现
### 4. 区块链选择建议
| 场景 | 推荐 | 理由 |
|------|------|------|
| 开发/测试 | 本地 Hardhat 私链 | 零成本、完全可控 |
| 企业联盟 | Hyperledger Fabric / 联盟链 | 隐私、可审计 |
| 公网生产 | Ethereum L2(Arbitrum/Optimism) | 低 Gas 成本、继承 L1 安全 |
| 高频场景 | Polygon / Solana | 确认快、成本低 |
---
## 附录:关联文档
| 文档 | 说明 | 关系 |
|------|------|------|
| [v1 身份草案](../v1/05_identity-protocol-draft.md) | 现有 v1 身份协议草案 | 本次讨论的基础文档 |
| [身份草案 v2](../01-draft/2026-06-29-identity-protocol-v2.md) | 根据本次决议更新的草案 | 基于本次决议生成 |
| [Raw协议](../v1/01_raw-protocol.md) | 原始协议定义 | 签名方案受影响需更新 |
| [v1 索引](../v1/00_index.md) | v1 版本索引 | 版本范围需更新 |
---
## 后续行动
| 事项 | 负责人 | 目标版本 | 状态 |
|------|--------|---------|------|
| 更新 Raw 协议签名方案 | - | v1.0 | 待办 |
| 更新身份草案为 v2 版本 | ✅ 已完成 | v1.0 | 完成 |
| 更新 v1 索引文件版本范围 | - | v1.0 | 待办 |
| 起草七大组件规范 | - | v1.1 | 待启动 |
| 起草 DHT 实现规范 | - | v1.1 | 待启动 |
| 链上合约实现 | - | v1.1 | 待启动 |