@agentunion/fastaun 0.5.23 → 0.5.24

package/CHANGELOG.md

@@ -6,6 +6,39 @@
 
 ---
 
+## 0.5.24 — 未发布
+
+> 基线：npm 已发布的 `@agentunion/fastaun@0.5.23` 编译产物；本节整理截至 2026-10-24 工作区的 SDK 增量。
+
+### 新功能
+
+#### 本地子 agent 绑定与转移
+- 新增 `bindLocalSubaid(subClient)` 与 `transferLocalSubaid(subClient, newOwnerClient)`：分别使用 owner／sub 两份、原 owner／sub／新 owner 三份本地身份材料，直接签署并条件提交本人文件，由 NS 验收，不发送 P2P 审批消息。转移先发布原 owner 授权，目标共识成立后按对象版本清理原授权。
+- Facade 自动为参与身份建立专属 `ownership-UUID` slot 的短连接，完成认证，关闭后台同步和自动重连，结束时关闭连接；传入的业务 client 无须预先连接。仅支持不同的普通 `agent` 身份及已验证的 NS 名片，human owner 继续使用人工确认流程。
+
+### 变更
+
+#### Ownership 由文件和 NS 权威状态驱动
+- 删除 Ownership 任务状态机、任务持久化、任务 inbox／outbox、审批记录、任务 CAS 和连接后自动恢复，不引入 WAL 或额外 decisions 请求。仅保留当次调用内存上下文及已认证请求索引；accept／reject 缺少内存请求时可从普通消息历史查找原请求，找不到则返回 `operation_not_found`。
+- 绑定由发起方先上传自己的 `agent.md` 或 `owner.md` 并通知对端；同意方提交本方文件并触发 NS 验收。转移先由原 owner 发布指定目标、版本和期限的授权再通知，sub 与新 owner 分别提交本人文件，不要求同时在线或固定确认顺序。
+- 冲突依据当前候选和 NS 归属事实判断，保留 NS ETag、Storage `expected_version` 和关系版本。未锁定前 sub 可条件替换 owner 声明，以最后成功提交者为准；拒绝仅发送反馈，不回滚已上传的候选。锁定后的 accept 只能确认相同目标关系，reject 不能改变归属，须走释放或合法转移。
+- 注册时指定 owner，改为在本次注册调用内以专属短连接发起绑定，不再保存等待下次连接执行的绑定恢复意图。初始名片上传失败会返回失败并保留已注册身份；成功发起请求不代表 owner 已确认。
+
+### 修复
+
+- 本地编排在异步读取、签名及上传前后检查源身份；参与 client 切换身份时停止后续副作用，避免沿用旧身份材料。
+- 转移支持读取 NS Stage 候选，兼容候选正文配合旧 active 锁或已晋升目标锁的响应；继续核对 Stage 能力、原签名字节、ETag、版本、授权期限和 CAS，最终成功以普通 active 共识为准。首次绑定仍要求 `pending/unlocked`，重试不能覆盖已替换的候选。
+- 名片观察有 ETag 时只按 ETag 判断内容变化，无 ETag 才使用 Last-Modified。`resolve` 的 Ownership 快照还须匹配当前展示名片的 sub、ETag 和摘要；`forceRefresh` 不再单独强制 Ownership 检查，同 ETag 可复用既有快照，显式 `ownershipTtlMs <= 0` 仍可绕过快照。
+- 普通消息入口隔离消费不可重试的非法 Ownership 控制消息，避免旧非法消息阻塞整页；直接调用 workflow 仍严格报错，合法请求后续的 NS／Storage 故障继续传播，不提前 ACK。
+
+### 兼容性与验证边界
+
+- 保留绑定、确认、拒绝、释放、转移和共识查询 API、`aun.ownership.sdk.v1` 控制格式及双文件签名格式；删除 `resetOwnershipTask()` 和 `OwnershipTaskResetResult` 导出。旧持久任务不再读取或恢复，故障后须查询 NS 并显式重新发起。
+- `OwnershipTaskResult` 名称保留，但普通流程的 `completed`／`step=local_actions` 只表示本次动作完成，最终归属须查询 `checkOwnershipConsensus()`；`ownership.completed` 仅在观测到共识时发出。旧 `getOwner()` 返回 `null`，`getOwnershipStatus()` 返回 `legacy_unbound` 兼容壳，不可作为归属权威。
+- 完整的新语义需配套 NS：旧 2.1 NS 的普通绑定和文件已齐的 local 正常路径可用，但 sub 先接受转移、Stage 交错及同一归属事实重签等边界依赖服务端更新。普通名片上传仍须保留已有关系材料，group／org 专属生命周期不受本次任务删除影响。
+- 包配置、锁文件、运行时 `VERSION` 和 V2 envelope 的 `sdk_version` 统一为 `0.5.24`。证书／凭证缓存、撤销小时补拉和 peer 名片已验正文缓存已在 `0.5.23`，不重复计为本次新增。
+- 扩展无持久任务、故障后重发、候选替换、锁后重复处理、异步转移、双／三身份 local 编排、专属 slot、身份切换和快照一致性测试，补充 [local E2E](tests/e2e/ownership-local-live.test.ts)。执行证据与四端边界见 [parity 文档](../python/CHANGES_FOR_PARITY.md)，不以用例存在代替全量通过结论。
+
 ## 0.5.22 — 未发布
 
 > 基线：已发布的 `0.5.21`；本节整理截至 2026-10-23 工作区的 SDK 增量。

package/_packed_docs/CHANGELOG.md

@@ -6,6 +6,39 @@
 
 ---
 
+## 0.5.24 — 未发布
+
+> 基线：npm 已发布的 `@agentunion/fastaun@0.5.23` 编译产物；本节整理截至 2026-10-24 工作区的 SDK 增量。
+
+### 新功能
+
+#### 本地子 agent 绑定与转移
+- 新增 `bindLocalSubaid(subClient)` 与 `transferLocalSubaid(subClient, newOwnerClient)`：分别使用 owner／sub 两份、原 owner／sub／新 owner 三份本地身份材料，直接签署并条件提交本人文件，由 NS 验收，不发送 P2P 审批消息。转移先发布原 owner 授权，目标共识成立后按对象版本清理原授权。
+- Facade 自动为参与身份建立专属 `ownership-UUID` slot 的短连接，完成认证，关闭后台同步和自动重连，结束时关闭连接；传入的业务 client 无须预先连接。仅支持不同的普通 `agent` 身份及已验证的 NS 名片，human owner 继续使用人工确认流程。
+
+### 变更
+
+#### Ownership 由文件和 NS 权威状态驱动
+- 删除 Ownership 任务状态机、任务持久化、任务 inbox／outbox、审批记录、任务 CAS 和连接后自动恢复，不引入 WAL 或额外 decisions 请求。仅保留当次调用内存上下文及已认证请求索引；accept／reject 缺少内存请求时可从普通消息历史查找原请求，找不到则返回 `operation_not_found`。
+- 绑定由发起方先上传自己的 `agent.md` 或 `owner.md` 并通知对端；同意方提交本方文件并触发 NS 验收。转移先由原 owner 发布指定目标、版本和期限的授权再通知，sub 与新 owner 分别提交本人文件，不要求同时在线或固定确认顺序。
+- 冲突依据当前候选和 NS 归属事实判断，保留 NS ETag、Storage `expected_version` 和关系版本。未锁定前 sub 可条件替换 owner 声明，以最后成功提交者为准；拒绝仅发送反馈，不回滚已上传的候选。锁定后的 accept 只能确认相同目标关系，reject 不能改变归属，须走释放或合法转移。
+- 注册时指定 owner，改为在本次注册调用内以专属短连接发起绑定，不再保存等待下次连接执行的绑定恢复意图。初始名片上传失败会返回失败并保留已注册身份；成功发起请求不代表 owner 已确认。
+
+### 修复
+
+- 本地编排在异步读取、签名及上传前后检查源身份；参与 client 切换身份时停止后续副作用，避免沿用旧身份材料。
+- 转移支持读取 NS Stage 候选，兼容候选正文配合旧 active 锁或已晋升目标锁的响应；继续核对 Stage 能力、原签名字节、ETag、版本、授权期限和 CAS，最终成功以普通 active 共识为准。首次绑定仍要求 `pending/unlocked`，重试不能覆盖已替换的候选。
+- 名片观察有 ETag 时只按 ETag 判断内容变化，无 ETag 才使用 Last-Modified。`resolve` 的 Ownership 快照还须匹配当前展示名片的 sub、ETag 和摘要；`forceRefresh` 不再单独强制 Ownership 检查，同 ETag 可复用既有快照，显式 `ownershipTtlMs <= 0` 仍可绕过快照。
+- 普通消息入口隔离消费不可重试的非法 Ownership 控制消息，避免旧非法消息阻塞整页；直接调用 workflow 仍严格报错，合法请求后续的 NS／Storage 故障继续传播，不提前 ACK。
+
+### 兼容性与验证边界
+
+- 保留绑定、确认、拒绝、释放、转移和共识查询 API、`aun.ownership.sdk.v1` 控制格式及双文件签名格式；删除 `resetOwnershipTask()` 和 `OwnershipTaskResetResult` 导出。旧持久任务不再读取或恢复，故障后须查询 NS 并显式重新发起。
+- `OwnershipTaskResult` 名称保留，但普通流程的 `completed`／`step=local_actions` 只表示本次动作完成，最终归属须查询 `checkOwnershipConsensus()`；`ownership.completed` 仅在观测到共识时发出。旧 `getOwner()` 返回 `null`，`getOwnershipStatus()` 返回 `legacy_unbound` 兼容壳，不可作为归属权威。
+- 完整的新语义需配套 NS：旧 2.1 NS 的普通绑定和文件已齐的 local 正常路径可用，但 sub 先接受转移、Stage 交错及同一归属事实重签等边界依赖服务端更新。普通名片上传仍须保留已有关系材料，group／org 专属生命周期不受本次任务删除影响。
+- 包配置、锁文件、运行时 `VERSION` 和 V2 envelope 的 `sdk_version` 统一为 `0.5.24`。证书／凭证缓存、撤销小时补拉和 peer 名片已验正文缓存已在 `0.5.23`，不重复计为本次新增。
+- 扩展无持久任务、故障后重发、候选替换、锁后重复处理、异步转移、双／三身份 local 编排、专属 slot、身份切换和快照一致性测试，补充 [local E2E](tests/e2e/ownership-local-live.test.ts)。执行证据与四端边界见 [parity 文档](../python/CHANGES_FOR_PARITY.md)，不以用例存在代替全量通过结论。
+
 ## 0.5.22 — 未发布
 
 > 基线：已发布的 `0.5.21`；本节整理截至 2026-10-23 工作区的 SDK 增量。

