Skip to content

Commit bdf13e0

Browse files
committed
docs(td): 技术债偿还补记(5cddb95/f8df1b6,存量 11→3)
1 parent f8df1b6 commit bdf13e0

3 files changed

Lines changed: 22 additions & 16 deletions

File tree

‎docs/archive/2026-08-29/README.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,9 @@
1919

2020
## 技术债摘要
2121

22-
- **滚动**:昨日(2026-08-28)9 carried + 2 open → 全部核实为 **11 carried**(TD-2026-08-28-B 的修复前提 D4 接线在本版未发生,转入 carried;无 closed)
23-
- **今日新增**:无残留 open——本次审查发现的问题(Rust 1 中 7 低,前端 2 高 5 中 12 低)全部即修(提交 313dd9ff)或登记观察项
24-
- **观察项**:新增 2026-08-29-1/2/3(原子提交记录 / 会话暂停重连循环待确认实施 / 成环父引用防御低优先);既有 2026-08-28-1/2/3 继承
25-
- 权威清单:[tech-debt.md](./tech-debt.md)(11 carried + 6 观察项)
22+
- **状态**:存量 11 笔 → **偿清 8 笔**(19-F/19-G/28-A/28-B = `5cddb95`;21-C/24-B/24-C/22-A = `f8df1b6`);**剩余 3 笔 carried**——TD-040(有意不修:ffmpeg 体积权衡)、TD-19-D(有意未接线:image_store,v0.7.3 体系后接线价值衰减)、TD-24-A(**本轮评估:lib.rs 注册清单在 Tauri v2 单点 generate_handler proc-macro 展开下技术上不可拆分**(分组函数实测 E0282);live_session_frame 单函数拆分方案已登记——继续顺延)
23+
- **clippy**:存量代码级告警清零(TD-22-A 关闭);仅剩系统级 build-target 元警告(非代码 lint)
24+
- 权威清单:[tech-debt.md](./tech-debt.md)(3 carried + 6 观察项)
2625

2726
## 验证
2827

‎docs/archive/2026-08-29/tech-debt.md‎

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,31 @@
33
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
44
> 来源:2026-08-29(v0.14.1 交付 20da94e7 + 新增代码七维审查即修 313dd9ff:
55
> 三区域并行 agent——Rust 侧 1中7低 / 前端纯函数层 2高3中6低 / 前端组管理 4中6低,
6-
> 全部即修或登记,无残留 open;设计规格归档)
6+
> 全部即修或登记,无残留 open;设计规格归档;**技术债专项 5cddb95/f8df1b6:
7+
> 存量 11 笔偿清 8 笔**)
78
89
## 未偿债务
910

1011
| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 |
1112
|----|------|------|--------|----------|------|
1213
| TD-040 | bundle.resources 未含 ffmpeg(deliberate 有意不修:体积权衡) | 有意 | P2 | 2026-08-18 | carried |
1314
| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110/123/088) | 有意 | P2 | 2026-08-19 | carried |
14-
| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容可能误报暂停 | 无意 | P3 | 2026-08-19 | carried |
15-
| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验存在性 | 无意 | P2 | 2026-08-19 | carried |
16-
| TD-2026-08-21-C | db_sessions/db_ai_tasks 的 lock().expect 未迁移 with_conn | 无意 | P3 | 2026-08-21 | carried |
17-
| TD-2026-08-22-A | clippy --all-targets -D warnings 未绿(存量项;后续交付批均零新增) | 无意 | P3 | 2026-08-22 | carried |
18-
| TD-2026-08-24-A | lib.rs(712 行)/ live_session_frame.rs(683 行)超 600 硬限——拆分计划顺延下一窗口 | 有意 | P1 | 2026-08-24 | carried |
19-
| TD-2026-08-24-B | RouteInfoPopover sysBrief 仅查 groupLinks[0] 体系——多体系组其余体系的概念失效不提示 | 无意 | P2 | 2026-08-24 | carried |
20-
| TD-2026-08-24-C | KnowledgePage KnowledgeSampleView refreshGlobal={0} 恒传死参数 | 无意 | P3 | 2026-08-24 | carried |
21-
| TD-2026-08-28-A | chapter_quality_scores 每章全量扫描 blocks(O(C×B))+ 每块文本克隆——正确性无影响,纯性能优化项 | 无意 | P3 | 2026-08-28 | carried |
22-
| TD-2026-08-28-B | incremental_merge 循环内线性 find 导致 O(n²)——dead code 模块(已登记豁免);修复前提(D4 接线)在 v0.14.1 未发生,顺延 | 无意 | P3 | 2026-08-28 | carried |
15+
| TD-2026-08-24-A | lib.rs(752 行)/ live_session_frame.rs(692 行)超 600 硬限——本轮评估:lib.rs 注册清单在 Tauri v2 单点 generate_handler proc-macro 展开(分组函数实测 E0282 类型不可推断)——**技术上不可拆分**,维持(752 行主体为 mod 声明+注册声明区,无业务逻辑);live_session_frame 拆分方案已登记(SessionFrameCtx 聚合,含豁免文档) | 有意 | P1 | 2026-08-24 | carried |
2316

