docs(v0.13): 落位v0.13.5书籍笔记组与知识树附加方案C

Author: Aparencia

docs/Foresight/competitive-analysis-personal-library.md

@@ -1,6 +1,6 @@
 # 竞品调研：个人电子图书馆（前瞻，未排期）
 
-> 状态：前瞻调研（2026-08-23，未排期）——回答"有没有个人电子图书馆"并以品类视角评估对熵减知识体系层的延展价值
+> 状态：前瞻调研（2026-08-23；**已输入 v0.13.5 立项**——"体会层"（书籍笔记组＋知识树附加，不存书内容）见 [v0.13.md 规划](../versions/v0.13.md#v0135-规划书籍笔记组与知识树附加方案-c2026-08-23-立项)）——回答"有没有个人电子图书馆"并以品类视角评估对熵减知识体系层的延展价值
 > 结论先行：**有，且品类活跃**，但分裂为五个互不相通的子类——"管书"（书库管理）/"看书"（书店平台）/"摄取"（读后高亮回顾）/"文献"（学术库）/"问书"（AI 问答）——**没有一家做到"书库→高亮→间隔回顾→学习循环→知识体系"贯通**；正是熵减一贯的空白带。
 > 检索时间 2026-08-23；价格为写稿时点以官网为准。
 
@@ -42,7 +42,7 @@ L1 本地书库管理层                Calibre(开源事实标准) · Calibre-W
 
 ## 四、对熵减的启示（均为未排期评估）
 
-1. **书籍/文献暂不作为新进料**：内容供给红线 + Calibre/微信读书已占"管书/看书"；**若未来接入**，正确形态=PDF/epub 作为"容器地形"的第三种进料（走现有会话→组管线，复用 ASR/OCR/结构化），**不做书库管理**（Calibre 不可战胜也不值得）。
+1. **书籍本体内容不作进料（维持）**：内容供给红线 + Calibre/微信读书已占"管书/看书"；**"体会层"已立项 v0.13.5**——正确形态＝books 元数据壳＋书籍笔记组（体会=组内用户笔记）＋挂知识树，不存书内容（零版权、零存储负担、接学习循环）；不做书库管理（Calibre 不可战胜也不值得）。
 2. **借鉴"高亮即回顾"到已有机制**：视频/碎片侧已有（词汇表术语卡/碎片多句卡）；若做书籍进料，高亮→卡是现成规则（`card_from_fragment` 同构），不必新发明。
 3. **不打"AI 问书"战**：书脉/LocalBrain 已在移动端+问答形态占位；熵减的差异化（本地全链路+学习循环+体系层）不在此。
 4. **观察项**：书脉"扫码建书房"低摩擦建库动线；Readwise 定价与增长（书库→记忆市场饱和度）；Pocket 用户迁移去向（迁移到 Readwise/Reader 的占比）。

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

@@ -114,6 +114,7 @@ P13（知识图谱出局）排的是"**连成网**"作为增长机制——失
 | 模块 | 与知识体系的关系 |
 |---|---|
 | 组（唯一容器） | 证据层：组挂载到问题/概念（`knowledge_links`）；课程组自动建议挂到全局树"领域入口" |
+| 书籍组（kind=book） | 容器地形**人工进料**：一本书＝一个组（books 元数据壳），体会＝组内笔记——**不存书内容**；"书→判断"证据链（体会"应用"字段→应用记录）；与 Readwise 的隐喻分界：它存高亮（书的内容片段），熵减存"书对我的改变"（v0.13.5） |
 | 闪卡（kind=model） | 记忆面：与体系概念单向升格（双面体） |
 | 组结算 | 审计的同构：结算＝组级审计（核心提炼/合并/归档）；审计＝体系级结算（失效检查/问题增删/交叉点） |
 | 周契约 | 弹性承诺纪律同源：无 streak、无惩罚、断签不清零 |

docs/product/requirements-pool.md

@@ -368,6 +368,20 @@
 | REQ-211 | 体系审计：季度触发（settlement_due 同构）＋审计清单（指南附录 D 六项）＋组结算第三步增强（概念失效检查） | P1 | 已立项 | v0.13.4 | 审计产出建议、用户确认后生效（防古德哈特/骚扰） |
 | REQ-212 | 交叉点派生提示（概念被 ≥2 领域体系引用时提示升格/建引用；默认关）＋审计报告视图（思辨动作 vs 学习动作并列） | P2 | 已立项 | v0.13.4 | 不做跨体系自由引用/图谱可视化；v0.14 视数据转正 |
 
+#### v0.13.5 · 书籍笔记组与知识树附加（方案 C，2026-08-23 用户裁决立项）
+
+> 用户裁决：知识树附加书籍＋书籍笔记组＋体会模板"应用"字段＋阅读状态生命周期＋交叉点/升卡复用——**不存书内容**（版权零触碰），只存用户体会（"书→判断"贯通，竞品空白带）。
+> 依据：[个人电子图书馆调研](../Foresight/competitive-analysis-personal-library.md)＋用户脑暴；规划详见 [versions/v0.13.md v0.13.5 规划](../versions/v0.13.md#v0135-规划书籍笔记组与知识树附加方案-c2026-08-23-立项)。
+
+| ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
+|----|------|--------|------|---------|------|
+| REQ-213 | books 元数据壳表（group_id UNIQUE=一本书一个组；title/author/isbn/status/rating/lesson——不存书内容）＋ note_groups.kind 扩展 'book'（命令层白名单+1） | P0 | 已立项 | v0.13.5 | 定制于内容供给红线外——只存体会；一书本一组（组=学习单元契约延续） |
+| REQ-214 | 书籍组 CRUD：create_book_group（事务建组+books 行）/ update_book_group / list_book_groups（状态过滤）；组卡片书籍元数据+状态徽标 | P1 | 已立项 | v0.13.5 | 删除=既有组归档路径（不删数据） |
+| REQ-215 | 知识树"附加书籍"：节点/概念详情面板书籍区（list_knowledge_links(target=note_group)+元数据 JOIN）+ 添加=复用 link_knowledge_target（选已有/现场新建书组） | P1 | 已立项 | v0.13.5 | 方案 C 展示层——树侧零 schema；交叉点提示自动适用（v0.13.4 复用） |
+| REQ-216 | 体会模板（"这本书改变了我哪个判断/我打算怎么用"应用字段）→ 一键复用 v0.13.3 application 记录（content=应用字段，挂概念/问题）——"书→判断"贯通 | P1 | 已立项 | v0.13.5 | 应用字段可空；解析/转义纯函数 TDD |
+| REQ-217 | 阅读状态生命周期（toread→reading→finished/abandoned 白名单）＋ book_stale 纯函数（finished 90 天无访问→审计"这本书还在影响你吗？"） | P1 | 已立项 | v0.13.5 | concept_stale 同范式；随 v0.13.4 审计清单展示；书版沼泽化防御 |
+| REQ-218 | 体会升卡与复习：复用 generate_group_cards/复习面（书组自然生效）+ 书组徽标 | P1 | 已立项 | v0.13.5 | 零新代码（接线+徽标）；生成效应（自己产出记忆深 2-5 倍） |
+
 ### V1.0 · 体验增强（远期）
 
 | ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |

docs/versions/v0.13.md

@@ -20,6 +20,7 @@
 | **v0.13.2** 概念双面体 | 思辨×记忆 | `flashcards.kind='model'` 落地（卡面契约：front=概念名，back=三问（本质/边界/联系）＋锚点回链——延迟揭示＝必要难度）＋卡→概念升格（回填三问；AI 可选增强默认关）＋概念库 UI（三问一用卡片：本质/边界/联系/最近应用）；REQ-206~207 |
 | **v0.13.3** 决策与应用 | 应用闭环 | `knowledge_decisions` 一表两面（kind=decision/application：内容/预期/实际/反思 四行＋used_refs 引用必填）＋入口：概念页/组/复习面"记一次使用"＋决策日志 UI＋`metrics_events` 扩展（concept_promoted/decision_logged/application_logged/system_audited）；REQ-208~210 |
 | **v0.13.4** 审计与整合 | 反馈环 | 体系审计（季度触发复用 `settlement_due` 范式；审计清单＝指南附录 D 六项）＋组结算第三步增强（概念失效检查：180 天未应用→待观察/归档建议）＋交叉点派生提示（概念被 ≥2 领域引用时提示，默认关）＋审计报告视图（思辨动作 vs 学习动作并列，诚实）；REQ-211~212 |
+| **v0.13.5**（立项 2026-08-23） | 书籍笔记组＋知识树附加（方案 C） | `books` 元数据壳（group_id UNIQUE——一本书＝一个组；不存书内容）＋`note_groups.kind='book'`＋书籍组卡片（书名/作者/状态/评分）＋体会模板（含"应用"字段）＋体会→应用记录/升卡接线（复用）＋知识树节点/概念"附加书籍"区（link 复用，树侧零 schema）＋阅读状态生命周期与 `book_stale` 审计联动；REQ-213~218；[规划 §](#v0135-规划书籍笔记组与知识树附加方案-c2026-08-23-立项) |
 
 ## 关键决策与纪律
 
@@ -76,3 +77,63 @@ knowledge_audits(id, system_id, items_json(附录D 六项), stats_json(失效数
 - 应用记录/决策日志数据（decision_logged/application_logged）为 Phase 4 测量层（显影报告"应用率"维度）新增输入——从 v0.13.3 第一天积累。
 - 交叉点提示若数据反映有效（升格率/引用率），v0.14 评估转正默认。
 - 体系审计执行率低于基线时，评估"体系沼泽化"防御加强（降级引导强化，不增加打扰）。
+
+---
+
+# v0.13.5 规划：书籍笔记组与知识树附加（方案 C，2026-08-23 用户决策立项）
+
+> 状态：**已立项（规划 2026-08-23）**
+> 来源：[个人电子图书馆调研](../Foresight/competitive-analysis-personal-library.md)（"管书"与"助学"断裂带）＋用户脑暴裁决：知识树附加书籍／书籍笔记组／体会模板"应用"字段／阅读状态生命周期／交叉点复用／生成效应升卡
+> 定位：书籍 = "证据＋体会"——**不存书内容**（版权/存储负担/内容供给红线零触碰），只存用户体会（自己产出＝生成效应，记忆深 2-5 倍）；与 Readwise 的隐喻分界：它存高亮（书的内容片段），熵减存"**书对我的改变**"——"书→判断"贯通正是竞品空白带
+
+## 一、范围（方案 C 组合：实体在组、展示在树）
+
+### 1. 数据层
+```sql
+-- note_groups.kind 扩展 'book'（现有 kind 无 CHECK，command 层白名单+1 即可）
+CREATE TABLE IF NOT EXISTS books (            -- 元数据壳，不存内容
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  group_id INTEGER NOT NULL UNIQUE REFERENCES note_groups(id) ON DELETE CASCADE,
+  title TEXT NOT NULL,
+  author TEXT, isbn TEXT,
+  status TEXT NOT NULL DEFAULT 'reading',     -- toread/reading/finished/abandoned
+  rating INTEGER,                             -- 1-5，可选
+  lesson TEXT,                                -- 一句话"这本书对我的意义"
+  created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
+);
+```
+
+### 2. 命令（commands_books.rs）
+- `create_book_group(title, author?, isbn?, status?)`——事务：建 `kind=book` 组（组名＝书名）＋ books 行
+- `update_book_group(group_id, title?/author?/isbn?/status?/rating?/lesson?)`；`list_book_groups(status?)`
+- 删除＝走既有组归档路径（不删数据）；体会＝组内**手动笔记**（复用既有笔记创建/编辑），零新命令
+
+### 3. 体会模板与接线（复用优先）
+- 前端"写体会"模板：`这本书改变了我哪个判断？/ 我打算怎么用？`（应用字段，可空）＋常规体会正文
+- **应用字段 → "记一次使用"**：一键复用 v0.13.3 `knowledge_decisions(kind=application)`（content=应用字段，挂概念/问题）——"书→判断"贯通
+- **升卡/复习**：复用 `generate_group_cards`（组→卡，v0.11.2 已就绪）＋复习面/周契约对书组天然生效——零新代码
+- 元数据拉取（书名/ISBN→作者/封面）＝可选增强，默认关（纯元数据，无版权问题，v0.13.5 只留桩不做）
+
+### 4. 知识树附加书籍（方案 C 展示层，树侧零 schema）
+- 节点/概念详情面板新增"**附加书籍**"区：`list_knowledge_links(target_type=note_group)` ＋ 书籍元数据 JOIN 渲染书卡（书名/作者/状态徽标/体会计数）
+- 添加＝复用 `link_knowledge_target`（选已有书组或现场新建书组）；交叉点：一本书挂多个问题→v0.13.4 交叉点提示**自动适用**（零新代码）
+
+### 5. 阅读状态生命周期与审计联动
+- 状态机：toread → reading → finished / abandoned（command 白名单校验）
+- `book_stale` 纯函数（复用 `concept_stale` 范式）：finished 书组 90 天无访问 → 审计提示"**这本书还在影响你吗？**"（可写新体会、归档或标记"已不再影响"）；随 v0.13.4 审计清单展示（书版沼泽化防御）
+
+## 二、边界（不做清单）
+
+书籍内容导入/格式转换/阅读器 · 全文检索（没有内容可检）· 书评社交 · 周阅读目标（≈学习计划 REQ-030，另议）· 书库管理（Calibre 已占位）· AI 摘要书评（获取隐喻；AI 只做建议）· 移动端
+
+## 三、测试与验收
+
+- books：事务建组＋`group_id` 唯一约束／状态白名单／rating 1-5 / title 非空
+- 纯函数：`book_stale`（90 天边界，AAA＋golden）；体会模板"应用字段"解析（可空/多行/含引号转义）
+- 接线：应用字段→application 记录（v0.13.3 复用）；书组→`generate_group_cards` 幂等；`link_knowledge_target` 挂书组校验
+- 前端 vitest：书籍卡渲染（状态徽标）／节点面板附加书籍区挂接／体会模板表单
+- 真机走查：建书组→写体会（带应用）→挂问题树→升卡复习→（审计）"这本书还在影响你吗？"提示
+
+## 四、需求登记
+
+REQ-213 books 表＋note_groups.kind='book' 扩展 · REQ-214 书籍组 CRUD 命令＋组卡片（元数据/状态徽标）· REQ-215 知识树"附加书籍"（节点/概念面板＋挂接）· REQ-216 体会模板（应用字段）＋应用记录接线 · REQ-217 阅读状态生命周期＋`book_stale` 审计联动 · REQ-218 体会升卡与复习（复用接线＋书组徽标）