|
| 1 | +# 技术债清单（权威：2026-09-05） |
| 2 | + |
| 3 | +> 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。 |
| 4 | +> 来源：2026-09-05（v0.19.6/7 交付后新增代码四区并行审查：捕获/会话（A）· AI 精修（B）· 笔记列表（C）· 挂体系与元数据（D）；昨日（2026-09-04）8 笔逐条核验均未发生偿还条件 → 继承 carried）。 |
| 5 | +
|
| 6 | +## 未偿债务 |
| 7 | + |
| 8 | +| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 | |
| 9 | +|----|------|------|--------|----------|------| |
| 10 | +| TD-040 | bundle.resources 未含 ffmpeg（deliberate 有意不修：体积权衡） | 有意 | P2 | 2026-08-18 | carried | |
| 11 | +| TD-2026-08-19-D | image_stream_store 已交付未接线（REQ-110/123/088）——lib.rs 仅 mod 声明，接线条件未发生 | 有意 | P2 | 2026-08-19 | carried | |
| 12 | +| TD-2026-08-24-A | lib.rs 超 600 硬限——实测 872（v0.19.3 模块/命令再 +5）；generate_handler 单点展开不可拆，拆分计划维持顺延 | 有意 | P1 | 2026-08-24 | carried | |
| 13 | +| TD-2026-08-30-A | ClassroomPage 超 600 硬限——实测 745；拆分计划（LiveCaptureCard）未启动 | 有意 | P1 | 2026-08-30 | carried | |
| 14 | +| TD-2026-08-30-B | note_filter 预存失败 2 笔（session29_live_ui_excluded_from_points / ocr_points_exclude_watermark_junk_and_dupes）——受限会话无法复跑全量，维持复现口径 | 预存 | P2 | 2026-08-30 | carried | |
| 15 | +| TD-2026-08-31-A | BrowserChrome 对 contenteditable 右键无应用内文本菜单——当前应用无该编辑面 | 有意 | P3 | 2026-08-31 | carried | |
| 16 | +| TD-2026-08-31-B | window.prompt/confirm/alert 替换为应用内对话框——余 13 处未决 | 有意 | P2 | 2026-08-31 | carried | |
| 17 | +| TD-2026-08-31-C | App.css 从未被引入（死样式）——引入改全局暗色观感，需单独裁决 | 环境变化 | P3 | 2026-08-31 | carried | |
| 18 | +| TD-2026-09-05-A | 挂体系空体系「去建体系」引导按钮未交付（spec §2.5-4/需求池文本要求按钮跳体系页向导）——组件无跨页跳转通道；当前为空态提示文案 | 有意 | P3 | 2026-09-05 | open | |
| 19 | +| TD-2026-09-05-B | 模型 disciplines 入参三形态契约漂移：Rust `disciplines:String`（JSON 数组字符串）vs knowledge.ts `string[]` vs 存量两调用点传数组（KnowledgeModelDialog/KnowledgeDetailPanel）——本批新路径已按 JSON 字符串修正，存量待统一 | 无意 | P3 | 2026-09-05 | open | |
| 20 | + |
| 21 | +## 今日审查即修（不立债，四批提交） |
| 22 | + |
| 23 | +审查基准 `4c7dad0^..HEAD(a3a7b781)`，四区并行（A 捕获/会话 · B AI 精修 · C 笔记列表 · D 挂体系/元数据），修复提交： |
| 24 | + |
| 25 | +1. **`e59c413`（B 批）**：流式 [DONE] 收尾校验（断流=失败回退非流式，禁止静默截断当成功）；流式拍去除 response_format（与 NDJSON 多值/stream 并存冲突）；整包 JSON 零成本回退兑现（compact/pretty 数组均可解析，免重发）；预算最坏档余量 16k→18k；授权文案按画面理解生效态条件化（不再误称"图像永不出本机"） |
| 26 | +2. **`fa1647a`（A 批）**：主路径 tick 对称处理 Resume（清 auto_paused——修"手动暂停被误当自动暂停并自动解除"）；暂停期 watchdog 探针（防 WGC 失活致永久卡自动暂停）；OCR 暂停边沿去重守卫（pause 已置时不重复记账/emit）；误停阈值 SUSPECT_AFTER_TICKS 1→2（静音静止 2~4s 不再误停，真机标定前保守）；live:resumed 清除媒体徽标 |
| 27 | +3. **`7569871`（C 批）**：note_orders 孤儿行清理钩子（delete/move 命令 purge）+ scope 从属校验（save 前整体校验拒绝陈旧序）；折叠组行剔除区间/划选可见序；跨组行落点"先归组后落位+无锁防互覆"；平铺态（搜索/标签/非默认排序）禁排序拖拽守卫；划选监听泄漏修复（rAF 节流+pointercancel/blur/松开清理）；anchor 语义（普通单击清选集并设锚/无锚 Shift=单选设锚）；INTEGER 参数类型化直绑 |
| 28 | +4. **`553e95a`（D 批）**：模型轻建 disciplines 改 JSON 数组字符串（原裸串必败）；Enter=有命中选首项/零命中新建 + IME isComposing 守卫；轻建与切体系代际守卫（防旧代覆盖） |
| 29 | +5. **`f15320d8`（元数据纠偏）**：requirements-pool REQ-281/282/285 状态收口"已实施 v0.19.6"；v0.19.6 版本文档范围表状态同步；豁免登记行数纠偏（ai_refine_protocol 撤登 340→295≤300；NoteListView 525→524；NoteLinkToSystem 314→325） |
| 30 | + |
| 31 | +## 审查观察项（登记不立债） |
| 32 | + |
| 33 | +| ID | 摘要 | 处置 | |
| 34 | +|----|------|------| |
| 35 | +| 观察 2026-09-05-1（A-F2） | 暂停期 audio_loopback 端点停采 → media_sound 槽冻结，auto 轮询的"声画任一恢复"实际只剩画面通道（与 media_state 单测契约不符） | 登记后续：暂停期低占空采样仅写槽，或如实化文档/测试（真机评估） | |
| 36 | +| 观察 2026-09-05-2（B-B10） | 流式行缓冲/整包回退解析无 Rust 单测；stream_sse_content 与 stream_chat SSE 循环近全同待抽公共 | 登记后续：抽 `sse_read_loop` + 行缓冲纯函数补测 | |
| 37 | +| 观察 2026-09-05-3（B-B7） | 轨迹 AiTurn.system 记 build_system 基座，缺 NDJSON 后缀与预算引导段（非实发原文）；AiTurn.response 为重组 JSON 非流式原文 | 登记后续：如实改注释或记录实发 system | |
| 38 | +| 观察 2026-09-05-4（B-B12） | 任务审计/AiRefineResult 无 vision 覆写标记；ai_refine_estimate 不含 vision 维度（开关切换预估费用不变） | 登记后续：审计补 vision 标记、预估随 effectiveVision 重算 | |
| 39 | +| 观察 2026-09-05-5（C-L10） | 批量移动串行 await N 次 invoke 无进度；每次 saveOrder 全量重拉 | 登记后续：并行/进度与局部刷新（量级小暂缓） | |
| 40 | +| 观察 2026-09-05-6（A-F6/提示） | live:frame-heartbeat 无前端消费（保留=诊断）；recent_session_titles 无 LIMIT；title_rules TITLE_MAX_CHARS=40 与 commands.rs 同名值 100；import 标题未 normalize 与实时入口不一致 | 登记后续整理批 | |
| 41 | +| 观察（继承 09-04B） | 事件名跨语言契约无机器校验 / kb_chunk 超窗尾段不入向量 / 本地写+总线双刷 / dock 无组件测试 / 播放中真检测 / 设置页技术串与模型下载进度 | 延续 | |
| 42 | + |
| 43 | +## 验证记录 |
| 44 | + |
| 45 | +- Rust：`cargo check --all-targets` 干净；clippy 终检 exit 0（受限会话无法启动 Rust 测试二进制——单测随文件入库，常规终端/CI 补跑，口径同 v0.19.6 文档） |
| 46 | +- 前端：vitest 全量绿（修复后复跑）；`tsc --noEmit` 零错误 |
| 47 | +- 提交：审查即修四批 + 元数据纠偏（见上表） |
| 48 | + |
| 49 | +## 关联 |
| 50 | + |
| 51 | +- 版本与需求：[v0.19.6 版本文档](../../versions/v0.19.6.md) · [v0.19.7 版本文档](../../versions/v0.19.7.md)（REQ-281~291 交付记录与真机验收待办） |
| 52 | +- 活跃设计：[v0.19 反馈批设计](../../superpowers/specs/2026-09-05-v0.19-feedback-batch-design.md)（v0.19.8 余项仍活跃）· [目标执行智能体设计](../../superpowers/specs/2026-09-05-goal-execution-agent-design.md)（v0.21 未实施） |
| 53 | +- 归档快照：[2026-09-05 README](./README.md) |
0 commit comments