@agentunion/fastaun-browser 0.5.18 → 0.5.19

package/CHANGELOG.md

@@ -6,7 +6,49 @@
 
 ---
 
-## 0.5.18 — 2026-10-06
+## 0.5.19 — 未发布
+
+> 基线：`0.5.18` 的仓库快照 `1f03bf2d`；本节整理 2026-10-11 工作区的 SDK 增量。
+
+### 新功能
+
+#### 跨设备已读未读
+- 新增 `MessageFacade.read/readState`、`GroupFacade.read/readState`，分别上报话题的 `last_read_message_id`、查询当前 AID 的跨设备汇总及当前设备 seq 映射；业务已读状态独立于消息 ACK、Pull 游标和群事件游标。
+- 消费 `message.read_changed`、`group.read_changed`，按公共 `last_read_order` 单调更新缓存并抑制重复／倒序事件；切换 AID 或设备时隔离缓存和在途查询结果。
+- 重连后补查已登记的话题并发布本地 `read_state_sync` 完成事件，携带汇总状态及逐项错误；保留 `current_device_seq=null` 和 `mapping_status`；超过安全整数范围的公共顺序和设备 seq 保留为精确十进制字符串。
+
+#### Ownership 2.1 管理
+- 新增 `bindOwneraid`、`bindSubaid`、`releaseSubaid`、`transferSubaid`、`acceptOwnershipRequest`、`rejectOwnershipRequest` 和 `checkOwnershipConsensus`，覆盖双向发起绑定、释放、转移、审批和独立共识检查。
+- 关系依据 sub 的 NS `agent.md` 与 owner 的 `sub_aids/{sub_aid}/owner.md`；使用本人尾签、`relation_version`、owner 锁、NS ETag 和 Storage revision CAS 验证及提交，不依赖旧 Auth owner operation。
+- `aun.ownership.sdk.v1` 控制消息走加密消息通道，由 SDK 消费；审批、inbox/outbox、待提交原始字节和步骤先持久化到 IndexedDB，连接后续跑。任务完成需要重新读取权威文件验证目标共识，不能由通知或发送成功推断。
+- 新增 `ownership.request/action_required/progress/completed/rejected/stopped/error` 应用事件；group/org 使用专属生命周期，通用 Ownership 2.1 返回 `not_applicable`。
+
+#### 凭证与组织服务
+- 增加 `credential` 门面的 `create`、`verifySignature`、`verify`、`verifyRegistrationReceipt` 及登记、撤销、状态／撤销列表 RPC；区分离线签名校验和包含凭证链、实时状态、能力范围、实际请求绑定的完整验证。
+- 增加 `org.lifecycle/member/credential/authz/audit` 门面、组织请求准备、成员双签绑定和转让接受签署；组织请求绑定目标服务、nonce、请求摘要及必要的代表证明，并进入统一客户端签名管线。
+- 组织／群身份由当前 owner 持有；专属转移强制 rekey。实体 `agent.md` 由 owner 使用本人证书和私钥代签、代上传，绑定 `signer_aid`、实体证书指纹及上传授权，失败阶段可恢复。
+- `org.*` 与 `credential.revoked` 事件在进入应用事件队列前验证签发服务、接收身份、证书、时间窗口及签名，并按服务／事件／接收身份去重。
+
+### 修复
+
+- Ownership 控制消息落盘或处理失败时保留有序队列／sender IK 待重试项，避免提前提交交付水位或 ACK；V2 解密保留控制消息原始 JSON，供重复键和严格字段校验。
+- Ownership 证书验证绑定当前证书代际、生命周期状态和可信吊销证据；普通名片上传与关系字段变更分开，实体解散或身份失效后清理相应本地状态。
+- 错误映射优先保留服务端 `data.retryable`，组织请求采用一致 canonical JSON 和请求参数摘要。
+
+### 兼容性与语言边界
+
+- `AIDStore.register(aid, {type, owner?, exttype?})` 登记接口改为显式传入 type；human 禁止 owner，agent/group/org 要求 owner。登记意图持久化后由连接期续跑关系流程，group/org 交给各自生命周期。
+- 旧 `auth.aid_register_*` / `auth.aid_bind_*` 关系编排已移除；`bindAid`、`bindOwner`、`releaseOwnership` 的 legacy 入口返回 `unsupported_protocol`，调用方应迁移到本节的 2.1 管理 API。
+- 浏览器的凭证创建、成员绑定、转让签署及验签 helper 使用异步 WebCrypto；Ownership 任务、revision CAS 和登记意图保存到 IndexedDB。
+- 组织创建、接受转让及解散可通过 `aidStore` 接入实体身份编排；`org.resource/task/host/workflow` 当前通过 `client.call` 使用。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.19`。
+
+### 测试
+
+- 增加 Ownership 2.1 和组织／凭证协议的跨语言共享向量、严格解析、签名／吊销、CAS、审批与重连恢复测试。
+- 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、cross-SDK 和双域测试入口列于 Python parity 文档。
+
+## 0.5.18 — 2026-10-06
 
 ### 新功能
 
@@ -14,7 +56,7 @@
 - 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
 - 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
 - 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
-- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
+- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
 - owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
 
 #### Owner relation Storage 与审计门面

package/_packed_docs/CHANGELOG.md

@@ -6,7 +6,49 @@
 
 ---
 
-## 0.5.18 — 2026-10-06
+## 0.5.19 — 未发布
+
+> 基线：`0.5.18` 的仓库快照 `1f03bf2d`；本节整理 2026-10-11 工作区的 SDK 增量。
+
+### 新功能
+
+#### 跨设备已读未读
+- 新增 `MessageFacade.read/readState`、`GroupFacade.read/readState`，分别上报话题的 `last_read_message_id`、查询当前 AID 的跨设备汇总及当前设备 seq 映射；业务已读状态独立于消息 ACK、Pull 游标和群事件游标。
+- 消费 `message.read_changed`、`group.read_changed`，按公共 `last_read_order` 单调更新缓存并抑制重复／倒序事件；切换 AID 或设备时隔离缓存和在途查询结果。
+- 重连后补查已登记的话题并发布本地 `read_state_sync` 完成事件，携带汇总状态及逐项错误；保留 `current_device_seq=null` 和 `mapping_status`；超过安全整数范围的公共顺序和设备 seq 保留为精确十进制字符串。
+
+#### Ownership 2.1 管理
+- 新增 `bindOwneraid`、`bindSubaid`、`releaseSubaid`、`transferSubaid`、`acceptOwnershipRequest`、`rejectOwnershipRequest` 和 `checkOwnershipConsensus`，覆盖双向发起绑定、释放、转移、审批和独立共识检查。
+- 关系依据 sub 的 NS `agent.md` 与 owner 的 `sub_aids/{sub_aid}/owner.md`；使用本人尾签、`relation_version`、owner 锁、NS ETag 和 Storage revision CAS 验证及提交，不依赖旧 Auth owner operation。
+- `aun.ownership.sdk.v1` 控制消息走加密消息通道，由 SDK 消费；审批、inbox/outbox、待提交原始字节和步骤先持久化到 IndexedDB，连接后续跑。任务完成需要重新读取权威文件验证目标共识，不能由通知或发送成功推断。
+- 新增 `ownership.request/action_required/progress/completed/rejected/stopped/error` 应用事件；group/org 使用专属生命周期，通用 Ownership 2.1 返回 `not_applicable`。
+
+#### 凭证与组织服务
+- 增加 `credential` 门面的 `create`、`verifySignature`、`verify`、`verifyRegistrationReceipt` 及登记、撤销、状态／撤销列表 RPC；区分离线签名校验和包含凭证链、实时状态、能力范围、实际请求绑定的完整验证。
+- 增加 `org.lifecycle/member/credential/authz/audit` 门面、组织请求准备、成员双签绑定和转让接受签署；组织请求绑定目标服务、nonce、请求摘要及必要的代表证明，并进入统一客户端签名管线。
+- 组织／群身份由当前 owner 持有；专属转移强制 rekey。实体 `agent.md` 由 owner 使用本人证书和私钥代签、代上传，绑定 `signer_aid`、实体证书指纹及上传授权，失败阶段可恢复。
+- `org.*` 与 `credential.revoked` 事件在进入应用事件队列前验证签发服务、接收身份、证书、时间窗口及签名，并按服务／事件／接收身份去重。
+
+### 修复
+
+- Ownership 控制消息落盘或处理失败时保留有序队列／sender IK 待重试项，避免提前提交交付水位或 ACK；V2 解密保留控制消息原始 JSON，供重复键和严格字段校验。
+- Ownership 证书验证绑定当前证书代际、生命周期状态和可信吊销证据；普通名片上传与关系字段变更分开，实体解散或身份失效后清理相应本地状态。
+- 错误映射优先保留服务端 `data.retryable`，组织请求采用一致 canonical JSON 和请求参数摘要。
+
+### 兼容性与语言边界
+
+- `AIDStore.register(aid, {type, owner?, exttype?})` 登记接口改为显式传入 type；human 禁止 owner，agent/group/org 要求 owner。登记意图持久化后由连接期续跑关系流程，group/org 交给各自生命周期。
+- 旧 `auth.aid_register_*` / `auth.aid_bind_*` 关系编排已移除；`bindAid`、`bindOwner`、`releaseOwnership` 的 legacy 入口返回 `unsupported_protocol`，调用方应迁移到本节的 2.1 管理 API。
+- 浏览器的凭证创建、成员绑定、转让签署及验签 helper 使用异步 WebCrypto；Ownership 任务、revision CAS 和登记意图保存到 IndexedDB。
+- 组织创建、接受转让及解散可通过 `aidStore` 接入实体身份编排；`org.resource/task/host/workflow` 当前通过 `client.call` 使用。
+- 包配置、锁文件、运行时 `VERSION`、V2 envelope 的 `sdk_version` 及加密 conformance 期望统一为 `0.5.19`。
+
+### 测试
+
+- 增加 Ownership 2.1 和组织／凭证协议的跨语言共享向量、严格解析、签名／吊销、CAS、审批与重连恢复测试。
+- 扩展已读状态门面、单调缓存、身份切换、重连补偿、组织实体身份及服务事件验签测试；配套单域、浏览器、cross-SDK 和双域测试入口列于 Python parity 文档。
+
+## 0.5.18 — 2026-10-06
 
 ### 新功能
 
@@ -14,7 +56,7 @@
 - 新增 `register({aid, type, owner?, ...})`，由 SDK 编排 `auth.aid_register_prepare` → `auth.aid_register_submit` → 带 `ownerOperationId` 的 agent.md 上传 → `auth.aid_register_activate`；保留 `register(aid)` 的 legacy 兼容语义。
 - 新增 `bindAid`、`getAidBindingStatus`、`resumeAidBinding` 和 `changeOwner`，分别覆盖已有 `legacy_unbound`/`unbound` AID 的绑定、状态查询、operation 恢复和三方换 owner；绑定不重新签发证书。
 - 注册规则明确 human 不得指定 owner，非 human 必须指定 owner，只有 agent 支持 self-owner；外部 owner 需要 subject 与 owner 双签，换 owner 需要旧 owner、subject、新 owner 签名及 `expected_relation_version` CAS。
-- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
+- 新增 ownership proof canonical bytes、`factHash`/`statementHash`、UUID v4 `proofId` 和签名封套校验；AID 统一规范化为小写，普通 agent.md 更新保留现有 proof，不能通过普通 PUT 改 owner。
 - owner operation 有效期为 7 天；pending、失败或过期期间证书、登录、连接和基本消息通信保持可用，关系状态可查询并从 operation ID 恢复。
 
 #### Owner relation Storage 与审计门面

package/_packed_docs/INDEX.md

@@ -17,15 +17,38 @@
 | [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
 | [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) | Forward A/T/H 窗口、Group 成员可见性下界、Tail/History RPC、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和跨 SDK 验收门禁 |
 | [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md) | `message.send` 秒级 TTL 钳制、持久/volatile 双游标、按 device 收件箱、隐藏 slot lease/ACK、文件 epoch、消息调试计数器与 payload type 分类、多实例/跨域和四 SDK 测试矩阵 |
+| [跨设备已读未读方案](跨设备已读未读方案.md) | 同一 AID 多设备按话题同步已读位置；服务端按 message ID 公共顺序汇总，返回汇总 message ID 及当前设备 seq 映射，支持 P2P/Group、批量和部分会话上报 |
+| [跨设备已读未读详细设计](跨设备已读未读详细设计.md) | RPC、单条/显式空值边界、紧凑状态表、晚到位置持久回填、Group canonical 与权限版本、owner 事件路由及四端补偿 |
+| [跨设备已读未读实施计划](跨设备已读未读实施计划.md) | 按 TDD 分阶段落地服务端、状态缓存与异步批写、Gateway、四端 SDK、单域/E2E/cross-SDK/跨域测试及完成定义 |
+| [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md) | TypeScript 身份加载、P2P/Group 上报查询、单调事件、本地 `read_state_sync`、精确整数和映射状态 |
+| [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md) | 其它语言 SDK 的 wire 契约、状态表迁移、顺序与映射、CACHE/异步批写、事件联邦、四端对齐和测试矩阵 |
+| [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md) | 服务端及四端 SDK 补充修复、本轮实际验证与历史隔离/Docker 证据；部署层验收未执行 |
 | [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md) | Python/Go 服务端、Gateway 与四 SDK 当前实现的 P0/P1/P2 问题、retention/Group Forward 可见性边界、跨语言差异、修复顺序和已排除误报 |
 | [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md) | 多语言 SDK 同网同服、test-runner 控制面的跨语言 E2E 方案 |
-| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
-| [E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md) | 当前 V2-only P2P / Group 明文与加密主链路、设备密钥注册和 pull/ack 时序 |
-| [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md) | RPC trace 诊断字段与 enter/exit span 设计 |
+| [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md) | SDK bootstrap 能力声明 + 服务端 policy 控制 1DH/per-AID wrap 的兼容方案 |
+| [E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md) | 当前 V2-only P2P / Group 明文与加密主链路、设备密钥注册和 pull/ack 时序 |
+| [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md) | 四 SDK `protected_headers` API、E2EE V2 元数据 HMAC、自动字段和接收信任边界 |
+| [Ownership 协议定义 2.1](protocol/Ownership协议定义2.1.md) | 当前普通双文件/锁/版本、非权威 P2P 编排，以及 Group/Org 专属生命周期、owner 本人尾签 signer_aid、V2 授权和实体证书代际 |
+| [Ownership SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md) | 七 Facade、审批、普通加密 P2P、本地事件、按角色完成证据与恢复契约 |
+| [Ownership 2.1 SDK 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md) | 当前应用接入、Group/Org 作为 sub 的边界、审批策略、任务事件、新鲜共识与 legacy 展示字段边界 |
+| [Ownership 2.1 SDK 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md) | 当前 SDK 文件验证、Storage 权威 revision、条件发布与发布标记恢复、HTTP 428 映射、持久任务和逐条通知恢复 |
+| [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md) | 0.5.19 应用接入、CAP 完整验证、登记回执、成员闭环、代表请求和转让恢复 |
+| [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md) | 0.5.19 四端协议实现、canonical JSON、强状态 proof、facade/RPC、持久编排和共同向量 |
+| [Ownership 2.1 详细设计](sdk/Ownership2.1详细设计.md) | SDK、NS、Storage 组件职责、原子提交、持久证据及 journal 恢复边界 |
+| [Ownership 2.1 TDD 分阶段实施计划](sdk/Ownership2.1-TDD分阶段实施计划.md) | 冻结实现契约、HTTP 428 与错误分类、共同向量、实施账本与四 SDK 实际验收范围 |
+| [Ownership 管理专题（legacy）](sdk/Ownership管理专题.md) | 历史 `aun.ownership.v1`、proof、托管、代签、代上传与 rekey 记录，不作为 2.1 接入依据 |
+| [Ownership SDK 集成指南（legacy）](sdk/Ownership-SDK集成指南.md) | 2026-10-09 历史 TypeScript 应用接入、旧审批 API 与自动编排记录 |
+| [Ownership SDK 实现指南（legacy）](sdk/Ownership-SDK实现指南.md) | 历史 proof/escrow、metadata、恢复和 rekey 移植记录 |
+| [Ownership 协议定义（legacy）](protocol/Ownership协议定义.md) | 历史 `aun.ownership.v1`、proof、托管和 owner 上传授权格式 |
+| [Ownership 2.1 代码审查报告](audit/Ownership2.1代码审查报告.md) | 历史服务端/四端审查与修复；本轮 13 项复审、逐项参考端、V2 过期停传、无消息释放清理及本地验证边界 |
+| [Group 专属生命周期与名片](sdk/09-group-rpc-manual.md) | 自动 owner 绑定/解绑、强制 rekey 的两阶段转移、owner 本人尾签和 V2 名片上传 |
+| [Org 0.8 专属生命周期](../../extensions/services/docs/org/0.8/02-组织模型.md) | 创建与解散 owner 自动建立/解除、先 rekey 后 owner CAS、材料归属与组织名片 |
+| [AUN RPC Trace 增强设计](design/2026-05-22-aun-rpc-trace-enhancement.md) | RPC trace 诊断字段与 enter/exit span 设计 |
 | [AUN 服务端消息通信诊断面板方案](design/AUN服务端消息通信诊断面板方案.md) | aun-console 消息通信页的服务端可观察诊断面板总体方案 |
 | [服务端消息通信诊断面板 P0 方案](design/服务端消息通信诊断面板P0方案.md) | aun-console 消息通信页的服务端可观察 P0 诊断面板 |
 | [消息收件箱统一迁移方案](design/消息收件箱统一迁移方案.md) | P2P `message_inbox` 与群消息 `group_inbox` 的统一读模型、后台回填和旧表清理方案 |
 | [AUN 反向代理服务方案与 TDD 实施计划](design/AUN反向代理服务方案与TDD实施计划.md) | AUN Service Proxy、service_proxy 服务模块、SDK service-proxy-client、URL 路由、隧道协议、Web 边界和分阶段 TDD 落地计划 |
+| [agent.md Schema（legacy 2.0）](agent.md/SCHEMA.md) | 历史 Ownership 2.0 双文件声明与撤销格式；当前 2.1 文件、关系版本和 owner 锁见协议定义 2.1 |
 | [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md) | 远程 agent.md per-AID 本地文件/IndexedDB 缓存、Gateway `_meta.agent_md_etags` 角色、消息信封 ETag 和注入节流方案 |
 | [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md) | working 讨论记录：当前 Schema、内嵌签名实现、三字段关系声明与 self-owner 单签、公开 proof 独立验签、owner 关系写入经 Auth 验证及冲突仲裁、事实摘要与 nonce/编排上下文分层、Auth 登记见证与回执、证书/关系状态分离，以及 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限的最新决策 |
 | [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md) | working 方案：Schema 的 owner/proof 可选但出现即必须完整合法，human 禁止 owner；共同签署声明字段为 proof_id/subject_aid/owner_aid，self-owner 仅 subject 单签，事实摘要排除 nonce、完整声明摘要绑定 proof，使用可见分号域分隔符；Auth 作为登记机构托管证据并签发回执，公开 owner 声明多数场景可独立验证，旧 AID 通过 `aid_bind` 建立 type/owner 绑定且基本登录通信不受限，关系写入经 Auth 仲裁，Storage 内部对象可删除/移动/重命名，失效关系进入 `unbound`/`unusable` |
@@ -35,7 +58,7 @@
 | [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、四 SDK 当前 access token getter、Python Push 自动登记/Facade、RPC 手册、E2EE、Storage VFS、Group FS 和 Collab 的子索引 |
 | [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
 | [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md) | 以 0.5.5 为基线的四 SDK 发布汇总；覆盖首次签名者回源、下载提交前验签、消息窗口、显式 change-seed 和语言能力边界 |
-| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.13 跨语言对齐清单；0.5.13 重点覆盖 agent.md `description` 可选字段、Unicode 长度边界与四端版本一致性 |
+| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.19 跨语言对齐清单；0.5.19 以仓库 0.5.18 为基线，覆盖跨设备已读未读、Ownership 2.1、凭证与组织服务、语言边界和测试入口 |
 | [AUN CLI 手册](cli/CLI手册.md) | Python CLI 源码位置、安装运行入口、全局选项、profile 配置和主要命令集 |
 | [AUN CLI 设计文档](cli/AUN-CLI设计文档.md) | `python/src/aun_cli` 当前实现架构、命令注册面、配置解析、SDK 桥接和实现边界 |
 | [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、服务端分层和 direct backend 上传下载 |
@@ -78,6 +101,12 @@
 - AUNClient 完全门面化、Runtime 状态归属、状态写入收口和四端分批实施 → [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md)
 - P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)
 - P2P `message.send` TTL 内存缓存、持久/volatile 游标、device 收件箱、隐藏 slot lease/ACK、服务 epoch、消息调试计数器与 payload type 分类、跨 SDK/双域验收 → [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md)
+- 同一 AID 多设备按会话话题同步已读位置、message ID 公共顺序汇总、当前设备 seq 映射、P2P/Group 批量上报与查询 → [跨设备已读未读方案](跨设备已读未读方案.md)
+- 跨设备已读未读 RPC、状态表、请求级提交、混合域部分提交、SDK 缓存及本地完成事件契约 → [跨设备已读未读详细设计](跨设备已读未读详细设计.md)
+- 跨设备已读未读 TDD 阶段、状态缓存与批写、测试矩阵、断点续跑、兼容审查和完成定义 → [跨设备已读未读实施计划](跨设备已读未读实施计划.md)
+- TypeScript 应用快速接入跨设备已读未读、上报/查询、单调事件、`read_state_sync`、精确整数和映射状态 → [跨设备已读未读 SDK 集成指南](跨设备已读未读SDK集成指南.md)
+- Python/TypeScript/JavaScript/Go 及其它语言 SDK 的已读状态实现、数据库迁移、CACHE 批写、事件联邦和验收 → [跨设备已读未读 SDK 实现/移植指南](跨设备已读未读SDK实现移植指南.md)
+- 跨设备已读未读实现完整度、文档一致性、四端 SDK 对齐、问题修复闭环及本轮/历史验证边界 → [跨设备已读未读代码审查报告](跨设备已读未读代码审查报告.md)
 - 当前实现的完整度、P0/P1/P2 缺陷、Python/Go 服务端差异、四 SDK 差异与 Go Group inbox-only 对齐项 → [消息同步与历史拉取代码审查问题清单](消息同步与历史拉取代码审查问题清单.md)
 - Python / TypeScript / Go / JavaScript 跨语言容器 E2E、internal 网络、每轮唯一 AID、test-runner、test-control API、用例矩阵 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 - 多语言 SDK 测试缺口与补测清单 → [审查与路线图目录](audit/)
@@ -89,11 +118,20 @@
 ### SDK 使用与协议
 
 - Python / TS / Go / JS SDK 使用手册，以及 Python `push_notify_aid` connect 自动登记和 PushFacade → [SDK 文档索引](sdk/INDEX.md)
-- 新 AID 的 type/owner 注册、legacy AID 的 `aid_bind`、ownership proof、换 owner 与 Storage relation backup → [SDK 文档索引](sdk/INDEX.md)、[Auth 协议](protocol/01-身份与凭证协议-auth.md)、[Storage 子协议](protocol/11-Storage-子协议.md)
+- Ownership 2.1 双文件、身份、owner 锁、关系版本、释放、转移、非权威 P2P 和审计 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)、[详细设计](sdk/Ownership2.1详细设计.md)
+- Ownership 2.1 七 Facade、Group/Org 作为 sub 的边界、审批、本地事件、任务与新鲜共识 → [SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md)、[应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)
+- Ownership 2.1 文件验证、权威 Storage revision、条件发布与发布标记恢复、HTTP 428 映射、持久恢复和实际验收 → [开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)、[TDD 实施账本](sdk/Ownership2.1-TDD分阶段实施计划.md)
+- Credential/Org 应用接入、CAP 完整 Verify、登记回执、成员入组/续期、代表请求和转让恢复 → [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)
+- Credential/Org 四端协议实现、canonical JSON、父链强状态 proof、请求绑定、facade/RPC 和共同向量 → [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md)
+- legacy 四端 proof、托管、代签和代上传记录 → [Ownership 管理专题](sdk/Ownership管理专题.md)
+- legacy 应用接入与旧 SDK 自动编排 → [Ownership SDK 集成指南](sdk/Ownership-SDK集成指南.md)
+- legacy proof/escrow、metadata 和 rekey 移植记录 → [Ownership SDK 实现指南](sdk/Ownership-SDK实现指南.md)
+- legacy `aun.ownership.v1` wire 格式和 owner 上传授权 → [Ownership 协议定义](protocol/Ownership协议定义.md)
+- Ownership 2.1 当前代码审查、四端逐项裁决、本轮 13 项修复、实体授权过期规则和验证限制 → [Ownership 2.1 代码审查报告](audit/Ownership2.1代码审查报告.md)
 - 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 → [连接与认证](sdk/04-连接与认证.md)、[API 手册](sdk/06-API手册.md)、[Storage RPC 手册](sdk/09-storage-rpc-manual.md)、[AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
 - 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
 - 四 SDK 0.5.6 发布摘要、首次签名者回源、可信缓存提交、消息窗口、语言能力边界 → [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md)
-- 四 SDK 相对发布基线的实现级差异、代码/测试落点、对齐优先级、agent.md 可选字段及历史消息同步边界 → [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)
+- 四 SDK 0.5.19 相对仓库 0.5.18 的已读未读、Ownership 2.1、凭证/组织服务、代码/测试落点、语言边界及历史实现差异 → [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)
 - Python CLI 源码位置、安装运行入口、全局选项、profile 配置、身份/消息/群组/Storage/Group FS/Collab/诊断等命令用法 → [AUN CLI 手册](cli/CLI手册.md)
 - Python CLI 当前实现架构、`main.py` 命令注册、`CLISession` SDK 桥接、配置解析和实现边界 → [AUN CLI 设计文档](cli/AUN-CLI设计文档.md)
 - Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、direct backend 上传下载和服务端分层 → [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
@@ -110,6 +148,7 @@
 - 终端如何登记、Push Server 如何签发 token、接收批次、平台推送、幂等 ACK，以及如何运行 Mock smoke → [AUN 离线推送接入与演示指南](AUN离线推送接入与演示指南.md)
 - P2P/Group 离线唤醒、Python connect/Facade 登记、六项冻结契约、9 Phase/40 Task、发布门和回滚 → [离线推送协议](protocol/15-离线推送通知协议.md)、[Push Service 设计](superpowers/specs/2026-07-24-push-service-design-v3.md)、[契约冻结](superpowers/契约冻结-v3-to-v4.md)、[v4 实施计划](superpowers/plans/2026-07-24-push-service-implementation-v4.md)、[运维与发布指南](AUN离线推送服务运维与发布指南.md)；[旧 Codex 版本](AUN离线推送服务架构与详细实现计划-codex.md)仅作历史背景
 - 协议细节、Agent 自主行为、群 `mention_mode` 提及过滤和消息格式 → [协议文档目录](protocol/)、[Group 子协议](protocol/10-Group-子协议.md)、[Agent 行为规范](protocol/13-Agent行为规范.md)
+- legacy Ownership 2.0 的 agent.md/owner.md 声明与撤销 → [agent.md Schema](agent.md/SCHEMA.md)；当前 2.1 文件与锁规则 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)
 - agent.md 远程缓存、`remote_etag` / `local_etag`、`requester` / `peer` / `group` 角色、消息信封与 Gateway `_meta` ETag 透传 → [远程 agent.md 缓存与 ETag 透传方案](agent.md/远程agent.md缓存与etag透传方案.md)
 - agent.md Schema、内嵌签名、三字段关系声明与 self-owner 单签、公开 proof 独立验签、关系写入经 Auth 验证与冲突仲裁、既有签名协议开放项及本轮状态/TTL/Storage 决策 → [agent.md Schema 与签发/验签流程澄清记录](agent.md/working/agent.md-schema与签发验签流程澄清.md)
 - AID 类型、owner/ownership_proof 可选但出现即合法、human 禁止 owner、共同签署字段集合、可见分号 canonical bytes、公开关系声明、Auth 关系写入与冲突裁定、owner-side 备份 ACL、`unbound`/`unusable` 与无专门 recovery → [AID 类型、owner 关系与换 owner 编排方案](agent.md/working/AID类型-owner关系与换owner编排方案.md)
@@ -133,10 +172,11 @@
 - 测试日志路径、测试输出、容器日志查看 → [aun测试运行指南](aun测试运行指南.md)
 - 跨语言 E2E trace 字段、日志产物、失败分类 → [跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 
-### E2EE 与跨语言一致性
-
-- SDK E2EE V2 API、会话管理、ProtectedHeaders、P2P/Group 当前主链路 → [SDK 文档索引](sdk/INDEX.md)、[E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md)
-- E2EE V2 1DH/per-AID wrap、bootstrap 能力声明、服务端 fanout → [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md)
+### E2EE 与跨语言一致性
+
+- SDK E2EE V2 API、会话管理、ProtectedHeaders、P2P/Group 当前主链路 → [SDK 文档索引](sdk/INDEX.md)、[E2EE V2 消息通信时序图](sdk/E2EE_V2消息通信时序图.md)
+- `protected_headers` 四端 API、合并优先级、元数据 HMAC 和解密信任边界 → [ProtectedHeaders 用法专题](sdk/ProtectedHeaders用法专题.md)
+- E2EE V2 1DH/per-AID wrap、bootstrap 能力声明、服务端 fanout → [E2EE V2 简化为 1DH + Per-AID Wrap 方案](design/E2EE_V2简化为1DH加Per-AID_Wrap方案.md)
 - 共享测试向量、transcript 回放、Python / TS / Go / JS 互通 → [aun测试运行指南](aun测试运行指南.md)、[跨语言容器E2E测试方案](design/跨语言容器E2E测试方案.md)
 
 ---
@@ -167,6 +207,30 @@
 
 定义 P2P `message.send` 的秒级 `ttl` 语义：`ttl <= 0` 走原持久化路径，正数钳制到 1-3600 秒并进入不写数据库/WAL 的 volatile 通道。方案规定持久/volatile 独立游标、按 device 的内存收件箱、slot 隐藏的 lease/ACK、服务模块数据目录中的递增 epoch 文件、消息调试页的 volatile 计数器与 payload type 分类、重启丢失和多实例/跨域约束，并给出 Python/Go 服务端、四 SDK、单域、cross-SDK、E2E 与双域验收矩阵。
 
+### 跨设备已读未读方案
+
+定义同一 AID 多设备的业务已读状态模型。P2P `seq` 按设备隔离，设备按应用传入的 `topic_key` 保存最后已读 `message_id`；服务端依据消息公共顺序汇总各设备状态，查询只返回汇总 message ID 及其在当前设备上的 seq 映射。方案覆盖 P2P/Group、AID/话题/Group 过滤查询、单条/批量/部分会话上报、在线变更事件、定向消息边界、四端 SDK 和前端未读数计算。
+
+### 跨设备已读未读详细设计
+
+定义四个已读 RPC 的 wire 契约、顶层单条与显式空值边界、128 字符字段上限、紧凑状态表与幂等迁移、公共顺序和晚到位置持久回填、Group canonical ID 与跨实例权限版本、请求级提交及混合域部分提交；明确原事件 scope、必需 owner、Gateway 来源与路由，以及四端 SDK 的原查询登记、身份隔离、精确整数和本地补偿完成事件。
+
+### 跨设备已读未读实施计划
+
+按契约测试、Message/Group 紧凑状态表与兼容迁移、repository、RPC/Gateway、事件、四端 SDK、单域/E2E/cross-SDK/跨域验收的顺序实施；定义断点续跑、兼容性审查、测试文件规划和完成定义。
+
+### 跨设备已读未读 SDK 集成指南
+
+以 `@agentunion/fastaun` TypeScript SDK 为例，说明 AID 加载、Gateway 连接、P2P/Group 已读上报与查询、单调 `read_changed`、本地 `read_state_sync` 的 states/errors、number/精确字符串整数表示、`mapping_status` 解释和混合域重试边界。
+
+### 跨设备已读未读 SDK 实现/移植指南
+
+面向四端和其它语言 SDK 实现者，定义 wire 字段、128 字符约束、紧凑状态表与迁移重试、公共顺序和当前设备映射、请求级异步提交、事件/federation、原查询登记与身份隔离、本地完成事件、精确整数及验收矩阵。
+
+### 跨设备已读未读代码审查报告
+
+记录 2026-10-11 本轮顶层单条/空值、事件 scope/owner、Gateway 来源与路由、晚到位置持久回填、Group 别名和跨实例权限、事件 ID 与日志边界的补充修复，另覆盖 A→B→A 身份代际和 Gateway 已读结果无损整数，实际隔离验证、工具缺失及既有 runner 失败已汇总于报告第 7.3 节。R-01～R-17、2026-10-10 隔离回归和 2026-10-09 Docker 结果单列为历史证据；真实 MySQL、多实例、集成/E2E、共享 AID cross-SDK 和双域部署验收本轮未执行。
+
 ### 消息同步与历史拉取代码审查问题清单
 
 以当前代码为唯一事实来源，汇总 Python/Go Message 与 Group 服务端、Python/Go Gateway、Python/TypeScript/Go/JavaScript SDK 的实现完整度和横向一致性。问题按 P0/P1/P2 排序，覆盖跨 Gap ACK、retention 与 Group Forward 可见性边界、崩溃窗口、异步任务代际、反向快照、History 分页、GC/WAL/cache、响应上限、敏感日志与诊断缺口；明确迁移完成后 Python Group inbox-only 为基准，Go Group 仍合并旧表必须对齐，并记录已排除的误报。
@@ -215,6 +279,10 @@
 
 定义每个远程 AID 在 SDK 内存和本地持久化记录中维护一条 agent.md 状态：Python / TypeScript / Go 使用 `{aun_path}/AIDs/{aid}/agent.md` 与 `agentmd.json`，浏览器 JavaScript 使用 IndexedDB logical key。方案规定 Gateway 在 RPC response / event push 的 `_meta.agent_md_etags` 中按 `requester`、`peer`、`group` 注入元数据，保留旧别名兼容，并通过 300 秒正缓存、60 秒负缓存和默认 60 秒发送节流控制热路径开销；Message Service V2 P2P 信封携带 `agent_md.sender`。四端 SDK 自动观察 `_meta` 和信封 `agent_md.sender/group`，写入 `remote_etag` / `last_modified`，并遵守按需下载、无条件 GET、304 兼容、竞态和跨 SDK 一致性规则。
 
+### agent.md Schema
+
+保留 legacy Ownership 2.0 的 agent.md/owner.md 独立声明、共识与撤销格式，不定义当前 2.1 的关系版本、owner 锁和释放终局。当前完整文件与身份校验见 [Ownership 协议定义 2.1](protocol/Ownership协议定义2.1.md)；`docs/protocol/agent.md/SCHEMA.md` 则是更早的 legacy 1.0 副本。
+
 ### agent.md Schema 与签发/验签流程澄清记录
 
 记录当前四端 SDK 的 agent.md Schema、尾部内嵌签名格式、签发与验签责任边界，并列出历史外挂 `.sig` 草案与当前实现的冲突。owner proof 可公开独立验证；只有 owner 关系创建、替换或撤销需要 Auth 验证写入，普通内容变化不触发关系审批；证书状态不因关系 pending 改变，legacy/绑定中保留基本登录通信；并记录 `unbound`/`unusable`、状态 pull/push、TTL、type-change 和 Storage 权限决策。该文档处于 working 状态，不是冻结协议。
@@ -235,17 +303,71 @@
 
 定义 `group.index` 的 owner/admin SDK 生成、canonical JSONL、签名、`etag` / `body_hash`、`expected_index_etag` CAS、`_meta.group_indexes` 版本提示、Gateway/Message 转发边界、服务端正/负缓存、singleflight、写后失效/刷新、注入频率控制，以及 DB 保存核心设置、group.fs 保存大附件、附件稳定引用和 SDK `check/get/updateGroupIndex` 语义。
 
-### SDK 文档索引
-
+### SDK 文档索引
+
 `docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、连接认证、E2EE V2、P2P device/TTL volatile 消息、Group 成员控制与两阶段群主转让、Storage MIME/Content-Type/OSS 403、Python `ErrorInfo.cause`、Group FS、Collab 和各类 RPC 手册。
