@agentunion/fastaun-browser 0.5.19 → 0.5.21

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -1,66 +1,71 @@
-# Kite / AUN SDK Core 文档查阅指南
-
-AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API 子索引为 `docs/sdk/INDEX.md`。
-
-行区间格式：`L7-18` 表示读取第 7 行到第 18 行。需要查 SDK 细节时，优先进入 `docs/sdk/AUN_DOCS_GUIDE.md`，不要一次性读取整套 SDK 手册。
-
-## 渐进式查阅流程
-
-### Step 1：先读根级 Layer 1
-
-- `docs/INDEX.md` L7-88：根级文档地图。
-
-### Step 2：按主题读根级 Layer 2
-
-- 测试与 E2E：`docs/INDEX.md` L91-111。
-- 服务端 Go 化重构审查：`docs/INDEX.md` L112-115。
-- SDK 使用与协议：`docs/INDEX.md` L116-154。
-- Service Proxy 与服务暴露：`docs/INDEX.md` L155-161。
-- 诊断与可观测性：`docs/INDEX.md` L162-170。
-- E2EE 与跨语言一致性：`docs/INDEX.md` L171-179。
-
-### Step 3：需要判断文档价值时读 Layer 3 摘要
-
-- `docs/INDEX.md` L180-426：重点文档摘要。
-
-### Step 4：再读目标文档章节
-
-只读取目标章节，不要默认读取全文。常用入口如下。
-
-## 常见查阅场景
-
+# Kite / AUN SDK Core 文档查阅指南
+
+AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API 子索引为 `docs/sdk/INDEX.md`。
+
+行区间格式：`L7-18` 表示读取第 7 行到第 18 行。需要查 SDK 细节时，优先进入 `docs/sdk/AUN_DOCS_GUIDE.md`，不要一次性读取整套 SDK 手册。
+
+## 渐进式查阅流程
+
+### Step 1：先读根级 Layer 1
+
+- `docs/INDEX.md` L7-92：根级文档地图。
+
+### Step 2：按主题读根级 Layer 2
+
+- 测试与 E2E：`docs/INDEX.md` L97-117。
+- 服务端 Go 化重构审查：`docs/INDEX.md` L118-121。
+- SDK 使用与协议：`docs/INDEX.md` L122-167。
+- Service Proxy 与服务暴露：`docs/INDEX.md` L168-174。
+- 诊断与可观测性：`docs/INDEX.md` L175-183。
+- E2EE 与跨语言一致性：`docs/INDEX.md` L184-190。
+
+### Step 3：需要判断文档价值时读 Layer 3 摘要
+
+- `docs/INDEX.md` L193-453：重点文档摘要。
+
+### Step 4：再读目标文档章节
+
+只读取目标章节，不要默认读取全文。常用入口如下。
+
+## 常见查阅场景
+
 | 场景 | 推荐读取 |
 | --- | --- |