24-
## 今日已偿
17+
## 今日已偿(技术债专项:5cddb95 / f8df1b6)
18+
19+
| ID | 摘要 | 偿还提交 |
20+
|----|------|----------|
21+
| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容误报——白像素判定(高亮+低饱和 ±40)+ bright 上限收紧 0.35 + 暗底彩亮块回归测试 | 5cddb95 |
22+
| TD-2026-08-19-G | db_ocr_search 500 会话静默截断——移除会话范围上限(全库检索,结果仍有界 100)+ >500 会话回归测试;图路径存在性校验(M4)确认已在 | 5cddb95 |
23+
| TD-2026-08-28-A | chapter_quality_scores O(C×B)——块排序一次 + 章节滑动窗口(partition_point 定界,O(B log B + C log B),间隙块语义不变) | 5cddb95 |
24+
| TD-2026-08-28-B | incremental_merge 帧回查 O(n²)——id→帧 HashMap 索引(O(n));修复不依赖 D4 接线 | 5cddb95 |
25+
| TD-2026-08-21-C | db_sessions/db_session_events 20 处 lock().expect 连接锁——全部迁移 with_conn(毒锁恢复+ROLLBACK 口径;子代理执行 + 编译/20 测试通过) | f8df1b6 |
26+
| TD-2026-08-24-B | RouteInfoPopover sysBrief 仅查 groupLinks[0]——聚合全部关联体系(unique systemId),stale 概念跨体系计数 | f8df1b6 |
27+
| TD-2026-08-24-C | KnowledgePage refreshGlobal={0} 死参数——sampleRefresh 令牌(创建/复制成功后递增驱动 KnowledgeSampleView checkGlobal 重试) | f8df1b6 |
28+
| TD-2026-08-22-A | clippy--all-targets 存量告警——clippy --fix 自动批量 + 9 项人工(注释缩进/签名 Copy by value/too_many_arguments allow/Vec→slice/dead_code 删除等);**clipty 零代码告警**(仅系统级 build-target 元警告) | f8df1b6 |
29+
30+
## 审查已偿(313dd9ff 批次,详见下方延续段)
2531

2632
| ID | 摘要 | 偿还提交 |
2733
|----|------|----------|

‎docs/standards/line-limit-exemptions.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,8 @@
4040
| app/src-tauri/src/vocab.rs | 373 | 词表域(存储/纠错/候选提取/n-gram 分词)内聚;分词纯逻辑与存储同域便于单测 | 若再增长:collect_tokens/split_runs 拆至 vocab_tokens.rs |
4141
| app/src-tauri/src/live_session_loop.rs | 369 | v0.7.0 M0 拆分产物(音频编排循环):主循环 + 长静音/音量骤变/VAD 段事件写入 + drain/停止 flush;LiveSessionCtx 聚合上下文;A1 暂停边沿 + P1 停止 drain 重构;H1 修复(drain_deadline 改 Option,draining 置位时才计算) | 若再增长:事件写入块拆至 live_session_events.rs |
4242
| app/src-tauri/src/screens_tests.rs | 366 | 画面要点屏构建测试域(分组/聚类/图匹配/可消费块过滤回归)单模块 #[path] 挂载 | 若再增长:可消费块过滤组拆至 screens_filter_tests.rs |
43-
| app/src-tauri/src/db_sessions.rs | 359 | 会话仓储(会话/段/OCR 块/建议查询);SQL 与行映射内聚;v0.7.1 列表标记子查询 | 若再增长:recent_ocr_texts 等建议查询拆至 db_sessions_queries.rs |
43+
| app/src-tauri/src/db_sessions.rs | 394 | 会话仓储(会话/段/OCR 块/建议查询);SQL 与行映射内聚;v0.7.1 列表标记子查询;TD-21-C 全部锁点迁移 with_conn 后 +35 行(闭包包裹) | 若再增长:recent_ocr_texts 等建议查询拆至 db_sessions_queries.rs |
44+
| app/src-tauri/src/live_session_frame.rs | 692 | 屏幕采样线程(采样循环/暂停隔离/播放器检测/tier 重评/视频档案重评)单单体函数——TD-24-A 拆分方案已登记(SessionFrameCtx 聚合 + 段落方法提取),本轮评估:与 lib.rs 同批后置 | 若再增长:按 Ctx 聚合方案拆至 live_session_frame_scan.rs |
4445
| app/src-tauri/src/commands_refine_inner.rs | 353 | v0.5.0 模型版:课后精修编排(清单构建/降级决策/引擎懒加载/逐候选识别/产物回填/HTML→MD 转换)内聚于精修执行域 | 若再增长:html_to_markdown 拆至 html_table_md.rs |
4546
| app/src-tauri/src/ui_junk.rs | 347 | UI 噪声过滤域(水印/字幕条/角标检测规则 + 窗口过滤启发式)内聚于同一判定管线,规则共享窗口几何上下文 | 若再增长:窗口过滤拆至 ui_junk_window.rs |
4647
| app/src-tauri/src/analysis.rs | 344 | v0.5.0 M2 起结构化分析编排域(章节/重点/术语/讲者 + 事件消费 + step_boundaries/practice_segments/player_actions 三字段 + 审查修复按类型判定);各机制输出聚合内聚于单一分析函数 | 若再增长:build_chapter_signals 事件版拆至 analysis_signals.rs |

0 commit comments

Comments
 (0)