+
+### ProtectedHeaders 用法专题
+
+按当前四端 SDK 实现整理 `protected_headers` 的实例级与单次调用方式、兼容别名、key/value 规范化、E2EE V2 元数据 HMAC、自动字段、解密失败信任边界，以及明文和裸 RPC 的适用边界。
+
+### Ownership 管理专题
+
+保留 legacy `aun.ownership.v1` 四端 proof、托管、代签、代上传和 rekey 历史记录；文中“当前”指该历史基线，不作为 Ownership 2.1 契约或接入依据。
+
+### Ownership 协议定义 2.1
 
-### Service Proxy RPC 手册
+定义当前普通双文件原始字节签名、自身份上传、owner.md 权限、持久 owner 锁、关系版本、release/权威删除、连续转移和审计；Group/Org 创建自动绑定、解散自动解绑、专属转移强制 rekey，实体名片 owner 本人尾签与 V2 上传授权单独分流；三个时间字段统一安全整数范围，invalid 与 unavailable 分别表示无效与不可用。实体 pending 固定完整 V2 授权与原 CAS，过期停止自动重传并保留待办，明确上传才生成新授权；同全文/ETag 已提交仅观察确认。SDK 普通 P2P 编排仅作非权威协作，不构成协议层授权。
+
+### Ownership SDK 编排指南 2.1
+
+定义七 Facade、明确审批、普通加密 P2P 载荷、公共 local_roles 与请求身份、本地事件、按角色核对完成证据和新鲜权威恢复；冻结重复发起复用、错误与任务状态分别记录、时间整数边界，文件保存、关系完成与清理分别跟踪；整体 30 秒从首次 GET 前计时，接收方固定授权摘要/期限，无控制消息也按精确本人历史同意恢复清理。
+
+Group/Org 作为 sub 时不进入这些通用任务、审批或 NS Ownership 账本；以其为 sub 误调用直接 not_applicable，符合普通 owner 规则时仍可作为 owner_aid。实体 owner 创建自动建立、解散自动解除，专属转移强制 rekey，名片由 owner 本人尾签，signer_aid 与 V2 上传授权绑定当前实体证书代际。
+
+### Ownership 2.1 SDK 应用集成指南
+
+说明应用身份准备、Group/Org 作为 sub 的专属边界、审批 UI/策略、任务事件、新鲜 checkOwnershipConsensus 和恢复接入；普通下载 ownership_status 保留 legacy proof 展示语义，不能作为 2.1 授权结果；说明实体授权过期保留待办/明确上传和无消息释放清理的应用处理。
+
+### Ownership 2.1 SDK 开发与移植指南
+
+以当前 Node TS 接线为参考，说明文件、证书、Storage authoritative/revision/expected_revision、持久 CAS/outbox 和实际收件边界；发布成功后保存权威 revision/ETag 标记，恢复区分未保存和已保存标记的核验条件，禁止刷新原提交条件；HTTP 428 统一映射 unsupported_protocol；通知恢复发送前逐条核对新鲜 NS，不以参考实现代替各语言验收；严格 OCSP issuer 绑定、本人原件/任务上下文及实体 pending 原授权复用以协议与逐项裁决为准，不默认全部行为以 TS 为准。
+
+### Ownership 2.1 详细设计
+
+定义四 SDK、NS、Storage 的组件职责、证据与原子边界、条件发布、名片同步和旧版隔离；说明 reserve 无法证明 SQL 提交及 DB+journal 一起回退时的人工恢复与可信上界门槛；补当前时间 OCSP 复核、原授权固定、无消息释放清理和实体授权过期恢复边界。
+
+### Ownership 2.1 TDD 分阶段实施计划
+
+保存实施顺序、共同向量、冻结实现契约与历史测试账本，统一 Group/Org 的 sub 边界、HTTP 428/错误分类及非权威 P2P；第 13 节区分各端当前源码、运行版本、恢复进程边界及未验证环境；旧群自签/token 上传结果保留为旧契约事实，不能作为新 owner 本人名片契约验收；第 13.7 节单列本轮 13 项复审后的本地验证，不改写历史网络账本。
+
+### Ownership 2.1 代码审查报告
+
+保留首次审查的实现完整性、协议一致性、四端差异及服务端问题；第九节记录用户授权后的 6 个 P1、12 个 P2、追加恢复窗口修复、受影响测试证据和验证边界；第十节记录三项契约冻结与本地验证，第十一节记录 Group/Org 既有转移/解散上的约束与恢复修复、owner 本人名片和 V2 授权、四端与服务按断点取得的本地测试证据、已知基线首败及未执行环境验收。第十二节新增本轮 6 个 P1、7 个 P2 的影响、修代码/修文档裁决和参考端，记录 V2 过期停止自动重传的用户决定、无消息释放清理、Red → Green 和断点回归结果。修复判断以 2.1 协议和冻结契约为准，不外推真实部署验收。
+
+### Ownership SDK 集成指南
+
+保留 2026-10-09 legacy TypeScript 应用接入及 proof、escrow、代上传流程。当前七 Facade、审批与新鲜共识见 [2.1 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)。
+
+### Ownership SDK 实现指南
+
+保留 legacy proof/escrow、metadata 和 rekey 移植记录。当前双文件、持久任务、权威条件发布和恢复见 [2.1 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)。
+
+### Ownership 协议定义
+
+保留 legacy `aun.ownership.v1`、proof、托管和 owner 代上传授权格式；当前文件、锁、版本及审计以 [协议定义 2.1](protocol/Ownership协议定义2.1.md) 为准。
+
+### Service Proxy RPC 手册
 
 定义 `proxy.register_services` / `proxy.unregister_services` / `proxy.list_services` 的 Gateway 控制面语义，以及 proxy-server `register_services` 数据面隧道消息、服务列表与连接绑定、一致性约束和 wakeup 路由策略。
 
 ### SDK 查阅指南
 
 `docs/sdk/AUN_DOCS_GUIDE.md` 说明如何按行区间渐进式读取 SDK 文档，避免一次性加载过多文档内容。