-| Ownership 2.1 当前文件格式，Group/Org 作为 sub 另查专属边界 | `docs/protocol/Ownership协议定义2.1.md` 1. L7-55; 2. L56-194; 3. L195-257; 4. L258-620; 5. L621-628; 6. L629-655 |
-| Ownership 2.1 七 Facade，Group/Org 作为 sub 另查专属边界 | `docs/sdk/Ownership-SDK编排指南2.1.md` 1. L7-38; 2. L39-258; 8. L728-780 |
-| Ownership 2.1 应用接入，Group/Org 作为 sub 另查专属边界 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` 1. L9-24; 2. L25-44; 3. L45-93; 7. L205-233; 8. L234-246 |
-| Ownership 2.1 开发移植，Group/Org 作为 sub 另查专属边界 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` 1. L9-27; 4. L79-118; 5. L119-139; 6. L140-169; 9. L239-262; 10. L263-305; 12. L324-339 |
-| Ownership 2.1 组件职责，Group/Org 作为 sub 另查专属边界 | `docs/sdk/Ownership2.1详细设计.md` 1. L7-60; 4. L159-200; 6. L232-312; 7. L313-405; 8. L406-442 |
-| Ownership 2.1 冻结实现契约，Group/Org 作为 sub 另查专属边界 | `docs/sdk/Ownership2.1-TDD分阶段实施计划.md` 1. L7-51; 13.3 L430-468; 13.6 L658-688; 13.7 L689-700 |
-| Group/Org 专属 owner 生命周期、本人尾签 signer_aid、V2 授权、实体证书代际与恢复 | `docs/protocol/Ownership协议定义2.1.md` L48-55、L173-194；`docs/sdk/09-group-rpc-manual.md` L168-419 |
-| 无控制消息的 released 清理、保留 completed 历史和原 CAS | `docs/sdk/Ownership-SDK编排指南2.1.md` L728-780；`docs/sdk/Ownership2.1-SDK应用集成指南.md` L179-188；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L306-323 |
-| legacy owner/proof、不完整关系、独立 signed_at、self-owner、ownership_release 及上传/下载校验 | `docs/protocol/Ownership协议定义.md` L157-319；`docs/sdk/Ownership管理专题.md` L379-525 |
-| legacy Ownership 2.0 的 agent.md/owner.md 声明、共识及撤销契约 | `docs/agent.md/SCHEMA.md` L1-6、L157-231；`docs/protocol/Ownership协议定义2.0.md`；更早 1.0 副本 `docs/protocol/agent.md/SCHEMA.md` L1-5 |
-| legacy Ownership 应用快速接入、TypeScript 示例、审批和状态查询 | `docs/sdk/Ownership-SDK集成指南.md` L1-154 |
-| legacy Ownership 自动 proof、identity 托管、代上传、解绑和恢复流程图 | `docs/sdk/Ownership-SDK集成指南.md` L156-270 |
-| legacy Ownership 实现/移植、proof 验签、escrow、metadata 和 rekey 恢复 | `docs/sdk/Ownership-SDK实现指南.md` L1-154；验收入口 L156-169 |
-| legacy Ownership wire schema、agent.md、identity escrow 和 owner 授权头 | `docs/protocol/Ownership协议定义.md` L7-399；本地事件/状态与校验 L400-443 |
-| legacy 四端 ownership API、proof、托管、代上传、release 与恢复记录 | `docs/sdk/Ownership管理专题.md` L1-559 |
-| Ownership 2.1 本轮 13 项复审、逐项参考端、修复与验证边界 | `docs/audit/Ownership2.1代码审查报告.md` 九、 L230-313; 十、 L314-364; 十一、 L365-443; 十二、 L444-531（本轮问题 L456-475；最终验证及限制 L504-522） |
-| Credential/Org 应用集成：service-plane、验证/登记、admission、受保护读取、转让恢复和解散清理 | `docs/sdk/凭证与组织服务SDK应用集成指南.md` L7-18、L32-124、L126-152、L162-173 |
-| Credential/Org SDK 开发与移植：CAP、Org/Credential 请求绑定、四端 facade/RPC、checkpoint 和共同向量 | `docs/sdk/凭证与组织服务SDK开发与移植指南.md` L7-16、L18-109、L111-172、L188-209 |
+| 0.5.21 应用开发者：TypeScript 接入、消息入库、resolve/owner、凭证组织、诊断和升级 | `docs/sdk/0.5.21-SDK应用集成指南.md` 1. L7-20；2. L21-79；3. L80-175；4. L176-228；5. L229-263；6. L264-311；7. L312-334；8. L335-356；9. L357-368 |
+| 0.5.21 SDK 开发者：peer/batch 提交、元数据与共识缓存、原件恢复、语言差异和验收 | `docs/sdk/0.5.21-SDK开发与移植指南.md` 1. L7-21；2. L22-45；3. L46-96；4. L97-156；5. L157-212；6. L213-228；7. L229-265；8. L266-295；9. L296-303；10. L304-319；11. L320-332；12. L333-350 |
+| Ownership 2.1 agent.md/owner.md、普通名片边界、原格式与 Header | `docs/protocol/Ownership协议定义2.1.md` 1. L11-61；2. L62-202；3. L203-266；4. L267-631；5. L632-639；6. L640-666 |
+| Ownership 2.1 七 Facade、原控制格式、reset 与旧任务恢复 | `docs/sdk/Ownership-SDK编排指南2.1.md` 1. L9-40；2. L41-243；3. L244-277；4. L278-378；5. L379-412；6. L413-542；7. L543-714；8. L715-773；9. L774-815；10. L816-930 |
+| Ownership 2.1 EC CLI 接入示例、审批、普通名片与历史兼容 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` 1. L13-34；2. L35-54；3. L55-172；4. L173-204；5. L205-246；6. L247-285；7. L286-314；8. L315-329；9. L330-348；10. L349-363 |
+| Ownership 2.1 SDK 移植、原件 CAS、历史任务与绑定容错 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` 1. L13-33；2. L34-64；3. L65-88；4. L89-131；5. L132-154；6. L155-190；7. L191-210；8. L211-259；9. L260-315；10. L316-394；11. L395-513；12. L514-529；13. L530-553 |
+| AIDStore.sign/verify、显式文件输入、连续尾块多签及 NS 表示协商 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L163-172；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L114-131、L155-190 |
+| Ownership 2.1 双文件持久化、普通名片非回归矩阵与组件职责 | `docs/sdk/Ownership2.1详细设计.md` 1. L9-78；2. L79-130；3. L131-166；4. L167-210；5. L211-241；6. L242-303；7. L304-396；8. L397-433；9. L434-467；10. L468-480 |
+| Ownership 2.1 历史分阶段计划、冻结契约与验收，Group/Org 另查专属边界 | `docs/sdk/Ownership2.1-TDD分阶段实施计划.md` 1. L7-53；2. L54-80；3. L81-103；4. L104-136；5. L137-165；6. L166-205；7. L206-237；8. L238-283；9. L284-318；10. L319-351；11. L352-370；12. L371-391；13. L392-708 |
+| Group/Org 实体主签、owner token 上传、可选附签、旧 V2 兼容、权威分类与恢复 | `docs/protocol/Ownership协议定义2.1.md` L52-61、L183-202；`docs/sdk/09-group-rpc-manual.md` L168-419 |
+| release 保持 v、清理后 0／重绑默认 1，原消息及无消息清理 | `docs/sdk/Ownership-SDK编排指南2.1.md` L413-542、L715-773；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L449-471、L504-513 |
+| 旧 SDK 隔离兼容、普通名片保留关系及原任务恢复；legacy proof wire | `docs/protocol/Ownership协议定义2.1.md` L220-242；`docs/sdk/Ownership2.1详细设计.md` L434-467；`docs/sdk/Ownership-SDK编排指南2.1.md` L715-773；`docs/protocol/Ownership协议定义.md` L159-321 |
+| legacy Ownership 2.0 的 agent.md/owner.md 声明、共识及撤销契约 | `docs/agent.md/SCHEMA.md` L1-6、L159-233；`docs/protocol/Ownership协议定义2.0.md`；更早 1.0 副本 `docs/protocol/agent.md/SCHEMA.md` L1-5 |
+| legacy Ownership 应用快速接入、TypeScript 示例、审批和状态查询 | `docs/sdk/Ownership-SDK集成指南.md` L1-154 |
+| legacy Ownership 自动 proof、identity 托管、代上传、解绑和恢复流程图 | `docs/sdk/Ownership-SDK集成指南.md` L156-270 |
+| legacy Ownership 实现/移植、proof 验签、escrow、metadata 和 rekey 恢复 | `docs/sdk/Ownership-SDK实现指南.md` L1-154；验收入口 L156-169 |
+| legacy Ownership wire schema、agent.md、identity escrow 和 owner 授权头 | `docs/protocol/Ownership协议定义.md` L9-401；本地事件/状态与校验 L402-445 |
+| legacy 四端 ownership API、proof、托管、代上传、release 与恢复记录 | `docs/sdk/Ownership管理专题.md` L1-559 |
+| Ownership 2.1 当前格式更正、reset、历史兼容与验证边界 | `docs/audit/Ownership2.1代码审查报告.md` L1431-1470；第十六至二十一节保留阶段记录 |
+| Credential/Org 应用集成：service-plane、验证/登记、admission、实体主签与 owner 上传、转让恢复和解散清理 | `docs/sdk/凭证与组织服务SDK应用集成指南.md` L7-18、L32-124、L126-152、L162-173 |
+| Credential/Org SDK 开发与移植：CAP、请求绑定、四端 facade/RPC、实体多签与 checkpoint 恢复、共同向量 | `docs/sdk/凭证与组织服务SDK开发与移植指南.md` 1. L7-17；2. L18-41；3. L42-82；4. L83-112；5. L113-144；6. L145-157；7. L158-175；8. L176-189；9. L190-211 |
+| Credential Service 实际 RPC、请求绑定、登记/吊销和签名状态证明 | `docs/sdk/09-凭证服务RPC手册.md` L1-71 |
+| Org Service 实际生命周期/成员/凭证/审计 RPC、内部接口和未实现占位 | `docs/sdk/09-组织服务RPC手册.md` L1-88 |
 | 本机 AUN 环境怎么选、如何避免 Compose/MySQL 混用 | `docs/aun测试运行指南.md` L9-80 |
 | `agentid.pub/evolagent.cn` 本地单实例和四语言 Tester 怎么跑 | `docs/aun测试运行指南.md` L81-317、L501-827 |
