@agentunion/fastaun-browser 0.5.17 → 0.5.19

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -8,20 +8,20 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 
 ### Step 1：先读根级 Layer 1
 
-- `docs/INDEX.md` L7-59：根级文档地图。
+- `docs/INDEX.md` L7-88：根级文档地图。
 
 ### Step 2：按主题读根级 Layer 2
 
-- 测试与 E2E：`docs/INDEX.md` L63-76。
-- 服务端 Go 化重构审查：`docs/INDEX.md` L78-80。
-- SDK 使用与协议：`docs/INDEX.md` L82-104。
-- Service Proxy 与服务暴露：`docs/INDEX.md` L106-111。
-- 诊断与可观测性：`docs/INDEX.md` L113-120。
-- E2EE 与跨语言一致性：`docs/INDEX.md` L122-126。
+- 测试与 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` L130-274：重点文档摘要。
+- `docs/INDEX.md` L180-426：重点文档摘要。
 
 ### Step 4：再读目标文档章节
 
@@ -29,8 +29,26 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 
 ## 常见查阅场景
 
-| 场景 | 推荐读取 |
-| --- | --- |
+| 场景 | 推荐读取 |
+| --- | --- |
+| 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 |
 | 本机 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 |
@@ -47,10 +65,16 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | A/T/H、Tail/Forward、Group 成员可见性下界、History、缺 sender IK 有界同步 bootstrap、页内唯一有序发布、应用层跨页幂等排序、Pull Gate 与兼容边界 | `docs/消息同步与历史拉取改造方案.md` L7-375 |
 | 消息同步 TDD、Gateway、兼容性和分布式 E2E 门禁 | `docs/消息同步与历史拉取改造方案.md` L434-750 |
 | P2P 消息 `ttl` 秒级钳制、volatile 双游标、device 收件箱、隐藏 slot lease/ACK、epoch 文件、消息调试计数器与 payload type 分类和四 SDK/双域测试方案 | `docs/design/P2P消息TTL内存缓存方案.md` L1-369 |
+| 跨设备 P2P/Group 按话题同步已读位置、AID 汇总、设备 seq 映射及补偿完成交付 | `docs/跨设备已读未读方案.md` L1-273 |
+| 跨设备已读未读 RPC、紧凑状态表、公共顺序、请求级提交、混合域部分提交、四端 SDK 缓存和本地完成事件 | `docs/跨设备已读未读详细设计.md` L1-209 |
+| 跨设备已读未读 TDD 阶段、迁移/批写、断点续跑、测试矩阵、历史部署记录和本轮完成定义 | `docs/跨设备已读未读实施计划.md` L1-156 |
+| 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` |
 | 当前实现的代码审查结论、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` L1282-1353、L1547-1605 |
+| 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 |
 | 测试环境数据保护规则 | `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 |
@@ -65,15 +89,19 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 测试故障排查 | `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` |
-| E2EE V2 当前 P2P/Group 主链路 | `docs/sdk/E2EE_V2消息通信时序图.md` |
-| 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
+| 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 |
+| 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
 | 服务端消息通信 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` L643-670 |
+| Python SDK 的 `connect()` 自动登记和 `client.push.register/unregister` 运行期接口 | `docs/sdk/04-连接与认证.md` L125-150、`docs/sdk/06-API手册.md` L664-689 |
+| 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 |
 | 离线推送 RPC、事件、批次 ACK、持久恢复和发布边界 | `docs/protocol/15-离线推送通知协议.md` L27-165 |
@@ -81,7 +109,7 @@ 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` L29、L104、L200-202 |
+| 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 |
@@ -97,14 +125,18 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 跨语言日志、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 |
+| 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 |
 | agent.md 本地持久化、竞态和测试点 | `docs/agent.md/远程agent.md缓存与etag透传方案.md` L321-370 |
