@agentunion/fastaun-browser 0.5.10 → 0.5.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +32 -0
- package/_packed_docs/CHANGELOG.md +32 -0
- package/_packed_docs/INDEX.md +3 -3
- package/_packed_docs/KITE_DOCS_GUIDE.md +1 -1
- package/_packed_docs/sdk/06-API/346/211/213/345/206/214.md +59 -0
- package/_packed_docs/sdk/AUN_DOCS_GUIDE.md +3 -2
- package/_packed_docs/sdk/INDEX.md +2 -1
- package/dist/bundle.js +588 -88
- package/dist/client/delivery.d.ts +11 -4
- package/dist/client/delivery.d.ts.map +1 -1
- package/dist/client/delivery.js +180 -31
- package/dist/client/delivery.js.map +1 -1
- package/dist/client/rpc-pipeline.d.ts.map +1 -1
- package/dist/client/rpc-pipeline.js +14 -2
- package/dist/client/rpc-pipeline.js.map +1 -1
- package/dist/client/v2-e2ee.d.ts +3 -0
- package/dist/client/v2-e2ee.d.ts.map +1 -1
- package/dist/client/v2-e2ee.js +147 -32
- package/dist/client/v2-e2ee.js.map +1 -1
- package/dist/client.d.ts +1 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +61 -2
- package/dist/client.js.map +1 -1
- package/dist/transport.d.ts.map +1 -1
- package/dist/transport.js +159 -15
- package/dist/transport.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,38 @@
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## 0.5.11 — 2026-09-03
|
|
10
|
+
|
|
11
|
+
### 新功能
|
|
12
|
+
|
|
13
|
+
#### 消息来源与同步生命周期
|
|
14
|
+
- P2P 消息、群消息、群事件、撤回和不可解密事件的应用 payload 新增 `source`,统一标识 `push`、`pull`、`inline_push` 或 `pending_retry`;`delivery.changed` 同步增加规范化 `source`。
|
|
15
|
+
- 新增 `sync.started`、`sync.progress`、`sync.stopped` 生命周期事件。首次进入 Pull 时启动同步,每个 P2P/群 Pull page 完成后报告 namespace、页数、原始/已投递条数、`has_more`、`remaining`/估算剩余量,全部 Pull work 排空或中止时结束。
|
|
16
|
+
- 同步事件继续经应用异步 FIFO 分发;并发 namespace 归入同一 run,Pull 失败、断线、关闭或身份代次重置以 `reason: "aborted"` 收口,不再把失败同步报告为正常排空。
|
|
17
|
+
|
|
18
|
+
#### 连接后身份准入自愈
|
|
19
|
+
- 每次 Gateway 连接成功后异步执行一次身份准入检查:普通 AID 缺少远端 agent.md 时复用本地内容或生成默认内容并补传。
|
|
20
|
+
- 对当前 AID 作为群主的群逐个检查 group AID;缺少本地群证书/私钥时触发绑定并沿用绑定流程上传 group agent.md,已有群身份但远端缺少 group agent.md 时补传。检查失败只记录告警,不阻塞已建立的连接。
|
|
21
|
+
|
|
22
|
+
### 修复
|
|
23
|
+
|
|
24
|
+
#### 浏览器 Worker 与 CSP 兼容
|
|
25
|
+
- Worker WebSocket 代理增加 `ready`/`open` 两阶段启动确认和超时;`worker-src 'none'` 等 CSP 导致的异步 `error`、启动无响应、open 前关闭均会销毁 Worker、撤销 Blob URL,并自动回退原生 WebSocket。
|
|
26
|
+
- Worker 已连接后异常也可切换到原生 WebSocket,待发送请求会明确完成或失败;无 Worker 环境直接使用原生 WebSocket,应用事件仍由异步 dispatcher 隔离,避免 handler 阻塞网络处理。
|
|
27
|
+
|
|
28
|
+
#### V2 消息兼容与来源保持
|
|
29
|
+
- Tail/Forward/History 能识别 V1 wrapper 内的 `e2ee.p2p_encrypted` / `e2ee.group_encrypted` V2 envelope,并进入 V2 解密路径;群撤回在旧格式行中仍优先归一化为撤回事件。
|
|
30
|
+
- ordered queue、sender IK 延迟恢复、inline realtime 和不可解密事件保持原始来源,避免补洞消息被误标为 push;群 Tail 同步进度仅由当前实例拥有的 cursor 产生。
|
|
31
|
+
|
|
32
|
+
### 改进
|
|
33
|
+
|
|
34
|
+
- SDK 包、锁文件、运行时 `VERSION`、V2 E2EE envelope `sdk_version`、conformance 及相关测试期望统一更新为 `0.5.11`。
|
|
35
|
+
|
|
36
|
+
### 测试
|
|
37
|
+
|
|
38
|
+
- 新增 Worker 正常可用、CSP 禁止 Blob Worker、无 Worker、异步启动失败、open 超时及运行中崩溃的单元与 Playwright 浏览器测试。
|
|
39
|
+
- 扩展 `source`、`sync.*` 状态机、Pull 中止、分页进度、V1 wrapper 内 V2 envelope、连接后普通/群 agent.md 自愈及版本 conformance 测试。
|
|
40
|
+
|
|
9
41
|
## 0.5.10 — 2026-09-02
|
|
10
42
|
|
|
11
43
|
### 新功能
|
|
@@ -6,6 +6,38 @@
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## 0.5.11 — 2026-09-03
|
|
10
|
+
|
|
11
|
+
### 新功能
|
|
12
|
+
|
|
13
|
+
#### 消息来源与同步生命周期
|
|
14
|
+
- P2P 消息、群消息、群事件、撤回和不可解密事件的应用 payload 新增 `source`,统一标识 `push`、`pull`、`inline_push` 或 `pending_retry`;`delivery.changed` 同步增加规范化 `source`。
|
|
15
|
+
- 新增 `sync.started`、`sync.progress`、`sync.stopped` 生命周期事件。首次进入 Pull 时启动同步,每个 P2P/群 Pull page 完成后报告 namespace、页数、原始/已投递条数、`has_more`、`remaining`/估算剩余量,全部 Pull work 排空或中止时结束。
|
|
16
|
+
- 同步事件继续经应用异步 FIFO 分发;并发 namespace 归入同一 run,Pull 失败、断线、关闭或身份代次重置以 `reason: "aborted"` 收口,不再把失败同步报告为正常排空。
|
|
17
|
+
|
|
18
|
+
#### 连接后身份准入自愈
|
|
19
|
+
- 每次 Gateway 连接成功后异步执行一次身份准入检查:普通 AID 缺少远端 agent.md 时复用本地内容或生成默认内容并补传。
|
|
20
|
+
- 对当前 AID 作为群主的群逐个检查 group AID;缺少本地群证书/私钥时触发绑定并沿用绑定流程上传 group agent.md,已有群身份但远端缺少 group agent.md 时补传。检查失败只记录告警,不阻塞已建立的连接。
|
|
21
|
+
|
|
22
|
+
### 修复
|
|
23
|
+
|
|
24
|
+
#### 浏览器 Worker 与 CSP 兼容
|
|
25
|
+
- Worker WebSocket 代理增加 `ready`/`open` 两阶段启动确认和超时;`worker-src 'none'` 等 CSP 导致的异步 `error`、启动无响应、open 前关闭均会销毁 Worker、撤销 Blob URL,并自动回退原生 WebSocket。
|
|
26
|
+
- Worker 已连接后异常也可切换到原生 WebSocket,待发送请求会明确完成或失败;无 Worker 环境直接使用原生 WebSocket,应用事件仍由异步 dispatcher 隔离,避免 handler 阻塞网络处理。
|
|
27
|
+
|
|
28
|
+
#### V2 消息兼容与来源保持
|
|
29
|
+
- Tail/Forward/History 能识别 V1 wrapper 内的 `e2ee.p2p_encrypted` / `e2ee.group_encrypted` V2 envelope,并进入 V2 解密路径;群撤回在旧格式行中仍优先归一化为撤回事件。
|
|
30
|
+
- ordered queue、sender IK 延迟恢复、inline realtime 和不可解密事件保持原始来源,避免补洞消息被误标为 push;群 Tail 同步进度仅由当前实例拥有的 cursor 产生。
|
|
31
|
+
|
|
32
|
+
### 改进
|
|
33
|
+
|
|
34
|
+
- SDK 包、锁文件、运行时 `VERSION`、V2 E2EE envelope `sdk_version`、conformance 及相关测试期望统一更新为 `0.5.11`。
|
|
35
|
+
|
|
36
|
+
### 测试
|
|
37
|
+
|
|
38
|
+
- 新增 Worker 正常可用、CSP 禁止 Blob Worker、无 Worker、异步启动失败、open 超时及运行中崩溃的单元与 Playwright 浏览器测试。
|
|
39
|
+
- 扩展 `source`、`sync.*` 状态机、Pull 中止、分页进度、V1 wrapper 内 V2 envelope、连接后普通/群 agent.md 自愈及版本 conformance 测试。
|
|
40
|
+
|
|
9
41
|
## 0.5.10 — 2026-09-02
|
|
10
42
|
|
|
11
43
|
### 新功能
|
package/_packed_docs/INDEX.md
CHANGED
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
| [SDK 文档索引](sdk/INDEX.md) | SDK 使用手册、四 SDK 当前 access token getter、Python Push 自动登记/Facade、RPC 手册、E2EE、Storage VFS、Group FS 和 Collab 的子索引 |
|
|
31
31
|
| [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md) | SDK 文档按行区间渐进式查阅方法 |
|
|
32
32
|
| [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md) | 以 0.5.5 为基线的四 SDK 发布汇总;覆盖首次签名者回源、下载提交前验签、消息窗口、显式 change-seed 和语言能力边界 |
|
|
33
|
-
| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.
|
|
33
|
+
| [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md) | 以 Python 实现为主线的 v0.3.3 至 v0.5.11 跨语言对齐清单;0.5.11 重点覆盖消息来源、sync 生命周期、连接后身份准入自愈、Worker 降级与 V1 wrapper 内 V2 envelope 兼容 |
|
|
34
34
|
| [AUN CLI 手册](cli/CLI手册.md) | Python CLI 源码位置、安装运行入口、全局选项、profile 配置和主要命令集 |
|
|
35
35
|
| [AUN CLI 设计文档](cli/AUN-CLI设计文档.md) | `python/src/aun_cli` 当前实现架构、命令注册面、配置解析、SDK 桥接和实现边界 |
|
|
36
36
|
| [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>) | Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、服务端分层和 direct backend 上传下载 |
|
|
@@ -86,7 +86,7 @@
|
|
|
86
86
|
- 四 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>)
|
|
87
87
|
- 按主题和行区间查 SDK 文档 → [SDK 查阅指南](sdk/AUN_DOCS_GUIDE.md)
|
|
88
88
|
- 四 SDK 0.5.6 发布摘要、首次签名者回源、可信缓存提交、消息窗口、语言能力边界 → [AUN SDK 0.5.6 更新日志](sdk/CHANGELOG-0.5.6.md)
|
|
89
|
-
- 四 SDK
|
|
89
|
+
- 四 SDK 相对发布基线的实现级差异、代码/测试落点、对齐优先级、消息来源、sync 生命周期、身份准入自愈和 Worker 降级边界 → [四 SDK 版本对齐变更清单](../python/CHANGES_FOR_PARITY.md)
|
|
90
90
|
- Python CLI 源码位置、安装运行入口、全局选项、profile 配置、身份/消息/群组/Storage/Group FS/Collab/诊断等命令用法 → [AUN CLI 手册](cli/CLI手册.md)
|
|
91
91
|
- Python CLI 当前实现架构、`main.py` 命令注册、`CLISession` SDK 桥接、配置解析和实现边界 → [AUN CLI 设计文档](cli/AUN-CLI设计文档.md)
|
|
92
92
|
- Storage SDK VFS、控制面/数据面分离、下载 ticket / AID Bearer 边界、当前 access token getter、类 Linux 权限、mount/symlink、direct backend 上传下载和服务端分层 → [AUN Storage 架构设计](<aun-fs/AUN Storage架构设计.md>)
|
|
@@ -222,7 +222,7 @@
|
|
|
222
222
|
|
|
223
223
|
### 四 SDK 版本对齐变更清单
|
|
224
224
|
|
|
225
|
-
`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript
|
|
225
|
+
`python/CHANGES_FOR_PARITY.md` 以 Python SDK 历史实现为主线记录 Go / TypeScript / JavaScript 的对齐要求。当前 v0.5.11 章节以 `8abb1d7d` 的 v0.5.10 为基线,区分四语言共有能力与 JS/TS Worker 专属边界,并明确消息来源、sync 生命周期、连接后身份准入自愈、V1 wrapper 内 V2 envelope 兼容和分页进度的一致性要求。
|
|
226
226
|
|
|
227
227
|
### AUN CLI 手册
|
|
228
228
|
|
|
@@ -102,7 +102,7 @@ AUN SDK Core 文档在 `docs/` 下。根级索引为 `docs/INDEX.md`,SDK API
|
|
|
102
102
|
| SDK API、RPC、E2EE、Storage VFS、Group FS、Collab GC/reflog/reset 使用细节 | `docs/sdk/AUN_DOCS_GUIDE.md` |
|
|
103
103
|
| 四 SDK 当前 access token getter、缓存快照语义和外部 HTTP 数据面下载凭据生命周期 | `docs/sdk/04-连接与认证.md` L94-123、`docs/sdk/06-API手册.md` L192-209、`docs/sdk/09-storage-rpc-manual.md` L621-663、`docs/sdk/09-group-rpc-manual.md` L1448-1452、`docs/aun-fs/AUN Storage架构设计.md` L153-166 |
|
|
104
104
|
| 四 SDK 0.5.6 发布摘要、验签缓存、消息窗口与语言能力边界 | `docs/sdk/CHANGELOG-0.5.6.md` L1-73 |
|
|
105
|
-
| 四 SDK
|
|
105
|
+
| 四 SDK 版本差异、跨语言对齐优先级、消息来源、sync 生命周期、身份准入自愈与 Worker 降级边界 | `python/CHANGES_FOR_PARITY.md` L11-101 |
|
|
106
106
|
| 群 `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` |
|
|
107
107
|
| AUN Python CLI 源码位置、安装入口、全局选项、profile 配置和主要命令集 | `docs/cli/CLI手册.md` L3-333 |
|
|
108
108
|
| AUN Python CLI 当前实现架构、命令注册、SDK 桥接和实现边界 | `docs/cli/AUN-CLI设计文档.md` L3-265 |
|
|
@@ -737,8 +737,11 @@ sub.unsubscribe()
|
|
|
737
737
|
| `message.received` | 收到 P2P 消息 |
|
|
738
738
|
| `message.ack` | 消息 ack |
|
|
739
739
|
| `message.undecryptable` | P2P E2EE 解密失败 |
|
|
740
|
+
| `group.message_created` | 收到群消息 |
|
|
740
741
|
| `group.changed` | 群组事件 |
|
|
742
|
+
| `group.message_recalled` | 群消息撤回 |
|
|
741
743
|
| `group.message_undecryptable` | 群 E2EE 解密失败 |
|
|
744
|
+
| `sync.started` / `sync.progress` / `sync.stopped` | Pull 同步生命周期 |
|
|
742
745
|
| `delivery.changed` | SDK 本地批量交付完成通知,用于合并应用层 UI 刷新 |
|
|
743
746
|
| `push.offline_message` | Push Server 收到离线唤醒批次;普通终端无需订阅 |
|
|
744
747
|
| `storage.object_changed` | Storage 对象变更事件透传 |
|
|
@@ -777,6 +780,62 @@ sub.unsubscribe()
|
|
|
777
780
|
|
|
778
781
|
`delivery.changed` 只表示 UI 刷新时机,不是消息明细或持久化账本。应用仓库仍应按照原消息事件的 `(namespace, message_id)` 做幂等,并按 `seq` 排序。
|
|
779
782
|
|
|
783
|
+
### 消息来源 `source`
|
|
784
|
+
|
|
785
|
+
消息、群消息、群事件、撤回和不可解密事件的 payload 可能带有顶层 `source`,用于区分 SDK 的投递来源:
|
|
786
|
+
|
|
787
|
+
| `source` | 含义 |
|
|
788
|
+
|----------|------|
|
|
789
|
+
| `push` | 普通实时推送 |
|
|
790
|
+
| `pull` | Pull、Tail、Forward 或群事件补洞 |
|
|
791
|
+
| `inline_push` | 已在连续窗口内直接消费的实时载荷 |
|
|
792
|
+
| `pending_retry` | 缺失 Sender IK 后延迟恢复的消息 |
|
|
793
|
+
|
|
794
|
+
直接由应用或无来源内部调用产生的事件不强行添加 `source`。`source` 位于应用事件 payload 顶层,不改变业务 `payload` 内的数据结构;应用应将其视为保留字段。
|
|
795
|
+
|
|
796
|
+
### Pull 同步生命周期
|
|
797
|
+
|
|
798
|
+
四个 SDK 均通过本地 dispatcher 发布以下异步生命周期事件;它们不是 Gateway 的 `event/...` 消息,应用 handler 不会阻塞网络 reader。
|
|
799
|
+
|
|
800
|
+
`sync.started` 在本次 Pull 的第一个 namespace 开始时发布一次:
|
|
801
|
+
|
|
802
|
+
```json
|
|
803
|
+
{
|
|
804
|
+
"run_id": 7,
|
|
805
|
+
"source": "pull",
|
|
806
|
+
"syncing": true,
|
|
807
|
+
"namespaces_pending": 1,
|
|
808
|
+
"namespace": "p2p",
|
|
809
|
+
"received_total": 0,
|
|
810
|
+
"started_at": 1730000000000
|
|
811
|
+
}
|
|
812
|
+
```
|
|
813
|
+
|
|
814
|
+
每完成一页消息或群事件的处理、提交和有序投递,发布一次 `sync.progress`。`page_raw_count` 是本页有效原始条数,`page_pulled_count` 是本页实际投递条数;`pulled_count` / `received_total` 是本次 namespace 的累计投递数。服务端返回合法非负整数时透传 `remaining`,并同步设置 `estimated_remaining`;否则仅在协议可推导时提供估算值。
|
|
815
|
+
|
|
816
|
+
```json
|
|
817
|
+
{
|
|
818
|
+
"run_id": 7,
|
|
819
|
+
"source": "pull",
|
|
820
|
+
"namespace": "p2p",
|
|
821
|
+
"page": 2,
|
|
822
|
+
"page_raw_count": 50,
|
|
823
|
+
"page_pulled_count": 48,
|
|
824
|
+
"pulled_count": 98,
|
|
825
|
+
"received_total": 98,
|
|
826
|
+
"batch_size": 48,
|
|
827
|
+
"has_more": true,
|
|
828
|
+
"remaining": 102,
|
|
829
|
+
"estimated_remaining": 102
|
|
830
|
+
}
|
|
831
|
+
```
|
|
832
|
+
|
|
833
|
+
当所有 namespace、续页、gap fill、ordered drain 和延迟 Sender IK 任务均排空时发布一次 `sync.stopped`。正常终态使用 `reason: "pull_drained"`;异常、取消、断线或连接/身份代次失效使用 `reason: "aborted"`。`sync.stopped` 描述同步生命周期终点,`delivery.changed(trigger="pull_drained")` 只汇总实际投递变化;空 Pull 可以有前者而没有后者。
|
|
834
|
+
|
|
835
|
+
### JS/TS Worker 降级
|
|
836
|
+
|
|
837
|
+
JavaScript 浏览器 SDK 的 Worker 是网络隔离增强:`new Worker()` 同步失败、CSP `worker-src` 阻止、Worker 启动后未及时 `open` 或异步崩溃时,SDK 会销毁 Worker 并回退原生 WebSocket。TypeScript Node.js SDK 在 `worker_threads` 不可用、启动超时或 Network Actor 崩溃时回退本地 transport。两种降级均保留异步 dispatcher 和 Pull 生命周期语义,不要求应用改变消息处理代码。
|
|
838
|
+
|
|
780
839
|
---
|
|
781
840
|
|
|
782
841
|
## E2EE 高级 API
|
|
@@ -32,7 +32,7 @@ Group FS 的 `group.fs.*` RPC、`client.group.fs.*` 门面、`aun group fs` CLI
|
|
|
32
32
|
- E2EE:默认加密、ProtectedHeaders、P2P / Group V2
|
|
33
33
|
- RPC 与事件:`client.call()`、`client.on()`、`client.notify()`、RPC 手册
|
|
34
34
|
- 离线推送:Python `connect()` 的 `push_notify_aid/push_token`、`client.push.register/unregister`、Push Server ACK
|
|
35
|
-
- 消息同步:A/T/H、Tail、Forward、History、页内唯一有序发布、应用层跨页幂等排序、每个 AUNClient 一个 Pull Gate(P2P Message/Group Message/Group Event Pull 共享,始终单飞、相同 key 折叠、不同 key 排队、前台 FIFO
|
|
35
|
+
- 消息同步:A/T/H、Tail、Forward、History、页内唯一有序发布、应用层跨页幂等排序、每个 AUNClient 一个 Pull Gate(P2P Message/Group Message/Group Event Pull 共享,始终单飞、相同 key 折叠、不同 key 排队、前台 FIFO 优先)、`source` 来源、`sync.started/progress/stopped` 生命周期、缺 sender IK 有界同步 bootstrap、永久页内 Gap、坏密文推进
|
|
36
36
|
- Storage:SDK VFS、direct backend 数据面、下载 ticket / AID Bearer 边界、`storage.*` low-level RPC、类 Linux 权限、mount/symlink、Storage Service 分层
|
|
37
37
|
- Group RPC:群提及过滤 `mention_mode`、`group_aid` / `group_id` 兼容、`group.index` 签名索引、`_meta.group_indexes`、`check/get/updateGroupIndex`、`expected_index_etag` CAS(见 `09-group-rpc-manual.md`、`06-API手册.md`)
|
|
38
38
|
- 群文件系统:`group.fs.*`、`client.group.fs.*`、`aun group fs`、`cp/mv` 上传下载、群自有区角色 ACL 与 `group_aid` 签名、`parents`、JS string 差异和 memberdata 服务端映射(见 `09-group-rpc-manual.md`)
|
|
@@ -55,7 +55,7 @@ Group FS 的 `group.fs.*` RPC、`client.group.fs.*` 门面、`aun group fs` CLI
|
|
|
55
55
|
| 03 | [核心概念](03-核心概念.md) | AID、A/T/H、Pull Gate、状态机、E2EE |
|
|
56
56
|
| 04 | [连接与认证](04-连接与认证.md) | AIDStore、默认 agent.md 自动上传、连接生命周期并发/取消、当前 access token getter、网关发现、事件、agent.md 校验和自动观察 |
|
|
57
57
|
| 05 | [E2EE加密通信](05-E2EE加密通信.md) | E2EE V2、ProtectedHeaders、agent.md 版本提示、recipient wrap |
|
|
58
|
-
| 06 | [API手册](06-API手册.md) | AIDStore / Agent.md 校验签名 / AID / AUNClient 生命周期并发 / 四 SDK access token getter / 群组高层身份编排 / History 门面 / 事件 / RPC |
|
|
58
|
+
| 06 | [API手册](06-API手册.md) | AIDStore / Agent.md 校验签名 / AID / AUNClient 生命周期并发 / 四 SDK access token getter / 群组高层身份编排 / History 门面 / 消息来源与 Pull 同步生命周期 / 事件 / RPC |
|
|
59
59
|
| 07 | [错误处理](07-错误处理.md) | Result、异常、错误码、重试 |
|
|
60
60
|
| 08 | [最佳实践](08-最佳实践.md) | 幂等、消息同步/History、AUNClient 级 Pull Gate(始终单飞)、测试数据 |
|
|
61
61
|
| - | [Storage RPC 手册](09-storage-rpc-manual.md) | Storage RPC、数据面 HTTP 下载流程、ticket / AID Bearer 边界、跨 issuer 下载 |
|
|
@@ -80,6 +80,7 @@ Group FS 的 `group.fs.*` RPC、`client.group.fs.*` 门面、`aun group fs` CLI
|
|
|
80
80
|
| 查方法签名、群组高层 facade 和 `aid_store` / `aidStore` | [06-API手册](06-API手册.md) |
|
|
81
81
|
| 查消息或群组 RPC、群提及过滤 `mention_mode` | 对应 `09-*-rpc-manual.md`;`mention_mode` 详见 [09-group-rpc-manual.md](09-group-rpc-manual.md) |
|
|
82
82
|
| 查 A/T/H、SDK 自动最新页同步与 AUNClient 级 Pull Gate | [03-核心概念.md](03-核心概念.md)、[08-最佳实践.md](08-最佳实践.md)、[09-message-rpc-manual.md](09-message-rpc-manual.md)、[09-group-rpc-manual.md](09-group-rpc-manual.md) |
|
|
83
|
+
| 查消息事件 `source`、`sync.started/progress/stopped` 和 `delivery.changed` | [06-API手册](06-API手册.md) |
|
|
83
84
|
| 查 History、Forward、Pull Gate、Group 成员可见性 floor 与 Piggy ACK | [09-message-rpc-manual.md](09-message-rpc-manual.md)、[09-group-rpc-manual.md](09-group-rpc-manual.md) |
|
|
84
85
|
| 查群组标识 `group_aid` / `group_id` 兼容规范 | [09-group-rpc-manual.md](09-group-rpc-manual.md) |
|
|
85
86
|
| 查 group.index 签名索引、版本观察、不同步判断、CAS 更新和 facade | [03-核心概念.md](03-核心概念.md)、[06-API手册.md](06-API手册.md)、[09-group-rpc-manual.md](09-group-rpc-manual.md)、[08-最佳实践.md](08-最佳实践.md) |
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
| [04-连接与认证](04-连接与认证.md) | 注册加载 · 认证连接 · 当前 access token getter · Python Push 自动登记 · 网关发现 · 事件 · agent.md 自动观察 |
|
|
16
16
|
| [05-E2EE加密通信](05-E2EE加密通信.md) | E2EE V2 消息 · ProtectedHeaders · agent.md 版本提示 · recipient wrap |
|
|
17
17
|
| [E2EE_V2消息通信时序图](E2EE_V2消息通信时序图.md) | V2 P2P/GROUP 明文与加密主链路 |
|
|
18
|
-
| [06-API手册](06-API手册.md) | AIDStore · AID · AUNClient · 四 SDK access token getter · Python PushFacade · Message/Group History 门面 · 事件 · E2EE 高级 API · RPC 索引 |
|
|
18
|
+
| [06-API手册](06-API手册.md) | AIDStore · AID · AUNClient · 四 SDK access token getter · Python PushFacade · Message/Group History 门面 · 消息来源与 Pull 同步生命周期 · 事件 · E2EE 高级 API · RPC 索引 |
|
|
19
19
|
| [07-错误处理](07-错误处理.md) | Result · 错误类层级 · 错误码 · 重试 |
|
|
20
20
|
| [08-最佳实践](08-最佳实践.md) | 幂等连接 · 消息同步/History · AUNClient 级 Pull Gate(始终单飞)· group.index · 测试数据保护 |
|
|
21
21
|
| [09-payload-reference](09-payload-reference.md) | message / group / thought payload 格式 |
|
|
@@ -50,6 +50,7 @@
|
|
|
50
50
|
- 九态状态机、device_id / slot_id 隔离键 → [03-核心概念](03-核心概念.md)
|
|
51
51
|
- `connect()` 选项、长短连接、网关发现 → [04-连接与认证](04-连接与认证.md)
|
|
52
52
|
- capability getter、事件、生命周期 API → [06-API手册](06-API手册.md)
|
|
53
|
+
- 消息事件 `source`、`sync.started/progress/stopped`、`delivery.changed` → [06-API手册](06-API手册.md)
|
|
53
54
|
- Capabilities 能力声明、`inline_realtime_payload_v1` 实时推送优化 → [02-WebSocket协议](02-WebSocket协议.md)、[CHANGELOG-0.5.6](CHANGELOG-0.5.6.md)
|
|
54
55
|
- 裸 WebSocket 握手 → [02-WebSocket协议](02-WebSocket协议.md)
|
|
55
56
|
|