Batch R3 (F-14 through F-19) is implemented and gate-verified. Record what changed, the measured test counts, and the two things it did not cover: auto_connect_configured_slots is still serial, and the operations switch guard still has no production writer. Also record that the new tests for F-14, F-15 and F-16 were each run against a mutation restoring the old behaviour and each fails under it, so they are known not to be tautological. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
229 行
15 KiB
Markdown
229 行
15 KiB
Markdown
# 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 协议健壮与契约治理 | 13 | 未开始 | — | — |
|
||
| R6 体验、无障碍与产品红线 | 10 | 未开始 | — | — |
|
||
| R7 性能与工程化 | 8(1 项已提前完成) | 未开始 | — | — |
|
||
| R8 剩余 P3 | 17(1 项已提前完成) | 未开始 | — | — |
|
||
|
||
**已完成 21 项,剩余 52 项。** 工作区干净。
|
||
|
||
> 2026-07-27 更新:R3(F-14 – F-19)已实现并通过门槛,实现记录见
|
||
> [fix-queue-2026-07-26.md](./fix-queue-2026-07-26.md) 的「R3 实现记录」。R3 的真机验收项
|
||
> 已并入 `docs/q9-local-acceptance.md` 的待真机清单。
|
||
|
||
> 2026-07-27 订正:R5 由 9 项增至 13 项、R8 由 16 项增至 17 项。初版队列遗漏了审计中的
|
||
> P2-6、P2-7、P2-8、P2-29、P3-7 五条发现,现补编为 F-70 – F-74(`F-69` 保持永久空缺)。
|
||
|
||
---
|
||
|
||
## 二、已完成
|
||
|
||
### 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<u8>` 缓冲、按 `\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` | `astrbot-desktop` 单元测试 76 通过;workspace 合计 96 通过 / 0 失败 / 2 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、F-70 … F-73(13) | 无,可与 R3/R4 并行 | 未知事件类型降级为跳过;移除只读 payload 的 `deny_unknown_fields`;schema 漂移比对进 `cargo test`;`TransportKind` 拼写统一;删除恒 false 的身份自比较;mock 网关三缺陷;mapper 重复 complete / 迟到 plain;非图片媒体占位与 FIFO;无 `message_id` 流的稳定合成 id;附件下载流式限额;`health()` 补 bearer;重连退避不再热循环;JWT `exp` 加时钟裕度 |
|
||
| **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、F-74 中的 16 项(F-56 已完成) | 随批携带 | 时钟注入、`server_instance_id` 改 sha2、username 逐字节编码、生产 CSP 移除 `127.0.0.1:*`、凭据轮换顺序、退出前 flush、Suspense 边界、`aria-hidden`、reduced-motion、文案统一、operations 守卫状态如实上报等 |
|
||
|
||
**当前构建仍可观测到的 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 无依赖关系,可并行分派到不同分支。
|