@agentunion/fastaun-browser 0.5.19 → 0.5.21

package/_packed_docs/sdk/INDEX.md

@@ -1,209 +1,239 @@
-# AUN SDK 文档索引
-
-> 三层索引：Layer 1 文档地图，Layer 2 主题交叉索引，Layer 3 单篇摘要。
-
----
-
-## Layer 1：文档地图
-
-| 文档 | 说明 |
-|------|------|
+# AUN SDK 文档索引
+
+> 三层索引：Layer 1 文档地图，Layer 2 主题交叉索引，Layer 3 单篇摘要。
+
+---
+
+## Layer 1：文档地图
+
+| 文档 | 说明 |
+|------|------|
+| [0.5.21 SDK 应用集成指南](0.5.21-SDK应用集成指南.md) | TypeScript 接入 · batch 持久幂等 · peer 同步 · resolve/owner 展示 · 凭证组织恢复 · 诊断与升级 |
+| [0.5.21 SDK 开发与移植指南](0.5.21-SDK开发与移植指南.md) | 四端公开契约 · peer 水位/流控/提交 · frontmatter 与共识缓存 · 原 CAS/旧任务/reset · checkpoint · 语言差异和验收 |
 | [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **0.5.6 版本更新日志**：首次签名者回源 · 下载提交前验签 · 消息窗口 · 显式 change-seed · 语言能力边界 |
-| [01-快速开始](01-快速开始.md) | 安装 · 三主体模型 · 最小示例 · 多语言构造 |
-| [02-WebSocket协议](02-WebSocket协议.md) | 握手流程 · Capabilities 能力声明 · JSON-RPC 消息格式 · 裸 WebSocket 示例 |
-| [03-核心概念](03-核心概念.md) | AID · AIDStore · AUNClient · A/T/H 消息窗口 · 每个 AUNClient 一个 Pull Gate · 九态状态机 · E2EE |
-| [04-连接与认证](04-连接与认证.md) | 注册加载 · 认证连接 · 当前 access token getter · Python Push 自动登记 · 网关发现 · 事件 · 已读状态本地补偿完成事件 · agent.md 自动观察 |
-| [Ownership管理专题](Ownership管理专题.md) | 四端 `aun.ownership.v1` P2P owner API · 应用层 accept/reject · identity escrow · owner 代签 agent.md · release 解绑/rekey · 崩溃恢复 · 完整消息 payload · metadata 状态 |
-| [Ownership SDK集成指南](Ownership-SDK集成指南.md) | TypeScript 应用层快速接入 · 审批 API · 状态查询 · SDK 自动编排流程图 |
-| [Ownership SDK实现指南](Ownership-SDK实现指南.md) | 四端移植入口 · proof/escrow · 消息拦截 · metadata · rekey/上传恢复 · 验收 |
-| [Ownership协议定义](../protocol/Ownership协议定义.md) | P2P 消息 schema · proof/签名 · agent.md · escrow · owner 授权头 · 现有 RPC |
-| [Ownership 协议定义 2.1](../protocol/Ownership协议定义2.1.md) | 普通双文件/锁/版本 · Group/Org 专属生命周期边界 · owner 本人尾签 signer_aid · 完整 V2 上传授权与实体代际 · 过期停传/保留待办/明确重新上传 |
-| [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 当前七 Facade、审批、持久任务/恢复 · 无消息历史同意释放清理 · Group/Org not_applicable 门禁 |
-| [Ownership 2.1 应用集成指南](Ownership2.1-SDK应用集成指南.md) | 当前应用接入、审批与新鲜共识 · 实体授权过期后的明确上传和专属生命周期 |
-| [Ownership 2.1 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | 四端文件/证书/Storage/CAS · 原件上下文、严格 OCSP 与授权恢复 · 按协议逐项裁决 |
-| [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md) | 0.5.19 应用接入：CAP 验证、登记回执、成员入组/续期、组织请求、代表操作和转让恢复 |
-| [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md) | 0.5.19 四端协议实现：canonical JSON、签名/状态 proof、binding、facade/RPC、持久编排和测试向量 |
-| [Ownership 2.1 详细设计](Ownership2.1详细设计.md) | 本地任务/完成证据、首次授权固定、清理原件与原 CAS |
-| [Ownership 2.1 TDD 实施计划](Ownership2.1-TDD分阶段实施计划.md) | 冻结契约、历史网络账本与本轮复审的本地验证 |
-| [Ownership 2.1 审查报告](../audit/Ownership2.1代码审查报告.md) | 本轮 13 项问题、修代码/修文档、逐项参考端和验证限制 |
-| [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE V2 消息 · ProtectedHeaders · agent.md 版本提示 · recipient wrap |
+| [01-快速开始](01-快速开始.md) | 安装 · 三主体模型 · 最小示例 · 多语言构造 |
+| [02-WebSocket协议](02-WebSocket协议.md) | 握手流程 · 严格布尔 peer 能力声明 · JSON-RPC 消息格式 · 裸 WebSocket 示例 |
+| [03-核心概念](03-核心概念.md) | AID · AIDStore · AUNClient · peer A/T/H 与稀疏覆盖 · N=4 Pull Gate 与动态共享队列 · 50k 内存去重 及 store/client 边界 · 九态状态机 · E2EE |
+| [04-连接与认证](04-连接与认证.md) | 注册加载 · 认证连接 · 当前 access token getter · Python Push 自动登记 · 网关发现 · 事件 · 已读状态本地补偿完成事件 · agent.md 自动观察 · resolve frontmatter 与按需 ownership |
+| [Ownership管理专题（legacy）](Ownership管理专题.md) | 四端 `aun.ownership.v1` P2P owner API · 应用层 accept/reject · identity escrow · owner 代签 agent.md · release 解绑/rekey · 崩溃恢复 · 完整消息 payload · metadata 状态 |
+| [Ownership SDK集成指南（legacy）](Ownership-SDK集成指南.md) | TypeScript 应用层快速接入 · 审批 API · 状态查询 · SDK 自动编排流程图 |
+| [Ownership SDK实现指南（legacy）](Ownership-SDK实现指南.md) | 四端移植入口 · proof/escrow · 消息拦截 · metadata · rekey/上传恢复 · 验收 |
+| [Ownership协议定义（legacy）](../protocol/Ownership协议定义.md) | P2P 消息 schema · proof/签名 · agent.md · escrow · owner 授权头 · 现有 RPC |
+| [Ownership 协议定义 2.1](../protocol/Ownership协议定义2.1.md) | 关系仅由agent.md/owner.md 确认 · release 保持 v、清理后 0／重绑默认 1 · Header 结果投影 · Group/Org 专属生命周期、实体主签与 owner token 上传 · owner完整原文/存在性再读 · 隔离的旧 SDK owner RPC/Auth JSONL · 无Storage路径历史 |
+| [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 七 Facade、原控制格式、原件 CAS 与恢复 · 无参数 reset、绑定容错和 0.5.19 及更早任务兼容 · Group/Org not_applicable 门禁 |
+| [Ownership 2.1 应用集成指南](Ownership2.1-SDK应用集成指南.md) | 普通 agent 可选 owner 注册、应用接入、审批与新鲜共识 · sign/verify 公共门面、显式文件输入、多签读取与实体原件恢复 |
+| [Ownership 2.1 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | 四端统一签验核心、多签 HTTP 表示与实体指纹绑定 · 文件/证书/Storage当前原件 · owner.md 同会话上传与 expected_version 发布 CAS · 任务CAS · 按协议逐项裁决 |
+| [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md) | 0.5.19 应用接入：CAP 验证、登记回执、成员入组/续期、组织请求、实体主签与 owner 上传、转让恢复 |
+| [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md) | 0.5.19 四端协议实现：canonical JSON、签名/状态 proof、binding、facade/RPC、实体多签与原件恢复、测试向量 |
+| [凭证服务 RPC 手册](09-凭证服务RPC手册.md) | Credential Service 实际注册的 health/status/register/revoke/revocationList RPC |
+| [组织服务 RPC 手册](09-组织服务RPC手册.md) | Org Service 生命周期、成员、凭证查询、审计/授权及内部/未实现方法 |
+| [Ownership 2.1 详细设计](Ownership2.1详细设计.md) | agent.md/owner.md 关系、agent.md 兼容非回归矩阵、旧 SDK owner RPC/JSONL 隔离、本地失败稿／显式重试、本地任务与原 CAS |
+| [Ownership 2.1 TDD 实施计划](Ownership2.1-TDD分阶段实施计划.md) | 历史分阶段计划、冻结契约与网络账本、2026-10-13 复查修复边界 |
+| [Ownership 2.1 审查报告](../audit/Ownership2.1代码审查报告.md) | 第二十二节：恢复 agent.md/owner.md 与原控制格式、reset 及历史兼容；第十六至二十一节保留已撤销方案的历史验证边界 |
+| [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE V2 消息 · ProtectedHeaders · need_render 外层提示 · agent.md 版本提示 · 旧 SPK 保留边界 |
 | [ProtectedHeaders用法专题](ProtectedHeaders用法专题.md) | `protected_headers` 四端 API · 实例级/单次调用 · E2EE V2 HMAC 完整性 · 接收信任边界 |
 | [E2EE_V2消息通信时序图](E2EE_V2消息通信时序图.md) | V2 P2P/GROUP 明文与加密主链路 |
-| [06-API手册](06-API手册.md) | AIDStore · AID · AUNClient · 四 SDK access token getter · Python PushFacade · P2P TTL volatile 消息 · Message/Group History 与已读门面 · 已读变更和本地补偿完成 · 消息来源与 Pull 同步生命周期 · 事件 · E2EE 高级 API · RPC 索引 |
+| [06-API手册](06-API手册.md) | AIDStore · resolve 完整输入输出/frontmatter/ownership 与 owner.md 缓存 · AID · AUNClient · 四 SDK access token getter · Python PushFacade · P2P TTL volatile 消息 · Message/Group History 与已读门面 · 已读变更和本地补偿完成 · 消息来源与 Pull 同步生命周期 · 三类批量事件/完整 single fallback · SDK 50k 内存去重/应用持久幂等 · E2EE 高级 API · RPC 索引 |
 | [07-错误处理](07-错误处理.md) | Result · Python `ErrorInfo.cause` · 错误类层级 · 错误码 · 重试 |
-| [08-最佳实践](08-最佳实践.md) | 幂等连接 · 消息同步/History · AUNClient 级 Pull Gate（始终单飞）· group.index · 测试数据保护 |
-| [09-payload-reference](09-payload-reference.md) | message / group / thought payload 格式 |
-| [09-message-rpc-manual](09-message-rpc-manual.md) | P2P 消息 RPC（含跨设备 `read/read_state/read_changed`、设备映射、精确整数、device 定向发送、TTL volatile 消息、双游标/ACK、Forward Pull、`message.history`、Piggy ACK、实时推送内联载荷） |
-| [09-group-rpc-manual](09-group-rpc-manual.md) | 群组 RPC（自动 owner 绑定/解绑、owner 本人名片、强制 rekey 的两阶段转移、跨设备已读、成员 block/status、Group Forward/History/index、Group FS） |
+| [08-最佳实践](08-最佳实践.md) | 幂等连接 · 消息同步/History · AUNClient 级 Pull Gate（同 namespace 单飞、客户端最多 4 个并行）· group.index · 测试数据保护 |
+| [09-payload-reference](09-payload-reference.md) | message / group / thought payload 格式 |
+| [09-message-rpc-manual](09-message-rpc-manual.md) | P2P 共享 seq/peer 游标 · 轻量 pending peers/可选整体估计快照 · 目录A近似/Pull精确next_pending_seq/缺hint安全A/每N次FIFO · Pull 页内渲染计数 · 200 条 Pull/History · 稀疏覆盖/前驱 · peer ACK/公共 S/历史基线 · SDK 50k 内存去重/应用持久幂等/三类batch · 跨设备已读 · TTL volatile |
+| [09-group-rpc-manual](09-group-rpc-manual.md) | 群组 RPC（need_render · 原 Pull/ACK 模型 · 自动 owner 绑定/解绑、owner 本人名片、强制 rekey 的两阶段转移、跨设备已读、成员 block/status、Group Forward/History/index、Group FS） |
 | [09-storage-rpc-manual](09-storage-rpc-manual.md) | 存储 RPC（含实际字节 MIME 识别、session/PUT/complete Content-Type 一致性、OSS 403、POSIX VFS / ACL / token） |
-| [09-collab-rpc-manual](09-collab-rpc-manual.md) | 协作 RPC（版本化文档 / 乐观锁 / 三方合并 / 标签 / GC / reflog / revert） |
-| [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md) | `client.group.fs.*` / `aun group fs` / `group.fs.*` 群文件系统设计，含群自有区角色 ACL、`parents` 和 JS string 语义 |
-| [group.fs POSIX 化分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md) | group.fs 重构的 IPO、Step-by-step、用例集、Checklist、验收和回滚 |
+| [09-collab-rpc-manual](09-collab-rpc-manual.md) | 协作 RPC（版本化文档 / 乐观锁 / 三方合并 / 标签 / GC / reflog / revert） |
+| [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md) | `client.group.fs.*` / `aun group fs` / `group.fs.*` 群文件系统设计，含群自有区角色 ACL、`parents` 和 JS string 语义 |
+| [group.fs POSIX 化分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md) | group.fs 重构的 IPO、Step-by-step、用例集、Checklist、验收和回滚 |
 | [AUN Storage架构设计](<../aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、服务端分层、类 Linux 权限、mount/symlink 与关键时序 |
-| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
-| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
-| [09-proxy-rpc-manual](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
-| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
-| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
-
----
-
-## Layer 2：概念交叉索引
-
-### 身份与认证
-
-- 当前普通 Ownership 2.1、七 Facade、任务恢复、Group/Org not_applicable → [编排指南 2.1](Ownership-SDK编排指南2.1.md)、[协议 2.1](../protocol/Ownership协议定义2.1.md)
-- Group/Org owner 本人尾签、signer_aid、完整 V2 上传授权、实体证书代际与 pending、过期停传/明确上传 → [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的-owner-代签与上传)、[Group RPC](09-group-rpc-manual.md#群组生命周期)
-- Credential/Org 应用接入、CAP 完整验证、登记回执、成员入组/续期、代表请求和转让恢复 → [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md)
-- Credential/Org 四端协议实现、canonical JSON、强状态 proof、请求绑定、facade/RPC 和共同向量 → [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md)
-
-- AID 格式、证书、不可变值对象 → [03-核心概念](03-核心概念.md)
+| [09-meta-rpc-manual](09-meta-rpc-manual.md) | meta RPC 和信任根 |
+| [09-stream-rpc-manual](09-stream-rpc-manual.md) | stream RPC |
+| [09-proxy-rpc-manual](09-proxy-rpc-manual.md) | Service Proxy 控制面 RPC 和数据面隧道注册 |
+| [09-custody-api-manual](09-custody-api-manual.md) | 可选 AID 托管 HTTP API |
+| [Notify通知方案](Notify通知方案.md) | `client.notify()` 在线轻量通知、跨域 federation 和可靠消息分工 |
+
+---
+
+## Layer 2：概念交叉索引
+
+### 0.5.21 接入与移植
+
+- 应用身份与连接、消息持久化及 UI、resolve、Ownership、凭证组织、诊断和升级 → [应用集成指南](0.5.21-SDK应用集成指南.md)
+- 新语言 SDK 分层、peer/batch 提交、缓存与原件恢复、持久化、语言差异和验收 → [开发与移植指南](0.5.21-SDK开发与移植指南.md)
+
+### 身份与认证
+
+- 当前普通 Ownership 2.1 双文件关系、release 保持 v／清理后 0／重绑默认 1、Header 结果投影、旧 SDK owner 隔离兼容、七 Facade 与任务恢复、Group/Org not_applicable → [编排指南 2.1](Ownership-SDK编排指南2.1.md)、[协议 2.1](../protocol/Ownership协议定义2.1.md)
+- 通用 Store raw/document 多签、Group/Org 实体主签、owner token 上传及可选附签、代际与原 CAS pending → [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)、[Group RPC](09-group-rpc-manual.md#群组生命周期)
+- Credential/Org 应用接入、CAP 完整验证、登记回执、成员入组/续期、代表请求和转让恢复 → [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md)
+- Credential/Org 四端协议实现、canonical JSON、强状态 proof、请求绑定、facade/RPC 和共同向量 → [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md)
+- Credential Service 实际 RPC 与签名状态 proof/吊销列表 → [凭证服务 RPC 手册](09-凭证服务RPC手册.md)
+- Org Service 生命周期、成员关系、受保护查询、内部接口和未实现占位 → [组织服务 RPC 手册](09-组织服务RPC手册.md)
+
+- AID 格式、证书、不可变值对象 → [03-核心概念](03-核心概念.md)
 - `AIDStore.register()` / `load()` / `exists()` / `resolve()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- 四端 `bindAid`/`bindOwner` ownership API、应用层请求确认、完整 P2P payload、identity escrow、owner 代签 agent.md、release 解绑/rekey 和消息拦截 → [Ownership管理专题](Ownership管理专题.md)
-- TypeScript 应用层 ownership 快速集成、审批、查询和 SDK 自动编排流程图 → [Ownership SDK集成指南](Ownership-SDK集成指南.md)
-- ownership SDK 实现/移植、声明字节与验签、escrow、metadata 持久化和恢复 → [Ownership SDK实现指南](Ownership-SDK实现指南.md)
-- ownership P2P/proof/agent.md/escrow schema 与现有 RPC、HTTP 授权边界 → [Ownership协议定义](../protocol/Ownership协议定义.md)
+- resolve opts、完整 frontmatter 字段/类型、按需 ownership 共识及 owner.md 缓存 → [resolve 输入与输出](06-API手册.md#resolve-输入与输出)
+- 旧 SDK owner 注册、绑定、转移、查询和解绑 RPC/Auth JSONL 隔离兼容 → [当前协议兼容边界](../protocol/Ownership协议定义2.1.md)；legacy 四端 `bindAid`/`bindOwner`、proof/escrow、代签代上传及 rekey 记录 → [Ownership管理专题（legacy）](Ownership管理专题.md)
+- legacy TypeScript 应用层 ownership 快速集成、审批、查询和 SDK 自动编排流程图 → [Ownership SDK集成指南（legacy）](Ownership-SDK集成指南.md)
+- legacy ownership SDK 实现/移植、声明字节与验签、escrow、metadata 持久化和恢复 → [Ownership SDK实现指南（legacy）](Ownership-SDK实现指南.md)
+- legacy ownership P2P/proof/agent.md/escrow schema 与现有 RPC、HTTP 授权边界 → [Ownership协议定义（legacy）](../protocol/Ownership协议定义.md)
 - agent.md 上传/下载/检查、`remote_etag` / `last_modified` 自动观察、`requester` / `peer` / `group` 角色 → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)、[远程 agent.md 缓存与 ETag 透传方案](../agent.md/远程agent.md缓存与etag透传方案.md)
-- AID 构造约束与多语言入口 → [01-快速开始](01-快速开始.md)、[06-API手册](06-API手册.md)
+- AID 构造约束与多语言入口 → [01-快速开始](01-快速开始.md)、[06-API手册](06-API手册.md)
 - 认证链路、后台刷新和当前 token getter（`get_access_token()` / `getAccessToken()` / `GetAccessToken()`）→ [03-核心概念](03-核心概念.md)、[04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- AID 托管恢复 / 跨设备复制 → [09-custody-api-manual](09-custody-api-manual.md)
-
-### 连接与状态
-
-- 九态状态机、device_id / slot_id 隔离键 → [03-核心概念](03-核心概念.md)
-- `connect()` 选项、长短连接、网关发现 → [04-连接与认证](04-连接与认证.md)
+- AID 托管恢复 / 跨设备复制 → [09-custody-api-manual](09-custody-api-manual.md)
+
+### 连接与状态
+
+- 九态状态机、device_id / slot_id 隔离键 → [03-核心概念](03-核心概念.md)
+- `connect()` 选项、长短连接、网关发现 → [04-连接与认证](04-连接与认证.md)
 - capability getter、事件、生命周期 API → [06-API手册](06-API手册.md)
-- 消息事件 `source`、`sync.started/progress/stopped`、`delivery.changed` → [06-API手册](06-API手册.md)
+- 消息事件 `source`、`sync.started/progress/stopped`、`delivery.changed` 及 `message.peers_snapshot` 的对端水位/可选整体积压估计 → [06-API手册](06-API手册.md)、[Message RPC](09-message-rpc-manual.md#messagepeers_snapshot)
 - 已读状态重连补偿、本地 `read_state_sync` 的 states/errors 和 `background_sync` 边界 → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- Capabilities 能力声明、`inline_realtime_payload_v1` 实时推送优化 → [02-WebSocket协议](02-WebSocket协议.md)、[CHANGELOG-0.5.6](CHANGELOG-0.5.6.md)
-- 裸 WebSocket 握手 → [02-WebSocket协议](02-WebSocket协议.md)
-
-### E2EE
-
+- 严格布尔 `p2p_peer_pull_v1` 能力、连接上下文与上线提示、`inline_realtime_payload_v1` 实时推送优化 → [02-WebSocket协议](02-WebSocket协议.md)
+- 裸 WebSocket 握手 → [02-WebSocket协议](02-WebSocket协议.md)
+
+### E2EE
+
 - E2EE 原理和默认行为 → [03-核心概念](03-核心概念.md)
-- ProtectedHeaders、agent.md 版本提示边界、V2 recipient wrap、sender_signature / AAD / recipient proof → [05-E2EE加密通信](05-E2EE加密通信.md)
+- ProtectedHeaders、need_render 不进 AAD/元数据保护但保留 RPC 签名、V2 recipient wrap、旧 SPK 安全证明边界 → [05-E2EE加密通信](05-E2EE加密通信.md)
 - `protected_headers` 用法、四端 API、合并优先级、key/value 规范化、HMAC 和信任边界 → [ProtectedHeaders用法专题](ProtectedHeaders用法专题.md)
 - V2 P2P/GROUP 时序 → [E2EE_V2消息通信时序图](E2EE_V2消息通信时序图.md)
-- 高级 E2EE API → [06-API手册](06-API手册.md)
-- 解密失败排查 → [07-错误处理](07-错误处理.md)
-
-### RPC 与事件
-
-- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
-- Python `connect()` 携带 `push_notify_aid/push_token` 自动登记，以及 `client.push.register/unregister` 运行期变更 → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)、`docs/protocol/15-离线推送通知协议.md`
-- `client.notify()` 在线轻量通知、跨域 federation、在线/离线边界 → [Notify通知方案](Notify通知方案.md)
-- A/T/H 实时窗口、页内唯一有序发布、应用层跨页幂等排序、每个 AUNClient 一个 Pull Gate（始终 single-inflight、相同 key 折叠、不同 key 排队、前台 FIFO 优先）、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进 → [03-核心概念](03-核心概念.md)、[05-E2EE加密通信](05-E2EE加密通信.md)、[08-最佳实践](08-最佳实践.md)
-- P2P device 定向发送、TTL volatile 消息、双游标/ACK、Forward/History/Piggy ACK → [09-message-rpc-manual](09-message-rpc-manual.md)
+- 高级 E2EE API → [06-API手册](06-API手册.md)
+- 解密失败排查 → [07-错误处理](07-错误处理.md)
+
+### RPC 与事件
+
+- `client.call()` / `client.on()` → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)
+- Python `connect()` 携带 `push_notify_aid/push_token` 自动登记，以及 `client.push.register/unregister` 运行期变更 → [04-连接与认证](04-连接与认证.md)、[06-API手册](06-API手册.md)、`docs/protocol/15-离线推送通知协议.md`
+- `client.notify()` 在线轻量通知、跨域 federation、在线/离线边界 → [Notify通知方案](Notify通知方案.md)
+- peer A/T/H、稀疏覆盖与 prev_peer_seq、human Tail→Forward、50k 内存去重 与应用幂等、N=4 Gate、后台工作片续拉、缺 sender IK 有界 bootstrap；Group 保持原终态规则 → [03-核心概念](03-核心概念.md)、[05-E2EE加密通信](05-E2EE加密通信.md)、[08-最佳实践](08-最佳实践.md)
+- P2P 完整轻量 pending peers、Pull逐页next_pending_seq/可靠commit后更新/连续提示段与每N次FIFO、原应用列表顺序、按 sender/全部对端 Pull、页内渲染计数、可选整体积压估计、冻结旧 ACK 基线、peer ACK/公共 S、TTL volatile、单 Message 实例范围 → [09-message-rpc-manual](09-message-rpc-manual.md)
 - 跨设备 `read/read_state/read_changed`、单条/显式空值、回执与汇总、scope/owner 绑定、晚到位置回填、Group canonical/权限版本及混合域部分提交 → [09-message-rpc-manual](09-message-rpc-manual.md)、[09-group-rpc-manual](09-group-rpc-manual.md)
 - Group 成员 block/status、暂停群权限、两阶段群主转让、Forward/History、`group.index`、Group FS MIME/Content-Type 和角色 ACL → [09-group-rpc-manual](09-group-rpc-manual.md)
-- 下一版群文件系统 `group.fs.*`、`client.group.fs.*`、`aun group fs`、`cp/mv` POSIX 化语义和 JS string 差异 → [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md)、[分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md)
+- 下一版群文件系统 `group.fs.*`、`client.group.fs.*`、`aun group fs`、`cp/mv` POSIX 化语义和 JS string 差异 → [group.fs POSIX 化详细设计](../aun-fs/group-fs/group.fs-POSIX化详细设计.md)、[分阶段实施计划](../aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md)
 - Storage 架构、SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、类 Linux 权限和 mount/symlink → [AUN Storage架构设计](<../aun-fs/AUN Storage架构设计.md>)
 - Storage RPC、实际字节 MIME 识别、三阶段 Content-Type 一致性与 OSS 403、`storage.fs.*` / ACL / token、`relation_backup_*` → [09-storage-rpc-manual](09-storage-rpc-manual.md)、[../protocol/11-Storage-子协议.md](../protocol/11-Storage-子协议.md)
-- Collab RPC（`collab.*` 版本化文档、乐观锁、标签、GC、reflog、revert）→ [09-collab-rpc-manual](09-collab-rpc-manual.md)
-- Meta RPC → [09-meta-rpc-manual](09-meta-rpc-manual.md)
-- Stream RPC → [09-stream-rpc-manual](09-stream-rpc-manual.md)
-- Service Proxy RPC 和隧道注册 → [09-proxy-rpc-manual](09-proxy-rpc-manual.md)
-- Payload 格式 → [09-payload-reference](09-payload-reference.md)
-
-### 错误与测试
-
+- Collab RPC（`collab.*` 版本化文档、乐观锁、标签、GC、reflog、revert）→ [09-collab-rpc-manual](09-collab-rpc-manual.md)
+- Meta RPC → [09-meta-rpc-manual](09-meta-rpc-manual.md)
+- Stream RPC → [09-stream-rpc-manual](09-stream-rpc-manual.md)
+- Service Proxy RPC 和隧道注册 → [09-proxy-rpc-manual](09-proxy-rpc-manual.md)
+- Payload 格式 → [09-payload-reference](09-payload-reference.md)
+
+### 错误与测试
+
 - Result、Python `ErrorInfo.cause` 与异常层级 → [07-错误处理](07-错误处理.md)
-- 重试策略 → [07-错误处理](07-错误处理.md)
+- 重试策略 → [07-错误处理](07-错误处理.md)
 - 幂等连接、多 AID、资源清理 → [08-最佳实践](08-最佳实践.md)
-- 集成 / E2E 运行顺序 → [../aun测试运行指南.md](../aun测试运行指南.md)；分布式 worktree 测试 → [../aun分布式测试运行指南.md](../aun分布式测试运行指南.md)
-
----
-
-## Layer 3：文档摘要
-
-### CHANGELOG-0.5.6
-
+- 集成 / E2E 运行顺序 → [../aun测试运行指南.md](../aun测试运行指南.md)；分布式 worktree 测试 → [../aun分布式测试运行指南.md](../aun分布式测试运行指南.md)
+
+---
+
+## Layer 3：文档摘要
+
+### 0.5.21 SDK 应用集成指南
+
+按应用接入顺序说明当前 0.5.21 的身份、批量入库、peer 同步、已读与 UI、frontmatter/owner 展示、关系审批/reset、凭证组织恢复、诊断和升级。TypeScript 示例区分 Node 与浏览器，明确展示缓存、业务授权和持久幂等的边界。
+
+### 0.5.21 SDK 开发与移植指南
+
+按 SDK 实现职责整理 peer 能力/水位、共享 Gate 与背压、batch/handler/水位/ACK 时序、运行时去重、resolve 元数据与共识缓存、普通名片非回归、Ownership 原 CAS 和历史任务、续期撤销、加密 checkpoint、诊断证书、四端差异及测试矩阵。
+
+### CHANGELOG-0.5.6
+
 以 0.5.5 发布提交为基线，汇总四个 SDK 的首次签名者证书回源、`group.index` / indexed settings / `agent.md` 下载提交前校验、可信缓存读取、消息窗口、inline realtime、mention mode、显式 change-seed，以及 Python、Go、TS 和浏览器 JS 的能力边界。
-
-### 01-快速开始
-
-说明安装、三主体模型、Python 最小消息收发示例、`AIDStore` / `AID` / `AUNClient` 的职责和 TS/JS/Go 构造约束。
-
-### 02-WebSocket协议
-
+
+### 01-快速开始
+
+说明安装、三主体模型、Python 最小消息收发示例、`AIDStore` / `AID` / `AUNClient` 的职责和 TS/JS/Go 构造约束。
+
+### 02-WebSocket协议
+
 说明 Gateway WebSocket 握手、Capabilities 能力声明（含 `inline_realtime_payload_v1` 实时推送优化）、JSON-RPC 请求/响应/通知格式，以及裸 WebSocket 客户端如何借助 SDK 完成 token 获取。
-
-### 03-核心概念
-
-解释 AID 身份、三主体职责、device_id / slot_id 隔离键、A/T/H 实时消息窗口、每个 AUNClient 一个 Pull Gate、九态状态机、默认 E2EE 行为和 RPC/事件模型。
-
+
+### 03-核心概念
+
+解释 AID 身份、三主体职责、device_id / slot_id 隔离键、共享 seq 下的 peer A/T/H 与覆盖证明、human Tail 策略、N=4 Pull Gate 与 page_size×N 共享队列、后台工作片续拉、50k 内存去重、自定义 store/多 client 边界和应用幂等、九态状态机及默认 E2EE 行为。
+
 ### 04-连接与认证
 
-描述 `AIDStore` 注册加载、`AUNClient` 身份加载、显式认证、当前 access token getter、连接选项、Python `connect()` 的 Push 自动登记、长短连接共存、网关发现、已读状态本地补偿完成事件、agent.md 上传/下载/检查，以及连接后从 Gateway `_meta.agent_md_etags` 和信封 `agent_md` 自动观察远端版本。
+描述 `AIDStore` 注册加载、自有身份 resolve 本地草稿/缓存优先、frontmatter 类型保留及按需 ownership 共识/owner.md 缓存、`AUNClient` 身份加载、显式认证、当前 access token getter、连接选项、Python `connect()` 的 Push 自动登记、长短连接共存、网关发现、已读状态本地补偿完成事件、agent.md 上传/下载/检查，以及连接后从 Gateway `_meta.agent_md_etags` 和信封 `agent_md` 自动观察远端版本。
 
 ### Ownership 2.1 当前契约与复审
 
-现行六份协议/SDK 文档定义普通双文件流程、七 Facade 与实体专属 owner 名片；实体 pending 保留原授权和 CAS，超过 ±300 秒停止自动重传，须明确重新上传。无控制消息的释放清理按精确本人历史同意恢复，保持 completed 历史；当前证书严格绑定 OCSP issuer，整体 30 秒包含首次 GET。各端差异按协议逐项裁决，TS 是接线参考；13 项本轮修复及实际验证见 [审查报告第十二节](../audit/Ownership2.1代码审查报告.md#十二2026-10-11-本轮复审与修复)。
-
-### 凭证与组织服务 SDK 应用集成指南
-
-面向应用开发者说明 0.5.19 的 Credential/Org service-plane 边界、CAP 完整 Verify、Credential 请求绑定、受保护读取、首次入组 admission、组织创建与两阶段转让恢复、解散证书失效清理；列出四端实际入口及状态未知和 `NOT_IMPLEMENTED` 的 fail-closed 边界。
-
-### 凭证与组织服务 SDK 开发与移植指南
-
-面向其它语言 SDK 开发者冻结两类 canonical JSON、P-256/DER 签名、CAP 深度和安全声明、父链强状态 proof、Org admission 与 Credential 请求绑定、四端 facade/RPC、创建/转让 checkpoint、解散清理、事件去重和共享测试向量。
+当前普通 Ownership 关系仅由 NS 当前 `agent.md` 与 owner Storage 当前 `owner.md` 确认，声明和控制消息沿用 0.5.20；owner 锁与 Header 投影本次校验结果。普通 agent 注册 owner 可选；普通正文更新保留全部关系材料、本人签名和原 ETag/CAS，不以前置共识或 owner Storage 为条件。release 保持 v，清理后投影 0／再次绑定默认 1；owner.md 仍通过同一上传会话及 expected_version 条件发布，当前完整原文和存在性用于读取核验。历史任务恢复、无参数 reset、绑定容错及 0.5.19 release wire 兼容见编排第 8 节；更早 proof 与旧 owner RPC 保持原隔离边界。当前更正见 [第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)，阶段计数不能代替恢复后专项及真实旧发布包联网验收。
+
+绑定恢复、reset 和历史任务的当前要求以[第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)及[编排第 8 节](Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)为准；历史第十九至二十一节仅保留阶段实施记录。
+
+### 凭证与组织服务 SDK 应用集成指南
+
+面向应用开发者说明 0.5.19 的 Credential/Org service-plane 边界、CAP 完整 Verify、Credential 请求绑定、受保护读取、首次入组 admission、组织创建与两阶段转让恢复、解散证书失效清理；列出四端实际入口及状态未知和 `NOT_IMPLEMENTED` 的 fail-closed 边界。
+
+### 凭证与组织服务 SDK 开发与移植指南
+
+面向其它语言 SDK 开发者冻结两类 canonical JSON、P-256/DER 签名、CAP 深度和安全声明、父链强状态 proof、Org admission 与 Credential 请求绑定、四端 facade/RPC、创建/转让 checkpoint、解散清理、事件去重和共享测试向量。
+
+### 凭证服务 RPC 手册
+
+按 Credential Service dispatcher 记录 health/status、register、revoke、revocationList 的参数、响应和授权边界，并区分本地 SDK helper 与服务端 RPC。
+
+### 组织服务 RPC 手册
+
+按 Org Service dispatcher 记录生命周期、成员、凭证查询、审计和授权 RPC，并标明受限内部方法及返回 `NOT_IMPLEMENTED` 的保留方法。
 
 ### Ownership管理专题
-
-以下旧 Ownership 专题、集成/实现指南与协议条目均为 legacy；当前 2.1 不使用旧 proof/escrow，Group/Org 的专属 owner 名片也不采用旧目标 identity 代签规则。
+
+以下旧 Ownership 专题、集成/实现指南与协议条目均为 legacy；当前 2.1 不使用旧 proof/escrow，Group/Org 的专属 owner 名片也不采用旧目标 identity 代签规则。
 
 按当前四端 SDK、CA、Name Service 和 Storage 实现说明 `ownership.request` 应用层 accept/reject、双方签署后立即发布 proof、独立托管与代上传、identity 的文件/IndexedDB 持久化位置、完整 P2P payload、agent.md 与 metadata 恢复、服务端 active signing 校验、下载端验签和实现边界。
-
-### Ownership SDK集成指南
-
-先以 TypeScript 应用示例完成身份加载、事件审批、双向绑定、状态查询与解绑，再用时序图说明 SDK 的 proof、identity 托管、owner 代上传、名片同步和中断恢复。
-
-### Ownership SDK实现指南
-
-面向其它语言 SDK 的实现者与移植者，对照四端代码说明公开契约、控制消息拦截、密码学原语、self-owner、escrow、metadata、rekey 和 agent.md 待上传恢复，并索引现有验收用例。
-
-### Ownership协议定义
-
-定义 `aun.ownership.v1` 的公共字段和六类 action、v2 独立声明及签名封套、ownership release、agent.md frontmatter、identity escrow、owner 上传授权头，以及 Message、Storage、Name Service、Auth/CA 的现有接口边界。
+
+### Ownership SDK集成指南
+
+先以 TypeScript 应用示例完成身份加载、事件审批、双向绑定、状态查询与解绑，再用时序图说明 SDK 的 proof、identity 托管、owner 代上传、名片同步和中断恢复。
+
+### Ownership SDK实现指南
+
+面向其它语言 SDK 的实现者与移植者，对照四端代码说明公开契约、控制消息拦截、密码学原语、self-owner、escrow、metadata、rekey 和 agent.md 待上传恢复，并索引现有验收用例。
+
+### Ownership协议定义
+
+定义 `aun.ownership.v1` 的公共字段和六类 action、v2 独立声明及签名封套、ownership release、agent.md frontmatter、identity escrow、owner 上传授权头，以及 Message、Storage、Name Service、Auth/CA 的现有接口边界。
 
 ### 05-E2EE加密通信
 
-覆盖默认加密发送、接收自动解密、E2EE V2 多设备 wrap、ProtectedHeaders、agent.md 版本提示与 E2EE 安全边界、`sender_signature` / AAD / recipient proof、群 E2EE 和高级存储扩展边界。
+覆盖默认加密发送、接收自动解密、E2EE V2 多设备 wrap、ProtectedHeaders、need_render 外层提示与 RPC 签名边界、agent.md 版本提示、`sender_signature` / AAD / recipient proof、peer/slot ACK 不作为设备旧 SPK 销毁证明、群 E2EE 和高级存储扩展边界。
 
 ### ProtectedHeaders用法专题
 
 按当前 Python、TypeScript、JavaScript、Go 实现说明 `protected_headers` 的实例级/单次调用 API、`headers` 兼容别名、E2EE V2 元数据 HMAC、自动字段、解密失败边界和裸 RPC 限制。
 
 ### 06-API手册
-
-列出 AIDStore、AID、AUNClient（含四 SDK 当前 access token getter）、Python PushFacade、P2P TTL volatile 消息、Message/Group History 与已读门面、已读变更及本地补偿完成事件、agent.md、ServiceProxyClient、E2EE 高级 API、Group Index facade 和 RPC 手册索引。
-
-### 07-错误处理
-
+
+列出 AIDStore、resolve 的四语言 opts/输入输出、frontmatter 标准与扩展字段、ownership 七种共识状态及 owner.md 快照/TTL/失败语义、AID、AUNClient、Ownership 2.1 与 Credential/Org 入口、Python PushFacade、P2P peer/全部对端 Pull、轻量 pending 快照与可选整体估计/Pull 页内渲染计数、50k 内存去重 和应用幂等、Message/Group History 与已读门面、生命周期事件、agent.md、ServiceProxyClient、E2EE 和 Group Index facade。
+
+### 07-错误处理
+
 说明 Result 字典、Python 本地原始异常 `ErrorInfo.cause`、AUNError 异常层级、错误码映射、重试策略、`group.index etag conflict` CAS 冲突处理和常见错误场景。
-
-### 08-最佳实践
-
-给出幂等加载身份、连接、关闭、多 AID 管理、Flow Control、A/T/H 实时同步、History 翻页、Piggy ACK、Group Index 更新和测试数据保护建议；每个 AUNClient 的 Pull Gate 始终单飞。
-
-### 09-*-rpc-manual
-
-各业务服务的 RPC 参数、响应和错误语义。Message RPC 覆盖 device 定向发送、TTL volatile 双游标/ACK；Group RPC 覆盖成员 block/status、暂停群权限、两阶段群主转让、Group Event 独立游标和 Group FS MIME/Content-Type；Storage RPC 覆盖实际字节 MIME 识别、session/PUT/complete Content-Type 一致性和 OSS 403。Message/Group 另定义顶层单条与显式空值、共享已读汇总、设备映射、晚到位置回填、精确整数及 scope/owner 绑定；Group 包含 canonical ID、跨实例权限版本、混合域逐域提交/幂等重试和全量查询。
-
-### AUN Storage架构设计
-
+
+### 08-最佳实践
+
+给出幂等加载身份、连接、关闭、多 AID 管理、Flow Control、peer A/T/H 与 human Tail 策略、History 翻页、50k 内存去重与应用持久幂等、后台超过100页续调度、Piggy ACK 和 Group Index 更新；每个 AUNClient 的网络 Pull Gate 同 namespace 单飞、最多4个不同 namespace 并行。
+
+### 09-*-rpc-manual
+
+各业务服务的 RPC 参数、响应和错误语义。Message RPC 覆盖 device 定向发送、TTL volatile 双游标/ACK；Group RPC 覆盖成员 block/status、暂停群权限、两阶段群主转让、Group Event 独立游标和 Group FS MIME/Content-Type；Storage RPC 覆盖实际字节 MIME 识别、session/PUT/complete Content-Type 一致性和 OSS 403；Credential/Org RPC 手册覆盖服务端实际注册方法、受保护请求、内部接口和未实现占位。Message/Group 另定义顶层单条与显式空值、共享已读汇总、设备映射、晚到位置回填、精确整数及 scope/owner 绑定；Group 包含 canonical ID、跨实例权限版本、混合域逐域提交/幂等重试和全量查询。
+
+### AUN Storage架构设计
+
 定义 AUN Storage 的 SDK VFS、low-level storage client、Storage Service、Storage Core、Metadata Engine 和 Blob Backend 分层。文档明确主数据流量直连 backend、控制面走 `storage.*` RPC，底层 session/ticket/complete RPC 继续保留，但普通应用通过 SDK VFS 获得类 POSIX 文件操作语义；同时定义下载 ticket 与 AID Bearer 的凭据边界、跨 issuer 下载和当前 token getter 用法、类 Linux mode/ACL、目录 `x` 位、mount/unmount、symlink/readlink/lstat、share link 与 direct backend ticket 的授权边界，并给出上传、下载、rename/move、delete/GC、路径解析和鉴权的 Mermaid 时序图。
-
-### 09-collab-rpc-manual
-
-定义协作层 `collab.*` RPC（共 21 个）：文档版本线（ls-files/create/show/commit/merge/log/diff/revert/prune）、运维备份迁移（gc/reflog/clone）、目录级标签（tag.create/list/show/diff/restore/rm/prune）、群内发现（ls-remote/unregister）。collab 编排并入 storage 服务进程，以调用者身份直调 storage 原语，授权下沉到 storage ACL。涵盖乐观锁 CAS commit 撞版本响应、三方合并冲突标记、forward-only 标签回滚、垃圾扫描和审计日志语义。
-
-### 09-proxy-rpc-manual
-
-定义 Service Proxy 的 Gateway 控制面 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services`，以及 proxy-server 数据面 `register_services` 隧道消息、双注册顺序、服务列表一致性和 wakeup 路由语义。
-
-### Notify通知方案
-
-定义 `client.notify()` 的在线轻量通知语义、服务端/AID/群路由方式、跨域 federation 在线转发、无离线存储边界、安全约束，以及与 `message.send` / `group.send` 可靠应用事件的分工。
-
-
+
+### 09-collab-rpc-manual
+
+定义协作层 `collab.*` RPC（共 21 个）：文档版本线（ls-files/create/show/commit/merge/log/diff/revert/prune）、运维备份迁移（gc/reflog/clone）、目录级标签（tag.create/list/show/diff/restore/rm/prune）、群内发现（ls-remote/unregister）。collab 编排并入 storage 服务进程，以调用者身份直调 storage 原语，授权下沉到 storage ACL。涵盖乐观锁 CAS commit 撞版本响应、三方合并冲突标记、forward-only 标签回滚、垃圾扫描和审计日志语义。
+
+### 09-proxy-rpc-manual
+
+定义 Service Proxy 的 Gateway 控制面 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services`，以及 proxy-server 数据面 `register_services` 隧道消息、双注册顺序、服务列表一致性和 wakeup 路由语义。
+
+### Notify通知方案
+
+定义 `client.notify()` 的在线轻量通知语义、服务端/AID/群路由方式、跨域 federation 在线转发、无离线存储边界、安全约束，以及与 `message.send` / `group.send` 可靠应用事件的分工。
+
+