Skip to content

Commit b58e685

Browse files
committed
docs(archive): 归档 v0.13 系列 Foresight 文档 4 份并同步活跃区引用
1 parent bcf6783 commit b58e685

16 files changed

Lines changed: 95 additions & 31 deletions

‎docs/Foresight/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,11 @@
2323
| [long-term-optimization-inventory.md](./long-term-optimization-inventory.md) | 长期优化清单——全面调研汇总(2026-08-20:六源合并,v0.8.0 AI 线之后批次的排期输入) |
2424
| [long-term-optimization-checklist.md](./long-term-optimization-checklist.md) | 长期优化完整清单——规则/阈值/词表持续校准项(2026-08-20:代码↔文档↔git 三方核验;与 inventory 互补) |
2525
| [v4-roadmap-build-order-analysis.md](./v4-roadmap-build-order-analysis.md) | v4 路线图代码建设顺序规划(2026-08-22 重新规划版,取代 v3 版:pain-points-v4 §11 Phase 1-4 ↔ 代码实态盘点 → Step 0~7 建设顺序 + 理论节点映射/反动机App化约束/统一指标埋点三增量,待裁决立项) |
26-
| [competitive-analysis-knowledge-system-layer.md](./competitive-analysis-knowledge-system-layer.md) | 竞品调研:知识体系层与学习闭环赛道(2026-08-23:五层竞品地图 + 定价锚点 + 「应用/决策」零竞品带判读;v0.13 立项依据) |
27-
| [competitive-analysis-knowledge-system-software.md](./competitive-analysis-knowledge-system-software.md) | 知识体系类软件调研:第二大脑/PKM 赛道细分(2026-08-23:五流派图谱 + 四件套支持度对比 + 方法论空白在"检验"不在"组织";含上轮结论修订与 v0.13 spec 输入) |
26+
| [competitive-analysis-knowledge-system-layer.md([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-layer.md) | 竞品调研:知识体系层与学习闭环赛道(2026-08-23:五层竞品地图 + 定价锚点 + 「应用/决策」零竞品带判读;v0.13 立项依据——v0.13 系列已交付,2026-08-28 归档) |
27+
| [competitive-analysis-knowledge-system-software.md([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-software.md) | 知识体系类软件调研:第二大脑/PKM 赛道细分(2026-08-23:五流派图谱 + 四件套支持度对比 + 方法论空白在"检验"不在"组织";含上轮结论修订与 v0.13 spec 输入——v0.13 系列已交付,2026-08-28 归档) |
2828
| [competitive-analysis-personal-library.md](./competitive-analysis-personal-library.md) | 个人电子图书馆调研(2026-08-23,未排期:五层地图——书库管理/书店平台/摄取回顾/文献库/AI 问书;Pocket 关停与 Omnivore sunset 退潮信号;"管书"与"助学"断裂带与熵减同构) |
29-
| [personal-knowledge-system-layer-integration.md](./personal-knowledge-system-layer-integration.md) | 整合分析·方案 B:个人知识体系指南 × 熵减(2026-08-23:范式判断/映射总表/数据模型概要/理念修订提案/防线扩展;已裁决落位 v0.13 系列) |
30-
| [source-personal-knowledge-system-guide-v2.md](./source-personal-knowledge-system-guide-v2.md) | 指南源文档存档(用户提供《个人知识体系搭建指南(综合版)》v2.0 原文) |
29+
| [personal-knowledge-system-layer-integration.md([ ] 已归档)](../archive/2026-08-28/personal-knowledge-system-layer-integration.md) | 整合分析·方案 B:个人知识体系指南 × 熵减(2026-08-23:范式判断/映射总表/数据模型概要/理念修订提案/防线扩展;已落位 v0.13 系列并交付,2026-08-28 归档) |
30+
| [source-personal-knowledge-system-guide-v2.md([ ] 已归档)](../archive/2026-08-28/source-personal-knowledge-system-guide-v2.md) | 指南源文档存档(用户提供《个人知识体系搭建指南(综合版)》v2.0 原文——随整合分析一并归档,2026-08-28) |
3131
| [brainstorming-classroom-assistant-gaps.md([ ] 已归档)](../archive/2026-08-19/brainstorming-classroom-assistant-gaps.md) | 课堂助手缺口评估:提取 / 性能 / 算法 / 体验 四维头脑风暴(2026-08:50 项机制评估;§9 裁决 22 项已排期 v0.6.0 → REQ-059~080;未选与远期项保留于归档副本待议) |
3232
| [brainstorming-video-types.md([ ] 已归档)](../archive/2026-08-19/brainstorming-video-types.md) | 视频类型 × 提取优化 × 图片配套 × 结构预处理 × 产物形态 × 补缝式 AI 头脑风暴(2026-08-18:六轮,已采纳进 v0.5.0;2026-08-19 归档) |
3333
| [2026-08-19-ocr-trigger-redesign.md([ ] 已归档)](../archive/2026-08-19/2026-08-19-ocr-trigger-redesign.md) | OCR 触发重做与 UI 面板抑制设计规格(2026-08-19:ADR-011/REQ-086/087 已实施 M1-M3,659 单测全绿,M4 真机验收待执行;2026-08-19 归档) |

‎docs/adr/ADR-024-knowledge-system-layer.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@
1010

1111
## 背景
1212

13-
用户提供《个人知识体系搭建指南 v2.0》(问题树/概念三问一用/模型交叉验证/决策日志/季度审计五环),要求整合进熵减。经范式判断([整合分析](../Foresight/personal-knowledge-system-layer-integration.md)):指南是 KM 范式+获取隐喻,熵减是学习科学+成为隐喻;两者**闭环互补**(指南缺记忆发动机与证据层,熵减缺"为什么学"与"应用闭环"),但指南的"知识资产/双链/多领域体系"要素与熵减现有裁决直接冲突:
13+
用户提供《个人知识体系搭建指南 v2.0》(问题树/概念三问一用/模型交叉验证/决策日志/季度审计五环),要求整合进熵减。经范式判断([整合分析([ ] 已归档)](../archive/2026-08-28/personal-knowledge-system-layer-integration.md)):指南是 KM 范式+获取隐喻,熵减是学习科学+成为隐喻;两者**闭环互补**(指南缺记忆发动机与证据层,熵减缺"为什么学"与"应用闭环"),但指南的"知识资产/双链/多领域体系"要素与熵减现有裁决直接冲突:
1414

1515
- 原则 4 克制清单:知识图谱/双链不做([P13 出局](../product/pain-points-v4.md));不做 Notion 式通用工作区。
1616
- 契约一:组粒度对齐领域、拒绝大类;组是唯一容器。
17-
- 竞品调研([赛道全景](../Foresight/competitive-analysis-knowledge-system-layer.md)+[品类深化](../Foresight/competitive-analysis-knowledge-system-software.md)):「提取→记忆→应用→决策」完整闭环无人做;整合型「概念/模型↔决策日志↔审计」为零竞品带(独立决策日志 App 存在但孤立);方法论空白在"**检验**"(知识是否被用、决策是否变好)而非"组织"——卡片盒/PARA/MOC 全部只回答"怎么存、怎么找"。
17+
- 竞品调研([赛道全景([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-layer.md)+[品类深化([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-software.md)):「提取→记忆→应用→决策」完整闭环无人做;整合型「概念/模型↔决策日志↔审计」为零竞品带(独立决策日志 App 存在但孤立);方法论空白在"**检验**"(知识是否被用、决策是否变好)而非"组织"——卡片盒/PARA/MOC 全部只回答"怎么存、怎么找"。
1818

1919
## 决策
2020

@@ -80,7 +80,7 @@
8080

8181
## 参考
8282

83-
- [整合分析·方案 B](../Foresight/personal-knowledge-system-layer-integration.md)
84-
- [竞品调研·赛道全景](../Foresight/competitive-analysis-knowledge-system-layer.md)/[品类深化](../Foresight/competitive-analysis-knowledge-system-software.md)
83+
- [整合分析·方案 B([ ] 已归档)](../archive/2026-08-28/personal-knowledge-system-layer-integration.md)
84+
- [竞品调研·赛道全景([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-layer.md)/[品类深化([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-software.md)
8585
- [v0.13 系列文档](../versions/v0.13.md)
86-
- [指南源文档](../Foresight/source-personal-knowledge-system-guide-v2.md)
86+
- [指南源文档([ ] 已归档)](../archive/2026-08-28/source-personal-knowledge-system-guide-v2.md)

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

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# 归档索引:2026-08-28
2+
3+
> 当日归档快照——不可变、仅可阅读;债务权威见 [tech-debt.md](./tech-debt.md)。
4+
5+
## 归档清单
6+
7+
| 源路径 | 归档路径 | 归档原因/状态 |
8+
|--------|---------|--------------|
9+
| docs/Foresight/competitive-analysis-knowledge-system-layer.md | [./competitive-analysis-knowledge-system-layer.md](./competitive-analysis-knowledge-system-layer.md) | v0.13 系列立项依据——v0.13.1~9 代码已交付,立项使命完成([ ] 已归档) |
10+
| 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 系列已交付,调研使命完成([ ] 已归档) |
11+
| 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 交付),生命周期终结([ ] 已归档) |
12+
| docs/Foresight/source-personal-knowledge-system-guide-v2.md | [./source-personal-knowledge-system-guide-v2.md](./source-personal-knowledge-system-guide-v2.md) | 指南源文档——整合分析的对象原文,随整合分析一并归档([ ] 已归档) |
13+
14+
## 当日交付摘要
15+
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 只读不改)
18+
19+
## 技术债摘要
20+
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,登记不立债)

docs/Foresight/competitive-analysis-knowledge-system-layer.md renamed to docs/archive/2026-08-28/competitive-analysis-knowledge-system-layer.md

File renamed without changes.

docs/Foresight/competitive-analysis-knowledge-system-software.md renamed to docs/archive/2026-08-28/competitive-analysis-knowledge-system-software.md

File renamed without changes.

docs/Foresight/personal-knowledge-system-layer-integration.md renamed to docs/archive/2026-08-28/personal-knowledge-system-layer-integration.md

File renamed without changes.

docs/Foresight/source-personal-knowledge-system-guide-v2.md renamed to docs/archive/2026-08-28/source-personal-knowledge-system-guide-v2.md

File renamed without changes.
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# 技术债清单(权威:2026-08-28)
2+
3+
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
4+
> 来源:2026-08-28(纯文档归档日:v0.13 知识体系层系列 4 份 Foresight 文档生命周期终结移入归档夹;无代码改动,债务全量继承 2026-08-25)
5+
6+
## 未偿债务
7+
8+
| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 |
9+
|----|------|------|--------|----------|------|
10+
| TD-040 | bundle.resources 未含 ffmpeg(deliberate 有意不修:体积权衡) | 有意 | P2 | 2026-08-18 | carried |
11+
| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110/123/088) | 有意 | P2 | 2026-08-19 | carried |
12+
| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容可能误报暂停 | 无意 | P3 | 2026-08-19 | carried |
13+
| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验存在性 | 无意 | P2 | 2026-08-19 | carried |
14+
| TD-2026-08-21-C | db_sessions/db_ai_tasks 的 lock().expect 未迁移 with_conn | 无意 | P3 | 2026-08-21 | carried |
15+
| TD-2026-08-22-A | clippy --all-targets -D warnings 未绿(存量项;后续交付批均零新增) | 无意 | P3 | 2026-08-22 | carried |
16+
| TD-2026-08-24-A | lib.rs(712 行)/ live_session_frame.rs(683 行)超 600 硬限——拆分计划顺延下一窗口 | 有意 | P1 | 2026-08-24 | carried |
17+
| TD-2026-08-24-B | RouteInfoPopover sysBrief 仅查 groupLinks[0] 体系——多体系组其余体系的概念失效不提示 | 无意 | P2 | 2026-08-24 | carried |
18+
| TD-2026-08-24-C | KnowledgePage KnowledgeSampleView refreshGlobal={0} 恒传死参数 | 无意 | P3 | 2026-08-24 | carried |
19+
20+
## 今日已偿
21+
22+
无(本批为纯文档归档,未触及代码债务)。
23+
24+
## 审查观察项(登记不立债)
25+
26+
| ID | 摘要 | 处置 |
27+
|----|------|------|
28+
| 观察 v0.13.9-1 | smartEdges 拖拽每帧 O(边数×节点数) 重算(useMemo 内 find)——节点 <100 微秒级 | 保持(画布规模增长后改 Map 索引) |
29+
| 观察 v0.13.9-2 | textarea 可视区定位在 soft-wrap 下按 scrollTop 比例近似(长行折行误差)——已校正到行首 | 保持(精确逐行测高成本高收益低) |
30+
| 观察 v0.13.9-3 | 可视区定位对所有工具栏插入类操作统一生效(设计文档原述标题类)——一致性改进,注释已明确口径 | 保持(行为更优,文档已同步) |
31+
| 观察 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 | 待专项治理(与归档无关,避免本批范围蔓延) |
32+
33+
## 验证记录
34+
35+
- docs-check 链接校验通过(归档后活跃区引用全部改指归档路径)
36+
37+
## 关联
38+
39+
- 版本与需求:[v0.13 系列文档](../../versions/v0.13.md)(已交付 v0.13.1~9)
40+
- 归档快照:[2026-08-28 README](./README.md) · [整合分析·方案 B(已归档 [ ] 已归档)](./personal-knowledge-system-layer-integration.md) · [竞品调研(赛道全景/品类深化,已归档)](./competitive-analysis-knowledge-system-layer.md)

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,3 +100,4 @@ docs/archive/
100100
| 2026-08-24(二轮) | v0.13.7 交付(15 提交:触点①②③ + 示例体系 + 具象化 + 纪律裁决 + 跨页跳转 + 文档同步 + 审查 Critical 修复)+ 新增代码七维审查:接入/牵连/性能/冗余/规范/安全全部通过,逻辑性 2 项登记 open(多体系组 stale 判定不全 / refreshGlobal 未接线);vitest 30 文件 156 用例全绿 + tsc 零错误 + vite build 通过;v0.13.7 设计规格与实施计划归档([ ] 已归档) | TD-2026-08-24-B(open P2)+ TD-2026-08-24-C(open P3)+ 继承一轮 7 笔,共 9 笔 |
101101
| 2026-08-24(三轮) | v0.13.8 画布交付(4 提交:数据层 canvas_x/y+视口表 / 4 命令 / 辐射布局+画布视图+双入口 / 文档同步)+ 新增代码七维审查:接入/牵连/性能/冗余/规范/安全全部通过,逻辑性高×1(重挂载拖拽位置被辐射重算覆盖)/ 中×1(框选批量移动未持久化)/ 低×1(测试死分支)即修 6464abd + 回归测试;cargo knowledge 151/151 + vitest 34 文件 189 用例全绿 + tsc 零错误;v0.13.8 设计规格归档([ ] 已归档) | TD-2026-08-24-A(open,拆分计划顺延)+ TD-24-B/C(open)+ 继承 6 carried,共 9 笔 |
102102
| 2026-08-25 | v0.13.9 交付(笔记编辑 H1 跳顶修复 / 问题树层级+引导线 / 画布体系根卡+类型 chip+接线动态化 / RING_STEP 160,209 单测全绿 + tsc 零错误 + vite build 通过)+ 新增代码七维审查:接入/牵连/性能/冗余/规范/安全通过,逻辑性 P1×1(typeColor 双处重复→提取 nodeTypeColor)/P2×2(表单缩进/注释口径)即修;v0.13.9 设计规格归档([ ] 已归档,创建当日即入夹,补充提交入库) | 继承 9 笔 carried,无增减 |
103+
| 2026-08-28 | v0.13 知识体系层系列 Foresight 文档归档 4 份([ ] 已归档:整合分析·方案 B + 竞品调研赛道全景/品类深化 + 指南源文档——v0.13.1~9 交付后生命周期终结,git mv 保留历史)+ 活跃区引用同步(versions/v0.13.md、requirements-pool、设计理念、ADR-024、v0.13.1~4 specs、Foresight README);纯文档归档无代码改动 | 继承 9 笔 carried,无增减 |

‎docs/product/knowledge-system-design-philosophy.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
> 本文档阐述熵减知识体系层的设计哲学——不是知识仓库,不是第二大脑模板,
44
> 而是一个**围绕真实问题组织学习、以使用为检验的决策操作系统**。
5-
> 关联:[ADR-024](../adr/ADR-024-knowledge-system-layer.md) · [整合分析·方案 B](../Foresight/personal-knowledge-system-layer-integration.md) ·
6-
> [竞品调研·品类深化](../Foresight/competitive-analysis-knowledge-system-software.md) ·
7-
> [pain-points-v4](./pain-points-v4.md)(L2 体系枝)· [指南源文档](../Foresight/source-personal-knowledge-system-guide-v2.md)
5+
> 关联:[ADR-024](../adr/ADR-024-knowledge-system-layer.md) · [整合分析·方案 B([ ] 已归档)](../archive/2026-08-28/personal-knowledge-system-layer-integration.md) ·
6+
> [竞品调研·品类深化([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-software.md) ·
7+
> [pain-points-v4](./pain-points-v4.md)(L2 体系枝)· [指南源文档([ ] 已归档)](../archive/2026-08-28/source-personal-knowledge-system-guide-v2.md)
88
> 分工:本文档是知识体系模块的**子理念**;顶层哲学以 [product-design-philosophy.md](./product-design-philosophy.md) 为准——凡冲突,改设计或改理念,不允许静默并存。
99
1010
---
@@ -126,7 +126,7 @@ P13(知识图谱出局)排的是"**连成网**"作为增长机制——失
126126
## 八、参考
127127

128128
- [ADR-024](../adr/ADR-024-knowledge-system-layer.md):裁决(有界体系通过、P13 重裁决、红线)
129-
- [整合分析·方案 B](../Foresight/personal-knowledge-system-layer-integration.md):映射总表/数据模型/防线
130-
- [竞品调研·品类深化](../Foresight/competitive-analysis-knowledge-system-software.md):方法论空白在"检验";模板不是体系;Roam 低锁定教训
129+
- [整合分析·方案 B([ ] 已归档)](../archive/2026-08-28/personal-knowledge-system-layer-integration.md):映射总表/数据模型/防线
130+
- [竞品调研·品类深化([ ] 已归档)](../archive/2026-08-28/competitive-analysis-knowledge-system-software.md):方法论空白在"检验";模板不是体系;Roam 低锁定教训
131131
- [v0.13 系列](../versions/v0.13.md):落地路线(v0.13.0~4)
132-
- [指南源文档](../Foresight/source-personal-knowledge-system-guide-v2.md):方法论来源(五环/三问一用/四行法/审计清单)
132+
- [指南源文档([ ] 已归档)](../archive/2026-08-28/source-personal-knowledge-system-guide-v2.md):方法论来源(五环/三问一用/四行法/审计清单)

0 commit comments

Comments
 (0)