Skip to content

Commit 1e80095

Browse files
committed
docs(v0.13): 理念修订批ADR-024与v0.13.1设计规格落位
1 parent 6fd4d1e commit 1e80095

6 files changed

Lines changed: 296 additions & 8 deletions

File tree

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# ADR-024: 知识体系层(方案 B)——有界体系通过、自由双链/图谱仍出局
2+
3+
## 状态
4+
5+
已接受(2026-08-23 用户裁决:B 模块新增型+全局/领域双层+保持技能自学者定位、理念局部修订;落位 v0.13 系列)
6+
7+
## 日期
8+
9+
2026-08-23
10+
11+
## 背景
12+
13+
用户提供《个人知识体系搭建指南 v2.0》(问题树/概念三问一用/模型交叉验证/决策日志/季度审计五环),要求整合进熵减。经范式判断([整合分析](../Foresight/personal-knowledge-system-layer-integration.md)):指南是 KM 范式+获取隐喻,熵减是学习科学+成为隐喻;两者**闭环互补**(指南缺记忆发动机与证据层,熵减缺"为什么学"与"应用闭环"),但指南的"知识资产/双链/多领域体系"要素与熵减现有裁决直接冲突:
14+
15+
- 原则 4 克制清单:知识图谱/双链不做([P13 出局](../product/pain-points-v4.md));不做 Notion 式通用工作区。
16+
- 契约一:组粒度对齐领域、拒绝大类;组是唯一容器。
17+
- 竞品调研([赛道全景](../Foresight/competitive-analysis-knowledge-system-layer.md)+[品类深化](../Foresight/competitive-analysis-knowledge-system-software.md)):「提取→记忆→应用→决策」完整闭环无人做;整合型「概念/模型↔决策日志↔审计」为零竞品带(独立决策日志 App 存在但孤立);方法论空白在"**检验**"(知识是否被用、决策是否变好)而非"组织"——卡片盒/PARA/MOC 全部只回答"怎么存、怎么找"。
18+
19+
## 决策
20+
21+
- **新增体系层(L2 飞轮层延伸枝,季/决策时钟)**:全局体系(唯一核心问题域+领域入口+场景问题)→ 领域体系(问题树/概念库/模型库);**组仍是唯一容器**,体系只引用、不收纳(`knowledge_links`,引用不复制)。
22+
- **P13 重裁决**:自由双链/图谱(任意连接+图可视化+图漫游)**仍出局**;**有界体系**(体系树+概念库+模型库+决策日志;引用限体系内及对证据的单向引用)**通过**。论证:P13 裁决的是优先序(骨折层>连接层)与"连接作为增长机制";体系层解决"围绕什么决策组织学习"(组织机制)+"为动手闭环提供记账本"(N12),不承担增长机制。
23+
- **双面体单向升格**:组内 `flashcards.kind='model'`(记忆面,REQ-199 预埋接口)↔ 体系概念(思辨面,三问一用),卡→概念单向升格;概念→卡不反向。
24+
- **决策/应用一表两面**:`knowledge_decisions.kind ∈ {decision, application}`(四行法字段+`used_refs` 引用必填);只记"我的决策"——产物层 `ArtifactKind::Decision` 禁止自动升格。
25+
- **审计=体系级结算**:季度触发(`settlement_due` 同范式);产出**建议**、用户确认后生效;无 streak、无惩罚(弹性承诺纪律延续)。
26+
- **门控**:REQ-146 真机验收总清(组级学习循环通过)为发布前置;开发可先行(v0.13.1 起),发布不放行。
27+
- **开关**:体系默认开(叙事层主枝);交叉点派生提示默认关(v0.13.4);AI 增强(卡→概念回填)默认关。
28+
- **零破坏**:既有表结构不动;`flashcards.kind` 补值 `model`;`metrics_events.kind` 新增 4 值。
29+
- **不做清单**:体系图谱可视化(力导向图,REQ-029 维持 P3);跨体系自由引用;全局概念库收纳内容;AI 自动生成决策/概念(AI 只建议不生成——假燃料红线);决策质量评级;领域体系嵌套;承接 REQ-030 学习计划系统。
30+
31+
## 备选方案
32+
33+
### 方案 A:机制提取型(原始建议,未采纳为终局)
34+
- 优点:零定位张力;全部落在预埋接口。
35+
- 缺点:只有"功能补丁",不承载"为什么学/怎么用"的叙事层职责;指南的体系化价值被降级为卡片增强。
36+
37+
### 方案 C:内容资产型(伴生保留)
38+
- 优点:最轻。
39+
- 缺点:指南只是内容,不是产品机制——"模板自律"仍是用户负担(PKM 高放弃率根因)。
40+
41+
### 方案 D:自由知识图谱(不做)
42+
- 优点:—。
43+
- 缺点:P13 出局(失败发生在人没回来的地方);Heptabase/Obsidian Graph/思源图谱已占位(品类深化调研);与"学习工具"定位冲突。
44+
45+
## 选择理由
46+
47+
用户裁决方案 B(模块新增型+双层),竞品调研验证:整合型「应用/决策」是唯一无人占据的闭环段,且"检验"是方法论级空白——这既是差异化,也是"AI 测量,人类见证"原则(人类判断领地)的产品化承载。有界体系在守住 P13 本意(不建图、不收内容、有审计、挂证据)的同时,把"模板自律"产品化(向导+四行模板+审计触发)——针对 PKM 品类的结构性痛点(搭建/维护成本高、放弃率高)。
48+
49+
## 影响
50+
51+
### 正面影响
52+
- 补齐 L1 缺失节点(动手闭环 N12 机制化)与 L2"为什么学"枝;学习链扩展为"…→自我叙事→决策判断"。
53+
- 首次把"应用率/决策引用"变成可测数据(metrics_events 新事件)——Phase 4 显影的差异化维度。
54+
- 零竞品带的先手:决策日志+审计+概念引用的整合闭环。
55+
56+
### 负面影响 / 代价
57+
- 双界面成本(体系页+学习面)——以三时钟纪律(体系不进每日视图)与单屏"树+审计"控制。
58+
- 体系沼泽化/假燃料放大器风险(体系漂亮、学习不动)——以门控+审计建议+思辨/学习动作并列报告防御。
59+
- 理念文档需同步修订(原则 4 表格/原则 5/pain-points §7.6/REQ-029)——本 ADR 为修订依据。
60+
61+
### 风险
62+
- Ramifly 类"AI 生成问题树"抢"问题树"心智——熵减差异=树长在学习证据上,AI 只建议不生成。
63+
- 记账负担(组结算+审计+决策+应用两本账)——一表两面+引用必填防膨胀。
64+
- 真机验收未过先建上层触发"假燃料"——门控条款保留至发布。
65+
66+
## 合规性验证
67+
68+
- `flashcards.kind='model'` 卡面契约(front=概念名/back=三问+锚点回链)落库生效;卡→概念升格单向且幂等。
69+
- `knowledge_decisions` 仅当 `used_refs` 引用体系实体非空时可入账(校验在 command 层+纯函数)。
70+
- 体系无内容入口(碎片/笔记只能先落组再被引用);审计建议须用户确认后变更状态。
71+
- 测试:pure 函数 TDD(audit_due/concept_stale/promote_rules golden)+ command 参数校验用例+真机走查(建体系→挂组→升格→用一次→审计→交叉点提示)。
72+
73+
## 相关决策
74+
75+
- P13 知识图谱出局(本 ADR 部分重裁决:有界体系通过)
76+
- 契约一/契约三(组粒度、组结算——审计的组级同构)
77+
- REQ-199(flashcards.kind=model 留接口——本 ADR 兑现)
78+
- ADR-018(FSRS:记忆面调度)
79+
- N12 动手闭环(本 ADR 以"应用记录"机制化)
80+
81+
## 参考
82+
83+
- [整合分析·方案 B](../Foresight/personal-knowledge-system-layer-integration.md)
84+
- [竞品调研·赛道全景](../Foresight/competitive-analysis-knowledge-system-layer.md)/[品类深化](../Foresight/competitive-analysis-knowledge-system-software.md)
85+
- [v0.13 系列文档](../versions/v0.13.md)
86+
- [指南源文档](../Foresight/source-personal-knowledge-system-guide-v2.md)