-| `evolagent.cn` / `agentid.pub` 等公网域的 Python SDK 测试怎么跑 | `docs/aun公网测试运行指南.md` L57-157 |
-| 公网测试与本地 Docker 数据如何隔离 | `docs/aun公网测试运行指南.md` L23-65 |
-| 公网 TLS、报告与服务端 12 项验收 | `docs/aun公网测试运行指南.md` L171-227 |
+| `evolagent.cn` / `agentid.pub` 等公网域的 Python SDK 测试怎么跑 | `docs/aun公网测试运行指南.md` L57-157 |
+| 公网测试与本地 Docker 数据如何隔离 | `docs/aun公网测试运行指南.md` L23-65 |
+| 公网 TLS、报告与服务端 12 项验收 | `docs/aun公网测试运行指南.md` L171-227 |
 | 真实双域线上单节点与分布式测试环境如何区分 | `docs/aun分布式测试运行指南.md` L12-45 |
 | 当前 worktree 的 data-dist 接管、三节点、分布式 Tester 和来源核验怎么跑 | `docs/aun分布式测试运行指南.md` L46-484 |
 | 本地 `agentid.pub/agentid.cn` 双域 Docker、固定身份双挂载 runner、P2P/Group/Storage 验收与日志判定 | `docs/aun分布式测试运行指南.md` L491-739 |
 | 公网 `agentid.pub/agentid.cn` 固定身份注册、TLS 双域复测与线上镜像门禁 | `docs/aun分布式测试运行指南.md` L740-820 |
 | 隔离 `dist-aid.com/dist-aid.net` federation 怎么跑 | `docs/aun分布式测试运行指南.md` L821-930 |
-| 10 个 AUN 服务 Go/Python 调用链、RPC 字段及并发/安全/性能终审 | `docs/audit/AUN服务Go化重构精细化源码审查-20260718.md` L10-27、L28-53、L54-188、L189-205、L206-222、L223-303、L304-345、L346-357、L358-366 |
-| AUNClient 巨类拆分重构执行方案 | `docs/design/AUNClient拆分重构执行方案.md` L3-252、L253-698、L699-803 |
+| 10 个 AUN 服务 Go/Python 调用链、RPC 字段及并发/安全/性能终审 | `docs/audit/AUN服务Go化重构精细化源码审查-20260718.md` L10-27、L28-53、L54-188、L189-205、L206-222、L223-303、L304-345、L346-357、L358-366 |
+| AUNClient 巨类拆分重构执行方案 | `docs/design/AUNClient拆分重构执行方案.md` L3-252、L253-698、L699-803 |
 | AUNClient 完全门面化与 Runtime 状态迁移细化方案 | `docs/design/AUNClient门面化与Runtime状态迁移细化方案.md` |
 | A/T/H、Tail/Forward、Group 成员可见性下界、History、缺 sender IK 有界同步 bootstrap、页内唯一有序发布、应用层跨页幂等排序、Pull Gate 与兼容边界 | `docs/消息同步与历史拉取改造方案.md` L7-375 |
 | 消息同步 TDD、Gateway、兼容性和分布式 E2E 门禁 | `docs/消息同步与历史拉取改造方案.md` L434-750 |
