Skip to content

Commit f9c9638

Browse files
committed
docs(archive): archive 2026-08-20
1 parent bca36da commit f9c9638

2 files changed

Lines changed: 37 additions & 24 deletions

File tree

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

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 归档索引:2026-08-20(v0.7.2 深化 + v0.7.3 屏卡 + v0.7.5 净化 + v0.7.6 结构渲染 批次)
1+
# 归档索引:2026-08-20(v0.7.2 深化 + v0.7.3 屏卡 + v0.7.5 净化 + v0.7.6 结构渲染 + v0.7.7 结构图 批次)
22

33
> 归档判定见 [archive README](../README.md)。本日归档夹为技术债滚动快照(唯一权威清单)。
44
@@ -11,31 +11,36 @@
1111
| `brainstorming-ocr-screen-cards.md` | v0.7.3 屏卡体系设计规格——M1-M5 全量代码建设完成(1053 单测全绿 + 前端构建通过),已落地实施;活跃区索引已标注 [ ] 已归档(v0.7.3.md / requirements-pool.md / ADR-015) |
1212
| `brainstorming-session-note-rules.md` | v0.7.5 会话转笔记规则优化设计规格——净化快赢批 12 项 + 停止残留修复 3 项已登记 REQ-162~176 并排期 v0.7.5(结构组织暂不实施,与 v0.8.0 AI 精修衔接);活跃区索引已标注 [ ] 已归档(v0.7.5.md / requirements-pool.md) |
1313

14+
**三轮归档 1 份**(v0.7.7 批次:规划中 → 已实施完成,生命终态):
15+
16+
| 文档 | 归档原因 |
17+
|------|---------|
18+
| `brainstorming-structure-images-v0.7.7.md` | v0.7.7 结构图捕获持久化设计规格——REQ-182~187 代码建设完成(1172 单测全绿 + 前端构建通过 + 三轮审查修复 bca36da),已落地实施;活跃区索引已标注 [ ] 已归档(v0.7.7.md / requirements-pool.md) |
19+
1420
**二轮归档 0 份**(v0.7.5/v0.7.6 批次核验——无新增生命终态文档):
1521

1622
| 候选文档 | 不归档原因 |
1723
|------|-----------|
18-
| `docs/versions/v0.7.5.md` / `docs/versions/v0.7.6.md` | versions/ 内容(规则明确不归档,持续活跃——v0.7.6 规划与实施记录均在其中) |
24+
| `docs/versions/v0.7.5.md` / `docs/versions/v0.7.6.md` / `docs/versions/v0.7.7.md` | versions/ 内容(规则明确不归档,持续活跃——规划与实施记录均在其中) |
1925
| `docs/Foresight/brainstorming-video-profile-detection.md` | 部分已立项(合集/自适应已实施)但检测准确度整体仍搁置待议——活跃 |
2026
| `docs/Foresight/video-data-extraction-inventory.md` | 部分已立项(说话人/信息面板已实施)其余待裁决——活跃 |
2127
| `docs/Foresight/brainstorming-classroom-assistant-mechanisms.md`(含 fed-guide) | 机制摘要投喂文档——供其他 AI 模型头脑风暴输入,持续活跃 |
2228
| `docs/Foresight/brainstorming-no-cloud-ai-extraction-limit.md` | 前瞻构想(未排期)——活跃 |
23-
| `docs/Foresight/brainstorming-structure-images-v0.7.7.md` | v0.7.7 结构图捕获持久化头脑风暴(2026-08-20 登记 REQ-182~187,规划中未实施)——活跃 |
2429

25-
## 本批工作摘要(2026-08-20 二轮,v0.7.5/v0.7.6 批次)
30+
## 本批工作摘要(2026-08-20 三轮,v0.7.7 结构图批次)
2631

