# 语音 · 窗口读取 · 游戏陪伴 实施记录(2026-07-27 夜) 按队列顺序推进:先清语音/屏幕读取被卡住的前期修复(A 段),再实施功能本体(B 段)。 七个提交,每个都过完整门槛后才推送。 > 配套文档:[ADR-0008](../decisions/ADR-0008-screen-awareness-and-voice-boundary.md)(边界与策略)、 > [fix-queue-2026-07-26.md](./fix-queue-2026-07-26.md)(缺陷队列与 F 编号)。 ## 门槛结果 | 项 | 结果 | | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | `cargo fmt --all -- --check` | 通过 | | `cargo clippy --workspace --all-targets -- -D warnings` | 通过 | | `cargo test --workspace --lib` | **139 通过 / 0 失败**(`astrbot-desktop` 113、`desktop-protocol` 26) | | `npm run typecheck` / `lint` | 通过(`--max-warnings 0`) | | `npm run test -- --run` | **59 通过 / 11 文件**(本轮 35 → 59) | | `npm run build` | 通过 | | `npm run test:e2e` | 5 通过 | | `cargo test --workspace`(含集成测试)与 `npm run tauri:build` | **未执行**:`target\debug\astrbot-desktop.exe` 被运行中的 dev 进程占用。停掉 dev 后需补跑 | 测试计数变化:Rust 101 → 139(协议 12 → 26、客户端 99 → 113),前端 35 → 59。 **每一条新断言都做过变异检验**,共 25 处刻意回归全部被对应测试抓到;其中两处第一次检验时 「无测试覆盖」,补测试后才通过(见下方 A2)。 --- ## A 段 · 前期修复 ### A2 · 分段回复不再丢内容(N-9) `streaming: false` 的 `plain` 帧被当作 delta **追加**进 `accumulated`,随后 `map_complete` 用自己的文本**整体替换**它。三段的回复只显示一段,其余既不显示也不入库。 真正的形状比原判断复杂,而且**我第一版改错了**:这类块**有时是已流式发过内容的重述,有时是全新 内容**——`astrbot_client.rs` 的诊断夹具里写着 `// Repeats what the delta stream already carried` 和 `// Carries content the stream never delivers`,那些注释是我自己写的。按「每块一个气泡」实现会把 重述显示两遍,并且立刻 complete 每一块导致截流/取消时已无消息可终止,两条 R2 哨兵拿到 `stop` 而不是 `error`/`cancelled`。 修正后两处统一走一个 `reconcile()`,三条互斥规则,任一分支都不会丢已展示的文本: 1. 逐字节是已展示内容的前缀延伸 → 只发尾部(流式收敛场景,既有测试钉住); 2. 空白归一化后已被展示过 → 什么都不发(分段场景,N-9 本体); 3. 与已展示内容分叉 → 另起一条消息,两边都保留。 顺带修掉 `adopt_message_id` 的一个真实缺陷:同 id 分支会把 `m1#part-1` 覆盖回 `m1`,抹掉刚区分开 的分块。`map_media` 里还留着同一段逻辑的私有副本,带同一个缺陷,已合并。 **同时修的 N-4 映射器半边**:`event()` 在没有任何帧携带 `message_id` 前发出的 delta,元数据里 `message_id` 为 `None`,客户端回退到每事件唯一的 `event_id`,于是每个 delta 自成一条消息。现在流 id 兜底命名。**N-4 的「两个气泡」现象本身尚未确认是这条**,客户端的 `messageId || eventId` 回退 未动。 ### A3 · 非图片媒体帧(F-33) 语音回复此前**什么都不产生**:无标记、无事件、无报错。四道独立闸门各自丢弃它,**只修任何一道都 看不出变化**: | 闸门 | 症状 | 修法 | | --------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | 映射器 | `map_media` 唯一的产出分支写死 `frame_type == "image"`,`map_attachment_saved` 直接拒绝非图片 | 两处都按实际类型产出,帧类型写进标记的 alt 文本 | | `pending_media` | 单槽位,一条回复里第二个媒体帧顶掉第一个 | 有界队列;无 id 的 `attachment_saved` 不再消耗待配对项 | | 下载 | 候选路径只在字节嗅探为图片时才算成功(服务端对未知路径以 HTTP 200 返回自己的文本,故嗅探是必需的) | 增加音频/视频签名;`Content-Type` 声明为媒体类型时才可短路嗅探 | | **CSP** | 无 `media-src`,回退到不含 `blob:` 的 `default-src 'self'`,`