|
1 | | -# 技术债清单（权威：2026-08-19，十四轮滚动——课堂助手页面优化批次 + A/C 批新增代码审查后） |
| 1 | +# 技术债清单（权威：2026-08-19，十五轮滚动——课堂助手三项优化合入 + 新增代码七维审查后） |
2 | 2 |
|
3 | 3 | > 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。 |
4 | | -> 来源：十三轮清单滚动（v0.7.0 全量代码建设 + 七维审查，审查即修 12 项 952386b + 3a97483；补记轮 87a3277 + 9a0c82e 即修 6 项）+ 2026-08 课堂助手页面优化（窗口过滤/档案右移/模型状态/实时图片，0177a17~0099dff）+ A/C 批（硬暂停/VU/标记/直达/就绪清单，89a1b9e~eb315d3）+ 新增代码七维审查（2026-08-19）。 |
5 | | -> 十四轮滚动（审查发现即修）：已偿 3 笔（提交 d390b3f——LiveImageStrip 节流/AudioLevelMeter 定时器/行数豁免更新）；已修待提交 3 笔（H/I/L，工作区与并行 P1-P3 混合，合入后核验 closed）；并行会话 P1-P3（停止即时/播放暂停驱动/引擎预热）工作区开发中未提交，合入后统一核验。 |
| 4 | +> 来源：十四轮清单滚动（A/C 批已合入 89a1b9e~eb315d3；H/I/L 修复待本批合入核验；并行会话 P1-P3 工作区开发中）+ 课堂助手三项优化合入（提交 6103832 + 4e9ccf6 + 1742468）+ 新增代码七维审查（2026-08-19，审查即修 4 项 + TD-H 补漏）。 |
| 5 | +> 十五轮滚动（核验与审查）：H/I/L 三项核验 closed（见下）；审查即修 3 项（R1 serde 契约/R2 stale Ready/R3 注释口径）+ TD-H 补漏（切块累加器清空）；新登记观察项 3 条（不立债）。 |
6 | 6 |
|
7 | 7 | ## 未偿债务 |
8 | 8 |
|
|
11 | 11 | | TD-040 | tauri.conf.json bundle.resources 未含 ffmpeg——生产安装包无捆绑 ffmpeg（v0.3.0 审查，2026-08-18） | carried（deliberate 有意不修）：resources glob 对缺失目录构建失败；捆绑 ffmpeg（≥80MB）与安装包体积权衡留待体积策略；开发期用 download-ffmpeg.ps1 + PATH 覆盖（ADR-008 风险项，保持观察）。多次核对（2026-08-19）：v0.7.0 全量代码未涉模型分发/捆绑，保持 carried | |
12 | 12 | | TD-2026-08-19-D | image_stream_store 已交付未接线（REQ-110 图像流存储层/REQ-123 步骤图卡配图/REQ-088 图注影子层）：ImageStreamStore 零生产调用 | carried：接线点明确（live_frame_process 帧归档处创建 + record，analysis 产物模板消费 step_frames），待 M3 平台图像后续迭代接线；接线前先修内部缺陷（深度审查 M4） | |
13 | 13 | | TD-2026-08-19-E | 前端未接入：search_ocr_blocks（REQ-133 图内检索入口）与 model_disk_overview（REQ-131 磁盘占用面板）命令已注册但无 UI 调用 | carried：待前端迭代接入（SessionsPage 搜索框可复用） | |
14 | | -| TD-2026-08-19-F | detect_pause_icon 颜色统计对"暗底+中央亮内容"（深色幻灯片白字/投影幕布）可能误报暂停——与"保守不产假信号"声明矛盾 | carried：需形状约束（中央连通亮块/双竖杠）或结合画面变化（diff_pass）；真机播放器样本校准计划保留（REQ-125 验收后失败则降级条款）；并行 P2 自动暂停实现依赖该检测，合入后重点核验 | |
| 14 | +| TD-2026-08-19-F | detect_pause_icon 颜色统计对"暗底+中央亮内容"（深色幻灯片白字/投影幕布）可能误报暂停——与"保守不产假信号"声明矛盾 | carried：需形状约束（中央连通亮块/双竖杠）或结合画面变化（diff_pass）；真机播放器样本校准计划保留（REQ-125 验收后失败则降级条款）；P2 自动暂停已依赖该检测（十五轮核验：误报仅致短暂自动暂停，检测恢复节流 5s 自愈，风险已评估可接受） | |
15 | 15 | | TD-2026-08-19-G | db_ocr_search 只搜最近 500 会话静默截断 + image_path_for 恒返回固定路径不校验存在性 | carried：全库扫描量级控制（500 会话上限可接受，注释注明）；图路径由前端加载降级（诚实） | |
16 | | -| TD-2026-08-19-H | WASAPI 暂停恢复残留缓冲未清空——恢复后以补偿时间戳混入暂停前音频（内容错位） | 修复已落工作区（audio_loopback.rs 恢复边沿清空缓冲，审查即修）；待提交——与并行 P1-P3 工作区混合，待并行批次合入后核验 closed | |
17 | | -| TD-2026-08-19-I | session:fusion-failed 后残留"✅ 融合完成"直达卡片（fusing 已预置 id）——失败误报完成 | 修复已落工作区（ClassroomPage fusion-failed 清除 fusedSessionId）；待提交核验（同上） | |
18 | | -| TD-2026-08-19-L | ClassroomPage.tsx 641 行 >600 硬上限（2026-08 A/C 批增长） | 硬拆已落工作区（ClassroomRightPane 右栏 + MaterialInputPanel 素材/提取，回归 548 行登记豁免）；待提交核验（同上） | |
19 | 16 |
|
20 | | -## 今日已偿（审查发现即修，可经代码验证） |
| 17 | +## 今日已偿（核验 + 审查即修，可经代码验证） |
21 | 18 |
|
22 | 19 | | ID | 摘要 | 偿还方式 | |
23 | 20 | |----|------|----------| |
24 | | -| （审查·J） | LiveImageStrip 事件刷新无节流——live:ocr 一帧多块高频触发目录读（IPC 风暴风险） | 500ms 事件刷新节流合并；修复提交 d390b3f | |
25 | | -| （审查·K） | AudioLevelMeter 削波复位 setTimeout 无句柄清理——组件卸载（暂停/停止）后仍 setState | 定时器句柄化 + effect cleanup；修复提交 d390b3f | |
26 | | -| （审查·L4 延续） | line-limit-exemptions 行数过期：audio_loopback ~320→~430/live_session_loop ~313→~360/structure_models ~303→~320；live_session.rs 与 live_session_frame.rs 重新超 300 行 | 豁免登记行数刷新 + 重新登记与拆分计划；修复提交 d390b3f | |
27 | | -| （审查·A1 补漏） | 会话暂停跨会话残留（paused 标志/补偿时长）——新会话起始即暂停、时间戳偏移 | 并行会话已修（SessionPause::reset + start 时调用），工作区未提交，合入后核验 | |
28 | | -| （审查·A1 断句） | 暂停边沿"喂 100ms 静音"不足以触发 sherpa 端点规则——挂起句内容丢失风险 | 并行会话已修（flush_tail_and_persist + reset 重建流），工作区未提交，合入后核验 | |
| 21 | +| TD-2026-08-19-H | WASAPI 暂停恢复残留缓冲未清空——恢复后以补偿时间戳混入暂停前音频（内容错位） | 端点缓冲排空（A/C 批已合入 89a1b9e）+ 十五轮补漏：应用层切块累加器清空（audio_loopback.rs 恢复边沿重建 ChunkAccumulator，提交 6103832）；closed | |
| 22 | +| TD-2026-08-19-I | session:fusion-failed 后残留"✅ 融合完成"直达卡片（fusing 已预置 id）——失败误报完成 | ClassroomPage fusion-failed 监听清除 fusedSessionId（提交 4e9ccf6）；closed | |
| 23 | +| TD-2026-08-19-L | ClassroomPage.tsx 641 行 >600 硬上限（2026-08 A/C 批增长） | 硬拆完成（ClassroomRightPane 右栏 + MaterialInputPanel 素材/提取，回归 548 行登记豁免，提交 4e9ccf6）；closed | |
| 24 | +| （审查·R1） | PrepareStatus IPC 序列化契约不一致——derive 对 Failed(String) 产出 `{"failed": ...}` 对象、unit 变体产出字符串；前端 `as` 断言掩盖，运行时预热状态提示静默失效（high 面） | 手写 Serialize 输出纯字符串 tag（失败原因经日志，不进 IPC）；提交 6103832 | |
| 25 | +| （审查·R2） | prepare_status/prepare 对线程已退出但 status=Ready 的残留返回 stale Ready——前端短暂显示"已就绪"实为无预备 | 线程已死统一返回 Idle（Failed 保留原因）；提交 6103832 | |
| 26 | +| （审查·R3） | flush_tail_and_persist 返回值 any 注释声称"调用方据此判断状态清理"但无消费点 | 注释修正（保留供诊断/单测断言，不引入 must_use）；提交 6103832 | |
29 | 27 |
|
30 | 28 | ## 观察项（登记不立偿，保持跟踪） |
31 | 29 |
|
|
41 | 39 | | （审查·S-L11） | 中断段 gap 用句首时刻（应句尾）——插入/暂停间隙时长统计偏差 | 当前 gap 语义="前句句首到本句句首"（含句长），统计口径注释已注明；切句尾口径随周报聚合（V1.0 A4）一并校准 | |
42 | 40 | | （审查·S-L12） | 播放器检测 5s 节流粒度——短于 5s 的暂停丢失（已接受） | 节流换成本（全帧 bgra→rgb + 图标检测 5s 一次）；REQ-125 验收后失败则降级条款，真机样本校准保留 | |
43 | 41 | | （审查·S-L13） | publish(NaN) 位模式原样透传共享槽——诊断面板可能读到 NaN | adaptive_vad 已钳制（next_threshold 输出恒有效）；位模式往返测试覆盖 NaN 不崩溃（防御性记录） | |
44 | | -| （观察·并行） | 并行会话 P1-P3（停止即时 drain/播放暂停驱动自动暂停/引擎预热）在未提交工作区开发中（live_session_prepare.rs 等 7 文件）——P2 自动暂停与手动暂停互斥语义、P3 前端 invoke 失败静默降级需验收 | 合入后按新增代码审查流程核验；本清单 H/I/L 待其合入后统一 closed | |
| 42 | +| （观察·并行-核验） | 并行会话 P1-P3（停止即时 drain/播放暂停驱动自动暂停/引擎预热）已合入（6103832+4e9ccf6+1742468）——十五轮审查核验：P2 自动暂停与手动暂停互斥语义正确（轻量轮询 vs 全冻结分支互斥）、P3 前端 invoke 失败静默降级可接受（catch→idle + start 内联兜底）；核验 closed | 本清单 H/I/L 已 closed；新审查问题见"今日已偿" | |
45 | 43 | | （观察·A1） | 暂停置位到捕获线程停采的窗口期（≤10ms）内音频仍被消费——暂停前真实内容，语义正确，无内容丢失 | 注释已说明；真机验证暂停边界转写完整性 | |
46 | 44 | | （观察·C1） | ReadyCheckCard 聚合 health_status/structure_model_status/ocr_device_status——OCR 引擎未启动时 ocr_device_status 返回内存态（可能误报就绪） | 引擎池常驻（setup 即启动），实际不触发；如出现可加 asr_alive/ocr_alive 联合判定 | |
47 | 45 | | （观察·窗口过滤） | bilibili 首页标题变体（"bilibili - 哔哩哔哩"等）未全部覆盖——未命中首页模式时仍进推荐 | 首页模式表可扩展（window_filter.rs SITE_HOMEPAGE_TITLES）；真机样本校准保留 | |
| 46 | +| （观察·十五轮-1） | start() 等待预备就绪期间持有 active 锁最长 5s——pause/resume/status 等命令短暂排队 | 同刻通常只有单个用户操作，可接受；代码注释已注明；若后续出现并发操作需求再改释放重取 | |
| 47 | +| （观察·十五轮-2） | start() 交接防御分支（理论不可达：仅 Cancel 竞态）会留下空会话记录 | 与内联 spawn 失败同级既有边界，概率极低；代码注释已注明 | |
| 48 | +| （观察·十五轮-3） | pause 下降沿 now_ms 竞态（A1 既有）：恢复事件时间戳可能少算本次暂停时长（捕获线程 fetch_add 与主循环检测先后） | 捕获线程 10ms 轮询 vs 主循环 500ms 轮询——实际几乎不触发；真机验证暂停边界时间戳 | |
0 commit comments