27-
- **v0.7.5 会话转笔记规则净化**(REQ-162~176,提交 0834b38/37ce5c1/14d4843/f2efab9):停止状态残留根治 + 图片时间戳数值排序 + 过渡句/修辞问句规则净化 + 会话转笔记净化优化(净化链 12 项 + 停止残留修复 3 项)
28-
- **v0.7.6 笔记纯本地结构渲染**(REQ-177~181,提交 974343b 规划 + 4edb5db 实施):章节边界 → `## 章节 N [MM:SS]` 标题层级(outline 窗口命名)+ 术语表 `## 词汇表` 块(score 降序/锚点回跳/上限防噪音)+ NoteStructureConfig 嵌套 JSON 可校准 + StructureStats 并入 purify_stats(RULE_VERSION → note-rules-0.7.6);1131 单测全绿(v0.7.6 增 17:structure_note 15 + 黄金 2)+ clippy 新代码零警告
29-
- **v0.7.7 结构图捕获持久化规划**(REQ-182~187 登记,提交 843bfce):头脑风暴文档入 Foresight(规划中,活跃不归档)
30-
- **新增代码七维审查即修**(提交 4dbafdf + 84c867f + fb40c1e):H1 AI 复核出口补结构渲染(REQ-081 三出口一致)、H2 commands_session 611 行 >600 硬拆(笔记管线 → commands_session_note.rs 240 行)、M1 glossary_max_terms=0 语义、M2 零回归黄金测试补测、L1 死代码 helpers 清理、L2 行数豁免登记同步、L3 mod 字母序;1133 单测全绿(审查增 2)+ clippy 新代码零警告;接入/逻辑/牵连/性能/冗余/提交规范/安全七维检查通过项见审查输出
32+
- **v0.7.7 结构图捕获持久化实施**(REQ-182~187,提交 1629ea0/5bb9c3a/0ca4fbe/b13ead0/5147d85/a399365):原子层 diagram_likeness/pick_sharpest(长直线+密度+面积+形状约束启发式)→ 业务层 struct/ 命名空间独立预算 + session_structure_images 新表 + 批量捕获管线(屏内选优帧→版面→过滤→裁剪→入库,幂等去重)→ 系统层四命令 + 停止后自动捕获 → 前端屏卡框选(BoxSelectOverlay 确认浮层)/ 图库区段 / 大图预览 / 会话列表全选框;1172 单测全绿(v0.7.7 增 34)+ 前端构建通过;实现校准:真实流程图被判 Text——Text 同过图结构门控 + 形状约束防标题误收(规格同步更新)
33+
- **技术债清偿 3 笔**:TD-B 术语锚点词边界+大小写折叠(1b24168)、TD-C list_events 失败留日志(f8be4d3)、TD-E 前端接入图搜/磁盘面板(5147d85)
34+
- **新增代码三轮审查即修 9 项**(提交 bca36da):R1 预算/错误区分(Err(_) 吞所有错误误判预算耗尽)、R2 删除顺序(先文件后记录防孤儿文件)、R3 屏定位 first_seen_ms(聚类屏号不唯一错屏)、R4 框选单击误触全屏、R5 错误消息误导、R6 rgb_to_bgra 重复、R7 拖出残留框、R8 非错误信息用 error 态、R9 测试冗余行;接入/逻辑/牵连/性能/冗余/提交规范/安全七维检查通过项见审查输出
35+
- **v0.7.8 规划**:无(下一规划为 v0.8.0 AI 精修,REQ-138~147 已排期,见 [v0.8.0 版本文档](../../versions/v0.8.0.md))
3136

3237
## 技术债摘要
3338

34-
- **未偿 5 笔**(全部 carried,与一轮一致):TD-040(deliberate)+ TD-2026-08-19-D~G(4 笔)
35-
- **今日已偿 6 笔**(二轮审查即修):H1/H2/M1/M2/L1/L2(详见 [tech-debt.md](./tech-debt.md))
36-
- **新登记 open 3 笔**(TD-2026-08-20-A/B/C:async 阻塞改造/锚点子串匹配/静默错误日志)+ 观察项 3 条
39+
- **未偿 4 笔**(全部 carried,压缩一行摘要):TD-040(deliberate)+ TD-2026-08-19-D/F/G
40+
- **今日已偿 15 笔**:二轮 6 笔(H1/H2/M1/M2/L1/L2)+ TD-B/TD-C/TD-E + 三轮审查 9 笔(R1~R9,详见 [tech-debt.md](./tech-debt.md))
41+
- **新登记 open 1 笔**(TD-2026-08-20-A:async 命令主体同步执行 spawn_blocking 改造;TD-B/C 已偿关闭)+ 观察项 3 条
3742

3843
## 关联
3944

40-
- 版本与需求:[v0.7.5 版本文档](../../versions/v0.7.5.md) · [v0.7.6 版本文档](../../versions/v0.7.6.md) · [需求池 REQ-162~181](../../product/requirements-pool.md)
45+
- 版本与需求:[v0.7.7 版本文档](../../versions/v0.7.7.md) · [v0.7.6 版本文档](../../versions/v0.7.6.md) · [需求池 REQ-162~187](../../product/requirements-pool.md)
4146
- 技术债:[tech-debt.md](./tech-debt.md)(唯一权威清单)

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

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
1-
# 技术债清单(权威:2026-08-20 二轮滚动——v0.7.5/v0.7.6 批次后)
1+
# 技术债清单(权威:2026-08-20 三轮滚动——v0.7.7 结构图批次后)
22

33
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
4-
> 来源:2026-08-20 一轮清单滚动(其源为 2026-08-19 十六轮清单)+ v0.7.5 会话转
5-
> 笔记规则净化(REQ-162~176,提交 14d4843/f2efab9)+ v0.7.6 笔记纯本地结构渲染
6-
> (REQ-177~181,提交 974343b/4edb5db,1131 单测全绿)+ 新增代码七维审查即修
7-
> (refactor 4dbafdf + fix 84c867f + docs fb40c1e,见"今日已偿")。
4+
> 来源:二轮清单滚动(v0.7.6 审查批次后)+ v0.7.7 结构图批次
5+
> (REQ-182~187,提交 1629ea0/5bb9c3a/0ca4fbe/b13ead0/5147d85/a399365,1172 单测全绿)
6+
> + 三轮新增代码审查即修(fix bca36da,9 项,见"今日已偿")。
87
9-
## 未偿债务(逐笔核验)
8+
## 未偿债务(逐笔核验;carried 仅留 ID + 一行摘要)
109

