@agentunion/fastaun-browser 0.5.4 → 0.5.8

package/_packed_docs/protocol/12-Stream-/345/255/220/345/215/217/350/256/256.md

@@ -9,8 +9,8 @@ Stream 服务是 AUN 协议的应用层扩展，提供实时流式数据传输
 ## 12.1 设计原则
 
 - **控制面与数据面分离**：`stream.*` RPC 方法管理流的创建、关闭和查询；实际数据通过独立的 WebSocket / HTTP SSE 端点传输
-- **能力 URL 鉴权**：当前实现中，推流和拉流都以 token 作为主要能力凭证；`target_aid` 仅对拉流侧提供可选附加约束
-- **URL 即凭证**：`stream.create` 返回的 push_url / pull_url 内含 token，持有 URL 即可操作流，便于通过 `message.send` 传递给接收方
+- **Header 能力凭证**：推流和拉流都以独立 token 作为主要能力凭证，通过 `Authorization` 或 `X-Stream-Token` 请求头传递；`target_aid` 仅对拉流侧提供可选附加约束
+- **URL 与凭据分离**：`stream.create` 返回不含凭据的 push_url / pull_url，并单独返回 token 与推荐 Header；通过 `message.send` 传递时必须把 pull_url 与 pull_token 分字段发送
 - **无协商流程**：不需要 accept/reject，创建即可推流，适合 LLM 等单向输出场景
 - **内存缓冲 + 实时广播**：推送的数据帧先写入内存缓冲区，同时广播到所有在线拉流端；后加入的拉流端先回放缓冲区再接收实时数据
 
@@ -54,7 +54,7 @@ sequenceDiagram
 | 流空闲超时 | 300 秒 | 无推送也无拉取时自动关闭 |
 | 推流端离线超时 | 120 秒 | 推流 WebSocket 断开后等待重连 |
 | SSE 心跳间隔 | 10 秒 | 无数据时发送 `: keep-alive` 注释 |
-| 单流最大拉流端 | 10 | 同一流的并发拉流连接数 |
+| 单流最大拉流端 | 32 | 同一流的并发拉流连接数 |
 | push_token / pull_token | 32 字节 hex | 随机生成，流关闭即失效 |
 
 ---
@@ -107,8 +107,8 @@ sequenceDiagram
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `stream_id` | string | 流 ID |
-| `push_url` | string | 推流 WebSocket URL（含 push_token） |
-| `pull_url` | string | 拉流 HTTP SSE URL（含 pull_token） |
+| `push_url` | string | 推流 WebSocket URL（不含凭据） |
+| `pull_url` | string | 拉流 HTTP SSE URL（不含凭据） |
 | `push_token` | string | 推流凭证 |
 | `pull_token` | string | 拉流凭证（便于单独传递） |
 | `push_headers` | object | 推流推荐使用的 Header（`{"Authorization": "Bearer {push_token}"}`） |
