@agentunion/fastaun-browser 0.5.19 → 0.5.20

package/_packed_docs/sdk/08-/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -94,10 +94,10 @@ SDK 内部自动管理 RPC 并发，应用层无需配置：
 |------|------|
 | RPC 并发上限 | 全局最多 16 个并发 RPC 请求 |
 | 后台 RPC 限制 | 后台任务额外限制为 8 个 |
-| Pull Gate | 每个 `AUNClient` 一个客户端级 Gate；P2P Message、Group Message、Group Event Pull 共享该 Gate，始终 single-inflight |
+| Pull Gate | 四端均为每个 `AUNClient` 一个客户端级 Gate；P2P Message、Group Message、Group Event Pull 共享，同 namespace 单飞，不同 namespace 最多 4 个并行 |
 | 队列优先级 | Tail/History 前台 FIFO 优先于 Forward/Gap Fill 后台 FIFO；Group Event Pull 为后台；同 key 自动折叠 |
 
-Gate 内始终保持单飞；相同 key 的调用共享同一结果，不同 key 按前台优先、队列顺序执行。应用层保持普通 `await client.call(...)` 即可，不应自行实现重复并发控制。
+同一 namespace 的 Tail、History、Forward 保持单飞；相同 key 的调用共享同一结果，其余可运行请求按前台优先、队列顺序调度。namespace 划分见 [核心概念](03-核心概念.md#消息实时窗口与历史拉取)。应用层保持普通 `await client.call(...)` 即可，不应自行实现重复并发控制。
 
 ---
 
@@ -109,7 +109,7 @@ Gate 内始终保持单飞；相同 key 的调用共享同一结果，不同 key
 - SDK 只保证单个 Tail/Forward 响应页内按 seq 升序、同 seq 最多发布一次；A/T/H 只是扫描水位，不是发布账本。
 - 实时消息可能从 Push、Tail、Forward 重复到达，跨页、跨通道都不保证全局回调顺序。全局去重与排序由应用业务仓库负责，不属于 SDK 业务逻辑保证；业务仓库必须按 `(namespace, message_id)` 幂等，并按 seq 排序展示。SDK 进程内折叠只能作为 best-effort 优化。
 - 用 `message.history(before_seq=..., limit=...)` 或 `group.history(group_id=..., before_seq=..., limit=...)` 向左翻页；下一页直接复用响应的 `next_before_seq`。History 不影响实时游标和 ACK。
-- Forward Piggy ACK 保留：有待提交 ACK 时，非满页仍会再拉一页并携带 ACK，拉到空页后停止。
+- Forward 仅在原始页实际前进且 `has_more`、已知 Head 或旧服务满页兼容规则证明仍有后页时续拉；volatile 消息另按其游标前进及 `volatile_has_more` 续页。正常后页携带已提交水位的 Piggy ACK，末页以独立 ACK 收尾，不会只为 ACK 额外拉取空页。ACK 失败保留待确认水位，供后续 Pull 重试。
 
 ---