docs(reports): add the R1/R2 status summary
Records what was completed, what was not, and how far verification actually got, so the next session does not have to reconstruct it from the queue and the commit log. Notably it separates the local gate (which passed) from the batch acceptance criteria that were not run: the Tauri release build, Playwright, and every real-device check. F-04 in particular cannot be considered verified until a release build is exercised, because development does not inject a CSP. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
这个提交存在于:
父节点
58a98d3c94
当前提交
573f9f793b
共有 1 个文件被更改,包括 222 次插入 和 0 次删除
|
|
@ -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<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` | 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 无依赖关系,可并行分派到不同分支。
|
||||
正在加载…
添加表格
在新工单中引用