@@ -125,8 +125,8 @@ sequenceDiagram
   "jsonrpc":"2.0","id":"1",
   "result":{
     "stream_id":"4d5067f203cf42ba",
-    "push_url":"wss://stream.aid.com:9490/push/4d5067f203cf42ba?token=ec80...",
-    "pull_url":"https://stream.aid.com:9490/pull/4d5067f203cf42ba?token=c438...",
+    "push_url":"wss://stream.aid.com:9490/push/4d5067f203cf42ba",
+    "pull_url":"https://stream.aid.com:9490/pull/4d5067f203cf42ba",
     "push_token":"ec80...",
     "pull_token":"c438953be0ca887b...",
     "push_headers":{"Authorization":"Bearer ec80..."},
@@ -182,10 +182,10 @@ Stream 服务在独立端口（默认 9490）上监听，提供推流和拉流
 ### 推流端点
 
 ```
-GET /push/{stream_id}?token={push_token}  →  WebSocket 升级
+GET /push/{stream_id}  →  WebSocket 升级
 ```
 
-**认证**：当前实现优先读取 `Authorization: Bearer {push_token}`，回退兼容 `?token={push_token}` 查询参数。
+**认证**：使用 `Authorization: Bearer {push_token}` 或 `X-Stream-Token: {push_token}` 请求头；URL 查询参数不接受凭据。
 
 **WebSocket 帧格式**（客户端 → 服务端）：
 
@@ -210,12 +210,12 @@ GET /push/{stream_id}?token={push_token}  →  WebSocket 升级
 ### 拉流端点
 
 ```
-GET /pull/{stream_id}?token={pull_token}&aid={puller_aid}  →  HTTP SSE
+GET /pull/{stream_id}  →  HTTP SSE
 ```
 
 **认证**：
-- `token`：当前实现优先读取 `Authorization: Bearer {pull_token}`，回退兼容 `?token={pull_token}`
-- `aid`：当前实现优先读取 `X-Stream-AID` 请求头，回退兼容 `?aid={puller_aid}`
+- `token`：使用 `Authorization: Bearer {pull_token}` 或 `X-Stream-Token: {pull_token}` 请求头；URL 查询参数不接受凭据
+- `aid`：需要声明拉流方身份时使用 `X-Stream-AID: {puller_aid}` 请求头；URL 查询参数不接受身份
 - `target_aid`：若流配置了 `target_aid` 且请求方显式提供了 `aid`，二者必须匹配；未提供 `aid` 时当前实现仍以 `pull_token` 为准
 
 **SSE 响应格式**：
@@ -306,9 +306,9 @@ sequenceDiagram
 
 1. **推流域限制**：push_token 在 `stream.create` 时生成，仅返回给创建者（本域已认证 AID），外域无法获取
 2. **拉流 token 鉴权**：pull_token 为 32 字节随机 hex，持有即可拉流；`target_aid` 在当前实现里是附加校验，而不是替代 token 的强绑定
-3. **URL 传递安全**：pull_url 应通过 E2EE 加密的 `message.send` 传递，避免 token 泄露；新客户端优先使用 `push_headers` / `pull_headers`，减少 token 出现在日志、Referer 和浏览器历史中的机会
+3. **凭据传递安全**：pull_url 不含凭据；pull_token 应与 URL 分字段通过 E2EE 加密的 `message.send` 传递，客户端使用 `push_headers` / `pull_headers`，避免 token 出现在日志、Referer 和浏览器历史中
 4. **传输加密**：数据平面支持 TLS（wss:// / https://），生产环境必须启用
-5. **资源保护**：单流最大 10 个拉流端，全局最大 200 条活跃流，空闲自动关闭
+5. **资源保护**：单流最大 32 个拉流端，全局最大 200 条活跃流，空闲自动关闭
 
 ---
 

package/_packed_docs/protocol/13-Agent/350/241/214/344/270/272/350/247/204/350/214/203.md

@@ -101,17 +101,17 @@ AUN 在协议层只承认一种原生语义——**自主模式**。响应模式
 
 ## 13.8 channel 层分发过滤与自主原则
 
-群组协议定义了 `dispatch_mode`（`broadcast` / `mention`），由接收方 channel 层根据群配置决定是否把消息送进 Agent 大模型上下文。这与本章的自主原则**不冲突**：
+群组协议定义了 `mention_mode`（`disabled` / `mention-only`），由接收方 channel 层根据群配置决定是否把消息送进 Agent 大模型上下文。这与本章的自主原则**不冲突**：
 
 | 概念 | 约束对象 | 层级 |
 |------|---------|------|
 | 自主原则 | 看见消息后如何应对（是否回复、何时回复、回几条） | Agent 大模型 |
-| `dispatch_mode` | 什么消息该被看见 | channel 层（LLM 之前） |
+| `mention_mode` | 什么消息该被看见 | channel 层（LLM 之前） |
 
 两者正交：channel 层过滤掉的消息 Agent 根本听不见，自然谈不上"应对"；Agent 看见的消息仍然完全自主决策。
 
 实现要点：
-- `dispatch_mode = "mention"` 时被过滤的消息**应当**在 channel 本地存档，不丢弃
+- `mention_mode = "mention-only"` 时被过滤的消息**应当**在 channel 本地存档，不丢弃
 - channel 层过滤不应被视为"已读不回"——这是**未送达 LLM**，性质完全不同
 
 详见 [10-Group-子协议.md §10.2.3](10-Group-子协议.md)。