‎docs/adr/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@
2727
| ADR-021 | [笔记正文源多态——`detect_body_source` 抽象层(图文会话 OCR 进笔记正文)](./ADR-021-note-body-source-polymorphism.md) | 已接受(v0.12.0 M1,已交付) | 2026-08-23 |
2828
| ADR-022 | [WGC 窗口级捕获——三级降级链(WGC→DXGI→GDI)](./ADR-022-wgc-window-capture.md) | 已接受(v0.12.0 M2,已交付) | 2026-08-23 |
2929
| ADR-023 | [视频会话 OCR 下线 + AI 精修图片理解(含隐私授权契约)](./ADR-023-video-ocr-offline-vision-extract.md) | 已接受(v0.12.0 M5,精修侧已交付) | 2026-08-23 |
30+
| ADR-024 | [知识体系层(方案 B)——有界体系通过、自由双链/图谱仍出局](./ADR-024-knowledge-system-layer.md) | 已接受(v0.13 系列) | 2026-08-23 |
3031

3132
## 编号规则
3233

‎docs/product/pain-points-v4.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ v1.0 的"熵减"指向**知识系统的熵**(遗忘、混乱、碎片)。但
228228
v3 导航层裁决并入此架构:**容器管线出现在每日视图/会话面;feed 产物只出现在组与结算面**——防止心智污染。认知卸载(P34)的最佳实现不是某个功能,而是这个分层架构本身。
229229
### 7.6 降级与出局名单(历史裁决)
230230
- **降级为后台传感器/工艺**:P29情绪锚点、P28认知负荷自评(探测低谷的输入信号);P39节律、P23睡前复习(引擎参数);P26悬念结课(工艺技巧,撤销科学背书)。**科学原理是设计者的约束条件,不是用户界面的功能清单。**
231-
- **出局**:P37学习风格(VAK 已证伪)· P32心流追踪(回溯性体验不可实时追踪)· P22/P45/P41(稳态精致化,瓶颈在瞬态)· P12/P24/P1(别人已做得更好)· P13知识图谱(失败发生在人没回来的地方,不在知识没连成网的地方——feed 卷以"技能地图"形式部分越狱)。
231+
- **出局**:P37学习风格(VAK 已证伪)· P32心流追踪(回溯性体验不可实时追踪)· P22/P45/P41(稳态精致化,瓶颈在瞬态)· P12/P24/P1(别人已做得更好)· P13知识图谱(失败发生在人没回来的地方,不在知识没连成网的地方——feed 卷以"技能地图"形式部分越狱。**2026-08-23 修订(ADR-024)**:自由双链/图谱出局不变;**有界体系**——体系树+概念/模型库+决策日志,引用限体系内及对证据的单向引用——**通过**,作为 L2 飞轮层"体系枝"(为什么学→怎么用→审计),不承担增长机制、无内容收纳权、不做图可视化)。
232232
---
233233
## 第八部分:指标体系(统一)
234234
| 层级 | 指标 | 含义 |

