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>
这个提交存在于:
父节点
566744a025
当前提交
25f41ff50f
共有 2 个文件被更改,包括 39 次插入 和 9 次删除
|
|
@ -1,18 +1,29 @@
|
|||
# AstrBot Desktop 修复队列
|
||||
|
||||
基于 2026-07-26 全源码审计 · 共 68 项 · 8 个批次
|
||||
基于 2026-07-26 全源码审计 · 共 73 项 · 8 个批次
|
||||
|
||||
> 配套审计档案:[full-source-audit-2026-07-26.md](./full-source-audit-2026-07-26.md)。
|
||||
> 本文中的 `P0-1` / `P1-7` 等编号均指向该档案中的对应发现。
|
||||
>
|
||||
> **编号说明**:`F-69` 永久空缺——该编号系一次审查污染中被凭空注入,已于 2026-07-26 撤销
|
||||
> (见 [r1-r2-status-2026-07-26.md](./r1-r2-status-2026-07-26.md) §5),不得复用。
|
||||
> `F-70` – `F-74` 于 2026-07-26 补编:初版队列遗漏了审计中的 P2-6、P2-7、P2-8、P2-29、P3-7
|
||||
> 五条发现,它们此前没有任何批次归属。
|
||||
|
||||
## 执行状态(2026-07-26 更新)
|
||||
|
||||
| 批次 | 状态 | 说明 |
|
||||
|---|---|---|
|
||||
| R1 发布阻断批 | **已完成,门槛已验证** | 9 项全部实现。2026-07-26 首次跑完整门槛,发现 2 处编译/lint 失败并修复(详见下方「R1 门槛验证结果」),补写 F-05 缺失的单测。现全绿。 |
|
||||
| R2 传输层批 | **已完成,门槛已验证** | F-10 – F-13 全部实现,新增 6 条 Rust 测试(workspace 67 → 73)。顺带并入 F-56(P3-4,取消不再置 Disconnected)。全绿。 |
|
||||
| R2 传输层批 | **已完成,门槛已验证** | F-10 – F-13 全部实现,新增 9 条 Rust 测试(`astrbot-desktop` 单元测试 67 → 76)。顺带并入 F-56(P3-4,取消不再置 Disconnected)。全绿。 |
|
||||
| R3 – R8 | 未开始 | 下一批为 R3。依赖关系见文末批次依赖图。 |
|
||||
|
||||
> 计数订正(2026-07-27 实测):本表此前记为「67 → 73(+6)」,与
|
||||
> `r1-r2-status-2026-07-26.md` 的「67 → 76(+9)」冲突。实跑 `cargo test --workspace` 的结果是
|
||||
> `astrbot-desktop` 单元测试 **76 通过**,workspace 合计 **96 通过 / 2 忽略**
|
||||
> (lib 76 + dual_gateway_integration 2 + desktop-protocol 9 + protocol_contract 5 + dual_instance 4;
|
||||
> windows_dialog_smoke 与 soak 各 1 项 ignored)。故 76 为准,73 系过期数据。
|
||||
|
||||
### R1 门槛验证结果(2026-07-26)
|
||||
|
||||
首次编译暴露 2 处失败,均为 R1 自身改动的直接后果:
|
||||
|
|
@ -189,6 +200,14 @@
|
|||
| **F-32** | P2-17 | `astrbot.rs:381-444` | complete 后记录 per-message 完成标记,同 id 的后续 plain/complete 需显式重新开窗或忽略 | 单测覆盖"重复 complete"与"complete 后迟到 plain" |
|
||||
| **F-33** | P2-18 | `astrbot.rs:336-353` | 非图片媒体输出通用占位标记;`pending_media` 改 FIFO 队列 | 单测:`record` + `attachment_saved` 产出可见标记;双图交错不丢 |
|
||||
| **F-34** | P2-13 | `commands.rs:341`;`ChatPanel.tsx:916-917` | mapper 为无 `message_id` 的流合成稳定流内 id(如 `synthetic-{stream}`),前后端同步取消 event_id 回退 | 单测:省略 message_id 的多帧流合并为一条消息 |
|
||||
| **F-70** | P2-6 | `astrbot_client.rs:383-388` | `download_attachment` 先查 `Content-Length`,改流式累读并在超过 16MiB 时立即中断,不再整体读入内存后才校验 | 单测:mock 返回超限 body,客户端在读满前返回超限错误且内存占用有界 |
|
||||
| **F-71** | P2-7 | `gateway_client.rs:121-126` | `health()` 与 SSE 一致附带 bearer | 单测:mock 对无 bearer 的 health 返回 401,激活仍成功即失败 |
|
||||
| **F-72** | P2-8 | `gateway_client.rs:237-238` | 仅在「连接存活超阈值且收到过事件」时重置退避,避免服务端接受即优雅关流时进入约 10 次/秒热重连 | 单测:mock 接受连接后立即关闭,断言重连间隔单调增长 |
|
||||
| **F-73** | P2-29 | `astrbot_client.rs:554-565` | JWT `exp` 判定改 `exp <= now + 30s`;不可解析的 token 打 debug 日志 | 单测:`exp` 落在 30 秒内的 token 被判为过期 |
|
||||
|
||||
上列四项系 2026-07-27 补编。它们与 F-26、F-30 同处 `gateway_client.rs` / `astrbot_client.rs`,按本队列
|
||||
「同文件相邻改动合并进同一批」的编排原则归入 R5;放入 R4 会让两个可并行分支争夺同一文件。
|
||||
R5 因此由 9 项增至 13 项,与 R3、R4 仍无依赖关系。
|
||||
|
||||
* * *
|
||||
|
||||
|
|
@ -226,7 +245,15 @@
|
|||
|
||||
## R8 · 剩余 P3 与外部依赖
|
||||
|
||||
**可随手带入相邻批次的 P3**:`F-53` 事件 timestamp 注入真实时钟(P3-1)· `F-54` `server_instance_id` 改 sha2 派生 + 兼容映射(P3-2)· `F-55` username 逐字节百分号编码(P3-3,**放宽用户名规则前必须先修**)· `F-56` 取消消息不再置 Disconnected(P3-4)· `F-57` 生产 CSP 移除 `127.0.0.1:*`(P3-5)· `F-58` 凭据轮换改「写新→落库→删旧」(P3-6)· `F-59` 退出前 deactivate 双槽并 flush 日志(P3-8)· `F-60` session_id 对象分支取键(P3-9)· `F-61` 桌宠窗口补 Suspense 边界(P3-10)· `F-62` 导航图标 `aria-hidden` + 测试选择器改语义文本(P3-11)· `F-63` reduced-motion 停帧 + onerror 清理 + DPR(P3-12)· `F-64` 文案统一中文(P3-13)· `F-65` 死控件与标签错误四处(P3-14)· `F-66` 测试 SSE 助手容错(P3-15)· `F-67` App.test mock 补 `close_pet_window`(P3-16)· `F-68` mock 订阅重放竞态(P3-18)
|
||||
**可随手带入相邻批次的 P3**:`F-53` 事件 timestamp 注入真实时钟(P3-1)· `F-54` `server_instance_id` 改 sha2 派生 + 兼容映射(P3-2)· `F-55` username 逐字节百分号编码(P3-3,**放宽用户名规则前必须先修**)· `F-56` 取消消息不再置 Disconnected(P3-4)· `F-57` 生产 CSP 移除 `127.0.0.1:*`(P3-5)· `F-58` 凭据轮换改「写新→落库→删旧」(P3-6)· `F-59` 退出前 deactivate 双槽并 flush 日志(P3-8)· `F-60` session_id 对象分支取键(P3-9)· `F-61` 桌宠窗口补 Suspense 边界(P3-10)· `F-62` 导航图标 `aria-hidden` + 测试选择器改语义文本(P3-11)· `F-63` reduced-motion 停帧 + onerror 清理 + DPR(P3-12)· `F-64` 文案统一中文(P3-13)· `F-65` 死控件与标签错误四处(P3-14)· `F-66` 测试 SSE 助手容错(P3-15)· `F-67` App.test mock 补 `close_pet_window`(P3-16)· `F-68` mock 订阅重放竞态(P3-18)· `F-74` operations 切换守卫无生产写入方(P3-7)
|
||||
|
||||
**F-74 补充说明**(2026-07-27 补编):该守卫的**读侧已全线接通**——`slots.rs:97,108` →
|
||||
`policy.rs:18-22` → `ProfileManager.tsx:276` 会依据 `operationsSwitchLocked` 禁用运维槽控件;但
|
||||
`begin_operations_task` / `end_operations_task`(`runtime_guards.rs:28,45`)的调用方只有
|
||||
`#[cfg(test)]`(`slots.rs:256,285`),因此 `connection_policy_status` 把一个**永为 false 的标志**
|
||||
当作已激活的守卫上报。R3 的 F-19 只是把读侧扩展到 probe/disconnect,不含写侧,因此不覆盖本项。
|
||||
审计给出的近期动作是**先在状态载荷中如实标注守卫未激活**,写侧接线待工具管线落地——这与下节
|
||||
「工具提案六道闸门」条目联动。
|
||||
|
||||
**需要真机/外部条件,不进本轮编码**:
|
||||
|
||||
|
|
|
|||
|
|
@ -16,12 +16,15 @@
|
|||
| R2 传输层批 | 4 | 已完成 | 已通过 | **未做** |
|
||||
| R3 隔离与状态正确性 | 6 | 未开始 | — | — |
|
||||
| R4 数据与凭据安全 | 6 | 未开始 | — | — |
|
||||
| R5 协议健壮与契约治理 | 9 | 未开始 | — | — |
|
||||
| R5 协议健壮与契约治理 | 13 | 未开始 | — | — |
|
||||
| R6 体验、无障碍与产品红线 | 10 | 未开始 | — | — |
|
||||
| R7 性能与工程化 | 8(1 项已提前完成) | 未开始 | — | — |
|
||||
| R8 剩余 P3 | 16(1 项已提前完成) | 未开始 | — | — |
|
||||
| R8 剩余 P3 | 17(1 项已提前完成) | 未开始 | — | — |
|
||||
|
||||
**已完成 15 项,剩余 53 项。** 共 10 个提交,工作区干净。
|
||||
**已完成 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` 保持永久空缺)。
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -124,7 +127,7 @@
|
|||
| --- | --- |
|
||||
| `cargo fmt --all -- --check` | 通过 |
|
||||
| `cargo clippy --workspace --all-targets -- -D warnings` | 通过 |
|
||||
| `cargo test --workspace` | 76 通过 / 0 失败 / 0 ignored |
|
||||
| `cargo test --workspace` | `astrbot-desktop` 单元测试 76 通过;workspace 合计 96 通过 / 0 失败 / 2 ignored |
|
||||
| `npm run typecheck` | 通过 |
|
||||
| `npm run lint` | 通过 |
|
||||
| `npm run test -- --run` | 19 通过 / 4 文件 |
|
||||
|
|
@ -159,10 +162,10 @@ R1 的前端 7 项按 F-02…F-09 逐项拆分提交。`astrbot.rs` 与 `astrbot
|
|||
| --- | --- | --- | --- |
|
||||
| **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 |
|
||||
| **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 中的 15 项(F-56 已完成) | 随批携带 | 时钟注入、`server_instance_id` 改 sha2、username 逐字节编码、生产 CSP 移除 `127.0.0.1:*`、凭据轮换顺序、退出前 flush、Suspense 边界、`aria-hidden`、reduced-motion、文案统一等 |
|
||||
| **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` 内联问题,本轮未处理。
|
||||
|
|
|
|||
正在加载…
添加表格
在新工单中引用