@agentunion/fastaun 0.5.23 → 0.5.24

package/_packed_docs/sdk/Ownership2.1-SDK/345/272/224/347/224/250/351/233/206/346/210/220/346/214/207/345/215/227.md

@@ -1,6 +1,6 @@
 # Ownership 2.1 SDK 应用集成指南
 
-面向应用开发者，按“准备身份 → 发起 → 审批 → 核验 → 恢复”接入。示例使用 Node.js TypeScript SDK `@agentunion/fastaun` 当前工作区 `0.5.22`（未发布，升级基线 `0.5.21`），Node.js ≥22.16.0；实际依赖须具有本文接口。
+面向应用开发者，按“准备身份 → 提交文件 → 通知／同意 → NS 验收”接入。示例使用 Node.js TypeScript SDK `@agentunion/fastaun` 当前工作区 `0.5.24`，Node.js ≥22.16.0；实际依赖须包含本文接口。
 
 协议见 [Ownership 2.1](../protocol/Ownership协议定义2.1.md)，SDK 内部实现见 [开发与移植指南](Ownership2.1-SDK开发与移植指南.md)。
 
@@ -10,17 +10,19 @@
 | --- | --- |
 | sub | 被管理身份；自己签署并以本人身份向 NS 提交 `agent.md`。 |
 | owner／新 owner | 自己签署并向本人 Storage 发布 `sub_aids/{sub_aid}/owner.md`。 |
-| NS | 根据这两份当前权威文件核验关系；Storage 中的 sub 名片副本不参与验收。 |
+| NS | 根据这两份当前权威文件验收并锁定关系；Storage 中的 sub 名片副本不参与验收。 |
 
 owner 权限不包含 sub 私钥或代签、代上传能力。普通名片更新保留全部关系字段及原 CAS；关系无效或暂不可确认只影响依赖 owner 的授权，不阻断普通名片和通信。
 
-本流程用于普通主体；human 可作为 owner，不能作为声明 owner 的 sub。Group/Org 自身使用专属创建、解散和强制 rekey 转让流程：任务方法抛出 `not_applicable`，共识方法返回同名状态。它们仍可按普通 owner 规则管理其他 sub。
+本流程用于普通主体；human 可作为 owner，不能作为声明 owner 的 sub。Group/Org 自身使用专属创建、解散和强制 rekey 转让流程：关系操作抛出 `not_applicable`，共识方法返回同名状态。它们仍可按普通 owner 规则管理其他 sub。
+
+SDK 不维护 Ownership 任务状态机、WAL 或后台恢复，不提交独立 decisions 回执。NS 以归属事实判断冲突；锁定后，新的 accept/reject 不能改变关系，须走释放或转移。
 
 ## 2. 接入前提与能力检查
 
 - 各端具有自己的私钥、有效证书和客户端；`load()` 成功后仍检查私钥。
-- sub 的初始 `agent.md` 已在 NS 可读；部署具备 NS 2.1、权威 Storage、P2P 和持久任务能力。共识查询成功不代表所有发布能力可用。
-- 固定可写的 `aunPath`、解密 seed、设备和 slot；任务保存在 `{aunPath}/AIDs/{aid}/aun.db`，重启沿用原数据。
+- sub 的初始 `agent.md` 已在 NS 可读；部署具备本轮 NS 2.1 验收、Stage、权威 Storage 能力。交互流程另需 P2P；本地编排不发 P2P。
+- 保管好各身份的 `aunPath`、解密 seed 和私钥；普通长连接使用各自的设备和 slot。本地编排由 SDK 另建专属 slot 的短连接。
 - 启用 TLS 校验并配置可信根；`rootCaPath` 用于 AUN 证书验证，Node.js HTTPS 信任仍须单独正确配置。外部地址使用 `ns.{issuer}`、`st.{issuer}`。
 
 ## 3. EC CLI 集成示例：sub 发起，human owner 同意