‎docs/product/requirements-pool.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -399,7 +399,7 @@
399399
| REQ-026 | 章节速览/思维导图 | P3 | 待评估 | V1.1 | 依赖时间轴 |
400400
| REQ-027 | 重点标记→闪卡自动联动 | P3 | 待评估 | V1.1 | 竞品无此闭环 |
401401
| REQ-028 | 中英混说识别 | P3 | 待评估 | V1.1 | 先做本地模型 spike |
402-
| REQ-029 | 知识图谱可视化(P13) | P3 | 待评估 | 远期 | 高成本 |
402+
| REQ-029 | 知识图谱可视化(P13) | P3 | 待评估 | 远期 | 高成本;**2026-08-23 联动(ADR-024)**:体系层(有界体系)落地后本项含义降为"体系数据可视化补充",维持 P3;不做力导向图(Heptabase 已占位 + P13) |
403403
| REQ-030 | 学习计划系统(P17) | P3 | 待评估 | 远期 | 目标→任务→追踪 |
404404
| REQ-096 | 跨会话图指纹关联:相同图跨课程出现 → 课程关联(P13 轻量版) | P3 | 待评估 | V1.1 | 2026-08-19 头脑风暴(图像复用);REQ-067 指纹的消费端 |
405405
| REQ-097 | 测验引用图:测验自生成时图表作题干素材 | P3 | 待评估 | V1.1 | 2026-08-19 头脑风暴(图像复用);依赖 K2 测验自生成 |

0 commit comments

Comments
 (0)