package/_packed_docs/INDEX.md

@@ -12,6 +12,8 @@
 | [0.5.21 SDK 开发与移植指南](sdk/0.5.21-SDK开发与移植指南.md) | 四端公开契约、peer 水位、流控与提交边界、frontmatter/共识缓存、原 CAS 和旧任务、checkpoint、语言差异及验收顺序 |
 | [0.5.22 SDK 应用集成指南](sdk/0.5.22-SDK应用集成指南.md) / [注册自动绑定 Owner E2E](TS注册自动绑定Owner的E2E验证代码.md) | TypeScript 接入、消息订阅、两种绑定与审批恢复、resolve 展示、60 秒读缓存与刷新、撤销同步和组织完整成员包 |
 | [0.5.22 SDK 开发与移植指南](sdk/0.5.22-SDK开发与移植指南.md) | 后台退避、群状态、两种绑定与 Stage/CAS、消息内部消费、撤销同步、组织恢复及配套服务修复、默认读缓存、Rust 移植与验收 |
+| [0.5.24 SDK 应用集成指南](sdk/0.5.24-SDK应用集成指南.md) | 当前身份与消息接入、无持久任务 Ownership、双／三身份 local 编排、展示与文件缓存、凭证组织及升级验收 |
+| [0.5.24 SDK 开发与移植指南](sdk/0.5.24-SDK开发与移植指南.md) | 当前 peer／batch 提交、NS 事实与远端 CAS、local 短连接、观察与 PKI 缓存、持久化边界、语言差异及移植验收 |
 | [aun测试运行指南](aun测试运行指南.md) | `agentid.pub/agentid.cn` 双域本地单实例、MySQL 命名卷/bind 核验、独立固定材料与 Tester、Go 1.24、断网 cross-SDK、缓存专项首失败续跑、三文件线上镜像替换包、开箱默认配置、一次性初始化辅助包及单节点部署 |
 | [aun公网测试运行指南](aun公网测试运行指南.md) | 可配置 issuer domain 的 Python SDK 公网 integration/E2E runner、独立身份/运行目录、TLS 与服务端公网验收衔接 |
 | [aun分布式测试运行指南](aun分布式测试运行指南.md) | 当前worktree三节点/双域、固定身份runner和Storage OSS；P0授权启动/TLS/单活放置、Tester新pycache与C2续跑；MinIO双healthy/原marker重建读回通过，旧87a09263镜像及AIO04/pool05续跑通过，双形态历史六项C2分轮累计及恢复后最终完整六项C2通过；五app正常停启持久恢复与NS材料匹配/错误0已有证；第二轮5project全15容器停用、10依赖/control/新desired/worker恢复及SQL-before-app/before-SDK一致及旧事实/继续写/post SQL已证，恢复后schema/身份材料/最终完整C2及readiness收敛已证；MinIO原marker及最终日志已通过；新e294两域升级/旧87a回滚/恢复、SQL退休、最终C2各6项、持久v3→v4读写/正ACK及MinIO/诊断通过；fresh10005两域V2/签名状态/SQL/清理及pool重复confirm闭环通过，旧日志不倒推且全窗非0；原Pool Org/Cred首FAIL及历史10004/10006证据缺口保留；57d4双形态回滚恢复/局部重启、独立SDK最终C2/持久v4→v5、03默认1DH路径/清理/严格对账与配置持久化已证，最终日志已分类并保留来源缺口，P0默认1DH有限范围本地技术验收通过，Git/线上待；本轮有限清单真实失败已修复，历史参数/来源缺口旁列；群七天保留/物理清理后续另验、当前未实施；P0 C7部署撤回/保留数据及peer ACK恢复门禁，未签收、P1—P9未开始 |
@@ -33,9 +35,9 @@
 | [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) | agent.md/owner.md 关系、原格式兼容、release/清理/重绑版本、Header 投影、普通 agent.md 独立及旧 SDK 兼容；非权威 P2P 编排与 Group/Org 专属生命周期、实体主签、owner token 上传与可选附签和实体证书代际 |
-| [Ownership SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md) | 七 Facade、审批、普通加密 P2P、本地事件、按角色完成证据与恢复契约 |
-| [Ownership 2.1 SDK 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md) | 应用侧 TS 接线与审批；sub-first／owner-first 绑定、释放、三方转移和重连恢复流程图，任务与当前共识分开判断 |
-| [Ownership 2.1 SDK 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md) | SDK 内部 TS 接口；严格文件签验、NS fresh 共识、Storage 同会话发布、收件持久化和原 CAS 恢复流程图 |
+| [Ownership SDK 编排指南 2.1](sdk/Ownership-SDK编排指南2.1.md) | 历史编排方案；持久任务、自动恢复及一次性决定已由当前两份指南中的无状态流程替代 |
+| [Ownership 2.1 SDK 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md) | 应用侧 TS 接线与审批；双向绑定、释放、转移、两个 local 编排及显式重试的流程图与示例，以 NS 当前归属为准 |
+| [Ownership 2.1 SDK 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md) | SDK 内部签验、NS 验收、Storage 条件发布、消息处理、两／三身份本地编排及文件 CAS；不维护 Ownership 任务或 WAL |
 | [凭证与组织服务 SDK 应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md) | TS 示例与凭证登记／验证、成员申请／邀请、续期、撤销同步和组织 rekey／finalize 转让流程图 |
 | [凭证与组织服务 SDK 开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md) | TS 内部示例与 Verify、双层请求摘要、登记最终化、撤销快照和实体 checkpoint 流程图；跨语言契约与验收 |
 | [凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md) | Credential Service 实际注册 RPC、状态 proof、登记、吊销和吊销列表 |
