Skip to content

Commit ea823bd

Browse files
committed
docs(archive): archive 2026-08-20
1 parent 3ed0973 commit ea823bd

5 files changed

Lines changed: 31 additions & 26 deletions

File tree

‎docs/adr/ADR-015-screen-cards-ocr.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## 状态
44

55
已接受(2026-08-20 用户头脑风暴裁决:路线 A+B+D,屏段落+配图;规格见
6-
[archive/2026-08-20/brainstorming-ocr-screen-cards.md](../archive/2026-08-20/brainstorming-ocr-screen-cards.md))
6+
[archive/2026-08-20/brainstorming-ocr-screen-cards.md([ ] 已归档)](../archive/2026-08-20/brainstorming-ocr-screen-cards.md))
77

88
## 日期
99

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

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,39 @@
1-
# 归档索引:2026-08-20(v0.7.2 课堂助手深化批次 + v0.7.3 屏卡体系设计)
1+
# 归档索引:2026-08-20(v0.7.2 课堂助手深化批次 + v0.7.3 屏卡体系设计/实施 + 归档)
22

33
> 归档判定见 [archive README](../README.md)。本日归档夹为技术债滚动快照(唯一权威清单)。
44
55
## 归档清单
66

7-
**本日无文档归档**——本批产生的文档均属活跃状态,不符合归档判定:
7+
**本日归档 1 份**(设计规格实施落地,生命终态):
8+
9+
| 文档 | 归档原因 |
10+
|------|---------|
11+
| `brainstorming-ocr-screen-cards.md` | v0.7.3 屏卡体系设计规格——M1-M5 全量代码建设完成(1053 单测全绿 + 前端构建通过),已落地实施;活跃区索引已标注 [ ] 已归档(v0.7.3.md / requirements-pool.md / ADR-015) |
12+
13+
**不归档(持续活跃)**:
814

915
| 文档 | 不归档原因 |
1016
|------|-----------|
11-
| `docs/versions/v0.7.2.md` | versions/ 内容(规则明确不归档,持续活跃) |
12-
| `docs/versions/v0.7.3.md` | versions/ 内容(v0.7.3 屏卡体系已排期——活跃) |
17+
| `docs/versions/v0.7.2.md` / `docs/versions/v0.7.3.md` | versions/ 内容(规则明确不归档,持续活跃) |
18+
| `docs/adr/ADR-015-screen-cards-ocr.md` | 当前生效 ADR(规则明确不归档) |
1319
| `docs/Foresight/brainstorming-video-profile-detection.md` | 部分已立项(合集/自适应已实施)但检测准确度整体仍搁置待议——活跃 |
1420
| `docs/Foresight/video-data-extraction-inventory.md` | 部分已立项(说话人/信息面板已实施)其余待裁决——活跃 |
15-
| `docs/archive/2026-08-20/brainstorming-ocr-screen-cards.md` | 已裁决立项(v0.7.3 REQ-155~161 + ADR-015 引用)——活跃 |
1621
| `docs/product/classroom-assistant-guide.md` | 课堂助手使用说明——持续维护的活跃文档 |
1722
| `docs/product/requirements-pool.md` | 需求池——持续活跃 |
1823

19-
## 本批工作摘要(2026-08-20)
24+
## 本批工作摘要(2026-08-20,v0.7.3 屏卡体系批次)
2025

