Skip to content

Commit 6ac2aac

Browse files
AparenciaAparencia
committed
docs(archive): archive 2026-08-23
六轮：v0.12.7 会话内部 ID 不外显 + v0.12.8 笔记列表级批量删除交付后技术债滚动——未偿 6 笔保持 carried，已偿 0 笔，新登记 open 0 笔（全部审查问题即修 c66df9c）；观察项新增 v0.12.7-1/v0.12.8-1；无文档移入归档夹（versions/ 不归档类 + 无新 spec/ADR）；候选 spec（v0.11 系列/画面要点序号/ai-platform）判读登记保持活跃。
1 parent c66df9c commit 6ac2aac

3 files changed

Lines changed: 45 additions & 3 deletions

File tree

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

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,3 +123,35 @@
123123
- v0.12.6 一提交（001d148：浮窗预创建隐藏修复 + 浮窗出现→主窗隐藏/收起→回显 + ADR-025 全局快捷键 Ctrl+Shift+F 自解锁 + float_toggle 单一语义 + 浮窗 CSS 重置 + 状态机单测）
124124
- 审查即修一提交（30a7502）
125125
- 验证：cargo check 零错误 / clippy 五轮零新增（存量 5 项与四轮一致）/ cargo test v0.12.5 全量 1550 通过（3 项既有失败与本版无关；应用运行期测试 exe 加载 onnxruntime.dll 环境问题仍存）/ tsc 零错误 / vitest 92 通过（新增 RefineWorkbench 4 项）/ 前端 build 通过
126+
127+
---
128+
129+
# 六轮归档（v0.12.7 + v0.12.8 交付 + 新增代码七维审查 + 滚动）
130+
131+
> 归档说明：同日六轮。v0.12.7/v0.12.8 交付文档属"不归档"类别（[v0.12.7 版本文档](../../versions/v0.12.7.md) / [v0.12.8 版本文档](../../versions/v0.12.8.md) 属 versions/ 规则且未发布——发布后按"已发布版本的规划文档"补归档；本批无新增 spec/ADR/调研文档，用户 docs(product)/docs(v0.13)/docs(Foresight) 系列与 Foresight 调研均活跃或未开发），**无文档移入归档夹**；本日六轮 = 技术债滚动 + 索引建立。
132+
133+
## 归档内容（六轮）
134+
135+
无。
136+
137+
- [v0.12.7 版本文档](../../versions/v0.12.7.md)：**不归档**（versions/ 内容规则；未发布）
138+
- [v0.12.8 版本文档](../../versions/v0.12.8.md)：**不归档**（versions/ 内容规则；未发布）
139+
- **候选保持活跃（登记防丢失）**：
140+
- [v0.11 笔记组与学习循环设计 spec](../../superpowers/specs/2026-08-22-v0.11-note-group-learning-loop-design.md)：v0.11 系列真机验收待执行 + 文档范围止于 v0.11.3 而系列含 v0.11.4——随 v0.11 验收轮归档
141+
- [画面要点 OCR 价值 + 会话/笔记序号补位 spec](../../superpowers/specs/2026-08-21-screen-ocr-value-and-display-no-design.md)：§4 序号（会话序号已落地 display_no、**笔记序号未落地**）——部分实施，保持活跃
142+
- [v0.11.6 AI 平台化设计 spec](../../superpowers/specs/2026-08-22-v0.11.6-ai-platform-design.md)：M2/M3 未启动，保持活跃
143+
- v0.13.1 体系基建 spec、docs/v0.13 系列、Foresight 知识体系调研：活跃（开发未启动，调研使命未终结）
144+
- **排除**：`docs/product/theme.md` / `ui-ux-system.md`（未 git 跟踪，前置条件不满足；且为活跃产品文档）
145+
146+
## 技术债摘要（六轮）
147+
148+
- 未偿 6 笔保持 carried（TD-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-C / TD-2026-08-22-A），本批纯前端改动未触及存量债模块；TD-2026-08-22-A（clippy 存量）零 Rust 变更自动保持
149+
- 已偿 0 笔；新增代码七维审查：接入/牵连/性能/冗余/安全通过；逻辑性 P2×1（勾选未随视图裁剪）+ 规范 P3×2（注释版本标签/豁免登记）即修（c66df9c），不立债
150+
- 新登记 open 0 笔；观察项新增 2 项（v0.12.7-1 任务中心 refine 行无标识符 / v0.12.8-1 批量删除成功无正反馈）
151+
152+
## 本日六轮交付
153+
154+
- v0.12.7 一提交（587720e：会话内部 ID 不外显——9 处「会话 #N」移除，保留 display_no 显示序号）
155+
- v0.12.8 一提交（4ef7e85：笔记列表级批量删除——行内勾选 + 底部批量操作栏，与会话管理台同操作逻辑）
156+
- 审查即修一提交（c66df9c：勾选视图裁剪安全边界 + 注释/豁免同步 + NoteListView 5 项交互单测）
157+
- 验证：tsc 零错误 / vitest 97 通过（新增 NoteListView 5 项，此前 92）/ 前端 build 通过

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

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
1-
# 技术债清单（权威：2026-08-23 · 五轮）
1+
# 技术债清单（权威：2026-08-23 · 六轮）
22