@@ -64,7 +66,7 @@
 | [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、P2P peer 能力/游标、完整 pending peers/快照、need_render、50k 内存去重/应用持久幂等、四端门面、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.22 跨语言对齐清单；0.5.22 覆盖后台退避、Ownership 2.1、撤销同步、组织恢复与配套服务修复、默认读缓存及已对齐分支，区分发布基线、专项回归和联网矩阵验证边界 |
+| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.24 跨语言对齐清单；0.5.24 覆盖 Ownership 无持久任务／WAL、两个 local 编排、快照一致性及语言边界，区分三端发布 0.5.23／Go 指定 0.5.22 基线与已有验证证据 |
 | [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 上传下载 |
@@ -127,10 +129,12 @@
 - 0.5.21 SDK 开发者的分层、peer/batch 提交、共识缓存、原件恢复、持久化和跨语言验收 → [开发与移植指南](sdk/0.5.21-SDK开发与移植指南.md)
 - 0.5.22 应用接入、两种绑定与审批恢复、resolve、60 秒读缓存与刷新、撤销同步及完整成员包 → [应用集成指南](sdk/0.5.22-SDK应用集成指南.md)
 - 0.5.22 后台退避、群状态、两种绑定与 Stage/CAS、消息订阅及内部消费、撤销同步、组织恢复与配套服务修复、默认读缓存和 Rust 移植 → [开发与移植指南](sdk/0.5.22-SDK开发与移植指南.md)
+- 0.5.24 应用接入、消息持久处理、Ownership 文件验收和两个 local 场景、resolve 与文件缓存、凭证组织和升级 → [应用集成指南](sdk/0.5.24-SDK应用集成指南.md)
+- 0.5.24 SDK 分层、消息提交、Ownership／Stage／CAS、local 身份隔离、缓存新鲜度、跨端差异及 Rust 核查 → [开发与移植指南](sdk/0.5.24-SDK开发与移植指南.md)
 - Python / TS / Go / JS SDK 使用手册，P2P peer 能力、共享 seq/隔离游标、轻量 pending peers/可选整体估计快照、目录/Pull逐页next_pending_seq持续提示/每N次FIFO、peer ACK/slot 公共 S、need_render/页内渲染计数、50k 内存去重/应用持久幂等，以及 Python PushFacade → [SDK 文档索引](sdk/INDEX.md)、[Message RPC](sdk/09-message-rpc-manual.md)、[服务协议](protocol/06-服务协议.md#63-点对点消息-message)
 - Ownership 2.1 agent.md/owner.md 关系、原格式兼容、普通 agent.md 独立、release 保持当前版本、清理后版本投影为 0／重绑默认 1、响应 Header 只投影校验结果、普通 agent owner 可选及旧 SDK 隔离兼容 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)、[详细设计](sdk/Ownership2.1详细设计.md)
-- Ownership 2.1 应用接入：双向绑定、释放、转移、审批和恢复的 TS 示例／流程图 → [应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)
-- Ownership 2.1 SDK 移植：文件签验、fresh 共识、权威发布、消息持久化和三类 CAS 恢复 → [开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)
+- Ownership 2.1 应用接入：双向绑定、释放、转移、两个 local 编排、审批和显式重试的 TS 示例／流程图 → [应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)
+- Ownership 2.1 SDK 移植：文件签验、NS 验收、条件发布、通用消息交付、本地编排和文件 CAS → [开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)
 - Credential/Org 应用接入：凭证登记验证、成员入组／续期、撤销同步和组织转让的 TS 示例／流程图 → [应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)
 - Credential/Org SDK 移植：共同签验、两层请求摘要、登记最终化、撤销快照及实体恢复 → [开发与移植指南](sdk/凭证与组织服务SDK开发与移植指南.md)
 - Credential Service 服务端 RPC、签名状态 proof 和吊销列表 → [凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md)
@@ -139,12 +143,12 @@
 - 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 恢复 agent.md/owner.md 及原控制格式、无参数 reset、绑定容错和历史任务兼容 → [第二十二节](audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)、[编排第 8 节](sdk/Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)
+- Ownership 2.1 历史格式更正、reset 与任务恢复记录 → [第二十二节](audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)、[旧编排第 8 节](sdk/Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)；当前无任务／WAL，以[应用指南](sdk/Ownership2.1-SDK应用集成指南.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 resolve 的 opts/输入输出、frontmatter 全字段与类型、按需 ownership 共识及 owner.md 缓存 → [resolve 规格](sdk/06-API手册.md#resolve-输入与输出)、[连接与认证](sdk/04-连接与认证.md)
 - 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
 - 四 SDK 0.5.6 发布摘要、首次签名者回源、可信缓存提交、消息窗口、语言能力边界 → [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md)
-- 四 SDK 0.5.22 相对发布 0.5.21 的后台退避、Ownership 2.1、撤销同步、组织恢复与配套服务修复、默认读缓存已对齐分支、专项回归及联网矩阵边界 → [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)
+- 四 SDK 0.5.24 的 Ownership 简化、本地双／三身份编排、resolve 快照修复、语言与服务端兼容边界、真实发布基线及验证证据；旧 0.5.22 记录保留为历史快照 → [四 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>)
@@ -332,6 +336,14 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 定义后台退避、群状态、Ownership Stage／CAS、内部消费、撤销与续期、缓存后端及失效契约；列出服务依赖、语言修复、Rust 定位和验收入口。
 
+### 0.5.24 SDK 应用集成指南
+
+按当前代码说明身份与消息接入、持久处理后 ACK、无任务／WAL 的 Ownership、双／三身份 local 编排、resolve 展示与文件缓存、证书和凭证查询复用、组织恢复及升级。保留关键 TypeScript 示例与流程图，区分动作完成与 NS 当前归属。
+
+### 0.5.24 SDK 开发与移植指南
+
+定义三主体分层、peer／batch 提交、后台退避、Ownership 文件与 NS 事实、远端两类 CAS、Stage 转移、专属 slot 短连接和身份代际。覆盖观察快照、文件与 PKI／Credential 缓存新鲜度、组织 checkpoint、跨语言差异和分层验收；Rust 仅列核查项。
+
 ### SDK 文档索引
 
 `docs/sdk/INDEX.md` 是 SDK 手册的三层子索引，覆盖快速开始、连接认证、E2EE V2、P2P 共享 seq/peer 游标、pending peers/统计快照、need_render、50k 内存去重/应用持久幂等、device/TTL volatile、Group 成员控制与两阶段群主转让、Storage、Group FS、Collab 和各类 RPC 手册。peer 模式本期限定单 Message 实例，设备级密钥安全证明可缺省。
@@ -350,17 +362,17 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 ### Ownership SDK 编排指南 2.1
 
-定义七 Facade、sub-first Stage／owner-first 直接提交及无锁预检、明确审批、普通加密 P2P 载荷、公共 local_roles 与请求身份、本地事件、按角色核对完成证据和新鲜权威恢复；冻结重复发起复用、错误与任务状态分别记录、时间整数边界，文件保存、关系完成与清理分别跟踪；整体 30 秒从首次 GET 前计时，接收方固定授权摘要/期限，无控制消息也按精确本人历史同意恢复清理。
+保留七 Facade、Stage、P2P、持久任务及一次性决定的历史设计。当前实现已移除 Ownership 任务、WAL、后台恢复和 decisions 接口，以两份现行 SDK 指南中的文件提交、NS 事实验收和显式重试为准。
 
 Group/Org 作为 sub 时不进入这些通用任务或审批；以其为 sub 误调用直接 not_applicable，符合普通 owner 规则时仍可作为 owner_aid。实体 owner 创建自动建立、解散自动解除，专属转移强制 rekey，名片由实体主签、owner token 上传，可选 owner 附签不改变当前授权。
 
 ### Ownership 2.1 SDK 应用集成指南
 
-按身份准备、发起、审批、核验和恢复组织内容；提供短 TS 示例及 sub-first／owner-first、release、三方转移和重连图。保留普通消息订阅、持久任务、六态、Group/Org 与 legacy 边界。
+按身份准备、发起、审批、核验和显式重试组织内容；保留并更新双向绑定、release、三方转移及故障处理图，补充两个 local 编排的图与 TS 示例。区分本次动作完成与 NS 权威归属，说明普通消息订阅及 human、Group/Org、legacy 边界。
 
 ### Ownership 2.1 SDK 开发与移植指南
 
-聚焦 SDK 内部实现：严格签验、当前证书、NS fresh 复读、Storage 原子发布、消息保存先于 ACK，以及原任务／原字节／原 CAS 恢复。图示关键边界，协议字段和历史细节链接原规范。
+聚焦 SDK 内部实现：严格签验、NS 权威复核、Storage 条件发布、通用消息交付与 ACK、Stage 和两／三身份本地编排。移除任务状态机、WAL、租约和自动恢复要求，保留文件 CAS、关系版本、显式重试及关键图与代码。
 
 ### Ownership 2.1 详细设计
 
@@ -372,15 +384,15 @@ Group/Org 作为 sub 时不进入这些通用任务或审批；以其为 sub 误
 
 ### Ownership 2.1 代码审查报告
 
-当前格式与兼容更正见[第二十二节](audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)：继续使用 agent.md/owner.md 和原控制字段；普通正文保留关系材料且不以前置 Ownership 共识为条件；保留 reset、绑定容错与 0.5.19 及更早任务兼容。第十六至二十一节保留阶段记录，其中独立资源、显式迁移及资源标记契约已经撤销，原通过计数不能作为恢复后专项、现场部署或全平台验收结论。
+保留[第二十二节](audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)等历史审查和兼容记录；其中任务恢复、reset 和一次性决定不作为当前接入要求。当前无状态流程见两份 SDK 指南；历史通过计数不能代替现场部署或全平台验收。
 
 ### Ownership SDK 集成指南
 
-保留 2026-10-09 legacy TypeScript 应用接入及 proof、escrow、代上传流程。当前七 Facade、审批与新鲜共识见 [2.1 应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)。
+保留 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)。
+保留 legacy proof/escrow、metadata 和 rekey 移植记录。当前双文件、权威条件发布、本地编排和显式重试见 [2.1 开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)。
 
 ### Ownership 协议定义
 
@@ -406,7 +418,7 @@ Group/Org 作为 sub 时不进入这些通用任务或审批；以其为 sub 误
 
 ### 四 SDK 版本对齐变更清单
 
-`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。v0.5.22 以已发布 v0.5.21 为基线，覆盖后台退避、Ownership 2.1 两种绑定与 CAS、撤销同步、组织恢复及配套服务修复、默认读缓存和 owner.md 读取边界；记录缺省 TTL 与权限查询分支的对齐、四端专项回归及 TS/JS 类型检查，保留 16×4 联网矩阵、真实浏览器和其它未执行范围，区分源码、发布产物和服务部署证据。
+`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。v0.5.24 对照 Python／TS／JS 已发布 0.5.23，Go 按指定对照 0.5.22 提交，覆盖移除 Ownership 任务与恢复、两个 local API 的专属 slot 短连接、注册当次绑定、NS 事实与 Stage／CAS、resolve 快照一致性、返回值及兼容接口差异。三端已发布的证书／Credential 缓存不重记为新增，Go 较早基线增量另列；核验四端 local、交互、cross33 断点及六项边界的已有证据，不等同全量发布回归。旧 0.5.22 及更早记录保留为历史快照。
 
 ### 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-94：根级文档地图。
+- `docs/INDEX.md` L7-96：根级文档地图。
 
 ### Step 2：按主题读根级 Layer 2
 
-- 测试与 E2E：`docs/INDEX.md` L99-119。
-- 服务端 Go 化重构审查：`docs/INDEX.md` L120-123。
-- SDK 使用与协议：`docs/INDEX.md` L124-171。
-- Service Proxy 与服务暴露：`docs/INDEX.md` L172-178。
-- 诊断与可观测性：`docs/INDEX.md` L179-187。
-- E2EE 与跨语言一致性：`docs/INDEX.md` L188-194。
+- 测试与 E2E：`docs/INDEX.md` L101-121。
+- 服务端 Go 化重构审查：`docs/INDEX.md` L122-125。
+- SDK 使用与协议：`docs/INDEX.md` L126-175。
+- Service Proxy 与服务暴露：`docs/INDEX.md` L176-182。
+- 诊断与可观测性：`docs/INDEX.md` L183-191。
+- E2EE 与跨语言一致性：`docs/INDEX.md` L192-198。
 
 ### Step 3：需要判断文档价值时读 Layer 3 摘要
 
-- `docs/INDEX.md` L197-465：重点文档摘要。
+- `docs/INDEX.md` L201-481：重点文档摘要。
 
 ### Step 4：再读目标文档章节
 
@@ -34,25 +34,28 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 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 |
 | 0.5.22 应用集成：TypeScript 接线、审批恢复、resolve、缓存及凭证组织 | `docs/sdk/0.5.22-SDK应用集成指南.md` 1. L5-13；2. L14-35；3. L36-54；4. L55-104；5. L105-127；6. L128-164；7. L165-200；8. L201-212 |
-| TypeScript 注册自动绑定 Owner E2E 代码 | [代码 L9-172、运行 L174-192、实测 L194-196](TS注册自动绑定Owner的E2E验证代码.md)：注册意图、connect 自动 bind.request、owner 审批、NS/Storage 校验 |
+| TypeScript 注册绑定 Owner 的历史 E2E 代码 | [代码 L9-172、运行 L174-192、实测 L194-196](TS注册自动绑定Owner的E2E验证代码.md)；当前为注册当次通知，见 `docs/sdk/Ownership2.1-SDK应用集成指南.md` §3.5 |
 | 0.5.22 SDK 移植：同步、Stage/CAS、撤销续期、缓存、语言修复及 Rust | `docs/sdk/0.5.22-SDK开发与移植指南.md` 1. L5-8；2. L9-29；3. L30-39；4. L40-83；5. L84-118；6. L119-171；7. L172-188；8. L189-199 |
+| 0.5.24 应用集成：当前消息、无任务 Ownership、两个 local 编排、缓存及凭证组织 | `docs/sdk/0.5.24-SDK应用集成指南.md` 1. L5-20；2. L21-75；3. L76-132；4. L133-168；5. L169-298；6. L299-321；7. L322-366；8. L367-385；9. L386-401；local bind L227-245、local transfer L246-267 |
+| 0.5.24 SDK 移植：提交／ACK、NS 事实与 CAS、local 身份隔离、缓存新鲜度与语言差异 | `docs/sdk/0.5.24-SDK开发与移植指南.md` 1. L5-17；2. L18-31；3. L32-84；4. L85-92；5. L93-122；6. L123-217；7. L218-245；8. L246-261；9. L262-297；10. L298-325；11. L326-339；12. L340-354 |
 | 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-634；5. L635-642；6. L643-669 |
-| Ownership 2.1 七 Facade、sub-first／owner-first 简化、三类 CAS 冲突、reset 与旧任务恢复 | `docs/sdk/Ownership-SDK编排指南2.1.md` 1. L9-40；2. L41-243；3. L244-277；4. L278-381；5. L382-415；6. L416-545；7. L546-717；8. L718-782；9. L783-824；10. L825-939 |
-| Ownership 2.1 应用 TS 接线、双向绑定／释放／转移与恢复图 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` 1. L7-18；2. L19-25；3. L26-139；4. L140-155；5. L156-167；6. L168-253；7. L254-275；8. L276-292；9. L293-305；10. L306-312 |
-| Ownership 2.1 SDK 移植：签验、共识、Storage、收件与恢复图 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` 1. L5-12；2. L13-35；3. L36-48；4. L49-81；5. L82-95；6. L96-125；7. L126-151；8. L152-167；9. L168-204；10. L205-262；11. L263-301；12. L302-309；13. L310-322 |
-| AIDStore.sign/verify 与完整文件多签 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L129-139；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L68-81、L96-125 |
+| Ownership 2.1 历史编排、任务恢复、reset 与三类 CAS 设计 | `docs/sdk/Ownership-SDK编排指南2.1.md` L9-939；仅作历史参考，当前流程见下面两份指南 |
+| Ownership 多设备归属冲突、最后上传候选与锁后保护；无独立 decisions | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L171-201、L326-342；旧编排 L941-986 的一次性决定方案已撤销 |
+| Ownership 2.1 应用 TS 接线、双向绑定／释放／转移、local 编排与显式重试图 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` 1. L7-20；2. L21-27；3. L28-140；4. L141-158；5. L159-168；6. L169-303；7. L304-325；8. L326-342；9. L343-354；10. L355-363；local bind L257-278、local transfer L279-303 |
+| Ownership 2.1 SDK 移植：签验、NS 验收、Storage、消息与本地编排图 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` 1. L5-14；2. L15-38；3. L39-51；4. L52-84；5. L85-98；6. L99-128；7. L129-153；8. L154-173；9. L174-209；10. L210-253；11. L254-374；12. L375-383；13. L384-399；local bind L297-335、local transfer L336-374 |
+| AIDStore.sign/verify 与完整文件多签 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L130-140；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L71-84、L99-128 |
 | 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-305；7. L306-398；8. L399-437；9. L438-471；10. L472-484 |
 | 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 与 sub 清理授权 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L199-222；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L288-291、L296-301 |
-| 旧 SDK 隔离兼容、普通名片保留关系及原任务恢复；legacy proof wire | `docs/protocol/Ownership协议定义2.1.md` L220-242；`docs/sdk/Ownership2.1详细设计.md` L438-471；`docs/sdk/Ownership-SDK编排指南2.1.md` L718-782；`docs/protocol/Ownership协议定义.md` L159-321 |
+| release 保持 v、清理后 0／重绑默认 1 与通知触发的 sub 清理 | `docs/sdk/Ownership2.1-SDK应用集成指南.md` L202-223；`docs/sdk/Ownership2.1-SDK开发与移植指南.md` L279-296 |
+| 旧 SDK 隔离兼容、普通名片保留关系及历史任务恢复；legacy proof wire | `docs/protocol/Ownership协议定义2.1.md` L220-242；历史恢复见旧编排 L718-782；当前兼容与显式重试见 `docs/sdk/Ownership2.1-SDK应用集成指南.md` L326-363；legacy wire 见 `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；第十六至二十一节保留阶段记录 |
+| Ownership 2.1 历史格式更正、reset、任务兼容与验证记录 | `docs/audit/Ownership2.1代码审查报告.md` L1431-1470；当前不再维护 Ownership 任务／WAL，接入见两份现行指南 |
 | Credential/Org 应用 TS 与登记、入组、续期、撤销、转让图 | `docs/sdk/凭证与组织服务SDK应用集成指南.md` 1. L5-10；2. L11-14；3. L15-74；4. L75-172；5. L173-214；6. L215-247；7. L248-257；8. L258-263；9. L264-266 |
 | Credential/Org 移植 TS 与 Verify、请求摘要、持久状态／实体恢复图 | `docs/sdk/凭证与组织服务SDK开发与移植指南.md` 1. L5-15；2. L16-44；3. L45-76；4. L77-144；5. L145-186；6. L187-213；7. L214-225；8. L226-231；9. L232-242 |
 | Credential Service 实际 RPC、请求绑定、登记/吊销、持久幂等结果恢复和签名状态证明 | `docs/sdk/09-凭证服务RPC手册.md` L1-73 |
@@ -100,7 +103,7 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 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 owner.md 同会话发布、条件删除与三类 CAS 恢复 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` L126-151、L253-262 |
+| Ownership 2.1 owner.md 同会话发布、条件删除、两类远端 CAS 与显式重试 | `docs/sdk/Ownership2.1-SDK开发与移植指南.md` L129-153、L210-253 |
 | legacy Ownership proof、托管持久化、owner 代签与代上传历史记录 | `docs/sdk/Ownership管理专题.md` L1-559 |
 | 服务端消息通信诊断总体方案 | `docs/design/AUN服务端消息通信诊断面板方案.md` L3-47 |
 | 服务端消息通信 P0 诊断面板 | `docs/design/服务端消息通信诊断面板P0方案.md` L3-73 |
@@ -118,7 +121,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` L62、L168、L315-318 |
+| group.index 签名索引、`_meta.group_indexes`、CAS 更新和服务端缓存注入 | `docs/design/群索引版本提示与附件引用方案.md` L1-348、`docs/INDEX.md` L65、L174、L319-322 |
 | 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 |
@@ -147,7 +150,7 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 四 SDK Storage / Group FS 默认读缓存、省略策略或 TTL 默认 60 秒、显式限制、SHA 无正文免计次与 owner.md 普通/权威读取 | `docs/sdk/09-storage-rpc-manual.md` L129-170；`docs/sdk/06-API手册.md` L497-510；`docs/sdk/09-group-rpc-manual.md` L1586-1620 |
 | 四 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` L690-734、`docs/sdk/09-group-rpc-manual.md` L1612-1618、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
 | 四 SDK 0.5.6 发布摘要、验签缓存、消息窗口与语言能力边界 | `docs/sdk/CHANGELOG-0.5.6.md` L1-73 |
-| 四 SDK 0.5.22 相对发布 0.5.21 的 Ownership 2.1、撤销快照、组织恢复及配套服务修复、默认读缓存已对齐分支和专项回归／联网矩阵边界 | `python/CHANGES_FOR_PARITY.md` L11-168 |
+| 四 SDK 0.5.24 的无持久任务 Ownership、两个 local 编排、快照修复、语言／NS 边界及已有验证记录；三端对照发布 0.5.23，Go 对照指定 0.5.22 | `python/CHANGES_FOR_PARITY.md` L13-147；旧 0.5.22 历史记录 L150-305，读缓存与测试块⑦/⑧ L235-305 |
 | 群 `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/protocol/Ownership/345/215/217/350/256/256/345/256/232/344/271/2112.1.md

@@ -4,7 +4,7 @@
 
 普通 `agent.md` 的基础读取、验签、上传与显式 pending 恢复不以前置 Ownership 共识、owner Storage 或关系状态为条件。普通正文更新须原样保留当前原件中全部关系材料的字段存在性、类型和值，并遵守本人签名和原 ETag/CAS；材料无效或依赖不可用不能阻断这种更新。增删改关系字段继续执行当前双文件授权核验，不能借普通名片入口清除或替换 owner 锁。
 
-本协议的通用关系流程适用于 `human`、`group`、`org` 以外的主体；`human` 禁止声明 owner，`group/org` 作为被管理的 subject 时使用第 1.3 节的专属生命周期，也可按普通规则作为 `owner_aid`。通用关系双方独立签名、上传自己的声明文件；本协议不定义 ownership 专用授权 RPC 或权威关系控制方法，也不提供代签名、代上传及协议层申请、接受、拒绝方法。SDK 可以用普通加密 P2P 载荷进行非权威的本地编排；这些载荷不构成关系授权或 NS 提交事实，不能替代双方文件及服务端验收。可选托管由应用层实现，不改变这两个文件的签署及上传身份。
+本协议的通用关系流程适用于 `human`、`group`、`org` 以外的主体；`human` 禁止声明 owner，`group/org` 作为被管理的 subject 时使用第 1.3 节的专属生命周期，也可按普通规则作为 `owner_aid`。通用关系双方独立签名、上传自己的声明文件；本协议不定义 ownership 专用授权 RPC 或权威关系控制方法，也不提供代签名、代上传及协议层关系申请、接受、拒绝方法。SDK 使用普通加密 P2P 载荷编排，并由 sub 归属 NS 按[编排指南第 11 节](../sdk/Ownership-SDK编排指南2.1.md#11-aid-级多设备一次性决策)保存各 AID 的不可变审批决定；载荷和决定均不构成关系授权或关系提交事实，不能替代双方文件及服务端验收。可选托管由应用层实现，不改变这两个文件的签署及上传身份。
 
 兼容方向为新服务端保留旧 SDK 的既有身份认证、普通名片、通信和 legacy owner 操作入口；新 SDK 的 2.1 关系操作不兼容旧服务端。兼容旧 SDK 所需的注册、绑定、转移、查询和解绑 RPC 使用隔离的 Auth JSONL 状态及 NS `ownership_proof`，只处理 legacy 关系；它们不生成 2.1 双文件声明，不构成 2.1 授权、owner 锁、关系版本或 `consensus`，也不得覆盖已存现代声明。Ownership 2.1 当前关系始终重新核对两份当前文件；不把新 SDK 源码调用形态兼容作为本契约要求。
 
@@ -663,7 +663,7 @@ self-owner 验证通过同样返回 `consensus`，仅证明该 AID 的自主管
 
 执行端按自身业务审计要求记录授权与执行结果；关系授权时应校验两份当前完整签名文件、owner_aid 身份及证书和本次验签结果。审计记录只描述历史操作，不参与当前关系判断；普通 `agent.md` 读取和身份验签不依赖 Ownership 审计数据。
 
-NS 不持久化独立关系事实、释放状态或关系版本上界。数据库只保存当前 `agent.md` 及其发布 ETag；owner 身份和声明依据 owner_aid 对应的证书及 Storage 当前 `owner.md`。无法从这两份当前材料确证关系或版本时，关系授权及关系变更 fail-closed，但不影响符合普通规则的 `agent.md` 读取、验签和使用。同步待办和应用审计均不能作为第三个事实来源。
+NS 不持久化独立关系事实、释放状态或关系版本上界。关系材料保存在当前 `agent.md` 及其发布 ETag；owner 身份和声明依据 owner_aid 对应的证书及 Storage 当前 `owner.md`。SDK 多设备编排另存 operation 上下文及不可变决定，仅用于防止重复决策。无法从这两份当前材料确证关系或版本时，关系授权及关系变更 fail-closed，但不影响符合普通规则的 `agent.md` 读取、验签和使用。决策记录、同步待办和应用审计均不能作为第三个关系事实来源。
 
 托管为应用层显式启用的可选能力，不改变各方签署及上传身份。外部 owner 若持有可解密的 sub 私钥，仍可冒用其身份，移除代理接口不能撤销该能力。关系变更不自动撤销旧凭据及其续签、恢复身份的能力；业务交接完成须另行确认凭据隔离，与 NS 关系提交是独立事实。
 

package/_packed_docs/sdk/AUN_DOCS_GUIDE.md

@@ -29,7 +29,7 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 常见主题：
 
 - 身份与认证：AIDStore / AID / 注册 / 加载 / 证书
-- Ownership 2.1：关系仅由当前 agent.md/owner.md 确认；release 保持 v，清理后版本投影为 0／重绑默认 1，Header 只投影校验结果；普通 agent 注册 owner 可选；owner 当前完整原文/摘要/存在性再读，object_id/version 不为读取一致性条件；owner.md 通过 create_upload_session→HTTP PUT→complete_upload 的同一会话发布，expected_version 作发布 CAS，不提供全局/ABA保证；新服务端兼容旧 SDK 的注册、绑定、转移、查询和解绑 RPC 及隔离 Auth JSONL，只激活旧 NS ownership_proof，不写 2.1 双文件，不授 2.1 lock/version/consensus，不覆盖已存现代声明；新 SDK 关系操作不兼容旧服务端；当前应用/移植指南、七 Facade 与 Group/Org 专属生命周期、实体主签及原始多签恢复；v1/proof/escrow 文档为 legacy
+- Ownership 2.1：NS 按当前 agent.md/owner.md 和转移授权验收；未锁候选以 sub 最后成功上传为准，锁定后须释放或合法转移，拒绝只通知；SDK 无 Ownership 任务、WAL、decisions 或重连恢复。文件 ETag／expected_version CAS、关系版本和 NS 原子锁定保留；release 保持 v，清理后为 0／重绑默认 1。注册带 owner 在注册当次通知；本地 bind／transfer 使用两／三身份专属短连接，不发 P2P，human 仍走人工确认。完整语义需配套 NS 与四 SDK，旧版本兼容范围见当前应用／移植指南；旧 owner RPC/Auth JSONL 仍隔离于 2.1 双文件。Group/Org 保持专属生命周期和实体多签边界；v1/proof/escrow 文档为 legacy
 - 连接与状态：AUNClient / 九态状态机 / Gateway / 重连 / 当前 access token getter / connect-disconnect-close 并发与取消
 - E2EE：默认加密、ProtectedHeaders、P2P / Group V2
 - RPC 与事件：`client.call()`、`client.on()`、`client.notify()`、RPC 手册
@@ -58,15 +58,17 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 | - | [0.5.21 SDK 开发与移植指南](0.5.21-SDK开发与移植指南.md) | SDK 开发者的 peer/batch 提交、共识缓存、原 CAS/旧任务、checkpoint、语言差异及验收 |
 | - | [0.5.22 SDK 应用集成指南](0.5.22-SDK应用集成指南.md) | TypeScript 接线、审批恢复、resolve、缓存及凭证组织 |
 | - | [0.5.22 SDK 开发与移植指南](0.5.22-SDK开发与移植指南.md) | 同步、Stage/CAS、撤销续期、缓存、服务依赖及 Rust 清单 |
+| - | [0.5.24 SDK 应用集成指南](0.5.24-SDK应用集成指南.md) | 当前消息接线、无任务 Ownership、两个 local 编排、缓存和凭证组织 |
+| - | [0.5.24 SDK 开发与移植指南](0.5.24-SDK开发与移植指南.md) | 消息提交、NS 事实和远端 CAS、local 身份隔离、缓存新鲜度与语言差异 |
 | - | [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **0.5.6 版本更新日志**：首次签名者回源、下载提交前验签、消息窗口、显式 change-seed 与语言能力边界 |
 | 01 | [快速开始](01-快速开始.md) | 安装、三主体模型、最小示例 |
 | 02 | [WebSocket协议](02-WebSocket协议.md) | 握手流程、严格布尔 peer 能力、各层大小限制、消息格式、裸 WebSocket |
 | 03 | [核心概念](03-核心概念.md) | AID、peer A/T/H、稀疏覆盖、N=4 Gate、50k 内存去重、状态机、E2EE |
 | 04 | [连接与认证](04-连接与认证.md) | AIDStore、默认 agent.md 自动上传、连接生命周期并发/取消、当前 access token getter、网关发现、事件、已读状态本地补偿完成事件、agent.md 校验和自动观察、resolve frontmatter 与按需 ownership |
 | - | [Ownership 协议定义 2.1](../protocol/Ownership协议定义2.1.md) | 当前双文件关系、版本、签名与授权边界、旧 SDK owner RPC/JSONL 隔离 |
-| - | [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 七 Facade、sub-first Stage／owner-first 直接提交、无锁预检、三类 CAS 冲突及持久恢复 |
-| - | [Ownership 2.1 SDK 应用集成指南](Ownership2.1-SDK应用集成指南.md) | 应用侧 TS 接线与审批；双向绑定、释放、三方转移和重连恢复图，任务与当前共识分开判断 |
-| - | [Ownership 2.1 SDK 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | SDK 内部 TS 接口；严格签验、NS fresh、Storage 发布、收件持久化和原 CAS 恢复图 |
+| - | [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 历史任务／恢复／一次性决定方案；当前无状态流程见下面两份指南 |
+| - | [Ownership 2.1 SDK 应用集成指南](Ownership2.1-SDK应用集成指南.md) | TS 接线与审批；双向绑定、释放、转移、两个 local 编排及显式重试的图与示例 |
+| - | [Ownership 2.1 SDK 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | 严格签验、NS 验收、Storage 条件发布、通用消息交付、本地编排和文件 CAS |
 | - | [Ownership管理专题（legacy）](Ownership管理专题.md) | 四端 P2P owner API、应用层 accept/reject、完整消息 payload、identity escrow、owner 代签 agent.md、metadata 状态和验签边界 |
 | - | [Ownership SDK集成指南（legacy）](Ownership-SDK集成指南.md) | TypeScript 快速接入、应用审批、状态查询及 SDK 编排流程图 |
 | - | [Ownership SDK实现指南（legacy）](Ownership-SDK实现指南.md) | SDK 移植入口、消息拦截、proof/escrow、metadata 和恢复验收 |
@@ -94,14 +96,18 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 | 实现、移植或审查 0.5.21 SDK | [0.5.21 SDK 开发与移植指南](0.5.21-SDK开发与移植指南.md) |
 | 接入或升级 0.5.22，查看 TypeScript 示例、关系审批、默认读缓存及完整成员包 | [0.5.22 SDK 应用集成指南](0.5.22-SDK应用集成指南.md) |
 | 实现、移植或审查 0.5.22 SDK，查看 Stage/CAS、配套服务修复、读缓存及 Rust 验收清单 | [0.5.22 SDK 开发与移植指南](0.5.22-SDK开发与移植指南.md) |
+| 接入或升级 0.5.24，查看当前消息、无任务 Ownership、两个 local 场景、缓存及凭证组织 | [0.5.24 SDK 应用集成指南](0.5.24-SDK应用集成指南.md) |
+| 实现、移植或审查 0.5.24，核对提交／ACK、NS 事实、远端 CAS、local 身份隔离和缓存新鲜度 | [0.5.24 SDK 开发与移植指南](0.5.24-SDK开发与移植指南.md) |
+| 0.5.24 应用按主题读：身份、消息、resolve、Ownership、文件缓存、凭证组织和升级 | `0.5.24-SDK应用集成指南.md` §2 L21-75、§3 L76-132、§4 L133-168、§5 L169-298、§6 L299-321、§7 L322-366、§9 L386-401；local bind L227-245、local transfer L246-267 |
+| 0.5.24 移植按主题读：消息提交、名片、观察、Ownership、缓存、PKI、凭证组织及语言差异 | `0.5.24-SDK开发与移植指南.md` §3 L32-84、§4 L85-92、§5 L93-122、§6 L123-217、§7 L218-245、§8 L246-261、§9 L262-297、§10 L298-325；Rust §11 L326-339、验收 §12 L340-354 |
 | 首次使用 SDK | [01-快速开始](01-快速开始.md) |
 | 理解新构造入口 | [01-快速开始](01-快速开始.md)、[06-API手册](06-API手册.md) |
 | 注册或加载 AID | [04-连接与认证](04-连接与认证.md) |
 | 查询 resolve opts、frontmatter 字段及类型、按需 ownership 共识和 owner.md 缓存 | [resolve 输入与输出](06-API手册.md#resolve-输入与输出) |
 | 查旧 SDK owner 注册、绑定、转移、查询及解绑的隔离兼容，或 legacy proof/escrow/代签 | [当前协议兼容边界](../protocol/Ownership协议定义2.1.md) 开篇/§3.2、[详细设计](Ownership2.1详细设计.md) §1 兼容矩阵；历史 wire 见 [Ownership管理专题（legacy）](Ownership管理专题.md)、[legacy 集成指南](Ownership-SDK集成指南.md) |
-| Ownership 2.1 应用：绑定／释放／转移、审批及恢复的 TS 示例与图 | [应用集成指南](Ownership2.1-SDK应用集成指南.md) |
-| Ownership 2.1 移植：fresh 共识、发布、收件持久化和 CAS 恢复 | [开发与移植指南](Ownership2.1-SDK开发与移植指南.md) |
-| Ownership 2.1 当前格式、reset、历史任务及验证边界 | [第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)：撤销独立资源和新增字段；[编排第 8 节](Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)：0.5.20/0.5.19 及更早兼容、原任务恢复、绑定容错与 reset |
+| Ownership 2.1 应用：绑定／释放／转移、两个 local 编排、审批及显式重试的 TS 示例与图 | [应用集成指南](Ownership2.1-SDK应用集成指南.md) |
+| Ownership 2.1 移植：NS 验收、条件发布、通用消息交付、本地编排和文件 CAS | [开发与移植指南](Ownership2.1-SDK开发与移植指南.md) |
+| Ownership 2.1 历史格式、reset、任务恢复及验证记录 | [审查报告第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)、[旧编排第 8 节](Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)；当前无任务／WAL，以两份现行指南为准 |
 | 当前双文件关系、release/清理/重绑版本、Header 投影及 Group/Org 名片 wire | [协议 2.1](../protocol/Ownership协议定义2.1.md) §3/§4.2/§6、§1.3/§2.5；旧 SDK RPC 隔离兼容见开篇/§3.2，旧 escrow/授权头 wire 查 legacy 协议 |
 | Credential/Org 应用：登记验证、入组、续期、撤销和转让图 | [应用集成指南](凭证与组织服务SDK应用集成指南.md) |
 | Credential/Org 移植：签验、双层摘要、快照和实体恢复 | [开发与移植指南](凭证与组织服务SDK开发与移植指南.md) |

package/_packed_docs/sdk/INDEX.md

@@ -12,6 +12,8 @@
 | [0.5.21 SDK 开发与移植指南](0.5.21-SDK开发与移植指南.md) | 四端公开契约 · peer 水位/流控/提交 · frontmatter 与共识缓存 · 原 CAS/旧任务/reset · checkpoint · 语言差异和验收 |
 | [0.5.22 SDK 应用集成指南](0.5.22-SDK应用集成指南.md) | TypeScript 接入 · 消息订阅 · 两种绑定与审批恢复 · resolve 展示 · 60 秒读缓存与刷新 · 撤销同步和完整成员包 |
 | [0.5.22 SDK 开发与移植指南](0.5.22-SDK开发与移植指南.md) | 后台退避 · 群状态 · 两种绑定与 Stage/CAS · 消息内部消费 · 撤销同步 · 组织恢复及配套服务修复 · 默认读缓存 · Rust 清单 |
+| [0.5.24 SDK 应用集成指南](0.5.24-SDK应用集成指南.md) | 当前身份与消息接入 · 无任务 Ownership · local 双／三身份编排 · resolve 与文件缓存 · 凭证组织 · 升级 |
+| [0.5.24 SDK 开发与移植指南](0.5.24-SDK开发与移植指南.md) | peer／batch 提交 · NS 事实与远端 CAS · local 短连接 · 观察与 PKI 缓存 · 持久化边界 · 语言差异和验收 |
 | [CHANGELOG-0.5.6](CHANGELOG-0.5.6.md) | **0.5.6 版本更新日志**：首次签名者回源 · 下载提交前验签 · 消息窗口 · 显式 change-seed · 语言能力边界 |
 | [01-快速开始](01-快速开始.md) | 安装 · 三主体模型 · 最小示例 · 多语言构造 |
 | [02-WebSocket协议](02-WebSocket协议.md) | 握手流程 · 严格布尔 peer 能力声明 · JSON-RPC 消息格式 · 裸 WebSocket 示例 |
@@ -22,9 +24,9 @@
 | [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、sub-first Stage／owner-first 直接提交、原件 CAS 冲突分类与恢复 · 无参数 reset、绑定容错和 0.5.19 及更早任务兼容 · Group/Org not_applicable 门禁 |
-| [Ownership 2.1 应用集成指南](Ownership2.1-SDK应用集成指南.md) | 应用侧 TS 接线与审批；sub-first／owner-first 绑定、释放、三方转移和重连恢复流程图，任务与当前共识分开判断 |
-| [Ownership 2.1 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | SDK 内部 TS 接口；严格文件签验、NS fresh 共识、Storage 同会话发布、收件持久化和原 CAS 恢复流程图 |
+| [Ownership SDK 编排指南 2.1](Ownership-SDK编排指南2.1.md) | 历史编排方案；任务恢复、reset 与一次性决定已由当前两份指南的无状态流程替代 |
+| [Ownership 2.1 应用集成指南](Ownership2.1-SDK应用集成指南.md) | TS 接线与审批；双向绑定、释放、转移、两个 local 编排和显式重试的图与示例，以 NS 当前归属为准 |
+| [Ownership 2.1 开发与移植指南](Ownership2.1-SDK开发与移植指南.md) | 严格签验、NS 验收、Storage 条件发布、通用消息交付、本地编排和文件 CAS；不维护 Ownership 任务或 WAL |
 | [凭证与组织服务 SDK 应用集成指南](凭证与组织服务SDK应用集成指南.md) | TS 示例与凭证登记／验证、成员申请／邀请、续期、撤销同步和组织 rekey／finalize 转让流程图 |
 | [凭证与组织服务 SDK 开发与移植指南](凭证与组织服务SDK开发与移植指南.md) | TS 内部示例与 Verify、双层请求摘要、登记最终化、撤销快照和实体 checkpoint 流程图；跨语言契约与验收 |
 | [凭证服务 RPC 手册](09-凭证服务RPC手册.md) | Credential Service 实际注册的 health/status/register/revoke/revocationList RPC |
@@ -66,9 +68,14 @@
 - 应用身份与连接、消息订阅、两种绑定与审批恢复、resolve、60 秒读缓存与刷新、撤销同步及完整成员包 → [0.5.22 SDK 应用集成指南](0.5.22-SDK应用集成指南.md)
 - 后台退避、群状态、NS fresh 共识、sub-first Stage／owner-first 直接提交与原 CAS、消息内部消费、撤销同步、组织恢复及配套服务修复、默认读缓存与 Rust 移植 → [0.5.22 SDK 开发与移植指南](0.5.22-SDK开发与移植指南.md)
 
+### 0.5.24 接入与移植
+
+- 当前身份与消息接入、无任务 Ownership、两个 local 场景、名片及文件缓存、凭证组织与升级 → [应用集成指南](0.5.24-SDK应用集成指南.md)
+- 三主体分层、提交／ACK、NS 事实和远端 CAS、local 身份隔离、缓存新鲜度、语言差异与验收 → [开发与移植指南](0.5.24-SDK开发与移植指南.md)
+
 ### 身份与认证
 
-- 当前普通 Ownership 2.1 双文件关系、sub-first Stage／owner-first 直接提交、fresh 无锁预检、三类 CAS 冲突恢复、release／清理／重绑与 legacy 边界 → [编排指南 2.1](Ownership-SDK编排指南2.1.md)、[协议 2.1](../protocol/Ownership协议定义2.1.md)
+- 当前普通 Ownership 2.1 双文件关系、双向绑定、release／转移、两个 local 编排、文件 CAS 与显式重试 → [应用集成指南](Ownership2.1-SDK应用集成指南.md)、[开发与移植指南](Ownership2.1-SDK开发与移植指南.md)；wire 格式见[协议 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#群组生命周期)
 - TS 示例与凭证登记／验证、成员申请／邀请、续期、撤销同步和组织 rekey／finalize 转让流程图 → [应用集成指南](凭证与组织服务SDK应用集成指南.md)
 - TS 内部示例与 Verify、双层请求摘要、登记最终化、撤销快照和实体 checkpoint 流程图；跨语言契约与验收 → [开发与移植指南](凭证与组织服务SDK开发与移植指南.md)
@@ -152,6 +159,14 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 定义后台退避、群状态、Ownership Stage／CAS、内部消费、撤销与续期、缓存后端及失效契约；列出服务依赖、语言修复、Rust 定位和验收入口。
 
+### 0.5.24 SDK 应用集成指南
+
+按当前实现说明身份与消息接入、持久处理后 ACK、无任务／WAL 的 Ownership、两个 local 编排、名片与文件缓存、凭证组织和升级。关键 TypeScript 示例与流程图区分本次动作、NS 归属及故障后显式重发。
+
+### 0.5.24 SDK 开发与移植指南
+
+定义消息 peer／batch／Gate、Ownership NS 事实和远端 CAS、Stage、local 专属 slot 与身份代际、展示及文件缓存、PKI 和 Credential 查询新鲜度、组织 checkpoint。列出四端兼容差异、Rust 核查与分层验收，不将已有专项证据等同完整发布验证。
+
 ### CHANGELOG-0.5.6
 
 以 0.5.5 发布提交为基线，汇总四个 SDK 的首次签名者证书回源、`group.index` / indexed settings / `agent.md` 下载提交前校验、可信缓存读取、消息窗口、inline realtime、mention mode、显式 change-seed，以及 Python、Go、TS 和浏览器 JS 的能力边界。
@@ -174,9 +189,9 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 ### Ownership 2.1 当前契约与复审
 
-当前普通 Ownership 关系仅由 NS 当前 `agent.md` 与 owner Storage 当前 `owner.md` 确认，声明和控制消息沿用 0.5.20；owner 锁与 Header 投影本次校验结果。普通 agent 注册 owner 可选；sub-first 先 Stage、owner-first 先发布 owner.md 后由 sub 直接提交，发起前 fresh 确认无锁；普通正文更新保留全部关系材料、本人签名和原 ETag/CAS，不以前置共识或 owner Storage 为条件。release 保持 v，清理后投影 0／再次绑定默认 1；owner.md 仍通过同一上传会话及 expected_version 条件发布，当前完整原文和存在性用于读取核验。本地 revision／NS 412／Storage -32009 冲突分类、原 operation 恢复、历史任务与 reset 见编排第 8 节和开发移植 §10.3；更早 proof 与旧 owner RPC 保持原隔离边界。当前更正见 [第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)，阶段计数不能代替恢复后专项及真实旧发布包联网验收。
+当前普通 Ownership 由 NS 按 sub 当前 `agent.md` 与 owner Storage 当前 `owner.md` 验收，转移另验原 owner 授权。未锁定时以最后成功 CAS 上传的 sub 声明为候选；锁定后 accept/reject 不能改变归属，须解绑或合法转移。拒绝仅反馈，不回滚文件。SDK 不维护任务状态机、WAL、决策账本或自动恢复；文件 CAS、关系版本和 NS 原子锁定仍保留。普通名片更新保留关系材料及原 ETag/CAS；release 保持 v，清理后投影 0／再次绑定默认 1。当前流程、两个 local 编排及显式重试见[应用指南](Ownership2.1-SDK应用集成指南.md)和[移植指南](Ownership2.1-SDK开发与移植指南.md)，历史记录不能代替真实旧发布包联网验收。
 
-绑定恢复、reset 和历史任务的当前要求以[第二十二节](../audit/Ownership2.1代码审查报告.md#二十二2026-10-18-恢复发布格式与历史兼容更正)及[编排第 8 节](Ownership-SDK编排指南2.1.md#8-崩溃与响应丢失后的恢复)为准；历史第十九至二十一节仅保留阶段实施记录。
+历史任务恢复、reset 与一次性决定的阶段记录保留在[审查报告](../audit/Ownership2.1代码审查报告.md)和[旧编排指南](Ownership-SDK编排指南2.1.md)中，不作为当前实现要求。当前故障处理为查询 NS 权威事实后显式重新操作。
 
 ### 凭证与组织服务 SDK 应用集成指南
 

package/_packed_docs/sdk/Ownership-SDK/347/274/226/346/216/222/346/214/207/345/215/2272.1.md

@@ -130,11 +130,11 @@ Ownership Facade 仅提供以下接口。应用调用编排接口发起操作，
 
 编排器和 P2P 消息处理器调用同一组内部文件方法：绑定复用 `declareSubaid`、`declareOwneraid`；解绑复用 `revokeSubaid`、`revokeOwneraid`；转移由原 owner 复用 `transferOwneraid`，目标声明和提交复用两个 declare 方法。消息处理器继续原任务，不再次调用 Facade 发起接口创建任务。`checkOwnershipConsensus` 对应用公开，其校验实现也供编排层复用。
 
-绑定、释放、转移的发起接口先查询权威现状以固定起始版本，在发送消息、发布文件或删除等副作用前持久保存本端任务，返回 `operation_id` 和本端进度；超时可返回等待结果，由事件继续通知。审批接口关联已有任务，不创建新任务。`operation_id` 为 SDK 生成的 UUIDv4，不写入 agent.md、owner.md 或额外 NS 关系事实。同一 sub_aid 的本端修改串行推进；恢复复用原任务及已签署文件。
+绑定、释放、转移的发起接口先查询权威现状以固定起始版本，在发送消息、发布文件或删除等副作用前持久保存本端任务及 NS 一次性决策，返回 `operation_id` 和本端进度；超时可返回等待结果，由事件继续通知。审批接口关联已有任务，不创建新任务。`operation_id` 为 SDK 生成的 UUIDv4，不写入 agent.md、owner.md；NS 单独保存第 11 节定义的操作上下文和不可变决定，该记录不作为关系事实。同一 sub_aid 的本端修改串行推进；恢复复用原任务及已签署文件。
 
 绑定可由 sub 或 owner 发起，只有 fresh 可靠确认当前无 owner 锁才可进入绑定；`invalid`、`unavailable` 或无法确认当前基线均不能当作无锁。已有锁时只能由当前 owner 发起解绑或转移。发起 API 表达发起方意愿，接收方通过 `ownership.request` 同意或拒绝。转移仅由 NS 当前原 owner 发起；新 owner 和 sub 分别审批，原 owner 收齐两方同意后才发布转移授权。两方审批可任意先后；任一方拒绝，原 owner 通知另一方停止本次待审批任务，不发布授权，原关系保持。
 
-三方意向共识只保存在各端 SDK 任务中，不写入协议文件或额外 NS 关系事实。sub 的同意还须落实为其自行签署、提交目标 agent.md；同意消息本身不能完成转移。
+参与方决定由 sub 归属 NS 持久化裁决，各端 SDK 保留本地执行检查点，不同步整份任务；决定不写入关系协议文件，也不作为额外 NS 关系事实。sub 的同意还须落实为其自行签署、提交目标 agent.md；同意消息或决策记录本身不能完成转移。
 
 审批决定限定 `operation_id`、操作、参与 AID 及起始/目标关系版本，在发送回复或发布文件前持久保存；不能用一个任务的同意批准另一目标。审批 API 仅用于待审批任务，批准后的停止按第 2.6 节处理。
 
@@ -937,3 +937,50 @@ version: 1.0.0
 恢复、降级与审计沿用第 8、9 节；分别核对 NS 和自身 Storage 的两份文件，不能退为单文件验收。
 
 self-owner 共识仅证明本方自主管理声明；外部 owner 的身份及业务信任检查按第 9.1 节，审计同样保存两个完整文件。
+
+## 11. AID 级多设备一次性决策
+
+### 11.1 权威与不可变约束
+
+同一操作统一访问 `sub_aid` 归属的 NS。owner、新 owner 及其不同设备不分别在各自域建立副本裁决。NS 通过已有 Bearer 验证取得真实 AID；跨域使用该 AID 归属域的认证验证，不信任 JSON 自报的设备身份。
+
+NS 保存两类小记录：
+
+| 记录 | 唯一键 | 保存内容 |
+| --- | --- | --- |
+| operation 上下文 | `operation_id` | 操作、sub、原/目标 owner、发起方、起始/目标版本。 |
+| AID 决定 | `operation_id, deciding_aid` | 稳定 `decision_id`、`accept/reject`、拒绝原因、NS 提交时间。 |
+
+发起方以认证身份登记自己的 `accept` 并创建 operation，之后才能发布文件或发送请求。其它参与方只能对已登记且完整上下文匹配的 operation 决策。角色重合时，同一 AID 只占一个决策槽。不同 AID 的决定相互独立；例如 transfer 的 sub 和新 owner 各有一次决定机会。
+
+决定首次提交成功后永不修改。相同 `decision_id`、相同决定和原因的重试返回原记录；其它提交返回 `operation_already_processed` 及原决定。同一 ID 更换载荷也不能改决定。operation 上下文不同返回 `conflict`，不能将旧 ID 用于另一目标或版本。
+
+### 11.2 HTTP 接口与事务
+
+接口为 sub 权威 NS 的 `/api/nameservice/ownership/decisions`，GET、POST 均要求认证且响应 `Cache-Control: no-store`，携带 Bearer 的请求不跟随重定向。
+
+POST 请求包含 `context`、`deciding_aid`、`decision_id`、`decision` 和可选 `reason`。`context` 固定为 `operation_id`、`operation`、`sub_aid`、`owner_aid`、`initiator_aid`、`base_relation_version`、`target_relation_version`；transfer 另含 `new_owner_aid`。各方本地基线可能因 Stage 而不同，因此不以本地任务的基线摘要生成跨设备上下文。原件、完整 statement、签名字节及 CAS 校验仍按原文件协议执行。
+
+首次写入返回 HTTP 201，完全相同的重试返回 HTTP 200，内容为 `decision` 原记录及 `idempotent`。原记录固定为 `{context, deciding_aid, decision_id, decision, reason, decided_at}`，`context` 保持嵌套，`reason` 缺省为空字符串，`decided_at` 为 NS 的整数毫秒时间。已有其它决定返回 HTTP 409，错误为 `operation_already_processed`，同时返回原记录。GET 使用 `operation_id`、`deciding_aid` 查询参数认证当前参与 AID，返回固定 `context` 及该 operation 的决定列表；非参与方不得查询。仅 404 且 JSON 错误为 `operation_not_found` 表示不存在，认证失败、路由错误或依赖不可用均不得视为未决定。
+
+数据库事务锁定 operation 行并核对固定上下文，再检查该 AID 的决定。已有决定优先按幂等规则返回，不因关系文件随后变化而重新决定。首次决定在同一事务中锁定、核对校验时读取的 sub 文档和 pending 快照，再插入唯一决定；快照竞争返回冲突。只有提交成功才能返回成功响应，数据库故障或提交结果未知均不能本地放行。唯一约束和事务负责跨进程、跨 NS 实例互斥，进程内锁不承担此保证。
+
+### 11.3 SDK 提交与故障恢复
+
+审批前先持久保存稳定的 `decision_intent`，包含请求 ID、原决定和原因；然后执行原有身份、请求上下文及 fresh 文件校验，向 NS 提交。收到成功记录后先保存 receipt，才改变本端审批状态、排队回复、签字或发布文件。
+
+若提交响应丢失，恢复先查询 NS。原 intent 已提交时恢复原决定；尚未提交时重新校验并以同一 ID 重试，不能另选相反决定。本机已有持久化、校验匹配的不可变 receipt 时直接复用，不随每次推进重复查询；待审批副本和新收到的对端决定仍查询权威记录。NS 不可用时保留任务和 intent，不发送审批、不发布文件，也不以本地缓存推断未处理。
+
+P2P 审批消息和同 AID 其它设备的 self-sync 副本仅触发权威查询。远端审批必须与 NS 中对应 AID 的决定一致，不能以迟到消息覆盖已确定的相反决定。ready 消息、转移授权和双方文件验收仍沿原协议，不由 receipt 替代。
+
+### 11.4 待办回收与完成边界
+
+其它设备查到本 AID 已由另一 intent 决定时，结束本设备的待审批副本并移出 pending；后续点击返回 `operation_already_processed`。保留可阻止迟到消息复活的本地终态和 NS 最小决定，不补造本设备的签字、原件或发布成功证据。包含实际文件提交、outbox 或必要清理证据的执行任务不能作为普通审批副本删除。
+
+拒绝表示该 AID 的本次决定已结束；同意只表示批准，绑定仍可能执行中。只有当前 `agent.md + owner.md` 有效共识及原任务提交证据满足既有完成规则，才确认执行完成。决定后的执行失败保留原决定，不重新开放审批；新意图必须使用新 operation。
+
+回收由现有收件、self-sync 提示、重连恢复和显式审批操作触发，不新增周期轮询。离线设备的界面可以暂存旧待办，但上线后的查询及每次提交均由 NS 裁决，不能成功提交第二次决定。NS 决定不随本地 pending 回收、重置或历史任务清理删除。
+
+### 11.5 TDD 验收边界
+
+必须覆盖并发 accept/reject 只胜出一次、重复拒绝、同 ID 同载荷重试、同 ID 改载荷、跨 AID 上下文冲突、跨域认证错配、数据库失败和提交响应丢失；四 SDK 还须覆盖稳定 intent 落盘、另一设备决定后的 pending 收敛、迟到 self-sync、未登记请求拒绝及恢复不重决策。原租约、revision CAS、签名字节和条件写入回归继续保留。