+
+### 凭证与组织服务 SDK 指南
+
+[应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)覆盖 service-plane 边界、完整验证、Credential 请求绑定、受保护读取、首次 admission、创建/转让恢复及解散清理；[开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md)定义四端共同密码学、CAP、binding、facade/RPC、checkpoint 和测试向量契约。
 
 ### AUN SDK 0.5.6 更新日志
 
@@ -253,7 +375,7 @@
 
 ### 四 SDK 版本对齐变更清单
 
-`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。当前 v0.5.13 章节以 `8df55664` 的 v0.5.12 为基线，明确 agent.md `description` 缺失、空字符串、类型和 Unicode 长度边界，并列出四语言实现、测试与版本落点。
+`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。当前 v0.5.19 章节以 `1f03bf2d` 的仓库 v0.5.18 为基线，记录跨设备已读未读、Ownership 2.1 持久编排、显式 type/owner 注册、实体名片代签与 rekey、凭证完整验证、组织门面与服务事件验签；列出四端 API、Python 函数定位、语言差异和测试入口，并保留 v0.5.18 历史章节。
 
 ### AUN CLI 手册
 

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：再读目标文档章节
 
@@ -31,7 +31,24 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 
 | 场景 | 推荐读取 |
 | --- | --- |
-| 新 AID 的 type/owner 注册、legacy/unbound AID 绑定、ownership proof、换 owner 与 operation 恢复 | `docs/sdk/06-API手册.md`、`docs/sdk/04-连接与认证.md`、`docs/protocol/01-身份与凭证协议-auth.md` |
+| 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 |
@@ -48,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 |
@@ -66,15 +89,18 @@ 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 |
@@ -83,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 |
@@ -108,9 +134,9 @@ 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` 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 |