Skip to content

Commit 6a0d54e

Browse files
committed
docs(archive): archive 2026-08-28
1 parent 15f306e commit 6a0d54e

7 files changed

Lines changed: 28 additions & 12 deletions

docs/superpowers/specs/2026-08-27-v0.14-editor-experience-design.md renamed to docs/archive/2026-08-28/2026-08-27-v0.14-editor-experience-design.md

File renamed without changes.

docs/superpowers/specs/2026-08-28-v0.14-capture-quality-design.md renamed to docs/archive/2026-08-28/2026-08-28-v0.14-capture-quality-design.md

File renamed without changes.

docs/superpowers/specs/2026-08-28-v0.14-knowledge-system-design.md renamed to docs/archive/2026-08-28/2026-08-28-v0.14-knowledge-system-design.md

File renamed without changes.

docs/superpowers/specs/2026-08-28-v0.14-visual-system-design.md renamed to docs/archive/2026-08-28/2026-08-28-v0.14-visual-system-design.md

File renamed without changes.

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

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,20 @@
1010
| docs/Foresight/competitive-analysis-knowledge-system-software.md | [./competitive-analysis-knowledge-system-software.md](./competitive-analysis-knowledge-system-software.md) | v0.13 体系层 spec 输入——v0.13 系列已交付,调研使命完成([ ] 已归档) |
1111
| docs/Foresight/personal-knowledge-system-layer-integration.md | [./personal-knowledge-system-layer-integration.md](./personal-knowledge-system-layer-integration.md) | 整合分析·方案 B——已批准并落位 v0.13 系列(v0.13.1~9 交付),生命周期终结([ ] 已归档) |
1212
| docs/Foresight/source-personal-knowledge-system-guide-v2.md | [./source-personal-knowledge-system-guide-v2.md](./source-personal-knowledge-system-guide-v2.md) | 指南源文档——整合分析的对象原文,随整合分析一并归档([ ] 已归档) |
13+
| docs/superpowers/specs/2026-08-27-v0.14-editor-experience-design.md | [./2026-08-27-v0.14-editor-experience-design.md](./2026-08-27-v0.14-editor-experience-design.md) | v0.14 A 编辑器 spec——已实施交付(7b01da58),生命周期终结([ ] 已归档) |
14+
| docs/superpowers/specs/2026-08-28-v0.14-visual-system-design.md | [./2026-08-28-v0.14-visual-system-design.md](./2026-08-28-v0.14-visual-system-design.md) | v0.14 B 视觉系统 spec——已实施交付(584a1dc1),生命周期终结([ ] 已归档) |
15+
| docs/superpowers/specs/2026-08-28-v0.14-knowledge-system-design.md | [./2026-08-28-v0.14-knowledge-system-design.md](./2026-08-28-v0.14-knowledge-system-design.md) | v0.14 C 知识体系 spec——已实施交付(584a1dc1),生命周期终结([ ] 已归档) |
16+
| docs/superpowers/specs/2026-08-28-v0.14-capture-quality-design.md | [./2026-08-28-v0.14-capture-quality-design.md](./2026-08-28-v0.14-capture-quality-design.md) | v0.14 D 采集质量 spec——已实施交付(584a1dc1,D4 ROI 接线登记 v0.14.1),生命周期终结([ ] 已归档) |
1317

1418
## 当日交付摘要
1519

16-
- **纯文档归档**(无代码改动):v0.13 知识体系层系列 4 份 Foresight 文档生命周期终结,移入归档夹(git mv 保留历史)
17-
- **活跃区索引同步**:Foresight/README.md、versions/v0.13.md、product/requirements-pool.md、product/knowledge-system-design-philosophy.md、adr/ADR-024、superpowers/specs v0.13.1~4 引用链接改指归档路径并标 `[ ] 已归档`(已归档的 v0.13.7 onboarding-design 只读不改)
20+
- **v0.14 A/B/C/D 设计规格归档 4 份**(代码已交付,生命周期终结):编辑器体验(A,7b01da58)+ 视觉系统(B)/知识体系(C)/采集质量(D,584a1dc1,D4 ROI 接线留 v0.14.1);git mv 保留历史
21+
- **活跃区索引同步**:versions/v0.14.md 子项目 A 设计规格链接与 B/C/D 状态表 spec 链接改指归档路径并标 `[ ] 已归档`
22+
- 上午批(v0.13 系列 4 份 Foresight):Foresight/README.md、versions/v0.13.md、requirements-pool、设计理念、ADR-024、v0.13.1~4 specs 引用同步(见本 README 既有记录)
1823

1924
## 技术债摘要
2025

