@agentunion/fastaun 0.5.33 → 0.5.35

package/CHANGELOG.md

@@ -6,9 +6,66 @@
 
 ---
 
-## 0.5.33 — 未发布
+## 0.5.35 — 2026-11-12
 
-按当前工作区未提交变更整理；四端接口、实现差异和服务依赖见 [parity 0.5.33](../python/CHANGES_FOR_PARITY.md#v0533)。
+对照已发布的 `0.5.34`，包含发布后的已提交变更及当前工作区增量；比较基线和四端实现边界见 [parity 0.5.35](../python/CHANGES_FOR_PARITY.md#v0535)。
+
+### EventService 订阅与本地收发
+
+- `subscribe`／`unsubscribe` 支持点分层 `*` 通配事件名；按当前目录和授权展开，不支持 `**` 或自动匹配未来新增事件。
+- `subscribe(busAid, events, options)` 新增 `publisherAids`、`publisherTypes`、`publisherExttypes`；线上字段为 snake_case，同字段内任一匹配、不同字段同时满足，类型取自验签通过的发布者名片。
+- 过滤条件随 SQLite 订阅状态持久化及恢复；订阅条件变化时淘汰队列中属于旧订阅代次的事件。同一 Client、Bus AID 和 device／slot 可在进程内收发，保留授权、租约、TTL、容量及去重边界。
+
+### 消息同步与 Echo
+
+- 后台 Pull 提交后异步合并累计 ACK，失败重试、更新发送参数并隔离身份／连接／namespace 代际；前台 Pull 继续等待 ACK，关闭时有限等待后台确认。
+- 减少已被在线交付覆盖的重复 Pull／ACK；历史同步移除 `history_bytes_per_second` 主动节流，保留并发、页字节、在途内存和背压限制，辅助连接创建／退役时更新需求通知。
+- 连接成功后的自动补拉和组织身份恢复随机延后 30–60 秒，执行前复核当前身份和连接，关闭或切换身份时取消旧任务。
+- 对齐 Echo v3.2 三前缀、强制明文、单一递减 `hop`、完整 trace 和真实耗时；提前返程通过现有单聊／群应用事件交付。
+- 明文 Echo 的发送失败／超时生成含 `reason`、`delivery_state` 和错误明细的 `echo_return`；认证错误、密文及应用回调错误保持原错误边界。
+
+### UDP 待机与原生邮件
+
+- Node 新增 `udp_standby_v1` 长连接空闲待机及 WebSocket 唤醒恢复；业务 RPC、消息通知、租约期限和心跳故障可唤醒，待确认／同步任务阻止入睡，`gateway.sync_demand` 不计作业务活动。
+- 导出独立 `MailClient`／`MailClientError` 及类型，支持 AID 证书认证、SMTP STARTTLS、IMAPS、MIME／附件、逐收件人结果、Sent 副本、UID 操作、流式读取、watch 和凭据轮换。
+- 邮件信封规范化并去重收件人，不改写调用方对象；修复 ImapFlow ESM／CJS 的 SEARCH、COPY、MOVE、EXPUNGE、STORE 错误传播，协议失败不再返回假成功／空结果，并保留合法空查询结果。
+- 原生邮件依赖独立 Mail 服务；旧 `client.mail` RPC 门面保留兼容。Mail 整体验收仍未完成，本次配套服务按单实例支持发布；Browser JS 不提供本节的原生 UDP／SMTP／IMAP 能力。
+
+### 版本与验证
+
+- 包配置、锁文件和运行时版本统一为 `0.5.35`，增加 UDP、Mail、Echo、订阅过滤及后台 ACK 回归覆盖；本条目不代表全量／公网／跨域验收已经通过。
+
+## 0.5.34 — 已发布
+
+相对已发布的 `0.5.33` 整理当前工作区增量；四端接口、实现差异和服务依赖见 [Python parity 文档](../python/CHANGES_FOR_PARITY.md#v0534)。
+
+### EventService 多角色与持久化
+
+- 同一 AID 在同一 Bus 上可同时承担 `bus`、`pub`、`sub`；角色分别授权，Bus 自发自订仍需对应权限。
+- Bus 目录、白名单、有效授权和订阅，以及客户端目录、订阅意图和待发布记录使用 SQLite（浏览器端为 IndexedDB）持久化；重启加载后与后续注册、订阅配置合并。
+- 发布消息先持久化再入队；按 `none` 或 `accepted` 成功阶段确认后删除本地正文，关闭、未知结果或发送失败时保留；恢复沿用原 `event_id` 和 TTL，过期记录 `EXPIRED`。
+- 新增 `publications` / `subscriptions` 查询，按事件名汇总发布次数与时间，或返回当前有效的设备/slot 订阅关系；分页 token 绑定运行实例和查询范围。
+
+### 消息同步与连接
+
+- 增加历史补拉弹性辅助连接、同步策略通知、主/辅连接回退和持久/volatile 独立读取范围；同一 namespace 保持串行，不同 namespace 按共享预算并行。
+- 完善消息与群消息交付队列的容量、背压、游标、ACK、重复折叠及连接代际隔离；超页、限流和辅助连接回收按策略停止或回退，不丢失待拉责任。
+- 补充 `need_render`、设备/slot 定向投递和控制信封字段在发送、加密、解密及恢复路径中的一致传递。
+
+### E2EE、Storage 与工具
+
+- 对齐 P2P/群组 V2 E2EE 的发送、解密、控制类别和降级路径，完善低层加解密入口及跨 SDK 工具参数。
+- Storage VFS 补充条件读取、上传会话字段、实际 MIME/Content-Type 处理及读缓存边界；ACL 支持 `subject.ownership.owner_aid`／`scope` 与 `subject.card.type`／`exttype` 条件，并保留 `grantee_aids`／兼容 `grantee_aid`，写入和 ACL 变更精确失效相关缓存。
+- 更新 Service Proxy、AID/Ownership 辅助接口及错误映射的类型和 RPC 白名单覆盖。
+
+### 版本与验证
+
+- 包配置、锁文件、运行时版本及测试引用统一为 `0.5.34`。
+- 增补 EventService 持久化、消息恢复、同步策略、Storage 缓存和 E2EE 回归测试；本条目不宣称已完成真实 Gateway 或跨域 E2E 验收。
+
+## 0.5.33 — 已发布
+
+本节记录 0.5.33 发布前相对 0.5.32 的增量；四端接口、实现差异和服务依赖见 [parity 0.5.33](../python/CHANGES_FOR_PARITY.md#v0533)。
 
 ### 控制消息兼容与降级
 

package/README.md

@@ -1,5 +1,7 @@
 # AUN Protocol — Node.js SDK
 
+Version: **0.5.34** · Node.js **>= 22.16.0**. This README describes the current source; package publication and service deployment are separate.
+
 ## Overview
 
 AUN (Agent Union Network) defines a standard interface for secure communication between Agents — based on WebSocket + JSON-RPC 2.0, covering identity, authentication, messaging, and autonomous Agent interaction, without being tied to a single communication topology.
@@ -13,15 +15,9 @@ AUN (Agent Union Network) defines a standard interface for secure communication
 **AUN's Answer**:
 
 - **AID Identity**: Globally unique identifier in `{name}.{issuer}` format (e.g., `alice.agentid.pub`), based on X.509 certificate chain
-- **Three Connection Modes**: Gateway (standard access), Peer (point-to-point direct), Relay (relay forwarding), with consistent application-layer API
+- **Gateway Access**: The current SDK connects through Gateway. Peer and Relay are protocol topology definitions; selecting either mode returns a not-implemented error.
 - **Tool-use Visualization**: Native `tool_call` / `tool_result` payload types for visualizing an Agent's local tool-use process in IM/viewer clients (**not a cross-Agent capability invocation contract**)
 
-```
-                  ┌─ Gateway ──→ Standard access (browser/mobile/server)
-Agent A ← WSS → ─┤─ Peer ─────→ Point-to-point direct (same network/low latency)
-                  └─ Relay ────→ Relay forwarding (NAT traversal/lightweight deployment)
-```
-
 **This SDK** is the Node.js/TypeScript client implementation of the AUN protocol. Install with `npm install @agentunion/fastaun`.
 
 ---
@@ -34,31 +30,32 @@ npm install @agentunion/fastaun
 
 ## Quick Start
 
-```typescript
-import { AunClient } from '@agentunion/fastaun';
+Load an identity already registered in the application's local store. Identity registration and configuration are covered in the [API manual](../docs/sdk/06-API手册.md#aidstore).
 
-// Create client
-const client = new AunClient({
-  aid: 'alice.agentid.pub',
-  gatewayUrl: 'wss://gateway.agentid.pub',
-  dataDir: './data'
-});
+```typescript
+import { AIDStore, AUNClient } from '@agentunion/fastaun';
+
+const store = new AIDStore({ aunPath: './data', encryptionSeed: '' });
+const loaded = store.load('alice.agentid.pub');
+if (!loaded.ok) throw new Error(loaded.error.message);
+const client = new AUNClient(loaded.data.aid);
+client.on('message.received', (event) => console.log(event));
+await client.connect({ auto_reconnect: true });
+```
 
-// Connect
-await client.connect();
+Send business RPCs after connection; message encryption is handled by the SDK.
 
-// Send message
-await client.sendMessage({
+```typescript
+await client.call('message.send', {
   to: 'bob.agentid.pub',
-  content: 'Hello from Alice!'
-});
-
-// Receive messages
-client.on('message', (msg) => {
-  console.log('Received:', msg);
+  payload: { type: 'text', text: 'Hello from Alice!' },
 });
 ```
 
+Call `await client.close()` when the application finishes. Storage, TLS and slot configuration belong to `AIDStore`; `AUNClient` accepts an AID object or no argument, and `connect(options)` authenticates as needed.
+
+Event publishing and subscriptions use `client.EventService`; Bus starts locally and Pub/Sub authorize independently. See the [EventService integration guide](../docs/sdk/AUN事件发布订阅应用集成指南.md) for role coexistence and SQLite recovery.
+
 ## Features
 
 - ✅ AID-based identity authentication
@@ -71,7 +68,12 @@ client.on('message', (msg) => {
 
 ## Documentation
 
-For detailed documentation, visit: https://github.com/agentunion/aun-sdk-core
+- [Quick start and identity model](../docs/sdk/01-快速开始.md)
+- [Connection and authentication](../docs/sdk/04-连接与认证.md)
+- [Public API manual](../docs/sdk/06-API手册.md)
+- [P2P message RPC](../docs/sdk/09-message-rpc-manual.md)
+- [EventService integration and SQLite persistence](../docs/sdk/AUN事件发布订阅应用集成指南.md)
+- [Documentation index](../docs/sdk/INDEX.md)
 
 ## License
 

package/_packed_docs/CHANGELOG.md

@@ -6,9 +6,66 @@
 
 ---
 
-## 0.5.33 — 未发布
+## 0.5.35 — 2026-11-12
 
-按当前工作区未提交变更整理；四端接口、实现差异和服务依赖见 [parity 0.5.33](../python/CHANGES_FOR_PARITY.md#v0533)。
+对照已发布的 `0.5.34`，包含发布后的已提交变更及当前工作区增量；比较基线和四端实现边界见 [parity 0.5.35](../python/CHANGES_FOR_PARITY.md#v0535)。
+
+### EventService 订阅与本地收发
+
+- `subscribe`／`unsubscribe` 支持点分层 `*` 通配事件名；按当前目录和授权展开，不支持 `**` 或自动匹配未来新增事件。
+- `subscribe(busAid, events, options)` 新增 `publisherAids`、`publisherTypes`、`publisherExttypes`；线上字段为 snake_case，同字段内任一匹配、不同字段同时满足，类型取自验签通过的发布者名片。
+- 过滤条件随 SQLite 订阅状态持久化及恢复；订阅条件变化时淘汰队列中属于旧订阅代次的事件。同一 Client、Bus AID 和 device／slot 可在进程内收发，保留授权、租约、TTL、容量及去重边界。
+
+### 消息同步与 Echo
+
+- 后台 Pull 提交后异步合并累计 ACK，失败重试、更新发送参数并隔离身份／连接／namespace 代际；前台 Pull 继续等待 ACK，关闭时有限等待后台确认。
+- 减少已被在线交付覆盖的重复 Pull／ACK；历史同步移除 `history_bytes_per_second` 主动节流，保留并发、页字节、在途内存和背压限制，辅助连接创建／退役时更新需求通知。
+- 连接成功后的自动补拉和组织身份恢复随机延后 30–60 秒，执行前复核当前身份和连接，关闭或切换身份时取消旧任务。
+- 对齐 Echo v3.2 三前缀、强制明文、单一递减 `hop`、完整 trace 和真实耗时；提前返程通过现有单聊／群应用事件交付。
+- 明文 Echo 的发送失败／超时生成含 `reason`、`delivery_state` 和错误明细的 `echo_return`；认证错误、密文及应用回调错误保持原错误边界。
+
+### UDP 待机与原生邮件
+
+- Node 新增 `udp_standby_v1` 长连接空闲待机及 WebSocket 唤醒恢复；业务 RPC、消息通知、租约期限和心跳故障可唤醒，待确认／同步任务阻止入睡，`gateway.sync_demand` 不计作业务活动。
+- 导出独立 `MailClient`／`MailClientError` 及类型，支持 AID 证书认证、SMTP STARTTLS、IMAPS、MIME／附件、逐收件人结果、Sent 副本、UID 操作、流式读取、watch 和凭据轮换。
+- 邮件信封规范化并去重收件人，不改写调用方对象；修复 ImapFlow ESM／CJS 的 SEARCH、COPY、MOVE、EXPUNGE、STORE 错误传播，协议失败不再返回假成功／空结果，并保留合法空查询结果。
+- 原生邮件依赖独立 Mail 服务；旧 `client.mail` RPC 门面保留兼容。Mail 整体验收仍未完成，本次配套服务按单实例支持发布；Browser JS 不提供本节的原生 UDP／SMTP／IMAP 能力。
+
+### 版本与验证
+
+- 包配置、锁文件和运行时版本统一为 `0.5.35`，增加 UDP、Mail、Echo、订阅过滤及后台 ACK 回归覆盖；本条目不代表全量／公网／跨域验收已经通过。
+
+## 0.5.34 — 已发布
+
+相对已发布的 `0.5.33` 整理当前工作区增量；四端接口、实现差异和服务依赖见 [Python parity 文档](../python/CHANGES_FOR_PARITY.md#v0534)。
+
+### EventService 多角色与持久化
+
+- 同一 AID 在同一 Bus 上可同时承担 `bus`、`pub`、`sub`；角色分别授权，Bus 自发自订仍需对应权限。
+- Bus 目录、白名单、有效授权和订阅，以及客户端目录、订阅意图和待发布记录使用 SQLite（浏览器端为 IndexedDB）持久化；重启加载后与后续注册、订阅配置合并。
+- 发布消息先持久化再入队；按 `none` 或 `accepted` 成功阶段确认后删除本地正文，关闭、未知结果或发送失败时保留；恢复沿用原 `event_id` 和 TTL，过期记录 `EXPIRED`。
+- 新增 `publications` / `subscriptions` 查询，按事件名汇总发布次数与时间，或返回当前有效的设备/slot 订阅关系；分页 token 绑定运行实例和查询范围。
+
+### 消息同步与连接
+
+- 增加历史补拉弹性辅助连接、同步策略通知、主/辅连接回退和持久/volatile 独立读取范围；同一 namespace 保持串行，不同 namespace 按共享预算并行。
+- 完善消息与群消息交付队列的容量、背压、游标、ACK、重复折叠及连接代际隔离；超页、限流和辅助连接回收按策略停止或回退，不丢失待拉责任。
+- 补充 `need_render`、设备/slot 定向投递和控制信封字段在发送、加密、解密及恢复路径中的一致传递。
+
+### E2EE、Storage 与工具
+
+- 对齐 P2P/群组 V2 E2EE 的发送、解密、控制类别和降级路径，完善低层加解密入口及跨 SDK 工具参数。
+- Storage VFS 补充条件读取、上传会话字段、实际 MIME/Content-Type 处理及读缓存边界；ACL 支持 `subject.ownership.owner_aid`／`scope` 与 `subject.card.type`／`exttype` 条件，并保留 `grantee_aids`／兼容 `grantee_aid`，写入和 ACL 变更精确失效相关缓存。
+- 更新 Service Proxy、AID/Ownership 辅助接口及错误映射的类型和 RPC 白名单覆盖。
+
+### 版本与验证
+
+- 包配置、锁文件、运行时版本及测试引用统一为 `0.5.34`。
+- 增补 EventService 持久化、消息恢复、同步策略、Storage 缓存和 E2EE 回归测试；本条目不宣称已完成真实 Gateway 或跨域 E2E 验收。
+
+## 0.5.33 — 已发布
+
+本节记录 0.5.33 发布前相对 0.5.32 的增量；四端接口、实现差异和服务依赖见 [parity 0.5.33](../python/CHANGES_FOR_PARITY.md#v0533)。
 
 ### 控制消息兼容与降级
 

package/_packed_docs/INDEX.md

@@ -1,6 +1,6 @@
 # AUN SDK Core 文档索引
 
-> 根级文档索引采用三层结构。Layer 1 用于快速定位，Layer 2 按主题交叉查找，Layer 3 给出重点文档摘要。SDK API 细节继续查看 `docs/sdk/INDEX.md`；P2P 保留共享 seq、按 sender 隔离游标，网络 Pull Gate 同 namespace 单飞、每客户端最多4个并行，末页独立 ACK。
+> 当前四 SDK 源码版本为 **0.5.35**，本版接入与实现见 [0.5.35 应用集成指南](sdk/0.5.35-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)，源码增量见 [parity 0.5.35](../python/CHANGES_FOR_PARITY.md#v0535)，现行接口见 [SDK 索引](sdk/INDEX.md)、[API 手册](sdk/06-API手册.md)及各 RPC 手册；版本专题和 CHANGELOG 保留原版本。根级索引采用三层结构：Layer 1 快速定位，Layer 2 按主题查找，Layer 3 重点文档摘要。P2P 保留共享 seq、按 sender 隔离游标，网络 Pull Gate 同 namespace 单飞、每客户端最多4个并行，末页独立 ACK。
 
 ---
 
@@ -21,7 +21,9 @@
 | [AUN 服务 Go 化重构精细化源码审查](audit/AUN服务Go化重构精细化源码审查-20260718.md) | 10 个 AUN 服务的 Go/Python 调用链、字段、并发、安全与性能修复终审；开放 P0/P1/P2 已归零，并附 Claude 60+76 条复审映射、跨实例/资源边界修复和 Docker/Linux 2344 条 Python 回归证据 |
 | [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md) | Python / Go / TS / JS SDK AUNClient 内部拆分边界、执行步骤和验收矩阵 |
 | [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md) | AUNClient 完全门面化、ClientRuntime 单一状态源和四端分批迁移步骤 |
-| [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) | Forward A/T/H 窗口、Group 成员可见性下界、Tail/History RPC、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和跨 SDK 验收门禁 |
+| [0.5.35 应用集成指南](sdk/0.5.35-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)；[0.5.35 变更与跨端对齐](../python/CHANGES_FOR_PARITY.md#v0535)；[0.5.34 应用指南](sdk/0.5.34-SDK应用集成指南.md) / [移植指南](sdk/0.5.34-SDK开发与移植指南.md)保留历史专题 | 对照已发布 0.5.34：通配订阅／发布者过滤、本地事件收发、后台 ACK、Echo v3.2；三端 UDP／原生 Mail、语言专属修复及单实例发布边界 |
+| [0.5.33 SDK 应用集成指南](sdk/0.5.33-SDK应用集成指南.md) / [开发与移植指南](sdk/0.5.33-SDK开发与移植指南.md) | 弹性补拉：应用面板配置/流程/故障边界 L404-464；四端用途认证、策略准入、共享预算与断线退主 L413-499；保留本版控制消息、Ownership和ACL专题 |
+| [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md) / [消息弹性补拉通道方案](消息弹性补拉通道方案.md) / [消息弹性补拉通道实施计划](消息弹性补拉通道实施计划.md) | Forward A/T/H 窗口、Group 可见性、Tail/History RPC、页内有序发布、跨页幂等排序、三 Pull Gate、缺 sender IK bootstrap及坏密文推进；弹性通道契约：本轮Gateway同AID＋设备最多授权1条、SDK按策略支持0..N（协议测试到2）、同namespace串行/跨namespace并行、history_sync、面板持久开关、断线退主、独立volatile与共享预算；实施计划L338-375为原额度历史证据（不证明新规则通过），新Gateway上限、四端策略行为和Ubuntu验收待完成 |
 | [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md) | `message.send` 秒级 TTL 钳制、持久/volatile 双游标、按 device 收件箱、隐藏 slot lease/ACK、文件 epoch、消息调试计数器与 payload type 分类、多实例/跨域和四 SDK 测试矩阵 |
 | [控制消息与设备能力协商方案](控制消息与设备能力协商方案.md) | 待实施：三类消息、固定优先级、Gateway 设备能力权威与 TTL 回源缓存、独立 SEQ / cursor、旧 SDK 降级及 Owner 名片感知 |
 | [风控响应与 SDK 协同方案](风控响应与SDK协同方案.md) | 待实施：服务端强制限制、SDK 能力与柔性响应、旧端断连暂封、版本化恢复、控制台解封及验收 |
@@ -38,7 +40,7 @@
 | [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) | agent.md/owner.md 关系、原格式兼容、release/清理/重绑版本、Header 投影、普通 agent.md 独立及旧 SDK 兼容；非权威 P2P 编排与 Group/Org 专属生命周期、实体主签、owner token 上传与可选附签和实体证书代际 |
+| [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) | 历史编排方案；持久任务、自动恢复及一次性决定已由当前两份指南中的无状态流程替代 |
 | [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 |
@@ -47,7 +49,7 @@
 | [凭证服务 RPC 手册](sdk/09-凭证服务RPC手册.md) | 旧版及六语义RPC、修订CAS／额度协调、签名CRL与十错误码 |
 | [语义凭证示例与验证](../examples/semantic-credential/示例使用指南.md) | E01—E36配置、CN／本地aid.com、真实浏览器／普通凭证冷恢复及证据边界 |
 | [组织服务 RPC 手册](sdk/09-组织服务RPC手册.md) | Org Service 生命周期、成员、受保护查询、审计/授权及内部/未实现方法 |
-| [Ownership 2.1 详细设计](sdk/Ownership2.1详细设计.md) | agent.md 兼容非回归原则与审查矩阵、旧 SDK owner RPC/JSONL 隔离、SDK／NS／Storage 职责；关系事实依赖`sub_aid/agent.md` 与 owner_aid 规范路径的 `owner.md`，普通名片和其 Storage 副本独立 |
+| [Ownership 2.1 详细设计](sdk/Ownership2.1详细设计.md) | agent.md 兼容非回归原则与审查矩阵、旧 SDK owner RPC/JSONL 隔离、SDK／NS／Storage 职责及现代 Group/Org 声明／共识与生命周期边界；关系事实依赖`sub_aid/agent.md` 与 owner_aid 规范路径的 `owner.md`，普通名片和其 Storage 副本独立 |
 | [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 与自动编排记录 |
@@ -72,7 +74,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)；[0.5.29 应用指南](sdk/0.5.29-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)、[共识与上传对齐](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布)；[0.5.28 应用指南](sdk/0.5.28-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.28-SDK开发与移植指南.md)；[0.5.27 应用指南](sdk/0.5.27-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.27-SDK开发与移植指南.md) | v0.3.3 至 v0.5.29 跨语言对齐清单；当前指南覆盖应用接入、NS 单次查询、无 TTL 的 ETag 缓存、resolve、上传锁／恢复和四端移植；旧版记录保留 |
+| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)；[0.5.29 应用指南](sdk/0.5.29-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)、[共识与上传对齐](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布)；[0.5.28 应用指南](sdk/0.5.28-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.28-SDK开发与移植指南.md)；[0.5.27 应用指南](sdk/0.5.27-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.27-SDK开发与移植指南.md) | v0.3.3 至 v0.5.35 跨语言对齐清单；0.5.29 历史指南覆盖应用接入、NS 单次查询、无 TTL 的 ETag 缓存、resolve、上传锁／恢复和四端移植；旧版记录保留 |
 | [AUN CLI 手册](cli/CLI手册.md) | Python CLI入口、profile及主要命令；credential 23命令、组织入口、文件／上下文、原字节和错误退出 |
 | [AUN CLI 设计文档](cli/AUN-CLI设计文档.md) | `python/src/aun_cli` 当前实现架构、命令注册面、配置解析、SDK 桥接和实现边界 |
 | [凭证与组织服务 CLI 开发与使用指南](cli/凭证与组织服务CLI开发与使用指南.md) | 流程图＋TS示例；真实CLI调用、凭证全流程、组织材料衔接与SDK胶水开发 |
@@ -114,7 +116,7 @@
 - 分布式节点角色、节点启动、服务启动/停止、注册发现、配置恢复和重启后状态恢复 → [分布式 AUN 节点与服务启动流程](../../extensions/services/docs/分布式AUN节点与服务启动流程.md)
 - AUNClient 巨类拆分、内部组件边界、逐步迁移和验收矩阵 → [AUNClient 拆分重构执行方案](design/AUNClient拆分重构执行方案.md)
 - AUNClient 完全门面化、Runtime 状态归属、状态写入收口和四端分批实施 → [AUNClient 门面化与 Runtime 状态迁移细化方案](design/AUNClient门面化与Runtime状态迁移细化方案.md)
-- P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)
+- P2P/Group Message 的 A/T/H、Tail/History、页内唯一有序发布、应用层跨页幂等排序、三 Pull Gate、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进和分布式验收门禁 → [消息同步与历史拉取改造方案](消息同步与历史拉取改造方案.md)；Gateway动态授权、主辅补拉、共享预算与通知回收 → [消息弹性补拉通道方案](消息弹性补拉通道方案.md)；双能力/history_sync、断线退主、面板持久化、Group分页补丁及S06/S08/S22、S07/S11/S16夹具、S13隔离定向测试、S15 cold SPK和S26本机准备状态、基础64/64已有通过attempt；后续resume2最终增量已保留身份更新Python/Go四桥、TS/JS四桥未变，707节点分段通过且两首败保留；缺省启用/显式关闭保留的Linux定向证据已补，完整E2E未签收，S05已运行未签收，S17反向8项P2P通过、Group首败仍核查，完整场景仍待验收 → [消息弹性补拉通道实施计划](消息弹性补拉通道实施计划.md)
 - P2P `message.send` TTL 内存缓存、持久/volatile 游标、device 收件箱、隐藏 slot lease/ACK、服务 epoch、消息调试计数器与 payload type 分类、跨 SDK/双域验收 → [P2P 消息 TTL 内存缓存方案](design/P2P消息TTL内存缓存方案.md)
 - 三类控制消息、设备能力持久化 / TTL 回源、SEQ / cursor 隔离、旧 SDK 投影及 agent.md Owner 感知 → [控制消息与设备能力协商方案](控制消息与设备能力协商方案.md)
 - Gateway 陌生人 P2P 限额、双向互通状态、拒绝/屏蔽、Inbox 手动回填和 Console AID 对状态查询 → [陌生人拒绝协议详细设计](陌生人拒绝协议详细设计.md)、[TDD 分阶段实施计划](陌生人拒绝协议TDD分阶段实施计划.md)
@@ -142,7 +144,7 @@
 - 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)
 - SDK 风控能力、内部控制消费、RPC/HTTP 门控、断线等待、旧端兼容、服务端执行与 Console 解封 → [风控响应与 SDK 协同方案](风控响应与SDK协同方案.md)
-- 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 agent.md/owner.md 关系、原格式兼容、普通 agent.md 独立、release 保持当前版本、清理后版本投影为 0／重绑默认 1、响应 Header 只投影校验结果、普通 agent owner 可选、现代 Group/Org 双文件共识及旧 SDK 隔离兼容 → [协议定义 2.1](protocol/Ownership协议定义2.1.md)、[详细设计](sdk/Ownership2.1详细设计.md)
 - Ownership 2.1 应用接入：双向绑定、释放、转移、两个 local 编排、审批和显式重试的 TS 示例／流程图 → [应用集成指南](sdk/Ownership2.1-SDK应用集成指南.md)
 - Ownership 2.1 SDK 移植：文件签验、NS 验收、条件发布、通用消息交付、本地编排和文件 CAS → [开发与移植指南](sdk/Ownership2.1-SDK开发与移植指南.md)
 - Credential/Org 应用接入：结构化约束、委托、登记、完整Verify与状态／CRL；语义原件、请求与业务验收 → [应用集成指南](sdk/凭证与组织服务SDK应用集成指南.md)§3—§4
@@ -160,7 +162,7 @@
 - 四 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.29 应用接入、共识输入输出、resolve、普通上传及业务服务 → [应用指南](sdk/0.5.29-SDK应用集成指南.md)；查询缓存、并发、上传恢复、NS 配套及四端落点 → [开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)；增量和已有验证见 [当前 parity](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布)。接口摘要见 [Python](../python/CHANGELOG.md)、[Go](../go/CHANGELOG.md)、[TS](../ts/CHANGELOG.md)、[JS](../js/CHANGELOG.md) CHANGELOG。
+- 四 SDK 0.5.35 增量、四端能力矩阵及单实例／Mail 验证边界 → [0.5.35 应用集成指南](sdk/0.5.35-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)；[当前 parity](../python/CHANGES_FOR_PARITY.md#v0535)；0.5.29 历史应用接入、共识输入输出、resolve、普通上传及业务服务 → [应用指南](sdk/0.5.29-SDK应用集成指南.md)；查询缓存、并发、上传恢复、NS 配套及四端落点 → [开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)；当版增量和已有验证见 [历史 parity](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布)。接口摘要见 [Python](../python/CHANGELOG.md)、[Go](../go/CHANGELOG.md)、[TS](../ts/CHANGELOG.md)、[JS](../js/CHANGELOG.md) CHANGELOG。
 - 四 SDK 0.5.28 的 agent.md 校验、共识 fresh、分类控制消息、Owner 通知与风控，以及四端差异和验证范围 → [0.5.28 应用指南](sdk/0.5.28-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.28-SDK开发与移植指南.md)；实现对照见 [历史 parity](../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布)。0.5.28 及更早记录中的公共共识查询以 0.5.29 增量为准。
 - Python CLI 源码位置、安装运行入口、全局选项、profile 配置、身份/消息/群组/Storage/Group FS/Collab/诊断等命令用法 → [AUN CLI 手册](cli/CLI手册.md)
 - Python CLI 当前实现架构、`main.py` 命令注册、`CLISession` SDK 桥接、配置解析和实现边界 → [AUN CLI 设计文档](cli/AUN-CLI设计文档.md)
@@ -385,13 +387,13 @@ TypeScript 身份与消息接线、Ownership 审批恢复、resolve、默认缓
 
 ### Ownership 协议定义 2.1
 
-定义 NS 当前 `agent.md` 与 owner Storage 当前 `owner.md` 的原始字节多签、逐块 prefix 验证、multi-v1 表示协商、自身份上传、owner.md 权限和当前关系校验；owner 锁与响应 Header 只投影本次材料的校验结果。release 保持被释放的版本 v，sub 清理关系字段后的版本投影为 0、再次绑定默认 1；转移仍核对 v 与 v+1。Group/Org 创建自动绑定、解散自动解绑、专属转移强制 rekey，实体名片以实体主签、owner token 上传与可选 owner 附签单独分流；三个时间字段统一安全整数范围，invalid 与 unavailable 分别表示无效与不可用。实体 pending 固定完整多签原文、owner/实体代际及原 CAS，取消额外 V2 上传授权与过期窗口，应用显式重试仍须新鲜核对当前代际；同全文/ETag 已提交仅观察确认。SDK 普通 P2P 编排仅作非权威协作，不构成协议层授权。新服务端保留旧 SDK 注册、绑定、转移、查询和解绑 RPC 及隔离的 Auth JSONL，仅激活旧 NS ownership_proof；不写 2.1 双文件，不授 2.1 lock/version/consensus，也不覆盖已存现代声明。
+定义 NS 当前 `agent.md` 与 owner Storage 当前 `owner.md` 的原始字节多签、逐块 prefix 验证、multi-v1 表示协商、自身份上传、owner.md 权限和当前关系校验；owner 锁与响应 Header 只投影本次材料的校验结果。release 保持被释放的版本 v，sub 清理关系字段后的版本投影为 0、再次绑定默认 1；转移仍核对 v 与 v+1。现代 Group/Org 使用相同 owner.md／agent.md 声明与共识，生命周期编排创建、解散及强制 rekey 转移；实体主签不带 signer_aid、不输出旧 entity_cert_fingerprint，以当前 owner token 上传并核对生命周期；三个时间字段统一安全整数范围，invalid 与 unavailable 分别表示无效与不可用。实体 pending 固定完整多签原文、owner/实体代际及原 CAS，取消额外 V2 上传授权与过期窗口，应用显式重试仍须新鲜核对当前代际；同全文/ETag 已提交仅观察确认。SDK 普通 P2P 编排仅作非权威协作，不构成协议层授权。新服务端保留旧 SDK 注册、绑定、转移、查询和解绑 RPC 及隔离的 Auth JSONL，仅激活旧 NS ownership_proof；不写 2.1 双文件，不授 2.1 lock/version/consensus，也不覆盖已存现代声明。
 
 ### Ownership SDK 编排指南 2.1
 
 保留七 Facade、Stage、P2P、持久任务及一次性决定的历史设计。当前实现已移除 Ownership 任务、WAL、后台恢复和 decisions 接口，以两份现行 SDK 指南中的文件提交、NS 事实验收和显式重试为准。
 
-Group/Org 作为 sub 时不进入这些通用任务或审批；以其为 sub 误调用直接 not_applicable，符合普通 owner 规则时仍可作为 owner_aid。实体 owner 创建自动建立、解散自动解除，专属转移强制 rekey，名片由实体主签、owner token 上传，可选 owner 附签不改变当前授权。
+本条历史任务方案不定义当前 Group/Org 生命周期编排。现代实体的双文件声明与共识同样适用；普通 Ownership 管理 Facade 的绑定、释放、转移仍返回 not_applicable，不能将这一入口限制扩展到声明／共识或放宽 owner 类型。创建、解散和强制 rekey 转移由专属生命周期完成，当前边界见协议 §1.3／§2.5。
 
 ### Ownership 2.1 SDK 应用集成指南
 
@@ -447,9 +449,9 @@ Group/Org 作为 sub 时不进入这些通用任务或审批；以其为 sub 误
 
 0.5.29 [应用指南](sdk/0.5.29-SDK应用集成指南.md)：接入与消息 §1—§2 L5-54、共识 §3 L55-80、resolve §4 L81-104、上传及管理 §5 L105-145、缓存／通知／业务 §6—§7 L146-167、升级 §8 L168-180；[开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)：契约 §1—§2 L5-63、缓存与 resolve §3—§4 L64-94、上传恢复 §5 L95-123、四端与继承契约 §6—§7 L124-151、核查 §8 L152-164。
 
-当前 [0.5.29 parity](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L15-87：公共入口与 NS 请求 L19-39、无 TTL 的 ETag 缓存及 resolve L40-47、普通上传与恢复 L48-67、NS 配套与定向验证 L68-87。四端 CHANGELOG 提供接口级摘要。
+[0.5.35 应用指南](sdk/0.5.35-SDK应用集成指南.md)：范围 L7-20、EventService L21-61、ACK／恢复 L62-77、Echo L78-94、UDP L95-124、Mail L125-163、语言专属 L164-177、验收 L178-189；[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)：职责 L7-17、事件契约 L18-63、ACK／同步 L64-83、Echo L84-99、UDP L100-136、Mail L137-172、语言落点 L173-184、回归 L185-204。 当前 [0.5.35 parity](../python/CHANGES_FOR_PARITY.md#v0535) L15-90：基线／矩阵 L17-29、EventService L30-43、ACK／同步 L44-51、Echo L52-58、UDP L59-65、Mail L66-73、语言专属 L74-80、核验范围 L81-90。历史 [0.5.29 parity](../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L456-528：公共入口与 NS 请求 L460-480、无 TTL 的 ETag 缓存及 resolve L481-488、普通上传与恢复 L489-508、NS 配套与定向验证 L509-528。四端 CHANGELOG 提供接口级摘要。
 
-历史 0.5.28 [应用指南](sdk/0.5.28-SDK应用集成指南.md)：身份／消息接入 §2—§3 L18-95、凭证／组织 §4—§5 L96-137、Storage／Ownership §6—§7 L138-186、Owner 通知 §8 L187-201、风控／升级 §9—§10 L202-228；[开发与移植指南](sdk/0.5.28-SDK开发与移植指南.md)：上传／下载 schema §1 L7-36、非一致共识 fresh §2 L37-62、分类控制消息 §3 L63-108、Owner outbox §4 L109-121、风控 §5 L122-134、移植矩阵 §6 L135-146。对应实现及验证边界见 `python/CHANGES_FOR_PARITY.md` 0.5.28 章节 L88-172。0.5.27 及更早版本保留原基线和执行记录。
+历史 0.5.28 [应用指南](sdk/0.5.28-SDK应用集成指南.md)：身份／消息接入 §2—§3 L18-95、凭证／组织 §4—§5 L96-137、Storage／Ownership §6—§7 L138-186、Owner 通知 §8 L187-201、风控／升级 §9—§10 L202-228；[开发与移植指南](sdk/0.5.28-SDK开发与移植指南.md)：上传／下载 schema §1 L7-36、非一致共识 fresh §2 L37-62、分类控制消息 §3 L63-108、Owner outbox §4 L109-121、风控 §5 L122-134、移植矩阵 §6 L135-146。对应实现及验证边界见 `python/CHANGES_FOR_PARITY.md` 0.5.28 章节 L529-613。0.5.27 及更早版本保留原基线和执行记录。
 
 0.5.27 [应用指南](sdk/0.5.27-SDK应用集成指南.md)：身份／连接／消息迁移 §2—§3 L30-133，结构化 §4 L134-192／语义 §5 L193-349，组织与缓存 §6—§7 L350-388，升级 §8 L389-408；[开发与移植指南](sdk/0.5.27-SDK开发与移植指南.md)：字节／签名 §2 L38-84，结构化 §3 L85-123／语义 §4 L124-297，组织 §5 L298-334，迁移交付 §6 L335-383，平台与回归 §7—§8 L384-410。 `python/CHANGES_FOR_PARITY.md` 以 Python SDK 实现为主线记录 Go / TypeScript / JavaScript 对齐要求。0.5.27 L173-290 统一对照 0.5.25 源码提交，覆盖结构化／语义凭证、消息证据、online／bounded、Usage 持久恢复、Gateway 迁移、时间容错、组织和 CLI；列出各端实现落点、存储差异及已有验证范围。0.5.26 仅记 TypeScript 根证书打包修正；0.5.25 及更早章节保留原基线和执行记录。
 
@@ -516,3 +518,15 @@ L5-121定义TS运行器、profile、三种凭证模式及23命令；L124-298说
 ### TS 注册自动绑定 Owner 的 E2E 验证代码
 
 [代码与运行方式](TS注册自动绑定Owner的E2E验证代码.md)：TS SDK 编译产物的 Node.js ESM 用例，覆盖注册意图、connect 自动发起 bind.request、owner 审批、双端锁定共识、NS/Storage 正文及 SHA；包含 agentid.cn 实测结果和私有探针/transport 范围。
+
+### 消息弹性补拉通道方案
+
+[方案正文](消息弹性补拉通道方案.md)（持续验收）：本轮Gateway同AID＋设备最多授权1条，SDK按策略支持0..N（协议测试到2），同namespace串行、跨namespace按授权/预算并行 L9-24；架构与认证 L40-101；Gateway策略/回收 L102-201；公平与顺序 L202-263；流程与兼容 L264-345；阶段状态 L357-400；面板开关 L420-440、双能力 L442-446、断线退主 L448-454；积压门槛、数量下界、短连接无unread hint及统计 L456-485。旧额度测试保留为历史，不证明新规则通过。
+
+### 消息弹性补拉通道实施计划
+
+[实施计划](消息弹性补拉通道实施计划.md)：交付/阶段 L6-159；四端验收 L212-235；旧额度验证证据 L338-375（不证明新规则）；本轮Gateway单辅助上限、SDK 0..N策略支持、namespace并发、积压门槛、短连接与统计验收 L377-399。新Gateway cap、四SDK新规则与Ubuntu Docker验收尚待完成。
+
+### 0.5.33 弹性补拉接入与移植
+
+[应用指南](sdk/0.5.33-SDK应用集成指南.md) L404-464：面板持久开关、无需新Client的补拉流程、暂停与断线退主、同版禁开及应用幂等；[移植指南](sdk/0.5.33-SDK开发与移植指南.md) L413-499：双能力/history_sync、发送前复核、消费预留、volatile主路径、真实辅助计数与回收；[连接协议](protocol/03-Gateway-连接模式.md)弹性专节及[Message](sdk/09-message-rpc-manual.md)/[Group](sdk/09-group-rpc-manual.md)分页段定义wire字段。

package/_packed_docs/KITE_DOCS_GUIDE.md

@@ -38,15 +38,15 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | 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 agent.md/owner.md、现代 Group/Org 共识、普通名片与历史格式边界 | `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 历史编排、任务恢复、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详细设计.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 |
+| Group/Org 现代声明／共识、实体主签、owner 上传、历史格式与每连接访问补齐 | `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` 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 |
@@ -92,10 +92,10 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | TypeScript 接入跨设备已读未读、单调事件、`read_state_sync`、精确整数、映射状态和错误处理 | `docs/跨设备已读未读SDK集成指南.md` L1-207 |
 | 四端及其它语言 SDK 实现/移植、迁移重试、请求级批写、身份隔离、精确整数、本地完成事件和测试验收 | `docs/跨设备已读未读SDK实现移植指南.md` L1-331 |
 | 跨设备已读未读问题修复闭环、文档与四端 SDK 对齐、本轮隔离回归及历史 Docker 验证边界 | `docs/跨设备已读未读代码审查报告.md` L1-252 |
-| P2P peer 能力、完整轻量 pending peers/可选整体估计快照、目录/Pull逐页next_pending_seq/可靠commit后更新与每N次FIFO、peer ACK/slot 公共 S、need_render/页内计数、device 定向发送及 TTL volatile | `docs/sdk/02-WebSocket协议.md` L116-142；`docs/sdk/09-message-rpc-manual.md` L340-581、L738-751；`docs/sdk/06-API手册.md` |
+| P2P peer 能力、完整轻量 pending peers/可选整体估计快照、目录/Pull逐页next_pending_seq/可靠commit后更新与每N次FIFO、peer ACK/slot 公共 S、need_render/页内计数、device 定向发送及 TTL volatile | `docs/sdk/02-WebSocket协议.md` L116-142；`docs/sdk/09-message-rpc-manual.md` L340-583、L740-753；`docs/sdk/06-API手册.md` |
 | 当前实现的代码审查结论、P0/P1/P2 问题与跨语言差异 | `docs/消息同步与历史拉取代码审查问题清单.md` L3-207 |
 | 消息同步问题修复顺序与已排除误报 | `docs/消息同步与历史拉取代码审查问题清单.md` L208-229 |
-| SDK peer A/T/H、稀疏覆盖/前驱、human Tail、N=4 Gate、后台续拉、50k 内存去重/应用持久幂等与 History/ACK | `docs/sdk/03-核心概念.md` L60-80；`docs/sdk/05-E2EE加密通信.md` L33-59、L294-316；`docs/sdk/08-最佳实践.md` L89-116；`docs/sdk/09-message-rpc-manual.md` L340-581；`docs/sdk/09-group-rpc-manual.md` L1434-1508、L1717-1784 |
+| SDK peer A/T/H、稀疏覆盖/前驱、human Tail、N=4 Gate、后台续拉、50k 内存去重/应用持久幂等与 History/ACK | `docs/sdk/03-核心概念.md` L60-80；`docs/sdk/05-E2EE加密通信.md` L33-59、L294-316；`docs/sdk/08-最佳实践.md` L89-116；`docs/sdk/09-message-rpc-manual.md` L340-583；`docs/sdk/09-group-rpc-manual.md` L1434-1510、L1719-1786 |
 | 测试环境数据保护规则 | `docs/aun测试运行指南.md` L166-182 |
 | 默认单实例 Docker 服务端、Tester 和常规测试命令 | `docs/aun测试运行指南.md` L183-369、L586-1074 |
 | 断网依赖准备、Go 1.24 和 Tester 复用纪律 | `docs/aun测试运行指南.md` L124-165、L183-369、`docs/aun分布式测试运行指南.md` L335-503 |
@@ -155,13 +155,14 @@ 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 resolve opts、frontmatter 字段／类型；当前 ownership 输出与无 TTL 缓存 | 基础解析见 `docs/sdk/06-API手册.md` L86-203、`docs/sdk/04-连接与认证.md` L233-243；当前共识变更见 `python/CHANGES_FOR_PARITY.md` L19-47 |
-| 四 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 resolve opts、frontmatter 字段／类型；当前 ownership 输出与无 TTL 缓存 | 基础解析见 `docs/sdk/06-API手册.md` L86-203、`docs/sdk/04-连接与认证.md` L233-243；当前共识变更见 `python/CHANGES_FOR_PARITY.md` L460-488 |
+| 四 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` L1588-1622 |
+| 四 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` L1614-1620、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
+| 四 SDK 0.5.35 增量、通配订阅／过滤、本地收发、后台 ACK、Echo、三端 UDP／Mail 及单实例边界 | [0.5.35 应用集成指南](sdk/0.5.35-SDK应用集成指南.md)、[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)；[parity 0.5.35](../python/CHANGES_FOR_PARITY.md#v0535) L15-90；0.5.34 历史专题保留在 `docs/sdk/0.5.34-SDK应用集成指南.md`、`docs/sdk/0.5.34-SDK开发与移植指南.md` |
 | 四 SDK 0.5.6 发布摘要、验签缓存、消息窗口与语言能力边界 | `docs/sdk/CHANGELOG-0.5.6.md` L1-73 |
-| 四 SDK 0.5.29 应用接入、共识输入输出、resolve、上传锁与恢复、四端移植 | [应用指南](sdk/0.5.29-SDK应用集成指南.md)：接入 L5-54、共识 L55-80、resolve L81-104、上传管理 L105-145、缓存／业务 L146-167、升级 L168-180；[开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)：契约 L5-63、缓存／resolve L64-94、上传恢复 L95-123、四端／继承 L124-151、核查 L152-164；parity 当前 L15-87 |
-| 历史 0.5.28 agent.md 校验、共识 fresh、分类控制消息、Owner 通知与风控 | `docs/sdk/0.5.28-SDK应用集成指南.md`：接入／消息 L5-95、凭证／组织 L96-137、Storage／Ownership L138-186、通知 L187-201、风控／升级 L202-228；`docs/sdk/0.5.28-SDK开发与移植指南.md`：校验 L7-36、共识 L37-62、wire L63-108、outbox L109-121、风控 L122-134、移植 L135-146；parity 历史 L88-172，公共共识规则以 0.5.29 为准 |
-| 四 SDK 0.5.27 对照 0.5.25 源码的凭证、消息证据、状态／Usage、Gateway 迁移、时间容错、组织与 CLI；0.5.26 仅为 TS 根证书打包修正 | `docs/sdk/0.5.27-SDK应用集成指南.md`：身份连接／消息 L30-133、结构化 L134-192、语义 L193-349、组织缓存 L350-388、升级 L389-408；`docs/sdk/0.5.27-SDK开发与移植指南.md`：字节 L38-84、结构化 L85-123、语义 L124-297、组织 L298-334、迁移 L335-383、平台回归 L384-410；`python/CHANGES_FOR_PARITY.md` 历史 0.5.27 L173-290、0.5.25 L291-359、0.5.24 L360-496、0.5.22 L497-654，读缓存块⑦ L582-622／版本测试块⑧ L623-654 |
+| 四 SDK 0.5.29 应用接入、共识输入输出、resolve、上传锁与恢复、四端移植 | [应用指南](sdk/0.5.29-SDK应用集成指南.md)：接入 L5-54、共识 L55-80、resolve L81-104、上传管理 L105-145、缓存／业务 L146-167、升级 L168-180；[开发与移植指南](sdk/0.5.29-SDK开发与移植指南.md)：契约 L5-63、缓存／resolve L64-94、上传恢复 L95-123、四端／继承 L124-151、核查 L152-164；parity 0.5.29 历史 L456-528 |
+| 历史 0.5.28 agent.md 校验、共识 fresh、分类控制消息、Owner 通知与风控 | `docs/sdk/0.5.28-SDK应用集成指南.md`：接入／消息 L5-95、凭证／组织 L96-137、Storage／Ownership L138-186、通知 L187-201、风控／升级 L202-228；`docs/sdk/0.5.28-SDK开发与移植指南.md`：校验 L7-36、共识 L37-62、wire L63-108、outbox L109-121、风控 L122-134、移植 L135-146；parity 历史 L529-613，公共共识规则以 0.5.29 为准 |
+| 四 SDK 0.5.27 对照 0.5.25 源码的凭证、消息证据、状态／Usage、Gateway 迁移、时间容错、组织与 CLI；0.5.26 仅为 TS 根证书打包修正 | `docs/sdk/0.5.27-SDK应用集成指南.md`：身份连接／消息 L30-133、结构化 L134-192、语义 L193-349、组织缓存 L350-388、升级 L389-408；`docs/sdk/0.5.27-SDK开发与移植指南.md`：字节 L38-84、结构化 L85-123、语义 L124-297、组织 L298-334、迁移 L335-383、平台回归 L384-410；`python/CHANGES_FOR_PARITY.md` 历史 0.5.27 L614-731、0.5.25 L732-800、0.5.24 L801-937、0.5.22 L938-1095，读缓存块⑦ L1023-1063／版本测试块⑧ L1064-1095 |
 | 群 `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-378 |
 | AUN Python CLI 当前实现架构、命令注册、SDK 桥接和实现边界 | `docs/cli/AUN-CLI设计文档.md` L3-279 |
@@ -180,4 +181,9 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`，SDK API
 | collab Plan 2 Python SDK/CLI 与单域 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan2.md` L1-132 |
 | collab Plan 3 Go/TS/JS 与跨语言 E2E | `docs/aun-fs/collab/2026-06-12-collab协作层-plan3.md` L1-154 |
 | Notify 在线轻量通知 / 跨域 federation 方案 | `docs/sdk/Notify通知方案.md` |
+| 离线消息弹性补拉：Gateway当前0/1、SDK按策略0..N、namespace并发和共享预算 | [方案正文](消息弹性补拉通道方案.md)：当前Gateway同AID＋设备最多授权1条，SDK现有协议测试到2；同namespace串行、不同namespace按授权/预算并行 L9-24；认证 L40-101；策略与回收 L102-201；公平/顺序/背压 L202-263；面板开关 L420-440；断线退主 L448-454；积压门槛、无新增读取下界、短连接无unread hint及统计 L456-485。旧额度结果不证明本轮规则通过。 |
+| 弹性补拉实施与验收 | [实施计划](消息弹性补拉通道实施计划.md)：交付/阶段 L6-159；四端验收 L212-235；旧额度验证证据 L338-375（不证明新规则）；本轮Gateway单辅助上限、SDK 0..N策略支持、namespace并发、积压门槛、短连接与统计验收 L377-399。新Gateway cap、四SDK新规则与Ubuntu Docker验收尚待完成。 |
 
+[0.5.35 应用指南](sdk/0.5.35-SDK应用集成指南.md)：范围 L7-20、EventService L21-61、ACK／恢复 L62-77、Echo L78-94、UDP L95-124、Mail L125-163、语言专属 L164-177、验收 L178-189；[开发与移植指南](sdk/0.5.35-SDK开发与移植指南.md)：职责 L7-17、事件契约 L18-63、ACK／同步 L64-83、Echo L84-99、UDP L100-136、Mail L137-172、语言落点 L173-184、回归 L185-204。 当前 0.5.35 见 [parity](../python/CHANGES_FOR_PARITY.md#v0535) L15-90：基线／矩阵 L17-29、EventService L30-43、ACK／同步 L44-51、Echo L52-58、UDP L59-65、Mail L66-73、语言专属 L74-80、核验范围 L81-90。0.5.34 历史 SDK 专题：应用接入见 [0.5.34 应用指南](sdk/0.5.34-SDK应用集成指南.md)，四端共同契约见 [0.5.34 开发与移植指南](sdk/0.5.34-SDK开发与移植指南.md)，实现级差异见 [parity 0.5.34](../python/CHANGES_FOR_PARITY.md#v0534)。文档覆盖 EventService 多角色、SQLite/IndexedDB 持久化、durable outbox、实时目录、Storage 条件 ACL、Group FS、Service Proxy 和弹性补拉。
+
+0.5.33 弹性补拉专题：应用配置与流程见 [应用指南 L404-464](sdk/0.5.33-SDK应用集成指南.md)；四端共同实现见 [开发与移植指南 L413-499](sdk/0.5.33-SDK开发与移植指南.md)。索引三层入口见 [INDEX.md 的弹性补拉与0.5.33条目](INDEX.md)；连接认证/回收和Message/Group存储范围及页字节字段已同步到各手册。

package/_packed_docs/agent.md/SCHEMA.md

@@ -5,7 +5,7 @@ Ownership 版本: 2.0.0
 
 本文保留 legacy Ownership 2.0 的文件格式与字段，不是当前 2.1 Schema。Ownership 2.0 的 ownership 声明由整个文件尾部签名保护；本文的第三方存储写删授权、sub 单方撤销及无关系版本示例仅适用于该历史版本。当前 2.1 的完整文件、角色、关系版本、owner 锁与六态结果以 [Ownership 协议定义 2.1](../protocol/Ownership协议定义2.1.md) 为准。
 
-当前 `group/org` 是独立生命周期分支：owner 必填，无 ownership 合法，通用 ownership/proof/release 禁止；实体私钥生成主签，当前 owner 以本人 token 上传，可选 owner 附签且存在必须验证；Group 旧实体单签及实体身份上传持续兼容，Org 不开放。通用多签、实体证书代际和恢复以 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传) 为准。下文 legacy 的 owner/ownership 成对及目标本人签名规则不得套用于当前 Group/Org。
+当前现代 `group/org` 由专属生命周期维护归属，同时使用配对 `owner.md`／`agent.md` 的 ownership.statement 并参与通用共识；普通 bind/release/transfer Facade 仍返回 not_applicable，NS 对缺少 ownership 的历史实体保留同名标记，SDK 按实际返回状态处理。现代实体私钥主签不含 signer_aid，也不要求旧 entity_cert_fingerprint；当前 owner 以本人 token 上传，可选 owner 附签且存在必须验证。Group 旧实体单签及实体身份上传持续兼容，Org 不开放该旧入口。完整声明、签名和恢复见 [协议 §2.5](../protocol/Ownership协议定义2.1.md#25-grouporg-名片的实体主签与-owner-上传)；下文 legacy Schema、实体主签字段与单方撤销规则不得套用于现代 Group/Org。
 
 ## 限制
 

package/_packed_docs/aun/346/265/213/350/257/225/350/277/220/350/241/214/346/214/207/345/215/227.md

@@ -1273,8 +1273,8 @@ docker logs --since 30m kite-app 2>&1 | Select-String -Pattern "WAL 批量写入
 本节适用于默认单域、分布式、双域及 cross-SDK 使用远程 Ubuntu Docker 的情况。
 
 - Ubuntu SSH：`root@61.169.195.42`，端口 `30248`；Docker context 为 `kite-ubuntu`，远端项目目录为 `/data/kite`，Docker 数据目录为 `/data/docker`。
-- 本机 identity file：`C:\Users\ready\.ssh\id_rsa`；对应公钥 `C:\Users\ready\.ssh\id_rsa.pub` 已安装到 Ubuntu。只记录路径，不保存私钥内容，也不把私钥同步到远端。
-- Windows PowerShell 登录命令：`ssh -p 30248 -i "$env:USERPROFILE\.ssh\id_rsa" -o IdentitiesOnly=yes root@61.169.195.42`。
+- 本机 identity file：`C:\Users\ready\.ssh\id_ed25519`；对应公钥 `C:\Users\ready\.ssh\id_ed25519.pub` 已安装到 Ubuntu。只记录路径，不保存私钥内容，也不把私钥同步到远端。
+- Windows PowerShell 登录命令：`ssh -p 30248 -i "$env:USERPROFILE\.ssh\id_ed25519" -o IdentitiesOnly=yes root@61.169.195.42`。
 - Ubuntu CN Compose 还需按顺序加载 `agentid.cn/local.env`、`agentid.cn/ubuntu.env`；后者由本机工作区维护并同步，固定远端 MySQL 镜像、健康卷、Redis 卷和 CN 子网，只用于远程 Docker，不用于本机 Docker。
 - Ubuntu PUB Compose 还要在基础与域 Compose 后加载 `agentid.pub/ubuntu-compose.yml`，并按 `local.env`、`ubuntu.env` 顺序提供变量；镜像 SHA 指向本机源码构建并同步到 Ubuntu 的镜像。
 

package/_packed_docs/protocol/03-Gateway-/350/277/236/346/216/245/346/250/241/345/274/217.md

@@ -64,7 +64,7 @@ WebSocket 连接建立
   ← challenge（服务端推送 nonce）
   → auth.aid_login1 (可选，已有 token 时跳过)
   → auth.aid_login2 (可选)
-  → auth.connect(nonce, auth, protocol, device, client, delivery_mode, options, extra_info, capabilities)
+  → auth.connect(nonce, auth, protocol, device, client, delivery_mode, options, extra_info, capabilities)
   ← {status: "ok", protocol, identity, ...}
   → READY，进入 Gateway 业务态
 ```
@@ -93,13 +93,13 @@ WebSocket 连接建立
 | device.id | string | 推荐 | 设备唯一标识。SDK 默认从 `~/.aun/.device_id` 稳定读取 |
 | device.type | string | 推荐 | 设备类型（desktop/mobile/browser） |
 | client.slot_id | string | 否 | 同一 `device.id` 下的实例槽位。仅在 `device.id` 存在时可用 |
-| delivery_mode.mode | string | 否 | 连接级投递模式：`fanout` 或 `queue` |
-| delivery_mode.routing | string | 否 | 仅 `queue` 时有效：`round_robin` 或 `sender_affinity` |
-| delivery_mode.affinity_ttl_ms | integer | 否 | 仅 `queue + sender_affinity` 时有效，表示发送者粘性保持时长 |
-| options.kind | string | 否 | 连接类型：`long`（默认）或 `short` |
-| options.short_ttl_ms | integer | 否 | 短连接服务端兜底超时，仅 `kind="short"` 时有效 |
-| extra_info | object | 否 | 应用层自定义连接信息；SDK 会过滤下划线开头的内部键 |
-| capabilities | object | 否 | 客户端能力声明 |
+| delivery_mode.mode | string | 否 | 连接级投递模式：`fanout` 或 `queue` |
+| delivery_mode.routing | string | 否 | 仅 `queue` 时有效：`round_robin` 或 `sender_affinity` |
+| delivery_mode.affinity_ttl_ms | integer | 否 | 仅 `queue + sender_affinity` 时有效，表示发送者粘性保持时长 |
+| options.kind | string | 否 | 连接类型：`long`（默认）或 `short` |
+| options.short_ttl_ms | integer | 否 | 短连接服务端兜底超时，仅 `kind="short"` 时有效 |
+| extra_info | object | 否 | 应用层自定义连接信息；SDK 会过滤下划线开头的内部键 |
+| capabilities | object | 否 | 客户端能力声明 |
 | client | object | 否 | 客户端信息（名称、版本等） |
 
 **当前实现补充**：
@@ -264,4 +264,54 @@ WebSocket 连接建立后 **30 秒**内未完成 `auth.connect`，服务端关
 - 远端 Gateway 验证请求后转发到本域服务
 - **auth 管凭证，auth.connect 管连接**——两者职责不同
 
+## 弹性辅助连接与历史补拉
 
+主连接承接实时消息、控制通知及普通 RPC；SDK 可按需建立历史补拉辅助连接。辅助连接共享主 Client 的身份、解密、游标和应用分发状态，不再创建完整 Client。
+
+| 契约 | 要求 |
+| --- | --- |
+| `capabilities.elastic_connections_v1` | 通用弹性辅助连接能力；主连接和辅助连接均需协商 |
+| `capabilities.sync_channels_v1` | 历史补拉用途能力；与通用能力均协商成功后，才可申请该用途 |
+| `options.kind` / `options.purpose` | 辅助认证使用 `short` / `history_sync` |
+| `options.parent_connection_id` | 绑定有效主连接；AID、device、slot 必须一致 |
+| 控制面开关 | Gateway 的 `sync_channels_enabled` 默认开启，已有显式 `false` 保持关闭；通过现有配置修订和绑定持久化，在线动态应用 |
+
+辅助连接使用主 Client 当前的有效访问凭证完成 `auth.connect`，以响应的 `negotiated_capabilities` 为协商结果，不单独刷新 token。仅主辅均成功协商两种能力的 SDK 可用；本轮 Gateway 按开关与实时压力实际授权 `0/1`，压力可降为 0，关闭时为 0、开启时上限为 1；承接主连接的同一 Gateway 内，`(aid, device_id)` 跨 slot、主会话合计最多 1 条，当前不跨 Gateway 全局统计。不同设备分别计数，历史资源仍按 AID 汇总。此为本轮 Gateway 准入上限，不代表 SDK 协议能力上限；普通短连接继续沿原有用途工作，其它弹性用途需另行定义方法及额度。
+
+### 策略与请求信封
+
+历史请求通过主或辅助连接发送时，都携带外层元数据；不把它放进业务 `params`：
+
+```json
+{"jsonrpc":"2.0","id":"pull-1","method":"message.v2.pull",
+ "params":{"sender_aid":"alice.agentid.pub","storage_scope":"persistent","max_page_bytes":262144},
+ "_meta":{"sync":{"purpose":"history_sync","parent_connection_id":"main-1","has_pending":true}}}
+```
+
+Gateway 在认证响应、可触发 Pull 的事件及相关 RPC 响应中携带外层 `_meta.sync_policy`，也可主动通知恢复：
+
+| 策略字段 | 语义 |
+| --- | --- |
+| `parent_connection_id` | 当前主连接 ID |
+| `version` | 同一主会话内单调递增的正安全整数，最大 `9007199254740991` |
+| `max_aux_channels` | SDK 按策略支持 `0..N`（当前协议实现及测试覆盖到 2）；本轮 Gateway 实际下发 `0/1`、开启时最多 1；同一 Gateway 内 `(aid, device_id)` 跨 slot、主会话合计最多 1 条 |
+| `max_history_pull_inflight` | 主辅合计历史请求额度，`0..3` |
+| `max_page_bytes` | 单页 `result` 的 JSON 编码上限，`1024..786432` 字节；初始 256 KiB |
+| `max_history_inflight_bytes` | 主辅合计编码预留；初始 1 MiB |
+| `history_bytes_per_second` | 历史结果字节速率；`0` 表示暂停 |
+
+SDK 在处理 result/error/notification 前应用策略，忽略错误主连接、无效值和旧版本；缺少快照不解除既有约束。`max_aux_channels=0` 时可退回主连接；历史在途额度或速率为 `0` 时主连接也暂停。等待恢复不占用普通 RPC 额度，不轮询探测。
+
+### 通知回收与断线回退
+
+| 消息 | 作用 |
+| --- | --- |
+| `event/gateway.sync_policy_changed` | 主连接上的策略更新通知，外层携带 `_meta.sync_policy` |
+| `event/gateway.sync_channel_close` | 主连接上提前通知回收；参数含 `parent_connection_id`、`target_connection_id`、`reason`、`drain_timeout_ms` |
+| `gateway.sync_demand` | SDK 需求状态变化时发送 Notification，参数为主连接 ID 和 `has_pending`，不设周期需求心跳 |
+
+Gateway 优先回收已确认无需求的空闲辅助连接。SDK 退役目标连接、排空或取消未完成请求，主 Client 保持在线。辅助断线后不自动重连，也不因冷却结束补开；当前主会话及策略版本内记住故障，待补请求使用剩余期限回到主连接。只有新的策略明确重新授权或新的主会话协商，才可再申请辅助连接；重复同版本快照不解禁。
+
+完整页仍按原游标和应用消费流程提交，半页不提交或 ACK；旧主会话页面不得向新会话提交。同主会话里策略版本更新不否定已经合法接收的页。`storage_scope=volatile` 使用独立主连接 Pull 和 volatile cursor，不受历史暂停阻塞，也不推进持久水位。
+
+所有 Transport 共用总 RPC 16、background 8、event 4、pull 4；历史最多使用 3 个 pull 名额。SDK 按 `max_aux_channels` 策略使用辅助连接；同一 namespace 的网络 Pull 串行，不同 namespace 可在策略授权和共享预算允许时并行复用辅助连接，实际并发仍受上述预算及 Gateway 策略限制。本地历史按编码页上限的 8 倍预留，共享上限初始 8 MiB，并保留至解密、应用消费结束。详细规则以消息弹性补拉方案第 18 节及实施计划第 9.5 节为准。