+| agent.md Schema、三字段关系声明与 self-owner 单签、公开 proof 独立验签、owner 关系写入经 Auth 验证与冲突仲裁、事实摘要与 nonce/编排上下文分层、Auth 登记见证与回执、证书/关系状态分离，以及 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限决策 | `docs/agent.md/working/agent.md-schema与签发验签流程澄清.md` |
+| AID Schema owner/proof 可选但出现即合法、human 禁止 owner；共同签署字段为 proof_id/subject_aid/owner_aid，self-owner 仅 subject 单签，事实摘要排除 nonce、完整声明摘要绑定 proof，使用可见分号域分隔符；Auth 登记机构托管证据并签发回执，旧 AID 通过 `aid_bind` 建立 type/owner 绑定且基本登录通信不受限，公开关系声明与 Auth 关系写入边界、未解除关系唯一性检查、转移授权、`unbound`/`unusable`、Storage 内部对象权限和无专门 recovery | `docs/agent.md/working/AID类型-owner关系与换owner编排方案.md` |
+| 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` L1448-1452、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
+| 四 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 0.5.6 发布摘要、验签缓存、消息窗口与语言能力边界 | `docs/sdk/CHANGELOG-0.5.6.md` L1-73 |
-| 四 SDK 版本差异、跨语言对齐优先级、agent.md `description` 可选字段及版本落点 | `python/CHANGES_FOR_PARITY.md` L11-54 |
+| 四 SDK 0.5.19 的跨设备已读未读、Ownership 2.1、凭证与组织服务、代码/测试落点和语言差异 | `python/CHANGES_FOR_PARITY.md` L11-173 |
 | 群 `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 |

package/_packed_docs/agent.md/SCHEMA.md