21-
- **v0.7.2 四深化落地**(REQ-148~154):三连体验(最近画面时序/ASR 未沉淀多行+按句拆行/未知档案)、采集信息面板(平台/时长/合集/字幕,全本地)、合集检测联动(系列名投票/记忆系列键/课程分组)、语速停顿自适应(动态合并阈值/骤变事件)、说话人分离弱化版(引擎接线/离线分析/会话详情展示/使用说明)
22-
- **新增代码七维审查**:五处即修(平台表单一来源/中文数字判定去重/暂停后语速基准重置/拆行标点过滤/讲者分析异步化+暂停态探测),提交 751b9c6
23-
- **验证**:1016 单测全绿 + clippy 干净 + 前端构建通过 + docs-check 通过;提交 9097e8f~751b9c6 已推送 rebuild
24-
- **v0.7.3 画面要点屏卡体系设计**(REQ-155~161 + ADR-015):会话29 实证(175 块/12 时间戳重复/UI 污染/无 bbox)→ 头脑风暴裁决(路线 A+B+D,屏段落+配图)→ 设计规格 + ADR + 需求登记,提交 1545bea
25-
- **v0.7.3 屏卡体系代码建设**(M1-M5):屏聚合纯函数(screen_merge/screens)+ bbox/screen_id 落库迁移 + 在线屏分配(ScreenTracker)+ 采集治理(前台过滤/直播 UI 黑名单)+ 消费端(原料屏卡流/笔记屏段落配图/大纲检索按屏/实时面板按屏)+ 结构识别接线(停止后自动精修/屏卡渲染精修产物);1053 单测全绿 + clippy 新代码零警告 + 前端构建通过;提交 1536222/8e9e889/d84ad14/df8d3be
26+
- **v0.7.2 四深化落地**(REQ-148~154):三连体验/采集信息面板/合集联动/语速停顿自适应/说话人分离弱化版,1016 单测全绿,提交 9097e8f~5159bee
27+
- **v0.7.3 画面要点屏卡体系**(REQ-155~161 + ADR-015):会话29 实证 → 头脑风暴裁决(路线 A+B+D,屏段落+配图)→ 设计规格 + ADR + 需求登记(1545bea)→ 全量代码建设 M1-M5(屏聚合纯函数/bbox+screen_id 落库/在线屏分配/采集治理/消费端屏卡流+笔记屏段落配图/大纲检索按屏/结构识别接线,1536222~df8d3be,1053 单测全绿 + clippy 新代码零警告 + 前端构建通过)
28+
- **新增代码七维审查**(提交 3ed0973):R6 AI 复核配图口径(双出口一致)、R7 图匹配单次扫描;三处低项注释加固(grouped 不变量/line_merge 混合顺序/is_cjk 收窄可见性);接入/逻辑/牵连/性能/冗余/提交规范/安全七维检查通过项见审查输出
2629

2730
## 技术债摘要
2831

2932
- **未偿 5 笔**(全部 carried,与昨日一致):TD-040(deliberate)+ TD-2026-08-19-D~G(4 笔)
30-
- **今日已偿 5 笔**(审查即修,751b9c6)
31-
- **新增观察项 4 条**(不立债:探测 OCR 竞争/音频保留期/短段跳过/final 判空边界)
33+
- **今日已偿 2 笔**(审查即修,3ed0973:R6/R7)
34+
- **新增观察项 0 条**(审查低项已注释加固,不立债)
3235

3336
## 关联
3437

35-
- 版本与需求:[v0.7.2 版本文档](../../versions/v0.7.2.md) · [需求池 REQ-148~154](../../product/requirements-pool.md)
38+
- 版本与需求:[v0.7.2 版本文档](../../versions/v0.7.2.md) · [v0.7.3 版本文档](../../versions/v0.7.3.md) · [需求池 REQ-148~161](../../product/requirements-pool.md)
3639
- 技术债:[tech-debt.md](./tech-debt.md)(唯一权威清单)

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

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
1-
# 技术债清单(权威:2026-08-20,v0.7.2 课堂助手深化批次滚动——十七轮后)
1+
# 技术债清单(权威:2026-08-20,v0.7.3 屏卡体系批次滚动——v0.7.2 批次后)
22

