@agentunion/fastaun 0.5.33 → 0.5.35

package/_packed_docs/sdk/09-stream-rpc-manual.md

@@ -19,6 +19,8 @@
 | `/pull/{stream_id}` | HTTP SSE | 拉流。推荐使用 `Authorization: Bearer {pull_token}`，可跨域 |
 | `/health` | HTTP GET | 健康检查 |
 
+四 SDK 均通过控制面 facade 封装上述 RPC：Python 使用 `client.stream.create/close/get_info/list_active`，TypeScript 与 Browser JS 使用 `client.stream.create/close/getInfo/listActive`，Go 使用 `client.Stream().Create/Close/GetInfo/ListActive(ctx, params)`。WS 推流和 SSE 拉流仍需按下文数据面端点自行连接。
+
 ---
 
 ## stream.create
@@ -31,7 +33,7 @@
 |------|------|------|------|
 | `content_type` | string | 否 | 内容类型，默认 `"text/plain"`。常用值：`text/plain`（文本流）、`application/json-stream`（JSON 对象流）、`text/event-stream`（SSE 风格事件流） |
 | `metadata` | object | 否 | 自定义元数据，如 `{"model": "gpt-4", "task_id": "xxx"}` |
-| `target_aid` | string | 否 | 绑定拉流方 AID。当前实现中，只有拉流方显式提供 `aid` 时才会做该匹配校验 |
+| `target_aid` | string | 否 | 绑定拉流方 AID。指定后，拉流请求必须通过 `X-Stream-AID` 提供完全匹配的 AID，否则返回 403 |
 
 ### 响应
 
@@ -43,7 +45,7 @@
 | `push_token` | string | 推流凭证 |
 | `pull_token` | string | 拉流凭证，便于通过 message.send 单独传递 |
 | `push_headers` | object | 推流 Authorization header（`{"Authorization": "Bearer {push_token}"}`) |
-| `pull_headers` | object | 拉流 Authorization header（`{"Authorization": "Bearer {pull_token}"}`) |
+| `pull_headers` | object | 拉流 Authorization header；设置 `target_aid` 时还包含 `X-Stream-AID` |
 
 ### 调用示例
 