@@ -1,207 +1,266 @@
-# Agent.md 规格定义
-
-版本: 1.0.0
-
-## 限制
-
-- **文件大小**: 被签名 payload 最大 4KB（尾部签名块不计入）
-- **签名块大小**: 尾部签名载体最大 2KB（2048 字节，按 UTF-8 原始字节计算）
-- **请求读取上限**: `PUT /agent.md` 最多读取 `payload_max + signature_max` 字节；超出即返回 `413 agent_md_too_large`，不执行证书查询、数据库或缓存写入
-- **编码**: UTF-8
-
-## 文件格式
-
-agent.md 文件采用 **YAML frontmatter + Markdown 内容 + 签名块（必需，位于文件尾部）** 的格式：
-
-```markdown
----
-# YAML 元数据 (核心字段)
-aid: "agent-name.aid.pub"
-name: "Agent Name"
-type: "agent"
-version: "1.0.0"
-description: "一句话描述"
-tags:
-  - tag1
-  - tag2
----
-
-# Markdown 正文内容
-详细说明、Skills、使用示例等...
-
-<!-- AUN-SIGNATURE
-cert_fingerprint: sha256:abc123...
-public_key_fingerprint: sha256:def456...
-timestamp: 1715300000
-signature: MEUCIQDx...
--->
-```
-
-上传接收契约要求签名块存在且有效；无签名文件只可作为本地草稿或只读示例，不得通过 `PUT /agent.md`。
-
-## 签名块规范
-
-### 位置
-
-文件尾部，位于 Markdown 正文之后。
-
-### 格式
-
-```
-<!-- AUN-SIGNATURE
-cert_fingerprint: sha256:<hex>
-public_key_fingerprint: sha256:<hex>
-timestamp: <unix_seconds>
-signature: <base64_der>
--->
-```
-
-- **cert_fingerprint**（必填）: X.509 证书 DER 的 SHA-256 指纹，格式 `sha256:<64位hex>`；不得使用公钥指纹代替
-- **public_key_fingerprint**（可选）: SubjectPublicKeyInfo DER 的 SHA-256 指纹，格式 `sha256:<64位hex>`
-- **timestamp**: 签名时刻的 Unix 时间戳（秒）
-- **signature**: ECDSA P-256 / SHA-256 签名的 DER 编码，使用严格 Base64 表示
-
-### 签名计算
-
-1. **被签内容（payload）**：签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部 UTF-8 字节，换行和空白均不得规范化
-2. **哈希**：对 payload 计算 SHA-256
-3. **签名**：使用证书对应的 NIST P-256 私钥执行 ECDSA 签名，结果采用 DER 编码
-
-### 验签流程
-
-1. 检测文件尾部是否存在且只能存在一个 `<!-- AUN-SIGNATURE` 签名块
-2. 提取签名块中的 `cert_fingerprint`、`timestamp`、`signature`
-3. 剥离签名块，取剩余内容为 payload
-4. 对 payload 计算 SHA-256
-5. 通过 `cert_fingerprint` 查找对应证书，获取公钥
-6. 确认证书公钥为 NIST P-256，并使用 ECDSA / SHA-256 验证签名
-
-### 约束
-
-- 签名块必须是文件的最后一个可见块（后面只允许可忽略的空白）
-- 签名块必须从新行开始，因此 payload 的最后一个原始字节必须是 `LF` 或 `CR`；SDK 不得自动补换行或改写 payload
-- frontmatter 与签名块均接受 `LF`、`CRLF` 或 `CR` 行尾；解析签名块时可识别行尾，但不得据此改写 payload
-- 签名块只能包含上述四个字段；除 `public_key_fingerprint` 外均为必填；重复字段和未知字段必须拒绝
-- 签名块不计入 4KB 文件大小限制，但自身不得超过 2048 字节；服务端必须在解析和证书查询前拒绝超限载体
-- `timestamp` 最多允许比服务端时间快 300 秒，不设置过去时间窗口，并且必须落在证书有效期内
-- `aid`、Host、Bearer Token 和签名证书 AID 必须一致
-- agent.md 上传签名算法固定为 ECDSA P-256 / SHA-256；其他曲线或密钥类型必须拒绝
-- 签名证书必须由当前 Issuer CA 返回，状态为 `active_signing` 且处于有效期内；证书 Subject CN 必须等于 AID
-- `PUT /agent.md` 成功验收后，文档不得仅因签名证书随后自然过期而失效；历史验签仍须确认 `timestamp` 落在该证书的有效期内
-- 服务端在数据库和缓存写入前完成全部校验；任一校验失败均拒绝接收
-
-## YAML Schema (核心字段)
-
-```yaml
-# ===== 身份标识 (必填) =====
-aid:
-  type: string
-  required: true
-  pattern: "^[A-Za-z0-9_][A-Za-z0-9_-]*(?:\\.[A-Za-z0-9_][A-Za-z0-9_-]*)+$"
-  description: "至少两个标签的 DNS 型 AID；Issuer 后缀不固定，比较时不区分大小写"
-  example: "lobster.agentid.pub"
-
-# ===== 基本信息 =====
-name:
-  type: string
-  required: true
-  description: "Agent 显示名称"
-  example: "Code Reviewer"
-
-type:
-  type: string
-  required: true
-  predefined_values:  # 预设值，不是封闭枚举
-    - human          # 真人用户
-    - agent          # AI 助手
-    - group          # 群组
-  allow_extensions: true
-  description: "Agent 类型；允许使用未预设的扩展值"
-
-version:
-  type: string
-  required: true
-  pattern: "^\\d+\\.\\d+\\.\\d+$"
-  example: "1.0.0"
-
-# ===== 描述信息 =====
-description:
-  type: string
-  required: false
-  max_length: 100
-  description: "一句话简介，用于列表展示"
-
-# ===== 头像 =====
-avatar:
-  type: string
-  required: false
-  max_length: 256
-  description: "头像地址或标识"
-
-# ===== 标签 =====
-tags:
-  type: array
-  required: false
-  items:
-    type: string
-  description: "用于分类和检索"
-```
-
-## Agent Type 说明
-
-`type` 是可扩展字符串。下表只定义当前预设值；解析方必须保留并容忍未知类型，不得因其不在预设列表中拒绝 agent.md。
-
-| 预设 Type | 用途 | 示例 |
-|------|------|------|
-| `human` | 真人用户 | 开发者、管理员、终端用户 |
-| `agent` | 通用 Agent | 对话助手、代码 Agent、自动化 Agent |
-| `group` | 群组身份 | 项目团队、协作群组 |
-
-## 示例文件
-
-| 文件 | Type | AID | 说明 |
-|------|------|-----|------|
-| [human-developer.md](examples/human-developer.md) | `human` | `zhangsan.aid.pub` | 全栈开发者 |
-| [openclaw-lobster.md](examples/openclaw-lobster.md) | `agent` | `lobster.aid.pub` | OpenClaw AI 助手（无签名） |
-| [signed-openclaw-lobster.md](examples/signed-openclaw-lobster.md) | `agent` | `lobster.aid.pub` | OpenClaw AI 助手（带签名） |
-| [codeagent-claudecode.md](examples/codeagent-claudecode.md) | `agent` | `claudecode.aid.pub` | Claude Code 编程助手 |
-| [群组-开发团队.md](examples/群组-开发团队.md) | `group` | `dev-team.aid.pub` | 开发团队协作群组 |
-
-表中无签名文件仅用于展示 payload 格式，不符合 `PUT /agent.md` 接收契约；静态签名示例也不代表可由线上 CA 验证的有效身份材料。
-
-## `PUT /agent.md` 接收顺序
-
-1. SDK 在联网前校验 UTF-8、payload 大小、frontmatter Schema；失败时不得签名或发起 HTTP 请求。
-2. SDK 使用当前 AID 的签名私钥追加签名块，再执行一次完整 Schema 校验和本地验签；失败时不得上传。
-3. Name Service 完成 Bearer Token 与 Host 绑定校验、完整 Schema 校验、CA 证书查询和验签。
-4. 只有全部校验成功后，Name Service 才能写入数据库并失效缓存。
-
-接收失败使用稳定的机器可读错误：格式或签名无效返回 `400 invalid_agent_md`，payload 超限返回 `413 agent_md_too_large`，CA 不可用返回 `503 certificate_verification_unavailable`，数据库不可用返回 `503 database_unavailable`。
-
-## Markdown 部分建议内容
-
-YAML 只保留核心元数据，详细信息放在 Markdown 部分：
-
-- **Skills** - 技能/命令列表及说明
-- **功能说明** - 详细的功能描述
-- **使用示例** - 具体的使用方法
-- **配置说明** - 运行时配置（如需要）
-- **限制/注意事项** - 使用限制
-
-## 解析方式
-
-解析时需先检测并跳过尾部签名块：
-
-```go
-// 1. 检测尾部签名块
-if idx := strings.LastIndex(content, "<!-- AUN-SIGNATURE"); idx >= 0 {
-    content = content[:idx] // 跳过尾部签名块，取 payload
-}
-// 2. 按原规则解析 frontmatter
-parts := strings.SplitN(content, "---", 3)
-// parts[0] = "" (空)
-// parts[1] = YAML 内容
-// parts[2] = Markdown 内容
-```
-
-
+# Agent.md 规格定义
+
+版本: 1.0.0
+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。
+
+## 限制
+
+- **文件大小**: 被签名 payload 最大 4KB（尾部签名块不计入）
+- **签名块大小**: 尾部签名载体最大 2KB（2048 字节，按 UTF-8 原始字节计算）
+- **请求读取上限**: `PUT /agent.md` 最多读取 `payload_max + signature_max` 字节；超出即返回 `413 agent_md_too_large`
+- **编码**: UTF-8
+
+Ownership 字段属于 frontmatter，计入 4KB payload；它们由整个文件的尾部签名覆盖，不另设 ownership 签名块。
+
+## 文件格式
+
+`agent.md` 和 `owner.md` 均采用 **YAML frontmatter + Markdown 内容 + 尾部签名块** 的格式：
+
+```markdown
+---
+aid: "agent-name.agentid.pub"
+name: "Agent Name"
+type: "agent"
+version: "1.0.0"
+---
+
+# Markdown 正文
+说明内容...
+
+<!-- AUN-SIGNATURE-AGENTMD-V2
+cert_fingerprint: sha256:abc123...
+public_key_fingerprint: sha256:def456...
+timestamp: 1715300000
+signature: MEUCIQDx...
+-->
+```
+
+`owner.md` 使用相同的签名块字段格式，但签名块标识为 `<!-- AUN-SIGNATURE-OWNERSHIP-V2`；其 frontmatter 最少包含 `owner_aid`、`sub_aid` 和 `ownership.statement`，不要求使用 `agent.md` 的 `aid`、`name`、`type` 等主体字段。`agent.md` 兼容旧的 `<!-- AUN-SIGNATURE` 标识，也可使用 `<!-- AUN-SIGNATURE-AGENTMD-V2`。
+
+## 尾部文件签名
+
+### 签名块格式
+
+```text
+<!-- AUN-SIGNATURE[-TAG]
+cert_fingerprint: sha256:<64位hex>
+public_key_fingerprint: sha256:<64位hex>
+timestamp: <unix_seconds>
+signature: <base64_der>
+-->
+```
+
+- `cert_fingerprint` 必填，表示签署者 X.509 证书 DER 的 SHA-256 指纹。
+- `public_key_fingerprint` 可选，表示 SubjectPublicKeyInfo DER 的 SHA-256 指纹。
+- `timestamp` 必填，为签名时的 Unix 秒时间戳。
+- `signature` 必填，为 ECDSA P-256 / SHA-256 DER 签名的严格 Base64 表示。
+
+签名输入是签名块开始标记 `<!-- AUN-SIGNATURE` 之前的全部原始 UTF-8 字节；换行和空白不得规范化。签名块必须是文件最后一个可见块，后面只允许空白。
+
+签名块标识使用 `<!-- 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 秒，并且必须落在签署证书有效期内。服务端须在数据库或缓存写入前完成全部校验。
+
+## YAML Schema（`agent.md` 核心字段）
+
+```yaml
+# ===== 身份标识（必填） =====
+aid:
+  type: string
+  required: true
+  pattern: "^[A-Za-z0-9_][A-Za-z0-9_-]*(?:\\.[A-Za-z0-9_][A-Za-z0-9_-]*)+$"
+  description: "主体的 DNS 型 AID"
+  example: "subject.agentid.pub"
+
+# ===== 基本信息 =====
+name:
+  type: string
+  required: true
+  description: "主体显示名称"
+  example: "Code Reviewer"
+
+type:
+  type: string
+  required: true
+  predefined_values:
+    - human
+    - agent
+    - group
+    - service
+    - device
+    - host
+    - org
+    - custom
+  allow_extensions: true
+  description: "主体类型；允许使用扩展值"
+
+exttype:
+  type: string
+  required: false
+  description: "主体类型的扩展形态"
+
+# ===== Ownership 2.0（可选；human 禁止声明） =====
+owner:
+  type: string
+  required: false
+  description: "owner_aid 的完整小写 AID"
+  example: "owner.agentid.pub"
+
+ownership:
+  type: object
+  required: false
+  requires: [owner]
+  description: "sub_aid 在自己的 agent.md 中发布的 Ownership 2.0 声明"
+
+version:
+  type: string
+  required: true
+  pattern: "^\\d+\\.\\d+\\.\\d+$"
+  example: "1.0.0"
+
+description:
+  type: string
+  required: false
+  max_length: 100
+
+avatar:
+  type: string
+  required: false
+  max_length: 256
+
+tags:
+  type: array
+  required: false
+  items:
+    type: string
+```
+
+`human` 类型不得出现 `owner` 或 `ownership`。其它主体类型可以按应用需要声明 owner_aid。AID 在 Ownership 2.0 字段中使用小写规范形式。
+
+## 主体 Type / ExtType 说明
+
+`type` 和 `exttype` 共同描述主体。`type` 是可扩展字符串，主要决定主体的数据存储结构；`exttype` 表示 `type` 对应的更具体形态，取值域由 `type` 决定。解析方应保留并容忍未知类型。
+
+| 预设 Type | 用途 | 示例 |
+| --- | --- | --- |
+| `human` | 真人用户 | 开发者、管理员、终端用户 |
+| `agent` | 使用大模型的服务程序 | 对话助手、代码 Agent、自动化 Agent |
+| `group` | 群组身份 | 项目团队、协作群组 |
+| `service` | 不使用大模型的服务程序 | 网关、存储服务、注册服务 |
+| `device` | 被控设备 | 传感器、摄像设备、机器人 |
+| `host` | 运行时承载主机 | 物理机、虚拟机、云主机 |
+| `org` | 组织 | 公司、部门、协作小组 |
+| `custom` | 自定义主体类型 | 用户声明的主体类型 |
+
+## Ownership 2.0 字段
+
+### sub_aid 的 `agent.md`
+
+```yaml
+owner: owner.agentid.pub
+ownership:
+  statement:
+    version: 2
+    declaration_id: 550e8400-e29b-41d4-a716-446655440000
+    owner_aid: owner.agentid.pub
+    sub_aid: subject.agentid.pub
+    declared_at: 1791523200
+```
+
+字段约束：
+
+| 字段 | 要求 |
+| --- | --- |
+| `owner` | 可选；出现时必须等于 `ownership.statement.owner_aid` |
+| `ownership.statement.version` | 固定为整数 `2` |
+| `ownership.statement.declaration_id` | 小写 UUID v4，用于审计标识 |
+| `ownership.statement.owner_aid` | 管理方的完整小写 AID，必须等于 `owner` |
+| `ownership.statement.sub_aid` | 必须等于当前 `agent.md` 的 `aid` |
+| `ownership.statement.declared_at` | 正整数 Unix 秒时间戳 |
+
+`owner` 与 `ownership` 可以同时省略；出现其中一个时另一个必须出现。`ownership` 只有 `statement` 及其定义字段，不包含独立签名字段。声明随整个 `agent.md` 文件签名，由 sub_aid 自己生成和上传。
+
+### owner_aid 的 `owner.md`
+
+owner_aid 为每个 sub_aid 保存一份声明，路径为：
+
+```text
+owner_aid:/sub_aids/{sub_aid}/owner.md
+```
+
+`owner.md` 的最小 frontmatter 为：
+
+```yaml
+---
+owner_aid: owner.agentid.pub
+sub_aid: subject.agentid.pub
+ownership:
+  statement:
+    version: 2
+    declaration_id: 660e8400-e29b-41d4-a716-446655440000
+    owner_aid: owner.agentid.pub
+    sub_aid: subject.agentid.pub
+    declared_at: 1791523260
+---
+```
+
+`owner.md` 的 `owner_aid`、`sub_aid` 必须与 statement 相同。文件尾部使用 `AUN-SIGNATURE-OWNERSHIP-V2` 标识和与 `agent.md` 相同的签名字段，签署者必须是 `owner_aid`。`owner.md` 公开可读、可下载，不开放公共写权限；写入和删除由 owner_aid 或应用层明确授权的存储执行者完成。
+
+## 关系状态、撤销与共识
+
+| 当前文档情况 | 状态 |
+| --- | --- |
+| `agent.md` 与对应 `owner.md` 都存在，字段及文件签名有效且 AID 匹配 | `consensus` |
+| 两份声明都不存在 | `unbound` |
+| 只有一方声明存在 | `single_sided` |
+| 字段、路径、角色或文件签名无效 | `invalid` |
+
+sub_aid 撤销时，从自己的 `agent.md` 移除 `owner` 和 `ownership` 后重新签名上传。owner_aid 撤销时，删除自己的 `sub_aids/{sub_aid}/owner.md`。撤销不发送 ownership RPC 或 P2P 消息，不产生申请或拒绝事件。
+
+需要 owner 关系的操作必须先读取并验证两份文档。验证成功后，应用层或审计服务应追加保存双方 statement、两份文件签名、文档摘要、调用方和校验时间；之后任一方撤销，不影响已保存的审计快照。
+
+## `PUT /agent.md` 接收顺序
+
+1. SDK 在联网前校验 UTF-8、payload 大小和 frontmatter Schema；失败时不得签名或发起 HTTP 请求。
+2. SDK 使用 sub_aid 自己的签名私钥追加尾部签名块，再执行完整 Schema 校验和本地文件验签。
+3. Name Service 校验目标 Host、Bearer Token 与 `aid` 一致，执行 Schema、尾部文件签名及 `ownership` 字段一致性验证；owner_aid 不得代 sub_aid 上传。
+4. 全部校验成功后，Name Service 才能写入数据库并失效缓存。
+
+接收失败使用稳定的机器可读错误：格式或签名无效返回 `400 invalid_agent_md`，payload 超限返回 `413 agent_md_too_large`，证书服务不可用返回 `503 certificate_verification_unavailable`，数据库不可用返回 `503 database_unavailable`。
+
+## 示例文件
+
+| 文件 | Type | AID | 说明 |
+| --- | --- | --- | --- |
+| [human-developer.md](examples/human-developer.md) | `human` | `zhangsan.aid.pub` | 全栈开发者 |
+| [openclaw-lobster.md](examples/openclaw-lobster.md) | `agent` | `lobster.aid.pub` | OpenClaw AI 助手 |
+| [signed-openclaw-lobster.md](examples/signed-openclaw-lobster.md) | `agent` | `lobster.aid.pub` | 带尾部签名的 OpenClaw AI 助手 |
+| [codeagent-claudecode.md](examples/codeagent-claudecode.md) | `agent` | `claudecode.aid.pub` | Claude Code 编程助手 |
+| [群组-开发团队.md](examples/群组-开发团队.md) | `group` | `dev-team.aid.pub` | 开发团队协作群组 |
+
+无签名示例只用于展示 payload；线上 `PUT /agent.md` 仍要求有效的尾部文件签名。
+
+## Markdown 部分建议内容
+
+YAML 只保留核心元数据，详细信息放在 Markdown 部分：
+
+- **Skills**：技能、命令及说明
+- **功能说明**：主体功能描述
+- **使用示例**：具体使用方法
+- **配置说明**：运行时配置
+- **限制/注意事项**：使用限制
+
+## 解析方式
+
+解析时先检测并剥离尾部签名块，再按 YAML frontmatter 解析：
+
+```text
+1. 定位唯一的 `<!-- AUN-SIGNATURE[-TAG]` 块。
+2. 取签名块之前的原始字节作为 payload 并验签。
+3. 解析 payload 的 YAML frontmatter。
+4. 对 agent.md 按 aid 校验；对 owner.md 按 owner_aid、sub_aid 和路径校验。
+```