33
> 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。
44
> 来源：2026-08-23 一轮（v0.12.0 七里程碑交付 + 新增代码七维审查，4 项即修 c624f4c）
55
> → 二轮（v0.12.3 浮窗死锁修复 + 交互/架构升级 + 精修工作台契约修复，新增代码七维审查，3 处即修 f8db9e2）
66
> → 三轮（**v0.12.2 笔记页信息架构重构交付 + 新增代码七维审查，8 处问题全部即修 fe8c919/f5731e1**）
77
> → 四轮（**v0.12.4 视频画面要点纯图落地 + 笔记预览锚点 chip 化交付 + 新增代码七维审查，零 P0/P1 缺陷、2 项 P3 观察不修；无文档归档**）
88
> → 五轮（**v0.12.5 AI 精修线路修复 + v0.12.6 浮窗显隐/锁定自解锁交付 + 新增代码七维审查，P1×1/P2×1/P3×1 即修 30a7502；无文档归档**）
9+
> → 六轮（**v0.12.7 会话内部 ID 不外显 + v0.12.8 笔记列表级批量删除交付 + 新增代码七维审查，P2×1/P3×2 即修 c66df9c；无文档归档**）
910
1011
## 未偿债务（逐笔保持 carried，仅留 ID + 一行摘要）
1112

@@ -30,6 +31,12 @@
3031
- **已偿 0 笔**：无旧债触及
3132
- **新登记 open 0 笔**：新增代码七维审查结论——接入性通过（float_toggle 注册/插件 handler/类型复用无孤立项）/ 逻辑性 P1（全局快捷键注册失败=锁定死局）与 P2（set_always_on_top 失败漂移）即修 30a7502 + P3（bar 双锁图标冗余）同批即修 / 牵连性通过（命令签名兼容、Cargo.lock 同步、文档/豁免登记/docs-check 一致）/ 性能通过 / 冗余通过（buildDataFromResult 中间产物零残留）/ 规范通过 / 安全通过（CSS 静态注入、快捷键 Rust 侧无前端权限面、无新 IPC 入参面）；4 项观察登记见下
3233

34+
## 本批滚动（2026-08-23 六轮：v0.12.7 会话内部 ID 不外显 + v0.12.8 笔记列表级批量删除 + 新增代码七维审查）
35+
36+
- **未偿 6 笔保持 carried**：TD-040（ffmpeg 体积）/ TD-2026-08-19-D/F/G（图库/暂停误报/OCR 搜索）/ TD-2026-08-21-C（lock().expect 迁移）/ TD-2026-08-22-A（clippy 存量 lib 5 项）本批未触及；本批为**纯前端改动（tsx/json/文档）**，TD-2026-08-22-A 自动保持
37+
- **已偿 0 笔**：无旧债触及
38+
- **新登记 open 0 笔**：新增代码七维审查结论——接入性通过（onBatchDelete 契约仅 NotesPage 消费、confirm 导入即用无孤立项）/ 逻辑性 P2（勾选集合未随视图变化裁剪——批量删除可波及当前视图外笔记）与规范性 P3×2（注释版本标签 v0.12.7→v0.12.8、NotesPage 行数豁免 334→361）即修 c66df9c / 牵连性通过（版本号/CHANGELOG/索引/豁免登记同步，NoteListView 唯一消费方已接线）/ 性能通过（批量勾选渲染与逐条删除均与会话管理台同级）/ 冗余通过（无导入/变量残留）/ 安全通过（无新 IPC 面、文案全静态、confirm 文本仅拼接数字计数）；2 项观察登记见下
39+
3340
## 观察项（登记不立债）
3441