@@ -59,7 +61,7 @@ result = await client.call("stream.create", {
 #   "push_token": "ec80...",
 #   "pull_token": "c438953be0ca887b...",
 #   "push_headers": {"Authorization": "Bearer ec80..."},
-#   "pull_headers": {"Authorization": "Bearer c438..."}
+#   "pull_headers": {"Authorization": "Bearer c438...", "X-Stream-AID": "target.aid.com"}
 # }
 ```
 
@@ -67,9 +69,15 @@ result = await client.call("stream.create", {
 
 ### 错误
 
+`content_type` 必须是非空字符串，包含 `/` 且不超过 255 bytes；`metadata` 必须是对象，UTF-8 JSON 编码后不超过 4096 bytes。
+`target_aid` 如提供必须是非空且合法的 AID；服务端会将其写入返回的 `pull_headers`。
+
 | code | message | 原因 |
 |------|---------|------|
-| -33402 | Stream limit exceeded | 活跃流数超过服务配置上限 |
+| -33402 | Stream limit exceeded | 活跃流数或关闭通知积压超过服务配置上限 |
+| -33405 | Stream invalid params | `content_type`、`metadata` 或 `target_aid` 参数无效 |
+| -33407 | Stream internal error | 外部地址不可用或服务内部错误 |
+| -32020 | Service stopping | 服务正在停止，暂不接受新流 |
 
 ---
 
@@ -108,7 +116,7 @@ await client.call("stream.close", {"stream_id": "4d5067f203cf42ba"})
 
 ## stream.get_info
 
-获取流的状态和统计信息。仅流的创建者或 `target_aid` 可调用。
+获取流的状态和统计信息。仅流的创建者或绑定的 `target_aid` 可调用；控制面通过已认证的调用方 AID 判定权限。
 
 ### 参数
 
@@ -169,7 +177,7 @@ for s in result["streams"]:
 
 ## 数据面：推流 WebSocket
 
-连接 `stream.create` 返回的 `push_url`，通过 WebSocket 发送 JSON 帧。使用 `Authorization: Bearer` 或 `X-Stream-Token` 请求头传递 token；query string 不接受凭据。
+连接 `stream.create` 返回的 `push_url`，通过 WebSocket 发送 JSON 帧。使用返回的 `push_headers`（或 `Authorization: Bearer` / `X-Stream-Token` 请求头）传递 token；query string 不接受凭据。
 
 ### 帧格式
 
@@ -181,8 +189,8 @@ for s in result["streams"]:
 | 字段 | 类型 | 必填 | 说明 |
 |------|------|------|------|
 | `cmd` | string | 是 | 固定 `"data"` |
-| `data` | string | 是 | 数据内容，无大小限制（WS 帧上限 64MB） |
-| `seq` | integer | 否 | 序列号，不提供则服务端自增 |
+| `data` | string | 是 | 数据内容；完整 WebSocket 消息最大 64 MiB，单条数据还必须不超过历史缓冲配置及运行时内存预算 |
+| `seq` | integer | 否 | 正整数序列号，不提供则服务端自增；低于或等于当前序号的帧会被忽略 |
 
 **关闭帧**：
 ```json
@@ -194,7 +202,7 @@ for s in result["streams"]:
 ```python
 import websockets, json
 
-async with websockets.connect(push_url, ssl=ssl_ctx) as ws:
+async with websockets.connect(push_url, additional_headers=push_headers, ssl=ssl_ctx) as ws:
     for i, token in enumerate(llm_tokens, 1):
         await ws.send(json.dumps({"cmd": "data", "data": token, "seq": i}))
     await ws.send(json.dumps({"cmd": "close"}))
@@ -202,7 +210,7 @@ async with websockets.connect(push_url, ssl=ssl_ctx) as ws:
 
 ### 断线重连
 
-WebSocket 断开后，服务端保留流状态最多 120 秒。重连后继续从断点 seq 推送即可。
+WebSocket 推流端离线后，默认 120 秒内可恢复（该超时可配置）；流关闭后默认保留 60 秒，保留与清理策略均可配置。重连后继续从断点 seq 推送即可。
 
 ---
 
@@ -210,7 +218,7 @@ WebSocket 断开后，服务端保留流状态最多 120 秒。重连后继续
 
 连接 `stream.create` 返回的 `pull_url`，接收标准 SSE 流。
 
-使用 `Authorization: Bearer` 或 `X-Stream-Token` 请求头传递 pull token；若提供拉流方 AID，使用 `X-Stream-AID` 请求头；query 参数不接受凭据或身份。
+使用 `Authorization: Bearer` 或 `X-Stream-Token` 请求头传递 pull token；指定 `target_aid` 时必须使用 `X-Stream-AID` 请求头提供匹配 AID；query 参数不接受凭据或身份。
 
 ### SSE 格式
 
@@ -235,8 +243,7 @@ data: {}
 - 客户端重连时可携带 `Last-Event-ID`
 - 服务端会跳过 `seq <= Last-Event-ID` 的缓冲数据，再继续实时推送
 
-注意：这只覆盖仍保留在当前流内存缓冲中的历史数据，不是持久化重放。
-如果请求的 seq 早于当前内存缓冲最小值，服务端不会返回显式 gap 错误，而是从仍保留的最早帧继续推送。
+注意：这只覆盖仍保留在当前流内存缓冲中的历史数据，不是持久化重放。`Last-Event-ID` 必须是非负整数；格式无效或为负数返回 400，超出当前序号或已早于保留窗口返回 416。
 
 ### 完整示例
 
@@ -244,7 +251,7 @@ data: {}
 import aiohttp
 
 async with aiohttp.ClientSession() as session:
-    async with session.get(pull_url, headers={"Accept": "text/event-stream"}) as resp:
+    async with session.get(pull_url, headers={**pull_headers, "Accept": "text/event-stream"}) as resp:
         buffer = ""
         async for chunk in resp.content.iter_any():
             buffer += chunk.decode()
@@ -255,10 +262,15 @@ async with aiohttp.ClientSession() as session:
 
 | 状态码 | 说明 |
 |--------|------|
-| 403 | pull_token 无效，或显式提供的 aid 与 target_aid 不匹配 |
+| 400 | `Last-Event-ID` 不是非负整数 |
+| 403 | pull_token 无效，或缺少/提供的 `X-Stream-AID` 与 target_aid 不匹配 |
 | 404 | 流不存在 |
-| 410 | 流已关闭 |
-| 429 | 拉流端数量已达上限 |
+| 410 | 推流路径对应的流已关闭 |
+| 416 | `Last-Event-ID` 超出当前序号或已早于保留窗口 |
+| 429 | 拉流端数量或重放内存预算已达上限 |
+| 503 | 服务正在停止或数据面准入容量已耗尽 |
+
+流关闭但尚未清理时，SSE 仍可回放 `event: done`；清理后返回 404。410 仅用于推流路径。
 
 ---
 
@@ -267,11 +279,12 @@ async with aiohttp.ClientSession() as session:
 | code | message | 说明 |
 |------|---------|------|
 | -33401 | Stream not found | stream_id 无效或流已被清理 |
-| -33402 | Stream limit exceeded | 活跃流数超过上限 |
+| -33402 | Stream limit exceeded | 活跃流数或关闭通知积压超过上限 |
 | -33403 | Stream permission denied | 非创建者执行受限操作 |
 | -33404 | Stream already closed | 流已关闭 |
-| -33405 | Stream invalid params | 参数无效（如缺少 stream_id） |
+| -33405 | Stream invalid params | 参数无效（如缺少 stream_id，或 `content_type`、`metadata`、`target_aid` 校验失败） |
 | -33406 | Stream rate limited | 速率限制 |
-| -33407 | Stream internal error | 服务内部错误 |
+| -33407 | Stream internal error | 外部地址不可用或服务内部错误 |
+| -32020 | Service stopping | 服务正在停止，暂不接受新流 |
 
 

package/_packed_docs/sdk/AUN_DOCS_GUIDE.md

@@ -1,6 +1,6 @@
 # AUN SDK 文档查阅指南
 
-AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：Layer 1 地图、Layer 2 主题索引、Layer 3 单篇摘要。按需逐层读取，避免一次性加载整套文档。
+AUN SDK 文档位于 `aun-sdk-core/docs/sdk/`，当前对照四 SDK **0.5.35** 源码。索引文件 `INDEX.md` 分三层：Layer 1 地图、Layer 2 主题索引、Layer 3 单篇摘要。`0.5.xx-*` 为版本增量专题，CHANGELOG 保留历史记录；现行接口以基础手册、RPC 手册和最新版本专题为准。
 
 ## SDK 文档定位
 
@@ -10,9 +10,9 @@ AUN SDK 文档位于 `docs/sdk/`，索引文件 `docs/sdk/INDEX.md` 分三层：
 - `AID`：不可变身份值对象，负责签名、验签和 agent.md 签验。
 - `AUNClient`：认证、连接、状态机、事件和 RPC。
 - `PushFacade`：Python SDK 的当前安装推送登记、注销和 Push Server 批次 ACK。
-- `ServiceProxyClient`：Python SDK 的 Service Proxy provider 侧客户端，负责 Gateway 控制面注册和 proxy-server 数据面隧道注册。
+- `ServiceProxyClient`：四 SDK 均有 Service Proxy 客户端入口，负责 Gateway 控制面注册和 proxy-server 数据面隧道注册；Browser provider 隧道需具备设置请求头能力的 `webSocketFactory`，见 [Proxy 手册](09-proxy-rpc-manual.md)。
 
-业务 RPC 的底层参数见 `09-*-rpc-manual.md`。P2P 共享 seq/peer 游标、pending peers/统计快照、need_render、device 定向发送、TTL volatile 和 ACK 见 `09-message-rpc-manual.md`。当前 Agent.md Schema、签名和上传前校验见 `../protocol/Ownership协议定义2.1.md` 与 `04-连接与认证.md`；`../agent.md/SCHEMA.md` 为 legacy 2.0。当前 Ownership 2.1 应用接入见 `Ownership2.1-SDK应用集成指南.md`，SDK 移植见 `Ownership2.1-SDK开发与移植指南.md`，wire schema 见 `../protocol/Ownership协议定义2.1.md`；旧集成/实现指南与管理专题为 legacy。新服务端为旧 SDK 保留隔离的 owner RPC/Auth JSONL，不参与 2.1 双文件关系判断。Group/Org owner 不走通用流程，名片实体主签、owner token 上传、可选 owner 附签、实体证书代际和原 CAS pending见协议 §1.3/§2.5。peer A/T/H、human Tail 策略、稀疏覆盖、后台续拉和每个 AUNClient 一个网络 Pull Gate（同 namespace 单飞、不同 namespace 最多 4 个并行、相同 key 折叠、可运行项前台 FIFO 优先）见 `03-核心概念.md`；`message.history` / `group.history` 与 Piggy ACK 见 Message/Group RPC Manual；SDK 50k 内存去重、应用持久幂等及三类 batch 的当前契约见 Message RPC Manual。
+业务 RPC 的底层参数见 `09-*-rpc-manual.md`。P2P 共享 seq/peer 游标、pending peers/统计快照、need_render、device 定向发送、TTL volatile 和 ACK 见 `09-message-rpc-manual.md`。当前 Agent.md Schema、签名和上传前校验见 `../protocol/Ownership协议定义2.1.md` 与 `04-连接与认证.md`；`../agent.md/SCHEMA.md` 为 legacy 2.0。当前 Ownership 2.1 应用接入见 `Ownership2.1-SDK应用集成指南.md`，SDK 移植见 `Ownership2.1-SDK开发与移植指南.md`，wire schema 见 `../protocol/Ownership协议定义2.1.md`；旧集成/实现指南与管理专题为 legacy。新服务端为旧 SDK 保留隔离的 owner RPC/Auth JSONL，不参与 2.1 双文件关系判断。现代 Group/Org 使用通用双文件声明与共识；绑定、释放、转移仍走专属生命周期，普通管理 Facade 的 not_applicable 不适用于共识。实体主签不带 signer_aid，不输出旧 entity_cert_fingerprint；历史格式、代际与访问补齐见协议 §1.3/§2.5。peer A/T/H、human Tail 策略、稀疏覆盖、后台续拉和每个 AUNClient 一个网络 Pull Gate（同 namespace 单飞、不同 namespace 最多 4 个并行、相同 key 折叠、可运行项前台 FIFO 优先）见 `03-核心概念.md`；`message.history` / `group.history` 与 Piggy ACK 见 Message/Group RPC Manual；SDK 50k 内存去重、应用持久幂等及三类 batch 的当前契约见 Message RPC Manual。
 
 Storage 的 SDK VFS、实际字节 MIME 识别、session/PUT/complete Content-Type 一致性、OSS 403、direct backend 上传下载和 ticket / AID Bearer 边界见 `09-storage-rpc-manual.md` 与 `AUN Storage架构设计.md`；Storage / Group FS 默认读缓存、60 秒总新鲜度、`read_cache`、SHA 条件读取、无正文 not_modified 不计次、持久层/容量与 `noCache` 规则见 [缓存策略](09-storage-rpc-manual.md#sdk-默认读缓存) 和 [API 选项](06-API手册.md#默认读缓存与单次刷新)。
 跨设备业务已读的 `read/read_state/read_changed`、单条/显式空值、回执与共享汇总、scope/owner 绑定、设备映射、晚到位置回填、TS/JS 精确整数和 Group canonical/权限版本及混合域提交见 Message/Group RPC Manual；四端门面与本地 `read_state_sync` 完成事件见 `06-API手册.md`、`04-连接与认证.md`。
@@ -29,11 +29,11 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 常见主题：
 
 - 身份与认证：AIDStore / AID / 注册 / 加载 / 证书
-- 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
+- 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 统一双文件声明／共识并保留专属生命周期，访问补齐及 create/transfer 检查点不等同于普通 Ownership 任务恢复；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 手册
-- AUN EventService：白名单/凭证授权、设备订阅、发布确认、TTL及恢复见[应用集成指南](AUN事件发布订阅应用集成指南.md)；协议、单实例、完整Verify、公平背压和四端差异见[开发移植指南](AUN事件发布订阅开发移植指南.md)
+- AUN EventService：0.5.35 通配／过滤与本地收发见 [0.5.35 应用集成指南](0.5.35-SDK应用集成指南.md)、[开发与移植指南](0.5.35-SDK开发与移植指南.md)及 [当前 parity](../../python/CHANGES_FOR_PARITY.md#v0535)；0.5.34 版本增量（多角色、持久目录、durable outbox、实时目录）见[0.5.34 应用集成指南](0.5.34-SDK应用集成指南.md)和[0.5.34 开发与移植指南](0.5.34-SDK开发与移植指南.md)；完整事件协议、租约、凭证和 fanout 流程见[AUN事件发布订阅应用集成指南](AUN事件发布订阅应用集成指南.md)与[AUN事件发布订阅开发移植指南](AUN事件发布订阅开发移植指南.md)
 - 离线推送：Python `connect()` 的 `push_notify_aid/push_token`、`client.push.register/unregister`、Push Server ACK
 - 消息同步：共享 seq 下的 peer A/T/H、稀疏覆盖/前驱、human Tail→Forward、50k 内存去重/应用持久幂等、N=4 网络 Gate、后台工作片续调度、`message.peers_snapshot` 的轻量对端水位/可选整体积压估计、目录/Pull逐页next_pending_seq、可靠commit后持续更新与每N次FIFO（无额外SQL、原列表顺序不改）、need_render/页内计数、`source` 和同步生命周期；Group 保持原终态规则
 - P2P TTL 消息：`message.send.ttl` 秒级钳制、按 device 内存收件箱、volatile 双游标、自动 ACK/去重、服务 epoch 与重启语义
@@ -56,15 +56,16 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 
 | 编号 | 文档 | 定位 |
 |------|------|------|
-| - | [AUN事件发布订阅应用集成指南](AUN事件发布订阅应用集成指南.md) | 在线通知接入、两种授权、多设备、成功语义、恢复和诊断 |
-| - | [AUN事件发布订阅开发移植指南](AUN事件发布订阅开发移植指南.md) | 线上协议、实例注册、凭证、背压、调度预算和跨端实现 |
+| - | [AUN事件发布订阅应用集成指南](AUN事件发布订阅应用集成指南.md) | 多角色接入、两种授权、目录合并、先持久再发布与重启恢复 |
+| - | [AUN事件发布订阅开发移植指南](AUN事件发布订阅开发移植指南.md) | 独立租约、SQLite/IndexedDB、成功删队列、原TTL与新发送尝试、凭证复核、过期失败及分角色实时清单查询 |
 | - | [0.5.21 SDK 应用集成指南](0.5.21-SDK应用集成指南.md) | 应用开发者的 TypeScript 接入、消息持久幂等、resolve/owner、凭证组织、诊断与升级 |
 | - | [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 身份隔离、缓存新鲜度与语言差异 |
-| - | [0.5.32 应用指南](0.5.32-SDK应用集成指南.md)、[开发与移植指南](0.5.32-SDK开发与移植指南.md)、[变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0532)；[Python](../../python/CHANGELOG.md)、[Go](../../go/CHANGELOG.md)、[TS](../../ts/CHANGELOG.md)、[JS](../../js/CHANGELOG.md) CHANGELOG | 当前目标对照已发布 0.5.31：EventService、设备租约、公平背压、消息调度、限流缓存及 Ownership |
+| - | [0.5.35 应用集成指南](0.5.35-SDK应用集成指南.md)、[开发与移植指南](0.5.35-SDK开发与移植指南.md)；[0.5.35 变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0535)；[0.5.34 历史应用集成指南](0.5.34-SDK应用集成指南.md)、[开发与移植指南](0.5.34-SDK开发与移植指南.md)、[变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0534)；[Python](../../python/CHANGELOG.md)、[Go](../../go/CHANGELOG.md)、[TS](../../ts/CHANGELOG.md)、[JS](../../js/CHANGELOG.md) CHANGELOG | 对照已发布 0.5.34：通配订阅／过滤、本地收发、后台 ACK、Echo v3.2、三端 UDP／原生 Mail、语言专属修复、单实例及验证边界 |
+| - | [0.5.32 应用指南](0.5.32-SDK应用集成指南.md)、[开发与移植指南](0.5.32-SDK开发与移植指南.md)、[变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0532)；[Python](../../python/CHANGELOG.md)、[Go](../../go/CHANGELOG.md)、[TS](../../ts/CHANGELOG.md)、[JS](../../js/CHANGELOG.md) CHANGELOG | 历史基线：EventService 初始 API、设备租约、公平背压、消息调度、限流缓存及 Ownership |
 | - | [0.5.30 应用指南](0.5.30-SDK应用集成指南.md)、[开发与移植指南](0.5.30-SDK开发与移植指南.md)、[变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0530--控制流按需恢复与-sdk-行为对齐未发布) | 按需控制流恢复、observer.forward 本地字段剥离、本地 human owner、Storage 版本预检及四端差异 |
 | - | [0.5.29 应用指南](0.5.29-SDK应用集成指南.md)、[开发与移植指南](0.5.29-SDK开发与移植指南.md)、[变更与跨端对齐](../../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) | 0.5.29 基线：共识输入输出、无 TTL 的 ETag 缓存、resolve、普通上传锁与恢复、NS 配套及四端移植 |
 | - | [0.5.28 应用指南](0.5.28-SDK应用集成指南.md)、[开发与移植指南](0.5.28-SDK开发与移植指南.md)；[0.5.27 应用指南](0.5.27-SDK应用集成指南.md)、[开发与移植指南](0.5.27-SDK开发与移植指南.md) | 0.5.28 agent.md 上传／下载校验、共识 fresh、分类控制消息、Owner 通知与风控；四端实现和验证范围见 [parity](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布) |
@@ -74,7 +75,7 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 | 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 协议定义 2.1](../protocol/Ownership协议定义2.1.md) | 当前双文件关系、现代 Group/Org 共识与生命周期、签名授权、旧 SDK owner RPC/JSONL 隔离 |
 | - | [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 |
@@ -90,7 +91,7 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 | - | [组织服务 RPC 手册](09-组织服务RPC手册.md) | Org Service 生命周期/成员 RPC、内部接口和未实现方法 |
 | 05 | [E2EE加密通信](05-E2EE加密通信.md) | E2EE V2、ProtectedHeaders、need_render、agent.md 版本提示、旧 SPK 保留 |
 | - | [ProtectedHeaders用法专题](ProtectedHeaders用法专题.md) | `protected_headers` 四端 API、实例级/单次调用、E2EE V2 HMAC 完整性和接收信任边界 |
-| 06 | [API手册](06-API手册.md) | AIDStore / resolve opts 与输入输出 / frontmatter 类型 / Agent.md 校验签名 / AID / AUNClient 生命周期并发 / 四 SDK access token getter / 群组高层身份编排 / History 与已读门面 / 已读变更及本地补偿完成 / 消息来源与 Pull 同步生命周期 / 事件 / RPC；当前增量见 [0.5.32 parity](../../python/CHANGES_FOR_PARITY.md#v0532) |
+| 06 | [API手册](06-API手册.md) | AIDStore / resolve opts 与输入输出 / frontmatter 类型 / Agent.md 校验签名 / AID / AUNClient 生命周期并发 / 四 SDK access token getter / 群组高层身份编排 / History 与已读门面 / 已读变更及本地补偿完成 / 消息来源与 Pull 同步生命周期 / 事件 / RPC；UDP 待机固定 20 字节心跳与动态周期见尾节 L1141-1165；当前增量见 [0.5.35 parity](../../python/CHANGES_FOR_PARITY.md#v0535) |
 | 07 | [错误处理](07-错误处理.md) | Result、Python `ErrorInfo.cause`、异常、错误码、重试 |
 | 08 | [最佳实践](08-最佳实践.md) | 幂等、消息同步/History、AUNClient 级 Pull Gate（同 namespace 单飞、客户端最多 4 个并行）、测试数据 |
 | - | [Storage RPC 手册](09-storage-rpc-manual.md) | Storage RPC、实际字节 MIME、三阶段 Content-Type、OSS 403、HTTP 下载与凭据边界、默认读缓存持久层、条件读取与 noCache |
@@ -103,24 +104,25 @@ Group 的成员 block/status、暂停群权限和两阶段群主转让，以及
 
 | 场景 | 推荐路径 |
 |------|----------|
-| 接入 AUN 发布订阅或处理未收到事件 | [应用集成指南](AUN事件发布订阅应用集成指南.md)：场景 L5-38、门面 L39-55、白名单 L56-127、凭证 L128-152、多设备 L153-168、恢复 L169-184、持久化/诊断 L185-216、依据 L217-222 |
-| 实现或移植 AUN 发布订阅 | [开发移植指南](AUN事件发布订阅开发移植指南.md)：分层 L5-19、实例 L20-39、协议/幂等 L40-87、授权 L88-115、目录 L116-127、分发/预算 L128-173、接收 L174-185、跨端状态 L186-204、验收 L205-229 |
+| 接入 AUN 发布订阅或处理未收到事件 | [应用集成指南](AUN事件发布订阅应用集成指南.md)：架构 L5-76、多角色门面 L77-103、Bus目录合并 L106-174、Sub订阅 L175-230、Pub先持久再发布 L231-290、凭证 L291-398、多设备 L399-414、原ID/TTL恢复 L415-430、存储/成功删除/诊断 L431-477、本次依据 L478-484 |
+| 实现或移植 AUN 发布订阅 | [开发移植指南](AUN事件发布订阅开发移植指南.md)：多角色分层 L5-64、实例与加载 L65-132、协议/幂等 L133-184、独立授权 L185-323、目录合并 L324-341、耐久入队/删除/TTL/预算 L342-430、订阅与发布恢复 L431-529、四端存储隔离 L530-554、统计错误及验收 L555-588 |
+| 核对 0.5.35 增量与 0.5.34 接入专题 | [0.5.35 应用指南](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；[开发与移植指南](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。 [当前 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 历史专题： [应用集成指南](0.5.34-SDK应用集成指南.md)：本版变化与架构、EventService 多角色和持久化、Storage 条件 ACL、Group FS／Service Proxy、弹性补拉与验收；[开发与移植指南](0.5.34-SDK开发与移植指南.md)：四端分层、EventService 共同契约、控制消息、ACL、Group FS／Storage／Proxy、弹性补拉和验收；[parity](../../python/CHANGES_FOR_PARITY.md#v0534) |
 | 接入或升级 0.5.21，查看 TypeScript 应用示例 | [0.5.21 SDK 应用集成指南](0.5.21-SDK应用集成指南.md) |
 | 实现、移植或审查 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.31，接入或移植 0.5.32 | [应用指南](0.5.32-SDK应用集成指南.md)：本版变化/整体架构 L5-52、身份与入口 L53-87、白名单多事件流程 L88-171、凭证审批签发 L172-246、设备/租约/容量/存储 L247-282、VFS Cache L283-330、其它主要改动与验收 L331-350；[开发与移植指南](0.5.32-SDK开发与移植指南.md)：基线/架构/四端入口 L5-53、单实例注册与状态 L54-107、鉴权和目录原子提交 L108-156、消息/公平背压/RPC预算 L157-227、恢复/限流/任务 L228-242、VFS并发失效 L243-288、四端落点/独有变化 L289-303、验收入口及已有证据 L304-319；[parity](../../python/CHANGES_FOR_PARITY.md#v0532) L17-114 |
-| 接入或移植 0.5.30，核查后台恢复、本地 Ownership 与 Storage 版本处理 | [应用指南](0.5.30-SDK应用集成指南.md)：行为 L5-14、消息恢复 L16-29、Ownership L31-43、Storage L45-47、转发与风控 L49-53、升级 L55-61；[开发与移植指南](0.5.30-SDK开发与移植指南.md)：契约 L5-14、控制恢复 L16-29、转发 L31-43、Ownership/YAML L45-49、Storage L51-55、差异 L57-68；[parity](../../python/CHANGES_FOR_PARITY.md#v0530--控制流按需恢复与-sdk-行为对齐未发布) L186-227 |
-| 接入或移植 0.5.29 基线，核查共识、resolve、上传锁与恢复 | [应用指南](0.5.29-SDK应用集成指南.md)：接入 L5-54、共识 L55-80、resolve L81-104、上传管理 L105-145、缓存／业务 L146-167、升级 L168-180；[开发与移植指南](0.5.29-SDK开发与移植指南.md)：契约 L5-63、缓存／resolve L64-94、上传恢复 L95-123、四端／继承 L124-151、核查 L152-164；[parity](../../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L231-300 |
-| 回看 0.5.28 的 schema、共识、控制消息、Owner 通知与风控，以及 0.5.27 的历史增量 | [0.5.28 应用指南](0.5.28-SDK应用集成指南.md)：接入与消息 §1—§3 L5-95、凭证／组织 §4—§5 L96-137、Storage／Ownership §6—§7 L138-186、通知 §8 L187-201、风控／升级 §9—§10 L202-228；[开发与移植指南](0.5.28-SDK开发与移植指南.md)：校验 §1 L7-36、共识 §2 L37-62、wire §3 L63-108、outbox §4 L109-121、风控 §5 L122-134、移植 §6 L135-146。 [历史 parity](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布) L304-385；公共共识流程以 0.5.29 为准 |
+| 对照已发布 0.5.31，接入或移植 0.5.32 | [应用指南](0.5.32-SDK应用集成指南.md)：本版变化/整体架构 L5-52、身份与入口 L53-87、白名单多事件流程 L88-171、凭证审批签发 L172-246、设备/租约/容量/存储 L247-282、VFS Cache L283-330、其它主要改动与验收 L331-350；[开发与移植指南](0.5.32-SDK开发与移植指南.md)：基线/架构/四端入口 L5-53、单实例注册与状态 L54-107、鉴权和目录原子提交 L108-156、消息/公平背压/RPC预算 L157-227、恢复/限流/任务 L228-242、VFS并发失效 L243-288、四端落点/独有变化 L289-303、验收入口及已有证据 L304-319；[parity](../../python/CHANGES_FOR_PARITY.md#v0532) L242-339 |
+| 接入或移植 0.5.30，核查后台恢复、本地 Ownership 与 Storage 版本处理 | [应用指南](0.5.30-SDK应用集成指南.md)：行为 L5-14、消息恢复 L16-29、Ownership L31-43、Storage L45-47、转发与风控 L49-53、升级 L55-61；[开发与移植指南](0.5.30-SDK开发与移植指南.md)：契约 L5-14、控制恢复 L16-29、转发 L31-43、Ownership/YAML L45-49、Storage L51-55、差异 L57-68；[parity](../../python/CHANGES_FOR_PARITY.md#v0530--控制流按需恢复与-sdk-行为对齐未发布) L411-452 |
+| 接入或移植 0.5.29 基线，核查共识、resolve、上传锁与恢复 | [应用指南](0.5.29-SDK应用集成指南.md)：接入 L5-54、共识 L55-80、resolve L81-104、上传管理 L105-145、缓存／业务 L146-167、升级 L168-180；[开发与移植指南](0.5.29-SDK开发与移植指南.md)：契约 L5-63、缓存／resolve L64-94、上传恢复 L95-123、四端／继承 L124-151、核查 L152-164；[parity](../../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L456-525 |
+| 回看 0.5.28 的 schema、共识、控制消息、Owner 通知与风控，以及 0.5.27 的历史增量 | [0.5.28 应用指南](0.5.28-SDK应用集成指南.md)：接入与消息 §1—§3 L5-95、凭证／组织 §4—§5 L96-137、Storage／Ownership §6—§7 L138-186、通知 §8 L187-201、风控／升级 §9—§10 L202-228；[开发与移植指南](0.5.28-SDK开发与移植指南.md)：校验 §1 L7-36、共识 §2 L37-62、wire §3 L63-108、outbox §4 L109-121、风控 §5 L122-134、移植 §6 L135-146。 [历史 parity](../../python/CHANGES_FOR_PARITY.md#v0528--校验控制消息与风控未发布) L529-610；公共共识流程以 0.5.29 为准 |
 | 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 共识 | [0.5.29 resolve](0.5.29-SDK应用集成指南.md#4-resolve-与-frontmatter) L81-104；完整基础接口见 [API 手册](06-API手册.md#resolve-输入与输出)，实现增量见 [parity](../../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L231-300 |
+| 查询 resolve opts、frontmatter 字段及类型、按需 ownership 共识 | [0.5.29 resolve](0.5.29-SDK应用集成指南.md#4-resolve-与-frontmatter) L81-104；完整基础接口见 [API 手册](06-API手册.md#resolve-输入与输出)，实现增量见 [parity](../../python/CHANGES_FOR_PARITY.md#v0529--共识查询缓存与普通上传未发布) L456-525 |
 | 查旧 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 应用：绑定／释放／转移、两个 local 编排、审批及显式重试的 TS 示例与图 | [应用集成指南](Ownership2.1-SDK应用集成指南.md) |
 | Ownership 2.1 移植：NS 验收、条件发布、通用消息交付、本地编排和文件 CAS | [开发与移植指南](Ownership2.1-SDK开发与移植指南.md) |