# AUN 协议规范

> AUN（Agent Union Network）— ACP 协议 2.0
>
> 版本：2.0 (草稿) | 日期：2026-03-23

## 概述

AUN 是 ACP 协议的 2.0 版本，采用 WebSocket + JSON-RPC 2.0 定义 Agent 间安全通信的标准接口。协议采用**主协议 + 子协议**架构，支持三种平级连接模式：`gateway`、`peer`、`relay`。

**核心特性**：
- 基于 AID（Agent Identifier）的去中心化身份体系，X.509 证书链信任模型
- 身份与拓扑解耦：`auth.*` 管身份凭证，`peer.*`/`relay.*`/Gateway 各管连接
- 业务层方法拓扑无关：认证完成后，`message.*` 等方法在三种模式下统一使用
- 四层协议架构：安全层 → 通信层 → 协议层 → 服务层

## 文档索引

### 主协议

| 文档 | 内容 |
|------|------|
| [00-总览与分层.md](00-总览与分层.md) | 协议目标、核心原则、四层架构、三种连接模式总览、文档导航 |
| [02-证书与信任体系.md](02-证书与信任体系.md) | AID 身份、四级证书链、信任模型、吊销机制（CRL/OCSP） |
| [09-安全考虑.md](09-安全考虑.md) | 威胁模型、防护措施、责任边界、连接升级安全、验签时序 |

### 子协议

| 文档 | 命名空间 | 内容 |
|------|---------|------|
| [01-身份与凭证协议-auth.md](01-身份与凭证协议-auth.md) | `auth.*` | AID 创建、两阶段登录、证书生命周期、JWT Token 机制 |
| [03-Gateway-连接模式.md](03-Gateway-连接模式.md) | `initialize` | Gateway 模式连接流程、initialize 握手、心跳重连 |
| [04-Peer-子协议.md](04-Peer-子协议.md) | `peer.*` | 对等认证四步握手、证书链验证、nonce 签名规则 |
| [05-Relay-子协议.md](05-Relay-子协议.md) | `relay.*` | 中继注册与转发、透明封装、与 peer.* 的关系 |

### 业务层与公共基础

| 文档 | 内容 |
|------|------|
| [06-服务协议.md](06-服务协议.md) | 业务层方法：message.* / meta.* / search.* / task.* / 跨域消息路由 / E2EE 摘要 |
| [07-错误码与状态机.md](07-错误码与状态机.md) | 错误码分层汇总、各模式状态机、可重试/不可重试分类 |
| [08-AUN-E2EE.md](08-AUN-E2EE.md) | 端到端加密安全层：握手、状态机、密文格式、重放保护（横跨三种模式） |

### 附录

| 附录 | 文件 | 内容 |
|------|------|------|
| A | [附录A-术语表.md](附录A-术语表.md) | 核心术语、命名规范 |
| B | [附录B-扩展性指南.md](附录B-扩展性指南.md) | 可选命名空间、自定义协议 |
| C | [附录C-私钥管理与身份恢复.md](附录C-私钥管理与身份恢复.md) | 私钥管理、社交恢复 |
| D | [附录D-Root_CA_治理机制.md](附录D-Root_CA_治理机制.md) | 根证书管理局治理 |
| E | [附录E-Root_CA_准入流程.md](附录E-Root_CA_准入流程.md) | Root CA 准入流程 |
| F | [附录F-Issuer_CA_申请流程.md](附录F-Issuer_CA_申请流程.md) | Issuer CA 证书申请 |
| G | [附录G-AID_孤儿预防与救援机制.md](附录G-AID_孤儿预防与救援机制.md) | 孤儿 AID 预防与救援 |
| H | [附录H-Identity服务实现指南.md](附录H-Identity服务实现指南.md) | Auth 服务实现 |
| I | [附录I-跨域消息路由实现指南.md](附录I-跨域消息路由实现指南.md) | 跨域消息路由实现 |
| J | [附录J-客户端接入示例.md](附录J-客户端接入示例.md) | 客户端接入示例 |
| K | [附录K-Agent_Web发现协议.md](附录K-Agent_Web发现协议.md) | Agent Web 发现协议 |
| L | [附录L-E2EE实现指南.md](附录L-E2EE实现指南.md) | E2EE 实现指南 |
| M | [附录M-JWT认证实现指南.md](附录M-JWT认证实现指南.md) | JWT 认证实现指南 |

## 快速导航

**接入开发者**：[00-总览](00-总览与分层.md) → [01-auth](01-身份与凭证协议-auth.md) → [03-Gateway](03-Gateway-连接模式.md) → [附录J](附录J-客户端接入示例.md)

**协议实现者**：[02-证书体系](02-证书与信任体系.md) → [01-auth](01-身份与凭证协议-auth.md) → [04-Peer](04-Peer-子协议.md) → [06-服务协议](06-服务协议.md) → [07-错误码](07-错误码与状态机.md)

**安全审计**：[02-证书体系](02-证书与信任体系.md) → [09-安全考虑](09-安全考虑.md) → [AUN-E2EE](08-AUN-E2EE.md)

**SDK 设计**：[00-总览](00-总览与分层.md) → [06-服务协议](06-服务协议.md) → [AUN-SDK-跨语言设计方案](../../AUN-SDK-跨语言设计方案.md)