21-
- 继承昨日(2026-08-25)9 笔未偿(TD-040 + TD-2026-08-19-D/F/G + TD-21-C + TD-22-A + TD-24-A/B/C)→ 全部 carried(本批纯文档,无代码触及)
22-
- 今日已偿:无
23-
- 观察项继承 3 条(v0.13.9-1/2/3,登记不立债)
26+
- 继承昨日 9 笔未偿(TD-040 + TD-2026-08-19-D/F/G + TD-21-C + TD-22-A + TD-24-A/B/C)→ 全部 carried(本批代码未触及这些区域;新增代码审查即修 5 项见 tech-debt.md 已偿)
27+
- 今日新增:TD-2026-08-28-A(chapter_quality_scores 每章全量扫描 + 文本克隆)/ TD-2026-08-28-B(incremental_merge O(n²) 线性 find,dead code 接线时修)→ open 2 笔
28+
- 今日已偿:5 笔(审查即修,提交 15f306e0)
29+
- 观察项:继承 3 条(v0.13.9-1/2/3)+ 新增 2 条(引擎重试无冷却 deliberate / D4 接线留 v0.14.1)

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

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# 技术债清单(权威:2026-08-28)
22

33
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
4-
> 来源:2026-08-28(纯文档归档日:v0.13 知识体系层系列 4 份 Foresight 文档生命周期终结移入归档夹;无代码改动,债务全量继承 2026-08-25)
4+
> 来源:2026-08-28(二轮:v0.14 A/B/C/D 实施交付 584a1dc1 + 新增代码审查即修 15f306e0;A/B/C/D 设计规格 4 份归档)
55
66
## 未偿债务
77

@@ -16,10 +16,18 @@
1616
| TD-2026-08-24-A | lib.rs(712 行)/ live_session_frame.rs(683 行)超 600 硬限——拆分计划顺延下一窗口 | 有意 | P1 | 2026-08-24 | carried |
1717
| TD-2026-08-24-B | RouteInfoPopover sysBrief 仅查 groupLinks[0] 体系——多体系组其余体系的概念失效不提示 | 无意 | P2 | 2026-08-24 | carried |
1818
| TD-2026-08-24-C | KnowledgePage KnowledgeSampleView refreshGlobal={0} 恒传死参数 | 无意 | P3 | 2026-08-24 | carried |
19+
| TD-2026-08-28-A | chapter_quality_scores 每章全量扫描 blocks(O(C×B))+ 每块文本克隆——正确性无影响,纯性能优化项 | 无意 | P3 | 2026-08-28 | open |
20+
| TD-2026-08-28-B | incremental_merge 循环内线性 find 导致 O(n²)——dead code 模块(已登记豁免),接线时(v0.14.1)修复 | 无意 | P3 | 2026-08-28 | open |
1921

2022
## 今日已偿
2123

22-
无(本批为纯文档归档,未触及代码债务)。
24+
| ID | 摘要 | 偿还提交 |
25+
|----|------|----------|
26+
| 审查 M1 | 净化链① merge_two 英文行合并词间空格丢失(单词粘连)——ascii_gap 补空格 + 2 单测 | 15f306e0 |
27+
| 审查 M2 | crop_line 无效 bbox 返回原图被送识别——rec_pipeline_on_blocks 过滤零宽高 bbox + 1 单测 | 15f306e0 |
28+
| 审查 L2 | engine_worker 不可达分支裸 return 会终止 OCR worker 主循环——改 continue | 15f306e0 |
29+
| 审查 L5 | 笔记删除后 knowledge_links 悬空引用(图谱悬空边)——delete_note 级联清理 target | 15f306e0 |
30+
| 审查 L6 | GroupSidebar setState updater 内写 localStorage——副作用移出至 useEffect | 15f306e0 |
2331

2432
## 审查观察项(登记不立债)
2533

@@ -29,6 +37,8 @@
2937
| 观察 v0.13.9-2 | textarea 可视区定位在 soft-wrap 下按 scrollTop 比例近似(长行折行误差)——已校正到行首 | 保持(精确逐行测高成本高收益低) |
3038
| 观察 v0.13.9-3 | 可视区定位对所有工具栏插入类操作统一生效(设计文档原述标题类)——一致性改进,注释已明确口径 | 保持(行为更优,文档已同步) |
3139
| 观察 2026-08-28-1 | docs-check 存量失效链接 18 处(本批归档零新增):v0.13.4/0.13.5 spec 相对路径笔误(`../superpowers/specs/` 应为 `./`)×4、v0.14 spec 代码片段 `path`/`src` 误检 ×3、v0.10.1/v0.12.0/v0.12.4 路径模板与 `[[ts:]]` 代码引用误检 ×11 | 待专项治理(与归档无关,避免本批范围蔓延) |
40+
| 观察 2026-08-28-2 | ensure_rec_engine 构建失败后每次请求重试完整模型加载(无冷却)——模型修复后自动恢复是收益 | 保持(deliberate:冷却会破坏自动恢复;影响面=异常场景重复失败加载) |
41+
| 观察 2026-08-28-3 | D4 平台 ROI 应用接线(platform_layout/layout_reorder 生产消费)留 v0.14.1——模板/兜底资产已就绪并登记豁免 | 待 v0.14.1 接线 |
3242