33
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
4-
> 来源:2026-08-19(十七轮)清单滚动 + v0.7.2 课堂助手四深化批次合入(REQ-148~154:
5-
> 三连体验/信息面板/合集联动/说话人分离/断句自适应,提交 9097e8f~5159bee,1016
6-
> 单测全绿)+ 新增代码七维审查(提交 751b9c6:五处即修——平台表单一来源/中文数字
7-
> 判定去重/暂停后语速基准重置/识别中拆行标点过滤/讲者分析异步化+自动暂停探测)。
4+
> 来源:2026-08-20(v0.7.2 批次)清单滚动 + v0.7.3 画面要点屏卡体系全量建设
5+
> (REQ-155~161:屏聚合/落库/在线分配/消费端/结构接线,提交 1536222~df8d3be,
6+
> 1053 单测全绿)+ 新增代码七维审查(提交 3ed0973:两处即修——AI 复核配图口径/
7+
> 图匹配单次扫描)+ 设计规格归档(brainstorming-ocr-screen-cards.md [ ] 已归档)。
88
99
## 未偿债务
1010

1111
| ID | 摘要 | 备注 |
1212
|----|------|------|
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 覆盖(ADR-008 风险项,保持观察)。多次核对(2026-08-20):本次未涉及模型分发/捆绑,保持 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 平台图像后续迭代接线;接线前先修内部缺陷(深度审查 M4);本次核对:v0.7.2 未涉及,保持 |
15-
| TD-2026-08-19-E | 前端未接入:search_ocr_blocks(REQ-133 图内检索入口)与 model_disk_overview(REQ-131 磁盘占用面板)命令已注册但无 UI 调用 | carried:待前端迭代接入(SessionsPage 搜索框可复用);本次核对:未涉及,保持 |
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 覆盖(ADR-008 风险项,保持观察)。多次核对(2026-08-20 v0.7.3):本次未涉及模型分发/捆绑,保持 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 平台图像后续迭代接线;接线前先修内部缺陷(深度审查 M4);本次核对:v0.7.3 屏卡体系未涉及图像流存储,保持 |
15+
| TD-2026-08-19-E | 前端未接入:search_ocr_blocks(REQ-133 图内检索入口)与 model_disk_overview(REQ-131 磁盘占用面板)命令已注册但无 UI 调用 | carried:待前端迭代接入(SessionsPage 搜索框可复用);本次核对:v0.7.3 增强 db_ocr_search 后端(命中带屏区间 REQ-160)但前端 UI 接入点仍缺,保持 |
1616
| TD-2026-08-19-F | detect_pause_icon 颜色统计对暗底+中央亮内容(深色幻灯片白字/投影幕布)可能误报暂停——与"保守不产假信号"声明矛盾 | carried:需形状约束(中央连通亮块/双竖杠)或结合画面变化(diff_pass);真机播放器样本校准计划保留(REQ-125 验收后失败则降级条款);本次核对:未涉及,保持 |
17-
| TD-2026-08-19-G | db_ocr_search 只搜最近 500 会话静默截断 + image_path_for 恒返回固定路径不校验存在性 | carried:全库扫描量级控制(500 会话上限可接受,注释注明);图路径由前端加载降级(诚实);本次核对:v0.7.2 仅适配包装结构(行为未变),保持 |
17+
| TD-2026-08-19-G | db_ocr_search 只搜最近 500 会话静默截断 + image_path_for 恒返回固定路径不校验存在性 | carried:全库扫描量级控制(500 会话上限可接受,注释注明);图路径由前端加载降级(诚实);本次核对:v0.7.3 新增屏区间映射(行为叠加未变既有两项),保持 |
1818

1919
## 今日已偿(核验 + 审查即修,可经代码验证)
2020