@@ -71,10 +76,10 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | TypeScript 接入跨设备已读未读、单调事件、`read_state_sync`、精确整数、映射状态和错误处理 | `docs/跨设备已读未读SDK集成指南.md` L1-207 |
 | 四端及其它语言 SDK 实现/移植、迁移重试、请求级批写、身份隔离、精确整数、本地完成事件和测试验收 | `docs/跨设备已读未读SDK实现移植指南.md` L1-331 |
 | 跨设备已读未读问题修复闭环、文档与四端 SDK 对齐、本轮隔离回归及历史 Docker 验证边界 | `docs/跨设备已读未读代码审查报告.md` L1-252 |
-| P2P device 定向发送、TTL volatile 消息、SDK 自动游标/ACK/去重与公开事件字段 | `docs/sdk/06-API手册.md`、`docs/sdk/09-message-rpc-manual.md` |
+| P2P peer 能力、完整轻量 pending peers/可选整体估计快照、目录/Pull逐页next_pending_seq/可靠commit后更新与每N次FIFO、peer ACK/slot 公共 S、need_render/页内计数、device 定向发送及 TTL volatile | `docs/sdk/02-WebSocket协议.md` L116-142；`docs/sdk/09-message-rpc-manual.md` L340-581、L738-751；`docs/sdk/06-API手册.md` |
 | 当前实现的代码审查结论、P0/P1/P2 问题与跨语言差异 | `docs/消息同步与历史拉取代码审查问题清单.md` L3-207 |
 | 消息同步问题修复顺序与已排除误报 | `docs/消息同步与历史拉取代码审查问题清单.md` L208-229 |
-| SDK 中如何使用 History、理解页内发布边界、缺 sender IK 有界同步 bootstrap、应用幂等、坏密文推进和 Piggy ACK | `docs/sdk/03-核心概念.md` L60-80、`docs/sdk/05-E2EE加密通信.md` L33-56、`docs/sdk/08-最佳实践.md` L89-116、`docs/sdk/09-message-rpc-manual.md` L278-395、`docs/sdk/09-group-rpc-manual.md` L1431-1501、L1700-1767 |
+| SDK peer A/T/H、稀疏覆盖/前驱、human Tail、N=4 Gate、后台续拉、50k 内存去重/应用持久幂等与 History/ACK | `docs/sdk/03-核心概念.md` L60-80；`docs/sdk/05-E2EE加密通信.md` L33-59、L294-316；`docs/sdk/08-最佳实践.md` L89-116；`docs/sdk/09-message-rpc-manual.md` L340-581；`docs/sdk/09-group-rpc-manual.md` L1434-1508、L1707-1774 |
 | 测试环境数据保护规则 | `docs/aun测试运行指南.md` L145-161 |
 | 默认单实例 Docker 服务端、Tester 和常规测试命令 | `docs/aun测试运行指南.md` L171-317、L501-827 |
 | 断网依赖准备、Go 1.24 和 Tester 复用纪律 | `docs/aun测试运行指南.md` L103-144、L171-317、`docs/aun分布式测试运行指南.md` L318-484 |
@@ -87,20 +92,20 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 何时 rebuild / recreate / restart | `docs/aun测试运行指南.md` L834-900 |
 | 双域固定材料、三文件线上镜像替换包、一次性初始化辅助包、开箱默认值、可选生产覆盖和线上单节点部署 | `docs/aun测试运行指南.md` L909-965 |
 | 测试故障排查 | `docs/aun测试运行指南.md` L967-994、`docs/aun分布式测试运行指南.md` L998-1004 |
-| 跨语言容器 E2E 背景与目标 | `docs/design/跨语言容器E2E测试方案.md` L5-35 |
-| E2EE V2 1DH/per-AID wrap 方案 | `docs/design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md` |
+| 跨语言容器 E2E 背景与目标 | `docs/design/跨语言容器E2E测试方案.md` L5-35 |
+| E2EE V2 1DH/per-AID wrap 方案 | `docs/design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md` |
 | E2EE V2 当前 P2P/Group 主链路 | `docs/sdk/E2EE_V2消息通信时序图.md` |
 | `protected_headers` / ProtectedHeaders 四端用法、E2EE V2 元数据 HMAC 和接收信任边界 | `docs/sdk/ProtectedHeaders用法专题.md` L1-299 |