3542
| ID | 摘要 | 处置 |
@@ -38,6 +45,8 @@
3845
| 观察 v0.12.5-2 | 同会话重复精修会产生第二条笔记（apply 恒新建，v0.11.5 现状） | 需求池评估"同会话复用笔记" |
3946
| 观察 v0.12.6-1 | 浮窗 toggle/按钮快速连按理论可交错（无动作级互斥锁——各操作幂等 + float:state 事件回流，最终状态一致） | 按反馈门控（必要时动作级锁） |
4047
| 观察 v0.12.6-2 | 主窗随浮窗打开隐藏后，浮窗无"退出应用"入口（设计内——收起即回主窗；全局键在任何焦点下可收起） | 保持（按反馈门控加退出键） |
48+
| 观察 v0.12.7-1 | AI 任务中心 refine 任务行去掉内部 id 后无标识符（多任务仅以时间/模型区分）——需求内（会话不外显 ID）；任务记录未快照 display_no（2026-08-21 序号设计 §D7 曾规划随任务快照） | 保持（价值低；若任务中心按反馈增强时再补快照） |
49+
| 观察 v0.12.8-1 | 批量删除全量成功无正反馈（列表行消失即为反馈；失败经 status 通道显式）——NotesPage 无 toast 基建，与单条删除现状一致 | 保持（按反馈门控加 toast） |
4150
| 观察 v0.12.4-1 | 视频会话大纲检测恒空（`detect_outline` 只消费 `region=="full"` 块，ADR-023 下线后无 full 块）——设计内行为，精修 vision 图片经 `load_session_vision_images` 独立读归档目录不受影响 | 真机验证确认后关闭 |
4251
| 观察 v0.12.4-2 | `import_frame.rs` 测试 `middle_region_crops_and_scales_to_max_width` 注释文案残留"中部区域（画面要点）"（中区域 OCR 已删，纯函数仍被字幕带复用）——文案性残留非代码缺陷 | 后续文档治理轮顺手清理 |
4352
| 观察 v0.12.0-1 | M4 仅 commands_ai_providers env 改 DEEPSEEK_API_KEY；ai_client / ai_balance / ai_refine_task / ai_text_filter 等 legacy 单 Provider 路径仍读 SILICONFLOW_API_KEY（昨日观察 M1-1/M1-4 延续） | 专项退役或后序范围 |
@@ -54,6 +63,6 @@
5463

5564
## 关联
5665