@@ -25,6 +25,8 @@
2525
| (审查 R3) | 暂停后首段与暂停前语速比较会跨暂停区间误判语速骤变(SpeechRateDrop 假事件) | 暂停边沿 flush 后重置 last_speech_rate=None;提交 751b9c6 |
2626
| (审查 R4) | 识别中行按句读拆分的连续句读切出纯标点垃圾行("结束。。") | splitBySentence 过滤纯标点/空白段(hasText);提交 751b9c6 |
2727
| (审查 R5) | 讲者分析同步命令在千段长会话上阻塞 IPC 吞吐 + 自动暂停时播放器信息不探测(暂停态视频时长缺失) | analyze_session_speakers 改 async + spawn_blocking;probe_player_info 抽公共函数并在 auto_paused 轻量轮询接入;提交 751b9c6 |
28+
| (审查 R6) | AI 复核路径(review_text_filter)画面要点屏未 attach 归档图——复核后预览配图消失,与 preview_session_note/session_to_note 双出口口径不一致 | review 路径补 attach_images + refresh_screen_points(单管线双出口的图版本);提交 3ed0973 |
29+
| (审查 R7) | attach_images 每屏一次 read_dir(N 屏 = N 次目录遍历) | 目录一次扫描建时间戳映射,逐屏二分匹配(match_timestamp);提交 3ed0973 |
2830

2931
## 观察项(登记不立债,保持跟踪)
3032

‎docs/product/requirements-pool.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@
201201
### v0.7.3 · 画面要点屏卡体系(2026-08-20 头脑风暴裁决)
202202

203203
> 用户反馈"画面要点(OCR)提取的内容零碎(时间整理和识别内容)";会话29 实证(175 块 OCR / 12 时间戳重复 / 平台 UI+其他窗口污染 / 无 bbox 落库)。
204-
> 设计规格 [头脑风暴 OCR 屏卡体系](../archive/2026-08-20/brainstorming-ocr-screen-cards.md) · 架构决策 [ADR-015](../adr/ADR-015-screen-cards-ocr.md) · [v0.7.3 版本文档](../versions/v0.7.3.md)。
204+
> 设计规格 [头脑风暴 OCR 屏卡体系([ ] 已归档)](../archive/2026-08-20/brainstorming-ocr-screen-cards.md) · 架构决策 [ADR-015](../adr/ADR-015-screen-cards-ocr.md) · [v0.7.3 版本文档](../versions/v0.7.3.md)。
205205
> 裁决:路线 A+B+D(采集治理+屏ID+屏级合并+bbox 落库+行合并/版面角色+结构识别接线);笔记形态=屏段落+配图;AI 精修留给 v0.8.0。
206206
207207
| ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |

‎docs/versions/v0.7.3.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> **状态**: 开发中(2026-08-20 头脑风暴裁决完成;M1-M5 代码建设已提交——屏聚合纯函数/落库/在线屏分配/消费端/结构接线,1053 单测全绿;真机验收待执行)
44
> **目标**: 画面要点从"块流"升级为"屏卡"——屏级时间区间(00:02–03:23)+ 屏内版面组织(标题/正文/图注标签)+ 采集治理(前台过滤/平台 UI 黑名单)+ 结构识别接线(表格/公式/代码)
5-
> **关联**: [头脑风暴 OCR 屏卡体系](../archive/2026-08-20/brainstorming-ocr-screen-cards.md) · [ADR-015](../adr/ADR-015-screen-cards-ocr.md)(架构决策)· [需求池](../product/requirements-pool.md)(REQ-155~161)
5+
> **关联**: [头脑风暴 OCR 屏卡体系([ ] 已归档)](../archive/2026-08-20/brainstorming-ocr-screen-cards.md) · [ADR-015](../adr/ADR-015-screen-cards-ocr.md)(架构决策)· [需求池](../product/requirements-pool.md)(REQ-155~161)
66
> **触发**: 用户反馈"画面要点(OCR)提取的内容零碎(时间整理和识别内容)";会话29 实证(175 块 OCR / 12 时间戳重复 / 平台 UI+其他窗口污染 / 无 bbox 落库)
77
88
## 一、阶段目标

0 commit comments

Comments
 (0)