-| Ownership 2.1 Storage 权威读取、不可复用路径修订、条件写删与上传 session | `docs/protocol/11-Storage-子协议.md` L32-40；`docs/sdk/09-storage-rpc-manual.md` L129-137 |
-| legacy Ownership proof、托管持久化、owner 代签与代上传历史记录 | `docs/sdk/Ownership管理专题.md` L1-559 |
+| Ownership 2.1 owner.md 同会话 create_upload_session→HTTP PUT→complete_upload、expected_version 发布 CAS；object_id/version 非读取条件 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` L191-210；`docs/protocol/11-Storage-子协议.md` L32-40；`docs/sdk/09-storage-rpc-manual.md` L129-135、L565-648 |
+| legacy Ownership proof、托管持久化、owner 代签与代上传历史记录 | `docs/sdk/Ownership管理专题.md` L1-559 |
 | 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
-| 服务端消息通信 P0 诊断面板 | `docs/design/服务端消息通信诊断面板P0方案.md` L3-73 |
+| 服务端消息通信 P0 诊断面板 | `docs/design/服务端消息通信诊断面板P0方案.md` L3-73 |
 | P2P / Group 消息 inbox 统一迁移与旧表清理 | `docs/design/消息收件箱统一迁移方案.md` |
 | 离线 Push Service 目标、职责、主链路和通信平面 | `docs/superpowers/specs/2026-07-24-push-service-design-v3.md` L7-75 |
 | 离线 Push Service 协议、持久状态机、调度、生产者、安全、生命周期和验证范围 | `docs/superpowers/specs/2026-07-24-push-service-design-v3.md` L78-265 |
 | `query_sessions`、Push RPC/ACK、状态汇总、dispatch 恢复、Gateway ACL、关闭顺序、横向约束和 TDD 执行原则的冻结契约 | `docs/superpowers/契约冻结-v3-to-v4.md` L15-273 |
 | 离线 Push Service 相关文档、实施原则、Phase/Task TDD 门禁及 9 个 Phase、40 个 Task | `docs/superpowers/plans/2026-07-24-push-service-implementation-v4.md` L5-213 |
-| Python SDK 的 `connect()` 自动登记和 `client.push.register/unregister` 运行期接口 | `docs/sdk/04-连接与认证.md` L125-150、`docs/sdk/06-API手册.md` L664-689 |
+| Python SDK 的 `connect()` 自动登记和 `client.push.register/unregister` 运行期接口 | `docs/sdk/04-连接与认证.md` L127-154、`docs/sdk/06-API手册.md` L816-843 |
 | owner relation 的 Storage 备份目录、ACL 撤销与状态查询 | `docs/sdk/09-storage-rpc-manual.md`、`docs/protocol/11-Storage-子协议.md` |
 | 终端客户端和 Push Server 如何接入，以及如何使用 Python Mock 完成隔离演示 | `docs/AUN离线推送接入与演示指南.md` L7-250 |
 | 离线推送接入验收、常见问题和生产硬门 | `docs/AUN离线推送接入与演示指南.md` L252-290 |
@@ -109,22 +114,22 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 离线 Push Service 当前发布结论与强制发布门 | `docs/AUN离线推送服务运维与发布指南.md` L5-23 |
 | 离线 Push Service 运行依赖、诊断和告警判断 | `docs/AUN离线推送服务运维与发布指南.md` L25-81 |
 | 离线 Push Service 性能基线、安全边界、隔离 PoC 灰度、回滚和已知限制 | `docs/AUN离线推送服务运维与发布指南.md` L83-141 |
-| group.index 签名索引、`_meta.group_indexes`、CAS 更新和服务端缓存注入 | `docs/design/群索引版本提示与附件引用方案.md` L1-348、`docs/INDEX.md` L55、L153、L298-301 |
-| AUN Service Proxy 总体架构、参考项目与边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L3-127 |
-| AUN Service Proxy URL、注册、隧道协议和 Web 边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L129-384 |
-| AUN Service Proxy 服务列表注册、双注册和 wakeup 路由 | `docs/sdk/09-proxy-rpc-manual.md` L1-226、`docs/protocol/06-服务协议.md` L43-204 |
-| AUN Service Proxy 不影响现有接口的约束 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L385-422 |
-| AUN Service Proxy TDD 分阶段实施计划 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L424-906 |
-| 跨语言 Docker 拓扑 | `docs/design/跨语言容器E2E测试方案.md` L37-76 |
-| 共享测试向量、CLI transcript、单域/双域分层 | `docs/design/跨语言容器E2E测试方案.md` L78-147 |
-| test-runner 如何控制不同语言 client | `docs/design/跨语言容器E2E测试方案.md` L149-158 |
-| test-control HTTP API | `docs/design/跨语言容器E2E测试方案.md` L160-305 |
-| 客户端容器要求和 Compose 建议 | `docs/design/跨语言容器E2E测试方案.md` L307-411 |
-| test-runner 标准用例流程 | `docs/design/跨语言容器E2E测试方案.md` L413-440 |
+| group.index 签名索引、`_meta.group_indexes`、CAS 更新和服务端缓存注入 | `docs/design/群索引版本提示与附件引用方案.md` L1-348、`docs/INDEX.md` L61、L166、L311-314 |
+| AUN Service Proxy 总体架构、参考项目与边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L3-127 |
+| AUN Service Proxy URL、注册、隧道协议和 Web 边界 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L129-384 |
+| AUN Service Proxy 服务列表注册、双注册和 wakeup 路由 | `docs/sdk/09-proxy-rpc-manual.md` L1-226、`docs/protocol/06-服务协议.md` L43-204 |
+| AUN Service Proxy 不影响现有接口的约束 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L385-422 |
+| AUN Service Proxy TDD 分阶段实施计划 | `docs/design/AUN反向代理服务方案与TDD实施计划.md` L424-906 |
+| 跨语言 Docker 拓扑 | `docs/design/跨语言容器E2E测试方案.md` L37-76 |
+| 共享测试向量、CLI transcript、单域/双域分层 | `docs/design/跨语言容器E2E测试方案.md` L78-147 |
+| test-runner 如何控制不同语言 client | `docs/design/跨语言容器E2E测试方案.md` L149-158 |
+| test-control HTTP API | `docs/design/跨语言容器E2E测试方案.md` L160-305 |
+| 客户端容器要求和 Compose 建议 | `docs/design/跨语言容器E2E测试方案.md` L307-411 |
+| test-runner 标准用例流程 | `docs/design/跨语言容器E2E测试方案.md` L413-440 |
 | Python / TypeScript / Go / JavaScript 跨 SDK 测试矩阵与 group.index 覆盖 | `docs/aun测试运行指南.md` L103-117、L318-500 |
-| 跨语言日志、trace、身份隔离、CLI 定位 | `docs/design/跨语言容器E2E测试方案.md` L514-576 |
-| 失败分类与落地阶段 | `docs/design/跨语言容器E2E测试方案.md` L579-625 |
-| 与现有测试环境的关系和验收标准 | `docs/design/跨语言容器E2E测试方案.md` L627-665 |
+| 跨语言日志、trace、身份隔离、CLI 定位 | `docs/design/跨语言容器E2E测试方案.md` L514-576 |
+| 失败分类与落地阶段 | `docs/design/跨语言容器E2E测试方案.md` L579-625 |
+| 与现有测试环境的关系和验收标准 | `docs/design/跨语言容器E2E测试方案.md` L627-665 |
 | agent.md 远程缓存目标与字段 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L5-127 |
 | agent.md ETag 透传时序图 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L129-239 |
 | agent.md 服务端与 SDK 实现流程 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L241-319 |
@@ -134,25 +139,26 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | AID owner 完整设计、Schema 可选性与 human owner 限制、三字段共同声明与 self-owner 单签、Phase 0 已确认的 P0-A01 至 P0-A12（canonical JSON、可见分号域分隔符、签名封套、proof-only/registered、Auth receipt、TTL、证书状态与关系 operation 分离、legacy/绑定中基本登录通信及按应用场景降级、旧 AID `aid_bind` 与新建 `aid_register` 的 RPC/Facade 边界、active/pending 唯一性检查、创建/绑定/换 owner/解绑、`unbound`/`unusable`、服务端/四端 SDK 改动和分阶段验收；剩余为正式 wire/RPC 文档与跨端向量落稿 | `docs/agent.md/working/AID类型-owner关系完整设计与实施计划.md` |
 | 本轮 owner 关系实施及本地 Docker、单域、cross-SDK、双域 federation 回归中发现的非任务失败、根因、修复与验证 | `docs/agent.md/working/本地Docker测试Bug清单.md` |
 | SDK API、RPC、E2EE、Storage VFS、Group FS、Collab GC/reflog/reset 使用细节 | `docs/sdk/AUN_DOCS_GUIDE.md` |
-| 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 | `docs/sdk/04-连接与认证.md` L94-123、`docs/sdk/06-API手册.md` L192-209、`docs/sdk/09-storage-rpc-manual.md` L621-663、`docs/sdk/09-group-rpc-manual.md` L1599-1604、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
+| 四 SDK resolve opts、完整输入输出、frontmatter 字段/类型、按需 ownership 共识及 owner.md 快照与 TTL | `docs/sdk/06-API手册.md` L86-203；`docs/sdk/04-连接与认证.md` L233-243 |
+| 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 | `docs/sdk/04-连接与认证.md` L96-125、`docs/sdk/06-API手册.md` L327-346、`docs/sdk/09-storage-rpc-manual.md` L610-691、`docs/sdk/09-group-rpc-manual.md` L1606-1611、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
 | 四 SDK 0.5.6 发布摘要、验签缓存、消息窗口与语言能力边界 | `docs/sdk/CHANGELOG-0.5.6.md` L1-73 |
-| 四 SDK 0.5.19 的跨设备已读未读、Ownership 2.1、凭证与组织服务、代码/测试落点和语言差异 | `python/CHANGES_FOR_PARITY.md` L11-173 |
+| 四 SDK 0.5.21 相对发布 0.5.20 的 peer Pull、batch／背压／ACK、Ownership 兼容与 reset、凭证续期撤销、checkpoint、诊断及语言边界、resolve 元数据与 ownership 缓存 | `python/CHANGES_FOR_PARITY.md` L11-127 |
 | 群 `mention_mode` 提及过滤、Agent 自主行为、SDK group.index facade 和 CAS 冲突处理 | `docs/protocol/10-Group-子协议.md`、`docs/protocol/13-Agent行为规范.md`、`docs/sdk/09-group-rpc-manual.md`、`docs/sdk/07-错误处理.md` |
 | AUN Python CLI 源码位置、安装入口、全局选项、profile 配置和主要命令集 | `docs/cli/CLI手册.md` L3-333 |
-| AUN Python CLI 当前实现架构、命令注册、SDK 桥接和实现边界 | `docs/cli/AUN-CLI设计文档.md` L3-265 |
+| AUN Python CLI 当前实现架构、命令注册、SDK 桥接和实现边界 | `docs/cli/AUN-CLI设计文档.md` L3-265 |
 | AUN Storage 架构、SDK VFS、direct backend 数据面、类 Linux 权限和 mount/symlink | `docs/aun-fs/AUN Storage架构设计.md` L16-47、L74-120、L153-166、L192-237、L298-324 |
-| AUN Storage SDK VFS / LowLevel 接口契约和错误映射 | `docs/aun-fs/SDK存储分层设计.md` L20-112、L169-317 |
-| AUN Storage CLI `aun fs` 命令语义和输出格式 | `docs/aun-fs/CLI-fs命令设计.md` L26-61、L89-207、L279-399 |
-| AUN Storage 分阶段 TDD 计划、P1/P2/P3/P4/P5/P6 执行记录、P6 mount/umount 验收和阶段验证纪律 | `docs/aun-fs/分阶段实施计划.md` L24-37、L108-1013、L1015-1071 |
-| AUN FS POSIX 覆盖现状、过期状态修正、缺口优先级和 step-by-step TDD 补全计划 | `docs/aun-fs/aun-fs-posix-coverage.md` L14-224、`docs/aun-fs/aun-fs-completion-plan.md` L9-66、L93-142、L144-257、L259-353、L355-608、L698-790 |
-| group.fs POSIX 化群文件系统详细设计、memberdata 服务端映射、SDK 数据面编排、群自有区角色 ACL 授权/撤销/查询、`parents` 和 `cp/mv` 语义 | `docs/aun-fs/group-fs/group.fs-POSIX化详细设计.md` L1-611 |
-| 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销、Storage 写审计和 TDD 计划 | `docs/aun-fs/group-fs/群自有区角色ACL写权限实施方案.md` |
-| `memberdata` / `group_data` 系统目录保护、`group_data` 目录树隐藏与读下载/写保护边界、Group FS 授权路径和配额归属 | `docs/protocol/16-系统目录保护方案.md` |
-| group.fs POSIX 化分阶段实施计划、每阶段 IPO、Step-by-step、用例集、Checklist、验收、回滚和 Phase 8 Docker 完成记录 | `docs/aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md` L1-1324 |
-| collab 协作层使用心智模型和命令语义 | `docs/aun-fs/collab/30-collab.md` L7-194 |
-| collab 服务端编排设计、台账、RPC、diff3、snapshot 和 SDK 薄封装 | `docs/aun-fs/collab/2026-06-10-collab层服务端编排详细设计.md` L10-416 |
-| collab Plan 1 服务端基础 TDD 任务 | `docs/aun-fs/collab/2026-06-10-collab服务端编排-plan1.md` L1-2304 |
-| collab Plan 2 Python SDK/CLI 与单域 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan2.md` L1-132 |
-| collab Plan 3 Go/TS/JS 与跨语言 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan3.md` L1-154 |
-| Notify 在线轻量通知 / 跨域 federation 方案 | `docs/sdk/Notify通知方案.md` |
-
+| AUN Storage SDK VFS / LowLevel 接口契约和错误映射 | `docs/aun-fs/SDK存储分层设计.md` L20-112、L169-317 |
+| AUN Storage CLI `aun fs` 命令语义和输出格式 | `docs/aun-fs/CLI-fs命令设计.md` L26-61、L89-207、L279-399 |
+| AUN Storage 分阶段 TDD 计划、P1/P2/P3/P4/P5/P6 执行记录、P6 mount/umount 验收和阶段验证纪律 | `docs/aun-fs/分阶段实施计划.md` L24-37、L108-1013、L1015-1071 |
+| AUN FS POSIX 覆盖现状、过期状态修正、缺口优先级和 step-by-step TDD 补全计划 | `docs/aun-fs/aun-fs-posix-coverage.md` L14-224、`docs/aun-fs/aun-fs-completion-plan.md` L9-66、L93-142、L144-257、L259-353、L355-608、L698-790 |
+| group.fs POSIX 化群文件系统详细设计、memberdata 服务端映射、SDK 数据面编排、群自有区角色 ACL 授权/撤销/查询、`parents` 和 `cp/mv` 语义 | `docs/aun-fs/group-fs/group.fs-POSIX化详细设计.md` L1-611 |
+| 群自有区 owner 默认写、admin 需 owner 显式 `role:admin` ACL 授权与撤销、Storage 写审计和 TDD 计划 | `docs/aun-fs/group-fs/群自有区角色ACL写权限实施方案.md` |
+| `memberdata` / `group_data` 系统目录保护、`group_data` 目录树隐藏与读下载/写保护边界、Group FS 授权路径和配额归属 | `docs/protocol/16-系统目录保护方案.md` |
+| group.fs POSIX 化分阶段实施计划、每阶段 IPO、Step-by-step、用例集、Checklist、验收、回滚和 Phase 8 Docker 完成记录 | `docs/aun-fs/group-fs/group.fs-POSIX化分阶段实施计划.md` L1-1324 |
+| collab 协作层使用心智模型和命令语义 | `docs/aun-fs/collab/30-collab.md` L7-194 |
+| collab 服务端编排设计、台账、RPC、diff3、snapshot 和 SDK 薄封装 | `docs/aun-fs/collab/2026-06-10-collab层服务端编排详细设计.md` L10-416 |
+| collab Plan 1 服务端基础 TDD 任务 | `docs/aun-fs/collab/2026-06-10-collab服务端编排-plan1.md` L1-2304 |
+| collab Plan 2 Python SDK/CLI 与单域 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan2.md` L1-132 |
+| collab Plan 3 Go/TS/JS 与跨语言 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan3.md` L1-154 |
+| Notify 在线轻量通知 / 跨域 federation 方案 | `docs/sdk/Notify通知方案.md` |
+

package/_packed_docs/agent.md/SCHEMA.md

@@ -5,12 +5,12 @@ Ownership 版本: 2.0.0
 
 本文保留 legacy Ownership 2.0 的文件格式与字段，不是当前 2.1 Schema。Ownership 2.0 的 ownership 声明由整个文件尾部签名保护；本文的第三方存储写删授权、sub 单方撤销及无关系版本示例仅适用于该历史版本。当前 2.1 的完整文件、角色、关系版本、owner 锁与六态结果以 [Ownership 协议定义 2.1](../protocol/Ownership协议定义2.1.md) 为准。
 
-当前 `group/org` 是独立生命周期分支：owner 必填，无 ownership 合法，通用 ownership/proof/release 禁止；仅当前 owner 以本人证书和私钥尾签并代上传，尾部必含 `signer_aid=owner`。V2 授权、实体证书代际和恢复以 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的-owner-代签与上传) 为准。下文 legacy 的 owner/ownership 成对及目标本人签名规则不得套用于当前 Group/Org。
+当前 `group/org` 是独立生命周期分支：owner 必填，无 ownership 合法，通用 ownership/proof/release 禁止；实体私钥生成主签，当前 owner 以本人 token 上传，可选 owner 附签且存在必须验证；Group 旧实体单签及实体身份上传持续兼容，Org 不开放。通用多签、实体证书代际和恢复以 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传) 为准。下文 legacy 的 owner/ownership 成对及目标本人签名规则不得套用于当前 Group/Org。
 
 ## 限制
 
 - **文件大小**: 被签名 payload 最大 4KB（尾部签名块不计入）
-- **签名块大小**: 尾部签名载体最大 2KB（2048 字节，按 UTF-8 原始字节计算）
+- **签名块大小**: 全部尾签区合计最大 2KB（2048 字节，含块间及尾部空白，按 UTF-8 原始字节计算）
 - **请求读取上限**: `PUT /agent.md` 最多读取 `payload_max + signature_max` 字节；超出即返回 `413 agent_md_too_large`
 - **编码**: UTF-8
 
@@ -59,11 +59,11 @@ signature: <base64_der>
 - `timestamp` 必填，为签名时的 Unix 秒时间戳。
 - `signature` 必填，为 ECDSA P-256 / SHA-256 DER 签名的严格 Base64 表示。
 
-签名输入是签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部原始 UTF-8 字节；换行和空白不得规范化。签名块必须是文件最后一个可见块，后面只允许空白。
+允许连续多尾块。第 i 块签署文件起点至本块 `<` 前的完整原始 UTF-8 prefix；第一块仍只签正文，后续块含前序完整块与分隔空白。append 仅向已有链追加才在末字节非 LF/CR 时补 LF 并纳入新块输入；无旧块按首签要求正文以 CR/LF 结束，否则拒绝。块间及末块后只允许空白，不规范化换行。顺序受后续签名保护；移除末端块可形成有效短链，verify 只返回实际列表且必须全块验签。
 
-签名块标识使用 `<!-- AUN-SIGNATURE` 前缀，可选追加大写 TAG（例如 `<!-- AUN-SIGNATURE-AGENTMD-V2` 或 `<!-- AUN-SIGNATURE-OWNERSHIP-V2`）。`agent.md` 的尾部签名证书必须属于 frontmatter `aid` 对应的 sub_aid；`owner.md` 的尾部签名证书必须属于 frontmatter `owner_aid`。验证方按证书指纹取得公钥，并确认签署者 AID、证书有效期和签名算法均符合要求。
+签名块标识使用 `<!-- AUN-SIGNATURE` 前缀，可选追加大写 TAG（例如 `<!-- AUN-SIGNATURE-AGENTMD-V2` 或 `<!-- AUN-SIGNATURE-OWNERSHIP-V2`）。`agent.md` 的主签证书必须属于 frontmatter `aid` 对应的 sub_aid；`owner.md` 的主签证书必须属于 frontmatter `owner_aid`。验证方按证书指纹取得公钥，并确认签署者 AID、证书有效期和签名算法均符合要求。
 
-签名块只能包含上述四个字段；除 `public_key_fingerprint` 外均为必填；重复字段和未知字段必须拒绝。`timestamp` 最多允许比服务端时间快 300 秒，并且必须落在签署证书有效期内。服务端须在数据库或缓存写入前完成全部校验。
+各块仅允许上述四字段及 `signer_aid`；附签必填与该块证书 AID 一致的 `signer_aid`，通用容器可解析主块可选 signer_aid；普通 agent.md／owner.md 主块不输出且业务拒绝该字段，实体主块显式 signer_aid=target。除可选 `public_key_fingerprint` 外其余字段必填，重复及未知字段拒绝。TAG 为 `[A-Z0-9-]+` 字面后缀，空串无后缀，传短 tag，AUN-SIGNATURE 不作特殊选项，不授予角色或权限；证书沿用可信 resolver 按指纹获取。通用 Store document 签验不判断 YAML 业务，资源角色及授权由调用者检查。`timestamp` 最多允许比服务端时间快 300 秒，并且必须落在签署证书有效期内。服务端须在数据库或缓存写入前完成全部校验。
 
 ## YAML Schema（`agent.md` 核心字段）
 
@@ -259,8 +259,8 @@ YAML 只保留核心元数据，详细信息放在 Markdown 部分：
 解析时先检测并剥离尾部签名块，再按 YAML frontmatter 解析：
 
 ```text
-1. 定位唯一的 `<!-- AUN-SIGNATURE[-TAG]` 块。
-2. 取签名块之前的原始字节作为 payload 并验签。
+1. 定位连续 `<!-- AUN-SIGNATURE[-TAG]` 尾块并保留原字节边界。
+2. 取首块前字节为 payload，逐块验各自之前的完整 prefix。
 3. 解析 payload 的 YAML frontmatter。
 4. 对 agent.md 按 aid 校验；对 owner.md 按 owner_aid、sub_aid 和路径校验。
 ```