57-
- 版本与需求：[v0.12.0 版本文档](../../versions/v0.12.0.md) / [v0.12.2 版本文档](../../versions/v0.12.2.md) / [v0.12.3 版本文档](../../versions/v0.12.3.md) / [v0.12.5 版本文档](../../versions/v0.12.5.md) / [v0.12.6 版本文档](../../versions/v0.12.6.md)
66+
- 版本与需求：[v0.12.0 版本文档](../../versions/v0.12.0.md) / [v0.12.2 版本文档](../../versions/v0.12.2.md) / [v0.12.3 版本文档](../../versions/v0.12.3.md) / [v0.12.5 版本文档](../../versions/v0.12.5.md) / [v0.12.6 版本文档](../../versions/v0.12.6.md) / [v0.12.7 版本文档](../../versions/v0.12.7.md) / [v0.12.8 版本文档](../../versions/v0.12.8.md)
5867
- 决策：ADR-021（正文源多态）/ ADR-022（WGC 三级链）/ ADR-023（视频 OCR 下线 + vision 精修）/ ADR-025（浮窗锁定自解锁——全局快捷键方案）
59-
- 验证：cargo check（v0.12.5/v0.12.6/审查批零错误）/ cargo clippy（五轮零新增告警，存量 5 项与四轮一致）/ cargo test（v0.12.5 全量 1550 通过 3 项既有失败——ai_client from_settings / note_filter golden session29 / ocr_points 过滤器，HEAD 基线与本版无关；v0.12.6 批 float_next_action_machine 新增；测试二进制加载期环境问题在应用运行中仍存——应用进程占用 onnxruntime.dll 时 lib 测试 exe 报 STATUS_ENTRYPOINT_NOT_FOUND，属本机环境非代码问题）；tsc 零错误 / vitest 92 通过 / 前端 build 通过
68+
- 验证：cargo check（v0.12.5/v0.12.6/审查批零错误）/ cargo clippy（五轮零新增告警，存量 5 项与四轮一致）/ cargo test（v0.12.5 全量 1550 通过 3 项既有失败——ai_client from_settings / note_filter golden session29 / ocr_points 过滤器，HEAD 基线与本版无关；v0.12.6 批 float_next_action_machine 新增；测试二进制加载期环境问题在应用运行中仍存——应用进程占用 onnxruntime.dll 时 lib 测试 exe 报 STATUS_ENTRYPOINT_NOT_FOUND，属本机环境非代码问题）；tsc 零错误（六轮前后）/ vitest 97 通过（六轮新增 NoteListView 5 项，此前 92）/ 前端 build 通过（六轮）

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,3 +95,4 @@ docs/archive/
9595
| 2026-08-23（三轮） | v0.12.2 笔记页信息架构重构交付（483ad4e/82ca3d8/027ca6a：三栏拆分+收件箱动线+ⓘ 弹层+新建去摩擦；promote_fragment_to_note/card + feedCapture 转正）+ 新增代码七维审查 8 处即修（fe8c919 HIGH 伪事务半态/f5731e1 MED 弹层串组+搜索态竞态等）；无文档归档（v0.12.2 属 versions/ 不归档类且未发布，无新 spec/ADR）；累计已偿 112 笔 + v0.12.2 即修 8 项 | TD-040 + TD-D/F/G/C + TD-2026-08-22-A（carried 6 笔），共 6 笔 |
9696
| 2026-08-23（四轮） | v0.12.4 交付（52f4958/5b67c77/911e539/704bdf1：视频画面要点纯图落地——删直播/导入两条残留 region OCR + 关键帧纯图归档 + 展示层按 kind 分派；笔记预览时间戳锚点 chip 化）+ 新增代码七维审查：接入/性能/冗余/规范/安全通过，逻辑性 1 P1（视频大纲恒空=ADR-023 设计内行为，已补文档）+1 P3（正则尾 ] 残渣无触发不修），零即修；无文档归档（versions/ 与生效 ADR 属不归档类）；累计已偿 112 笔 | TD-040 + TD-D/F/G/C + TD-2026-08-22-A（carried 6 笔），共 6 笔 + 观察 v0.12.4-1/2 |
9797
| 2026-08-23（五轮） | v0.12.5+v0.12.6 交付（6fd4d1e 精修工作台三级数据源+线路优化 / 001d148 浮窗显隐链路修复+ADR-025 锁定自解锁+CSS 重置）+ 新增代码七维审查：P1×1（快捷键注册失败死局）/P2×1（打开漂移）/P3×1（bar 双锁）全部即修（30a7502）；无文档归档（versions/ 与生效 ADR 属不归档类；用户 product/v0.13/Foresight 系列活跃）；累计已偿 112 笔 | TD-040 + TD-D/F/G/C + TD-2026-08-22-A（carried 6 笔），共 6 笔 + 观察 v0.12.5-1/2、v0.12.6-1/2 |
98+
| 2026-08-23（六轮） | v0.12.7 会话内部 ID 不外显（587720e，9 处「会话 #N」移除，保留 display_no）+ v0.12.8 笔记列表级批量删除（4ef7e85，行内勾选+底部批量栏，与会话管理台同操作逻辑）+ 新增代码七维审查：接入/牵连/性能/冗余/安全通过，逻辑性 P2×1（勾选未随视图裁剪）+ 规范 P3×2（注释版本标签/豁免登记）即修（c66df9c，含 NoteListView 5 项单测）；无文档归档（versions/ 不归档类 + 无新 spec/ADR）；候选 spec 判读登记（v0.11 系列/画面要点序号/ai-platform——部分实施或待验收，保持活跃） | TD-040 + TD-D/F/G/C + TD-2026-08-22-A（carried 6 笔），共 6 笔 + 观察 v0.12.7-1、v0.12.8-1 |

0 commit comments

Comments
 (0)