3343
## 验证记录
3444

‎docs/versions/v0.14.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ v0.13 知识体系层交付后,用户基于实际使用提出 **8+1 大痛点*
2020

2121
## 子项目 A:编辑器基础体验(CodeMirror 6)
2222

23-
设计规格:[2026-08-27-v0.14-editor-experience-design.md](../../docs/superpowers/specs/2026-08-27-v0.14-editor-experience-design.md)(已提交 d445b3cc)
23+
设计规格:[2026-08-27-v0.14-editor-experience-design.md](../../docs/archive/2026-08-28/2026-08-27-v0.14-editor-experience-design.md)([ ] 已归档——A 子项目实施完成,交付 7b01da58)
2424

2525
- **引擎**:CodeMirror 6 替换 textarea(选型演进:TipTap → CodeMirror 6——存储零变更、版本链零风险,编辑 Markdown 源码而非富文本)
2626
- **图片内联渲染**:`Decoration.replace` widget + React `createRoot` 挂载 NoteImage(点击放大保留);`destroy()` 必须 `root.unmount()`
@@ -130,9 +130,9 @@ v0.13 知识体系层交付后,用户基于实际使用提出 **8+1 大痛点*
130130

131131
| 子项目 | 状态 | 说明 |
132132
|---|---|---|
133-
| A 编辑器 | **代码已交付**(2026-08-28) | spec 已提交(d445b3cc);实施:CM 富编辑(图片内联/撤销/标题/草稿恢复/降级护栏),259 单测全绿,真机验收待执行 |
134-
| B 视觉系统 | **代码已交付**(2026-08-28) | 实施:tag_colors 迁移(db_colors 表 CRUD)+ colors 命令(list/set/reset)+ 前端 12 色色板/选择器/`==文本==` 高亮渲染/组色继承色条 |
135-
| C 知识体系 | **代码已交付**(2026-08-28) | 实施:C1 组侧栏 Obsidian 式(分区/拖拽/最近使用)/ C2 `graph_snapshot` 聚合 + 图谱页(三边图层/局部聚焦)/ C3 反查 + 挂接增强 + refreshToken |
136-
| D 采集质量 | **代码已交付**(2026-08-28) | 实施:D1 纯函数层(chapter_morph/ocr_quality/layout_reorder/line_merge/incremental_merge)/ D2 line_rec_engine + platform_layout + 净化链①②③ / D3 章节级混合形态组装 + 质量门控;D4 ROI 应用接线留 v0.14.1(模板/兜底资产已就绪) |
133+
| A 编辑器 | **代码已交付**(2026-08-28) | 实施:CM 富编辑(图片内联/撤销/标题/草稿恢复/降级护栏),259 单测全绿,真机验收待执行;[spec 已归档](../../docs/archive/2026-08-28/2026-08-27-v0.14-editor-experience-design.md) |
134+
| B 视觉系统 | **代码已交付**(2026-08-28) | 实施:tag_colors 迁移(db_colors 表 CRUD)+ colors 命令(list/set/reset)+ 前端 12 色色板/选择器/`==文本==` 高亮渲染/组色继承色条;[spec 已归档](../../docs/archive/2026-08-28/2026-08-28-v0.14-visual-system-design.md) |
135+
| C 知识体系 | **代码已交付**(2026-08-28) | 实施:C1 组侧栏 Obsidian 式(分区/拖拽/最近使用)/ C2 `graph_snapshot` 聚合 + 图谱页(三边图层/局部聚焦)/ C3 反查 + 挂接增强 + refreshToken;[spec 已归档](../../docs/archive/2026-08-28/2026-08-28-v0.14-knowledge-system-design.md) |
136+
| D 采集质量 | **代码已交付**(2026-08-28) | 实施:D1 纯函数层(chapter_morph/ocr_quality/layout_reorder/line_merge/incremental_merge)/ D2 line_rec_engine + platform_layout + 净化链①②③ / D3 章节级混合形态组装 + 质量门控;D4 ROI 应用接线留 v0.14.1(模板/兜底资产已就绪);[spec 已归档](../../docs/archive/2026-08-28/2026-08-28-v0.14-capture-quality-design.md) |
137137

138138
> 实施策略:用户裁决**并行推进**(A 实施已交付,B/C/D 设计完成后各自进入实施会话)。

0 commit comments

Comments
 (0)