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>
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 项已提前完成) | 未开始 | — | — |
已完成 21 项,剩余 52 项。 工作区干净。
2026-07-27 更新:R3(F-14 – F-19)已实现并通过门槛,实现记录见 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 处失败(本次修复)
npm run typecheck——ChatPanel.tsxTS2345。F-06 把updatedAt放宽为.nullish()后,string | null流进了formatSessionTime(value?: string)。形参放宽为string | null(函数原有的 falsy 判断已覆盖null)。这正是队列文档「接手 R2 前必须先做的事」第 4 条预警的.nullish()向下游传播。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 无依赖关系,可并行分派到不同分支。