11-
| ID | 摘要 | 备注 |
12-
|----|------|------|
13-
| 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 覆盖。二轮核验(v0.7.6):未涉及模型分发/捆绑,保持 carried |
14-
| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110 图像流存储层/REQ-123 步骤图卡配图/REQ-088 图注影子层);ImageStreamStore 零生产调用 | carried:接线点明确(live_frame_process 帧归档处创建 + record;analysis 产物模板消费 step_frames),待 M3 平台图像后续迭代接线。三轮核验(v0.7.7):结构图存储独立于图像流,保持 |
15-
| TD-2026-08-19-F | detect_pause_icon 颜色统计对暗底+中央亮内容(深色幻灯片白字/投影幕布)可能误报暂停——与"保守不产假信号"声明矛盾 | carried:需形状约束(中央连通亮块/双竖杠)或结合画面变化(diff_pass);真机播放器样本校准计划保留。三轮核验:未涉及,保持 |
16-
| TD-2026-08-19-G | db_ocr_search 只搜最近 500 会话静默截断 + image_path_for 恒返回固定路径不校验存在性 | carried:全库扫描量级控制(500 会话上限可接受,注释注明);图路径由前端加载降级(诚实)。三轮核验:未涉及,保持 |
10+
| ID | 摘要 |
11+
|----|------|
12+
| TD-040 | bundle.resources 未含 ffmpeg(deliberate 有意不修:体积权衡,开发期脚本+PATH 覆盖);三轮核验未涉及,保持 |
13+
| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110/123/088);三轮核验:结构图存储独立于图像流,保持 |
14+
| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容可能误报暂停(与"保守不产假信号"矛盾);三轮核验未涉及,保持 |
15+
| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验存在性(量级控制可接受+前端降级);三轮核验未涉及,保持 |
1716

1817
## 今日已偿(v0.7.6 审查即修,可经代码/提交验证)
1918

@@ -28,6 +27,15 @@
2827
| (TD-B) | 术语锚点 first_occurrence_ms 大小写敏感子串匹配——短术语(如 "AI")可能锚到无关段或漏锚 | word_boundary_contains 词边界 + 内部大小写折叠(汉字前后不设限);5 个新单测;提交 1b24168 |
2928
| (TD-C) | apply_note_structure 中 db.list_events 错误静默吞掉——事件缺失时章节检测回退 OCR/gap 近似(诚实降级),但无日志线索 | match + eprintln(purify_config 同模式),降级行为不变;提交 f8be4d3 |
3029
| (TD-E) | 前端未接入 search_ocr_blocks(REQ-133 图内检索)与 model_disk_overview(REQ-131 磁盘占用) | 会话列表搜索框新增「画面」模式(图搜:命中行带时间/屏区间/📷 标记,点击跳详情)+ 模型设置面板挂 ModelDiskPanel(总占用+明细+版本徽标);提交 5147d85 |
30+
| (三轮审查 R1) | structure_capture 预算耗尽处理:`Err(_)` 吞所有错误——单区域编码/IO 失败被误判预算耗尽,终止整个会话后续捕获 | 预算前置检查(remaining_budget)拦截 + 单区域失败仅 eprintln 继续;提交 bca36da |
31+
| (三轮审查 R2) | 删除结构图顺序:先删 DB 记录后删文件——文件删除失败时记录已删、孤儿文件残留不一致 | db_structures 分离 get_structure_image 查询;命令层先删文件后删记录(失败时记录保留可重试);提交 bca36da |
32+
| (三轮审查 R3) | 手动捕获屏定位按 screen_id——旧数据聚类屏 screen_id 全 NULL,多聚类屏时匹配错屏 | 命令参数改 first_seen_ms 精确定位(前端 BoxSelectOverlay/SessionDetailPanel 同步);提交 bca36da |
33+
| (三轮审查 R4) | BoxSelectOverlay 单击未拖动(初始占位 w=h=1)→ 确认浮层全屏框选——误触保存整屏图 | moved 标志区分"拖拽/单击"(单击忽略);提交 bca36da |
34+
| (三轮审查 R5) | 手动捕获 <32px 错误消息误导(越界钳制后报"过小") | 消息改"框选区域无效(过小或超出画面边缘)";提交 bca36da |
35+
| (三轮审查 R6) | rgb_to_bgra 在 structure_capture 与 commands_structures 重复实现 | structure_capture 提 pub(crate) 复用,命令层删除重复;提交 bca36da |
36+
| (三轮审查 R7) | BoxSelectOverlay 拖出框外残留虚线框(onMouseLeave 仅清 dragging) | onMouseLeave 同时清 box 残留;提交 bca36da |
37+
| (三轮审查 R8) | StructureImageSection 用 error state 显示非错误信息(重跑无新增显示红色) | info state 分离(错误红/信息灰);提交 bca36da |
38+
| (三轮审查 R9) | structure_capture_tests 冗余行 `let _: FrameGrid = grid;` | 删除;提交 bca36da |
3139

3240
## 今日新登记 open(审查观察,暂不修)
3341

0 commit comments

Comments
 (0)