|
| 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) |
0 commit comments