AstrBot-Desktop/docs/reports/r1-r2-status-2026-07-26.md
YokiiroBW 25f41ff50f docs(reports): assign f-ids to five untracked audit findings
The 2026-07-26 audit records 68 findings, but five of them never
received an F-id and belonged to no batch: P2-6 (download_attachment
buffers the whole body before checking the 16 MiB cap), P2-7 (health()
omits the bearer that SSE sends), P2-8 (the reconnect backoff resets to
100ms on a graceful close, giving a hot loop), P2-29 (JWT exp is
checked with no clock skew margin), and P3-7 (the operations switch
guard has no production writer).

Assign F-70 to F-73 into R5, which already owns gateway_client.rs and
astrbot_client.rs through F-26 and F-30, so the queue's own
same-file-same-batch rule holds and R4 and R5 do not contend for one
file. Assign F-74 into R8 with a note that R3's F-19 extends only the
guard's read side. F-69 stays permanently unassigned because it was
retracted.

Also correct the Rust test count. The queue said 67 to 73 and the
status summary said 67 to 76; a real cargo test --workspace run gives
76 unit tests in astrbot-desktop and 96 passed with 2 ignored across
the workspace, so 73 was stale.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 00:05:00 +08:00

15 KiB

R1 / R2 执行状态

2026-07-26 · 分支 feat/p02-dual-connections · 基线 v0.1.0-alpha.2

配套文档:full-source-audit-2026-07-26.md(68 项发现)、 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 项已提前完成) 未开始 — —

已完成 15 项,剩余 58 项。 共 10 个提交,工作区干净。

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 无依赖关系,可并行分派到不同分支。