diff --git a/docs/reports/r1-r2-status-2026-07-26.md b/docs/reports/r1-r2-status-2026-07-26.md new file mode 100644 index 0000000..c939f30 --- /dev/null +++ b/docs/reports/r1-r2-status-2026-07-26.md @@ -0,0 +1,222 @@ +# R1 / R2 执行状态 + +2026-07-26 · 分支 `feat/p02-dual-connections` · 基线 v0.1.0-alpha.2 + +> 配套文档:[full-source-audit-2026-07-26.md](./full-source-audit-2026-07-26.md)(68 项发现)、 +> [fix-queue-2026-07-26.md](./fix-queue-2026-07-26.md)(8 个批次的执行队列)。 +> 本文只记录**做了什么、没做什么、验证到什么程度**,不重复队列正文。 + +--- + +## 一、总览 + +| 批次 | 项数 | 状态 | 门槛验证 | 真机验证 | +| --- | --- | --- | --- | --- | +| R1 发布阻断批 | 9 | 已完成 | 已通过 | **未做** | +| R2 传输层批 | 4 | 已完成 | 已通过 | **未做** | +| R3 隔离与状态正确性 | 6 | 未开始 | — | — | +| R4 数据与凭据安全 | 6 | 未开始 | — | — | +| R5 协议健壮与契约治理 | 9 | 未开始 | — | — | +| R6 体验、无障碍与产品红线 | 10 | 未开始 | — | — | +| R7 性能与工程化 | 8(1 项已提前完成) | 未开始 | — | — | +| R8 剩余 P3 | 16(1 项已提前完成) | 未开始 | — | — | + +**已完成 15 项,剩余 53 项。** 共 10 个提交,工作区干净。 + +--- + +## 二、已完成 + +### R1 · 发布阻断批(9 项) + +这批改动由上一个会话写入仓库但**从未编译过**。本次首次跑完整门槛,暴露并修复了 2 处真实失败。 + +| ID | 来源 | 内容 | +| --- | --- | --- | +| F-01 | P0-1 | `AstrBotStreamMapper` 每流重置 sequence,而 `seen_event_ids` 挂在 client 上跨请求存活,导致同一连接第二条消息起助手回复被去重器整体吞掉。事件 ID 加入每请求唯一的 `stream_id`。 | +| F-02 | P1-12 | 宠物素材包 manifest 正则 `\\.` → `\.`,此前拒绝一切合法素材包(含仓库自带示例)。 | +| F-03 | P1-13 | `desktop-pet` 加入 capability 窗口清单,此前该窗口全部 IPC 与事件监听被 ACL 静默拒绝。 | +| F-04 | P1-14 | 生产 CSP `img-src` 追加 `blob:`,此前发行版聊天附件图全部被拦。 | +| F-05 | P1-15 | Markdown 链接协议白名单(http/https/mailto),非法协议降级为纯文本,`rel` 补 `noopener`。 | +| F-06 | P1-7a | 五处 `.optional()` → `.nullish()`,修复事件、远端会话、模型能力三条链路因 Rust `null` 而静默失效。 | +| F-07 | P1-7b | `AstrBotModelOption` 补 `rename_all = "camelCase"`,此前前端 `isDefault` 恒 undefined。 | +| F-08 | P1-16 | 抽出共享 `errorMessage()`,此前 9 处 IPC 失败一律显示 `[object Object]`。 | +| F-09 | P1-17 | 恢复 6 处乱码文案与 1 处乱码 `aria-label`。 | + +**门槛暴露的 2 处失败(本次修复)** + +1. `npm run typecheck` —— `ChatPanel.tsx` `TS2345`。F-06 把 `updatedAt` 放宽为 `.nullish()` 后, + `string | null` 流进了 `formatSessionTime(value?: string)`。形参放宽为 `string | null` + (函数原有的 falsy 判断已覆盖 `null`)。**这正是队列文档「接手 R2 前必须先做的事」第 4 条预警的 + `.nullish()` 向下游传播。** +2. `npm run lint` —— `react-refresh/only-export-components`。F-05 把 `safeLinkHref` 作为非组件导出 + 放进了 `MessageContent.tsx`;仓库用 `--max-warnings 0`,warning 即失败。已移到 + `src/lib/safeLinkHref.ts`。 + +预警清单中的另两项(`astrbot.rs` 新测试闭包借用、`errorMessage()` 接入点类型)实测无问题。 + +**补齐的缺失测试**:F-05 的验收条件写明需要 `[x](javascript:alert(1))` 单测,但该测试从未写过。 +已新增 `src/features/chat/MessageContent.test.tsx`(4 例:`javascript:`、`data:`、正常 https 链接 +带 `noopener`、相对路径不被伪装成绝对链接)。 + +### R2 · 传输层批(4 项) + +四项都在同一个流循环里,按队列要求串行落地。 + +| ID | 来源 | 内容 | +| --- | --- | --- | +| F-10 | P1-1 | 每个 client 拆成 REST(保留总时限 120s / 30s)与流式(**不设** `.timeout()`,改 `read_timeout` 120s / 90s + `tcp_keepalive` 60s)。`Client::timeout` 是「请求开始到响应体读完」的总时限且在消费 `bytes_stream()` 期间持续生效,此前 desktop-v1 长连接每 30 秒必断(心跳无法续命),AstrBot 超过 120s 的生成被中途截断。已从 vendored reqwest 0.13.4 源码确认 `read_timeout` 语义为「每次读成功后重置」。 | +| F-11 | P1-3 | 新增 `SseLineBuffer`:`Vec` 缓冲、按 `\n` **字节**分行、逐行解码。此前逐 chunk `from_utf8_lossy` 会把跨 chunk 的多字节字符打成 `U+FFFD` 并随 delta 入库。 | +| F-12 | P1-2 | `should_retry_astrbot` 收窄为 `reqwest::Error::is_connect()` 唯一可重试;新增 `AstrBotClientError::StreamInterrupted` 标记「响应已开始后断流」,经 `astrbot_send_error()` 映射为前端可见的 `streamInterrupted` 码供手动重试。此前响应流中断被当作未送达整条重发,`/api/v1/chat` 无幂等键,会在会话里产生重复提问与重复回答。 | +| F-13 | P2-2 | 取消 / chunk 错误 / mapper 错误 / 行溢出四条路径统一走新的 `finish_and_fail()` → `finish_stream_with(Cancelled \| Error)` 并 dispatch。此前这些路径不发 `MessageCompleted`,DB 残留 `streaming = 1`,重启后重新显示为「生成中」。 | + +**顺带并入的两项** + +- **F-56**(R8 · P3-4):取消不再把连接置 `Disconnected` 再置回。它就在为 F-13 重写的那一行上, + 队列本身标注该项「可随手带入相邻批次」。 +- **F-49**(R7 · 优化 §2):`send_slot_message` 由 `client.take()` 改 `clone()`,并以 + `message_cancellation` 存在性串行化发送(并发发送返回 `slotBusy`)。提前的理由:另外五个槽位命令 + 在 client 缺席时一律报「未连接」,这个独占窗口**原本被 120s 总超时封顶,F-10 移除后变成与回复等长** + —— 一次正常的长回复就会让该槽的 sessions / capabilities / upload / download / switch 全部瘫痪。 + 是 R2 让它显性化的,因此在 R2 内修掉。 + +**审查发现的两处加固**(均为 R2 自身改动造成) + +- 移除流式总超时后,单条响应失去唯一边界(`read_timeout` 只测两次读之间的间隔,替代不了), + `SseLineBuffer` 与 `mapper.accumulated` 都可无限增长。已加 64 MiB 单响应上限。 +- `SseLineBuffer` 逐行从头 `drain` 会把剩余缓冲整体搬移一次,对 hyper 单个可达数百 KiB 的 item + 是平方复杂度。已改为游标,每 chunk 只压缩一次。 + +--- + +## 三、测试与验证 + +### 新增测试 + +**Rust:67 → 76(+9)** + +| 测试 | 覆盖 | +| --- | --- | +| `line_buffer_keeps_multibyte_characters_split_across_chunks_intact` | F-11 单元层 | +| `line_buffer_strips_crlf_and_returns_the_trailing_line` | F-11 边界 | +| `line_buffer_cursor_survives_interleaved_reads_and_writes` | 游标改造 | +| `line_buffer_bounds_a_single_line_and_the_whole_response` | 单行上限 + 64 MiB 总量上限 | +| `decodes_multibyte_text_split_across_tcp_chunks` | F-11 端到端 | +| `truncated_body_reports_stream_interrupted_and_finalizes_the_message` | F-12 分类 + F-13 错误路径 | +| `a_broken_response_body_does_not_resend_the_chat_post` | F-12 不重发 | +| `cancellation_finalizes_the_message_as_cancelled` | F-13 取消路径 | +| `only_connect_failures_are_resent_automatically` | F-12 重试收窄 + 错误码 | + +**前端:19 项 / 4 文件**(新增 `MessageContent.test.tsx` 4 例) + +### 测试基建 + +三条传输测试用**裸 `TcpListener` 手写的 HTTP/1.1 chunked SSE 假服务端**驱动真实 `AstrBotClient`, +**未引入任何新依赖**。选它而非 axum 的理由:需要按字节精确控制 chunk 切分点,以及在不发终止块的 +情况下中途断连——这两点用 HTTP 框架无法表达。 + +**护栏有效性已验证**:把 `push_chunk` 临时退回旧的逐 chunk lossy 解码后,端到端测试真实复现了 +乱码才失败,证明 hyper 确实把两帧当作独立 stream item 投递,测试不是同义反复。 + +### 门槛结果 + +| 命令 | 结果 | +| --- | --- | +| `cargo fmt --all -- --check` | 通过 | +| `cargo clippy --workspace --all-targets -- -D warnings` | 通过 | +| `cargo test --workspace` | 76 通过 / 0 失败 / 0 ignored | +| `npm run typecheck` | 通过 | +| `npm run lint` | 通过 | +| `npm run test -- --run` | 19 通过 / 4 文件 | +| `npm run build` | 通过 | + +### 提交 + +``` +58a98d3 docs(reports): record the source audit, fix queue, and R1/R2 results +c4c40bd fix(astrbot): do not resend messages after the response starts +6e81a3a fix(astrbot): scope stream event ids and fix the transport layer +41592e2 fix(ui): restore corrupted localized strings +828f7c5 fix(chat): accept null in runtime event contracts +e8d9dbc refactor(ui): share ipc error formatting +051b9ce fix(chat): restrict markdown link protocols +78f03e3 fix(tauri): allow blob images in production csp +def5e92 fix(tauri): grant desktop-pet capability +28ec300 fix(pet): correct manifest image pattern +``` + +R1 的前端 7 项按 F-02…F-09 逐项拆分提交。`astrbot.rs` 与 `astrbot_client.rs` 中,R1 的 F-01/F-07 +与 R2 的 F-10/F-11/F-13 物理交织在同一函数内,无法在不伪造未经测试的中间状态的前提下拆开, +因此合为一个提交,并在提交正文中逐项说明。 + +--- + +## 四、未完成 + +### 4.1 未开始的批次(53 项) + +| 批次 | 剩余项 | 依赖 | 内容摘要 | +| --- | --- | --- | --- | +| **R3** | F-14 … F-19(6) | R1 的 F-06(已完成,**可立即开始**) | 探测移出全局锁且可取消;`listen()` 注销竞态(StrictMode 下 delta 翻倍);附件/草稿/错误按槽隔离;`switch_slot_session` 的 generation 校验;发送先校验后入库;`probe_connection_slot` 校验槽位分配 | +| **R4** | F-20 … F-25(6) | 无,可与 R3 并行 | 长会话取最新 N 条 + 游标分页;脱敏正则补裸 `token`/JWT;YAML/INI/.env 结构化脱敏;删除 profile 时清理凭据;敏感请求结构体手写 `Debug`;`account_id` 键模型统一 | +| **R5** | F-26 … F-34(9) | 无,可与 R3/R4 并行 | 未知事件类型降级为跳过;移除只读 payload 的 `deny_unknown_fields`;schema 漂移比对进 `cargo test`;`TransportKind` 拼写统一;删除恒 false 的身份自比较;mock 网关三缺陷;mapper 重复 complete / 迟到 plain;非图片媒体占位与 FIFO;无 `message_id` 流的稳定合成 id | +| **R6** | F-35 … F-44(10) | R3 | **产品红线**:`alwaysOnTop` 默认改 `false`;未读三连;重试按会话过滤;取消与真错误区分;`ChatMessage` 补四元组;键盘 focus 死锁;tablist 无障碍;凭据卡明文清空;轮询退避与告警;自动滚动与语音卸载清理 | +| **R7** | F-45 … F-52 中的 7 项(F-49 已完成) | R6 | spritesheet 去 `?inline` 改 WebP(lazy chunk ~5.2 MB → ~0.6 MB);前端渲染管线 memo 化;附件走二进制 IPC 通道;事件通道改每槽独立 mpsc;`styles.css` token 合并;`tauri.conf` 改 pnpm;tsconfig/eslint/vitest 收紧 | +| **R8** | F-53 … F-68 中的 15 项(F-56 已完成) | 随批携带 | 时钟注入、`server_instance_id` 改 sha2、username 逐字节编码、生产 CSP 移除 `127.0.0.1:*`、凭据轮换顺序、退出前 flush、Suspense 边界、`aria-hidden`、reduced-motion、文案统一等 | + +**当前构建仍可观测到的 R7 症状**:`npm run build` 产出的 `DesktopPetView` chunk 为 5,230.85 kB +(gzip 3,921.56 kB),即 F-45 描述的 `?inline` 内联问题,本轮未处理。 + +### 4.2 未做的验证 + +以下属于 R1/R2 的**批次验收条件**,本轮只跑了本地门槛,尚未执行: + +- **Tauri release 构建(NSIS)** —— 只跑了 Vite 生产构建(`npm run build`),未跑 + `npm run tauri:build`。**F-04 必须用 release 验证**,因为 dev 不注入 CSP。 +- **Playwright e2e**(`npm run test:e2e`)—— 未运行。 +- **R1 真机验收**:同一连接连发 3 条消息每条完整显示;桌宠事件联动、拖动、右键菜单; + release 构建下附件图渲染。 +- **R2 真机验收**:断网/恢复、超过 120s 的长回复完整到达、中途停止后重启应用不残留「生成中」。 +- **`docs/q9-local-acceptance.md`** 未刷新(队列建议 R1 与 R2 合并后同时刷新)。 + +### 4.3 需要外部条件、不进本轮编码 + +- **P1-9 附件契约验证**(置信度中):需用真实容器发一条带图消息,确认模型是否真的看到附件。 + 若确认被忽略,改为 `message` 段数组承载 `attachment_id`(snake_case),属 P1 级改动。 +- **证书指纹绑定**:TLS 校验零接入,录入通道已开放。建议在实现前于录入层标注「暂不生效」。 +- **工具提案六道闸门**:未开始实现属阶段合理;闸门落地前不得放开任何工具执行入口。 +- **签名更新、双服务器 soak**:维持现状,不在本地伪造。 + +--- + +## 五、过程记录:审查工具链事故 + +本批的对抗式审查让 subagent 直接运行在**工作区**上。其中两个 agent 在做「临时改动以验证测试是否 +真的会失败」之后**没有还原**,留下了: + +- `send_chat_stream` 错误分支内一段显式的第二次 `POST /api/v1/chat`(注释标着 + `MUTATION (temporary)`); +- `astrbot_client.rs` 的 `zz_repro`、`runtime.rs` 的 `throwaway_slot_lockout_repro` 两个测试模块; +- `src-tauri/tests/zz_repro_sse_quadratic.rs`; +- 把 F-10 的流式 client 改回 `.timeout()` 并留下 `let _ = STREAM_IDLE_TIMEOUT;`。 + +那段注入的 POST 一度被误判为「HTTP 栈自行重发」的真实缺陷并记为 F-69,且**被提交进了仓库**。 +从复现侧逐级二分(用 client 自己的 `stream_http` 手动驱动 → 换真实 body → 换 `select!` 驱动 → +加锁与 mpsc → 近乎逐字复制整个函数体,全部只发 1 次请求,唯独真函数发 2 次)把差异压缩到函数体 +内部之后,注入的那 7 行才暴露出来。 + +**处置**:全部注入物已清除;F-69 记录已从 CHANGELOG、`docs/progress.md`、修复队列中撤销; +三个含污染代码的本地提交已用 `git reset --soft` 重写(未推送),并逐提交扫描确认无残留; +`#[ignore]` 的占位测试改回正常断言 `a_broken_response_body_does_not_resend_the_chat_post`, +现已通过。 + +**结论:F-69 不存在,P1-2 已闭环。** + +**规程**:后续审查必须只读运行,或用独立 worktree 隔离;不得让审查 agent 写主工作区。 + +--- + +## 六、下一步 + +按队列顺序进入 **R3 · 隔离与状态正确性批**(F-14 … F-19)。R3 依赖的 R1 · F-06 已完成, +无阻塞。R4 与 R5 与 R3 无依赖关系,可并行分派到不同分支。