@@ -48,19 +50,18 @@ if (!loaded.data.aid.isPrivateKeyValid()) throw new Error('本身份私钥不可
 const client = new AUNClient(loaded.data.aid);
 ```
 
-两端先订阅再连接。下文 `saveMessage`、`updateView`、`saveTask` 为应用自己的消息持久处理、界面更新和业务任务保存函数。
+两端先订阅再连接。下文 `saveMessage`、`updateView` 为应用自己的消息持久处理和界面更新函数，不要求应用保存 Ownership 任务。
 
 ```ts
 function watch(client: AUNClient): void {
   client.on('message.received', payload => saveMessage(payload));
-  for (const event of ['ownership.action_required', 'ownership.progress',
-    'ownership.completed', 'ownership.rejected', 'ownership.stopped', 'ownership.error']) {
+  for (const event of ['ownership.completed', 'ownership.rejected']) {
     client.on(event, payload => updateView(event, payload));
   }
 }
 ```
 
-`0.5.22` 至少需要 `message.received/message.recalled/message.batch` 中一种普通消息订阅才启动后台 P2P 拉取；已有订阅直接复用。消息处理须完成持久交付后返回，不能用空回调 ACK。仅订阅 `ownership.*` 不够；控制消息由 SDK 内部消费，仍遵守队列背压。
+当前 TS 实现至少需要 `message.received/message.recalled/message.batch` 中一种普通消息订阅才启动后台 P2P 拉取；已有订阅直接复用。消息处理须完成持久交付后返回，不能用空回调 ACK。仅订阅 `ownership.*` 不够；控制消息由 SDK 内部消费，仍遵守队列背压。
 
 ### 3.3 owner App 先订阅审批，再连接
 
@@ -70,10 +71,10 @@ function watch(client: AUNClient): void {
 ownerClient.on('ownership.request', payload => {
   const request = readApproval(payload);
   showApproval(request, async accept => {
-    const task = accept
+    const result = accept
       ? await ownerClient.acceptOwnershipRequest(request.operation_id)
       : await ownerClient.rejectOwnershipRequest(request.operation_id, '用户拒绝');
-    await saveTask(task);
+    updateView('ownership.result', result);
   });
 });
 ```
@@ -83,15 +84,15 @@ watch(ownerClient);
 await ownerClient.connect({ auto_reconnect: true });
 ```
 
-收件回调不等待用户决定；按 `operation_id` 幂等展示，不因重连重复审批或改变已保存的决定。
+收件回调不等待用户决定；按 `operation_id` 去重展示。SDK 使用经过认证的原始请求执行 accept/reject，应用不要自行拼造请求；失败按 §8 查询 NS 后重新发起。
 
 ### 3.4 EC／Evolcore 的 sub 发起绑定
 
 ```ts
 watch(subClient);
 await subClient.connect({ auto_reconnect: true });
-const task = await subClient.bindOwneraid('owner.agentid.pub');
-await saveTask(task);
+const result = await subClient.bindOwneraid('owner.agentid.pub');
+updateView('ownership.result', result);
 ```
 
 ```mermaid
@@ -101,16 +102,16 @@ sequenceDiagram
     participant O as human owner App
     participant T as owner Storage
     S->>N: fresh 确认无锁及 Stage 能力
-    S->>S: 保存同意、签名原件和原 CAS
+    S->>S: 本次签署 agent.md，保留文件 CAS
     S->>N: Stage 条件提交 agent.md
     N-->>S: pending / v+1 / unlocked
     S->>O: 加密 bind.request
-    O->>O: 核验并保存请求，用户点击同意
+    O->>O: 核验原始请求，用户点击同意
     O->>T: 本人发布匹配的 owner.md
     O->>N: fresh 检查双文件
     N-->>O: consensus / locked
-    O-->>S: 提示结果；sub 可离线后恢复
-    S->>N: fresh 核验目标及本人原件后完成
+    O-->>S: 发送结果通知；sub 无需在线或再次 PUT
+    S->>N: 应用查询当前共识并更新界面
 ```
 
 sub 发起即表达本端同意，不再调用审批方法。Stage 只保存待确认名片，此时公共共识为 `single_sided`；owner 同意并发布后，NS 可直接验收已有候选，sub 无需再次 PUT。
@@ -124,7 +125,7 @@ const registered = await store.register('helper.agentid.pub', {
 if (!registered.ok) throw new Error(registered.error.message);
 ```
 
-这是显式 `bindOwneraid` 的替代入口。注册先初始化无关系名片并保存固定 ID 的意图，连接后 SDK 续跑绑定，owner 仍须审批；不要再发起另一绑定。省略 owner 只注册普通 agent；`registered: true` 不表示关系成立。
+这是显式 `bindOwneraid` 的替代入口。注册先初始化无关系名片，再于本次调用内用专属短连接提交绑定并通知 owner，最后关闭连接；owner 仍须审批。省略 owner 只注册普通 agent；`registered: true` 不表示关系成立。失败后先检查已注册身份与 NS 状态，需要时显式调用 `bindOwneraid`，不等待连接后自动续跑。
 
 ### 3.6 通用签验与多签名片
 
@@ -137,7 +138,7 @@ if (!verified.ok || !verified.data.valid) throw new Error('验签失败');
 
 默认 `raw` 为 detached 签名；文件输入须显式 `inputType: 'file'`，附签用 `append: true`。验签检查全部已有签块，数学验签不等于当前证书或 owner 授权。签名不发布文件；完整参数见 [API 手册](06-API手册.md#通用-sign--verify)。
 
-## 4. 七个 Facade 的参数、角色与结果
+## 4. Facade 的参数、角色与结果
 
 | 方法 | 本端角色／结果 |
 | --- | --- |
@@ -145,25 +146,25 @@ if (!verified.ok || !verified.data.valid) throw new Error('验签失败');
 | `bindSubaid(subAid)` | owner 发起绑定，sub 审批。 |
 | `releaseSubaid(subAid)` | 当前 owner 释放，不要求 sub 在线。 |
 | `transferSubaid(subAid, newOwnerAid)` | 当前 owner 发起，sub 和新 owner 审批。 |
+| `bindLocalSubaid(subClient)` | 本地 owner 与 sub 双身份自动绑定，见 §6.5。 |
+| `transferLocalSubaid(subClient, newOwnerClient)` | 本地旧 owner、sub、新 owner 三身份自动转移，见 §6.6。 |
 | `acceptOwnershipRequest(operationId)` | 同意本端已验证的 bind/transfer 请求。 |
 | `rejectOwnershipRequest(operationId, reason?)` | 拒绝同一请求。 |
 | `checkOwnershipConsensus(subAid?)` | 只读当前共识；省略参数检查本端 AID。 |
 
-前六项返回 `Promise<OwnershipTaskResult>`，包含 `operation_id`、参与方、base/target 版本及 `status/step`；status 为 `pending/completed/rejected/stopped/error`。共识查询返回独立的 `OwnershipConsensusResult`。
+除共识查询外，方法返回 `Promise<OwnershipTaskResult>`；这是保留的类型名，表示本次调用结果，包含 `operation_id`、参与方、base/target 版本及 `status/step`。共识查询返回独立的 `OwnershipConsensusResult`。
 
-保存业务记录与 `operation_id` 的对应关系。Promise 返回、ACK、审批通过都不是完成；`completed` 表示本端已核验本次目标，后续清理错误不撤销该结果。没有公开按 ID 查询任务、取消或强制解锁接口。
+当前 TS 普通交互方法返回 `completed/step=local_actions`，只表示当次文件与通知动作执行完成；例如 sub 发出请求后仍可能是 `single_sided`。本地编排会额外确认目标共识。应用统一以 §7 的 NS 共识判断当前归属，不以返回值、ACK 或通知代替验收。SDK 没有待办任务查询、取消或强制解锁接口。
 
 ## 5. 审批与本地事件接入 UI
 
 | 本地事件 | 处理 |
 | --- | --- |
 | `ownership.request` | 展示已验证请求，等待用户或明确策略决定。 |
-| `ownership.action_required` | sub 清理旧关系字段需要明确授权。 |
-| `ownership.progress` | 更新阶段。 |
-| `ownership.completed` | 保存本任务完成记录；当前关系另查共识。 |
-| `ownership.rejected/stopped/error` | 展示拒绝、停止或错误；完成后的清理错误单独显示。 |
+| `ownership.completed` | 本次执行观察到共识，可刷新界面；当前关系另查共识。 |
+| `ownership.rejected` | 展示对端拒绝通知；不代表 NS 回滚或解除关系。 |
 
-载荷直接传入回调，没有 `event.data` 包装；包含任务字段及 `local_roles`，request 另含可信 `requester_aid`。按任务 ID、事件、step 幂等更新；`relation_version` 是本任务实际验收版本，不能替代当前查询。事件字段见 [编排指南 §2.6](Ownership-SDK编排指南2.1.md#26-本地事件与完成依据)。
+以上为当前 TS 工作流实际发出的事件，不依赖旧 `progress/action_required/stopped/error` 事件。载荷直接传入回调，没有 `event.data` 包装；request 含操作、参与方、base/target 版本和可信 `requester_aid`，不要依赖旧 `local_roles`。`operation_id` 只关联通知与界面，不是 NS 的归属锁或决定记录。调用错误仍须处理返回的 `status/code/reason` 和异常。
 
 ## 6. 关系操作流程
 
@@ -172,8 +173,8 @@ if (!verified.ok || !verified.data.valid) throw new Error('验签失败');
 sub-first 见 §3.4；owner-first 如下：
 
 ```ts
-const task = await ownerClient.bindSubaid('helper.agentid.pub');
-await saveTask(task);
+const result = await ownerClient.bindSubaid('helper.agentid.pub');
+updateView('ownership.result', result);
 ```
 
 ```mermaid
@@ -185,22 +186,24 @@ sequenceDiagram
     O->>N: fresh 确认无锁
     O->>T: 按原条件发布 owner.md
     O->>S: bind.request
-    S->>S: 验证并固定提案全文／SHA，用户明确同意
+    S->>S: 验证当前提案，用户明确同意
     S->>N: 直接条件提交 agent.md，不使用 Stage
     N->>T: 核对当前声明
     N-->>S: consensus / locked
-    S-->>O: 提示结果；owner 自行 fresh 核验完成
+    S-->>O: 提示结果；owner 查询当前共识
 ```
 
-绑定目标版本为当前可见声明 `v+1`，无声明时从 `1` 开始。只有可靠无锁状态可发起；`invalid/unavailable` 不能当作无锁。owner-first 正常成功无需 `bind.accept/owner.ready` 往返。
+初次绑定版本从 `1` 开始；替换未锁定的候选时沿用候选版本，不因重新通知而递增。只有可靠无锁状态可发起；`invalid/unavailable` 不能当作无锁。NS 验收不以 `bind.accept` 通知到达或发起端再次在线为前提。
+
+拒绝仅发送通知，不删除或回滚已上传文件。未锁定前，sub 可用 CAS 替换 owner 声明，以最后成功上传的 `agent.md` 为准：先声明 B 后声明 C，B 同意不能形成共识；C 同意才可验收，C 拒绝则保留单边声明。NS 锁定后，同目标 accept 可返回已完成，reject 或不同目标不能改变归属；不再维护跨设备“唯一决定”记录。
 
-拒绝仅清理仍属于本任务、未锁定且原文／摘要／CAS 匹配的候选或邀请；不能删除已验收文件。释放后重绑同一 owner 前，先清除 sub 的旧声明，避免覆盖释放依据。
+释放后重绑同一 owner 前，先清除 sub 的旧声明，避免覆盖释放依据。
 
 ### 6.2 释放：原 owner 发起，sub 可以离线
 
 ```ts
-const task = await ownerClient.releaseSubaid('helper.agentid.pub');
-await saveTask(task);
+const result = await ownerClient.releaseSubaid('helper.agentid.pub');
+updateView('ownership.result', result);
 ```
 
 ```mermaid
@@ -208,23 +211,21 @@ flowchart LR
     A[原 owner 发起] --> B[发布同版本 v 的 release]
     B --> C[NS fresh 确认 released / v]
     C --> D[owner 完成；sub 可离线]
-    D --> E[sub 回源确认释放]
-    E --> F{有匹配的本人历史同意吗}
-    F -->|有| G[本人条件清理 agent.md]
-    F -->|没有| H[action_required：应用明确决定清理]
-    H --> G
-    G --> I[unbound / 0]
+    D --> E[sub 收到合法释放通知]
+    E --> F[当次回源验证并条件清理 agent.md]
+    F --> G[unbound / 0]
+    D --> H[通知未处理则仍为 released，不等待后台任务]
 ```
 
-释放不递增版本。权威确认 owner 文件不存在也可证明释放，网络错误或普通 404 不可。自动清理须匹配本人已同意的原 bind/transfer 完整声明；否则应用明确决定后，用本人 `store.uploadAgentMd(subAid, content)` 清除旧关系字段。release 不接受 accept/reject 审批。
+释放不递增版本。权威确认 owner 文件不存在也可证明释放，网络错误或普通 404 不可。sub 收到合法 release 通知时，当次回源核验并用本人身份条件清理声明，不依赖历史审批任务。若通知未处理，先按 `released` 展示；当前没有公开的强制清理 Facade，不能用普通 `uploadAgentMd` 删除关系字段。release 不接受 accept/reject 审批。
 
-字段已空不能单独认领某任务完成；SDK 仍核对本任务原件和提交证据。关系释放、sub 字段清理、旧 owner 文件清理分别展示。
+NS 已确认 `released/unlocked` 即关系释放；sub 字段未清不恢复旧 owner 权限，清理后为 `unbound/0`。关系释放和文件清理分开展示。
 
 ### 6.3 三方转移
 
 ```ts
-const task = await ownerClient.transferSubaid('helper.agentid.pub', 'next.agentid.pub');
-await saveTask(task);
+const result = await ownerClient.transferSubaid('helper.agentid.pub', 'next.agentid.pub');
+updateView('ownership.result', result);
 ```
 
 ```mermaid
@@ -233,25 +234,74 @@ sequenceDiagram
     participant S as sub
     participant N as 新 owner
     participant NS as sub NS
+    O->>O: 发布指定目标、v+1 和固定期限的转移授权
     O->>S: transfer.request
     O->>N: transfer.request
-    S-->>O: 明确同意
-    N-->>O: 明确同意
-    O->>O: 发布指定目标、v+1 和固定期限的转移授权
-    N->>N: 验证授权，发布 v+1 owner.md
-    S->>NS: 本人条件提交目标 agent.md
-    NS-->>S: 核验三方材料，直接从 v 切到 v+1
-    S-->>O: 提示结果，各端自行 fresh 核验
-    S-->>N: 提示结果，各端自行 fresh 核验
+    par sub 同意（无先后要求）
+        S->>NS: 验证授权，Stage 提交目标 agent.md
+        NS-->>S: 材料未齐时保留旧 active / locked / v
+    and 新 owner 同意
+        N->>N: 验证授权，发布 v+1 owner.md
+    end
+    S->>NS: 验收当前材料；任一参与方可触发检查
+    NS-->>S: 三方材料一致，原子切到新 owner / v+1
+    S-->>O: 提示结果，各端查询当前共识
 ```
 
-审批未齐不发布授权；任一待审批方拒绝则停止未提交流程。授权过期不自动解除旧关系，恢复不延期、不换目标，也不改成“先释放再绑定”。
+旧 owner 先发布授权再通知。sub 与新 owner 各自上传本人文件，不要求同时在线，也没有同意时序要求。拒绝只反馈，不撤销已发布材料；授权过期或撤回不解除旧活动关系。材料未齐时 NS 保留旧 owner 锁，达成一致后原子切换，不经过“先释放再绑定”。
 
 ### 6.4 自拥有与角色重合
 
-同一 AID 的多个角色合并为一次决定，不给自己发 P2P；双文件签署和 NS 核验仍执行。`sub.bindOwneraid(subAid)` 建立 self-owner；外部 owner 转给 sub 时，sub 同时审批 `sub/new_owner` 两个角色。human 禁止 self-owner，原 owner 与新 owner 相同不是有效转移。
+同一 AID 承担多个角色时，一次调用执行本人的全部文件动作，不给自己发 P2P；双文件签署和 NS 核验仍执行。`sub.bindOwneraid(subAid)` 建立 self-owner；外部 owner 转给 sub 时，sub 同时审批 `sub/new_owner` 两个角色。human 禁止 self-owner，原 owner 与新 owner 相同不是有效转移。
+
+### 6.5 本地双身份自动绑定
+
+Evolcore／EC CLI 同时掌握 daemon 与新 sub 的身份材料时，由 daemon 调用 `bindLocalSubaid(subClient)` 自动完成绑定，无需 P2P 或人工确认。传入两个 client 用于提供身份，不要求应用另行 connect；SDK 创建 `ownership-UUID` 专属 slot 的短连接，完成认证、发布与验收后在 `finally` 关闭，避免占用普通长连接 slot。
+
+```ts
+const bound = await daemonClient.bindLocalSubaid(subClient);
+if (bound.status !== 'completed') throw new Error(bound.reason);
+showBound({
+  sub_aid: bound.sub_aid, owner_aid: bound.owner_aid,
+  relation_version: bound.target_relation_version,
+});
+```
+
+```mermaid
+flowchart LR
+    A[daemon + sub 两个本地 client] --> B[SDK 创建两身份专属短连接]
+    B --> C[daemon 签署并发布 owner.md]
+    C --> D[sub 签署并条件提交 agent.md]
+    D --> E[NS 验收一致归属并锁定]
+    E --> F[返回结果，关闭短连接]
+```
+
+### 6.6 本地三身份自动转移
 
-## 7. 任务完成与当前共识六态
+当前 owner、本地 sub 和目标 owner 的身份材料都可用时，由当前 owner 调用 `transferLocalSubaid(subClient, newOwnerClient)`。SDK 为三个身份创建专属短连接，先发布原 owner 授权和新 owner 声明，再由 sub 提交名片并确认 NS 共识；不发 P2P，不经过先释放再绑定。
+
+```ts
+const moved = await daemonClient.transferLocalSubaid(subClient, nextAgentClient);
+if (moved.status !== 'completed') throw new Error(moved.reason);
+showBound({
+  sub_aid: moved.sub_aid, owner_aid: moved.new_owner_aid,
+  relation_version: moved.target_relation_version,
+});
+```
+
+```mermaid
+flowchart LR
+    A[旧 owner + sub + 新 owner 三个本地 client] --> B[SDK 创建三身份专属短连接]
+    B --> C[旧 owner 发布指定目标的转移授权]
+    C --> D[新 owner 签署并发布 owner.md]
+    D --> E[sub 签署并条件提交新 agent.md]
+    E --> F[NS 验收并原子切换归属]
+    F --> G[核验目标，条件清理旧授权并关闭短连接]
+```
+
+两个本地方法仅支持不同的 `type: agent` 身份，每个 client 均须有有效私钥、证书及 NS 名片。human 作为 owner 仍走 §3／§6.3 的现有确认流程；本地方法不替人同意，也不自动沿 daemon 的 owner 关系推导授权。失败后按 §8 查询 NS 再重新发起，不等待后台恢复。
+
+## 7. 当前共识六态与完成判断
 
 ```ts
 const current = await ownerClient.checkOwnershipConsensus('helper.agentid.pub');
@@ -271,42 +321,43 @@ if (current.status === 'consensus' && current.owner_aid === 'owner.agentid.pub')
 
 Group/Org 的 `not_applicable` 不属于六态。先判断 status，不能把占位版本 0／unlocked 当成无锁证据。无目标上下文的查询也不能枚举独立 owner 邀请。
 
-普通下载的 `verification.ownership_status` 是 legacy 展示字段；当前授权使用 fresh 共识。敏感操作由执行端核对调用者、sub、owner、权限范围及完整声明；清理后可再次出现版本 1，版本号不是全局关系标识。
+普通下载的 `verification.ownership_status` 是 legacy 展示字段。普通 peer 名片展示可按 ETag 复用 Ownership 快照，不必轮询重检；`owner.md` 可独立变化，实际管理操作仍由 SDK／服务端回源核验当前归属、权限和文件 CAS。清理后可再次出现版本 1，版本号不是全局关系标识。
 
-## 8. 断线与重启恢复
+## 8. 故障后查询与重新发起
 
 ```mermaid
 flowchart LR
-    A[恢复原身份、目录、设备和 slot] --> B[订阅后连接]
-    B --> C[SDK 读取原任务、审批、签名字节和 CAS]
-    C --> D{fresh 核对结果}
-    D -->|完整目标与本任务证据匹配| E[确认原任务完成]
-    D -->|尚未提交且原条件有效| F[只补未完成步骤]
-    D -->|依赖暂不可用| G[保留 pending]
-    D -->|原件或关系已变化| H[停止旧写入]
+    A[恢复本人身份，订阅后连接] --> B[查询 NS 当前共识]
+    B --> C{当前事实}
+    C -->|目标归属已锁定| D[按已完成更新界面]
+    C -->|仍无锁或只有单边声明| E[用户显式重新发起绑定]
+    C -->|仍锁定原 owner| F[需要时重新发起转移或释放]
+    C -->|已锁定其它 owner| G[停止旧请求，按当前归属处理]
+    C -->|unavailable / invalid| H[先排除依赖或材料问题]
 ```
 
-`connect()` 返回不表示恢复已完成。应用恢复自己的业务任务记录并幂等更新 UI；SDK 复用原 operation，不重新绑定或转移。合法历史 completed 保留，当前关系另查。
+SDK 不保存未完成操作，不在 `connect()` 后扫描任务或补发通知。若上传成功但通知失败，已提交文件仍然有效；先查 NS，目标已锁定则视为完成，否则显式重新发起。新调用有新的 `operation_id`，NS 按当前归属事实和 CAS 验收，不靠旧消息 ID 锁定关系。
 
-`resetOwnershipTask()` 仅归档当前身份发起的未完成任务，不删除远端候选、不解绑或解锁；普通断线不用 reset。历史任务和三类 CAS 冲突见 [移植指南 §10](Ownership2.1-SDK开发与移植指南.md#10-持久任务审批与恢复)。
+审批时需要经过认证的原始请求。实现可从正常消息记录重取原请求；若已不可恢复，让发起方重新发起，不重建审批任务。不要调用旧 `resetOwnershipTask()` 来期望回滚或续跑；它不再是新流程的一步。
 
 ## 9. 错误处理与安全降级
 
 | 错误 | 处理 |
 | --- | --- |
-| `persistence_unavailable` | 恢复原存储，停止副作用，不删除数据库伪造新任务。 |
 | `unsupported_protocol` | 核对 SDK／服务能力，不回退 legacy 写入。 |
 | `owner_locked` | 由当前 owner 释放或转移。 |
 | `conflict` | fresh 核对已提交目标；真实变化则停止，不换 CAS 强写。 |
-| `forbidden/operation_not_found/invalid` | 检查角色、身份、任务关联或材料，不盲重试。 |
-| `unavailable` | 保留原任务和字节，依赖恢复后继续核验。 |
+| `forbidden/operation_not_found/invalid` | 检查角色、身份、原始请求或材料；请求丢失时重新发起，不盲重试。 |
+| `unavailable` | 恢复依赖后查询 NS；未完成时显式重新发起。 |
 
-错误可能来自异常、任务／事件或共识结果。结果读取 `code/reason/retryable`；抛出的 `AUNError` 读取 `stringCode/retryable`，其 `code` 是数字 RPC 码。`retryable` 不授权换目标、重签或延期。
+错误可能来自异常、当次结果或共识结果。结果读取 `code/reason/retryable`；抛出的 `AUNError` 读取 `stringCode/retryable`，其 `code` 是数字 RPC 码。不要绕过 CAS 强写，或因网络错误认定远端未提交；重新发起仍须按当前 NS 事实验收。
 
 ## 10. 可选托管与旧接口迁移
 
 托管和凭据交接由应用独立决定；关系转移不会自动撤销旧 owner 已掌握的私钥、证书或 token。
 
-旧 `bindOwner/bindAid/releaseOwnership` 在新 SDK 中返回 `unsupported_protocol`；分别改用 `bindOwneraid/bindSubaid/releaseSubaid`。旧 proof、metadata owner 和旧查询不能证明 2.1 共识。新服务端保留旧 SDK 隔离兼容，新 SDK 的 2.1 操作不兼容旧服务端；不能清空旧关系强行迁入。
+旧 `bindOwner/bindAid/releaseOwnership` 在新 SDK 中返回 `unsupported_protocol`；分别改用 `bindOwneraid/bindSubaid/releaseSubaid`。旧 proof、metadata owner 和旧查询不能证明 2.1 共识，不能清空旧关系强行迁入。
+
+完整的新语义应配套发布 NS 与四 SDK。已有 2.1 NS 的普通绑定、本地绑定及目标 owner 文件先提交的本地转移，正常路径仍可能可用；sub 先同意的转移、Stage 与 owner 文件交错及相同归属重新签发，需要本轮 NS 修复。新 SDK 不调用 decisions，旧服务保留该接口不影响它；过渡版 SDK 若强依赖已移除接口，则需升级。Rust SDK 未随本轮改造，不能套用本文“无任务、无 WAL”的实现结论。
 
 Group/Org 名片由实体主签、当前 owner token 上传；失败稿保留完整多签原文、固定 owner／证书代际及原 CAS，应用显式重试，重连不自动 PUT。格式见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)。