# 拆书工作流产品复盘

日期：2026-10-12。本轮是工作流与模板升级，不是重新拆解现有书籍，也没有批量替换旧入口。

## 产品目标

读者打开任意一本书，都能沿用同一套行为：先获得当前问题的一句话答案，再理解作者主线，随后带走独立概念和金句，查看延伸书单，最后按需追查细节与证据。关键内容要先出现，深层资料始终可追查。

## 两条线程提供的需求依据

- [拆解真正的大学](codex://threads/01a12a26-4142-7b10-a5d6-a9c42ad3d859)：解决信息分散、多份 HTML 跳转难理清的问题；操作统一；原线程先认识原书的入口，已按本轮用户最新要求改为问题答案优先；答案要先于“去哪里读”。AI 时代建议应与原书研究结论分开。
- [拆解《精神健康讲记》](codex://threads/01a129b1-fe29-7931-a49e-d6f2a27ac9e9)：口述问题可整理成简洁完整的展示标题，但保留原话；阅读路线需要脑图加文字；已有步骤视频与其他定制应保留。作者的中医解释、训练经验和现代实证边界应区分。

## 从首次进入到深入阅读

| 读者要完成的事 | 产品决定 | 验收方式 |
| --- | --- | --- |
| 知道书在讲什么 | 获取问题答案后，在第二栏看中心问题与主线 | 内容核对 |
| 知道哪里重要 | 首屏直接给问题答案；其余内容按核心/支撑/参考分级，逐项写理由 | 检查排序与稳定入口 |
| 理解作者怎样推进 | 逐步列问题、当前结论、下一步的理由 | 核对论证，无跳步或伪因果 |
| 找到自己关心的回答 | 原始问题可追查，展示标题简洁；一句话答案先显示 | 问题覆盖核对 |
| 追到章节与证据 | 问题→章节/概念/引文，内容→问题；同一主内容区 | 内部定位引用校验 |
| 随时理解术语 | 正文概念和概念入口可 hover、键盘聚焦显示定义 | 生成结构已检查；视觉待验收 |
| 看见来源和限制 | 原书观点、外部来源、用户体验、本轮推导分开 | 来源边界核对 |
| 不丢阅读位置 | 返回上一处、浏览器前后退、会话内刷新恢复 | 脚本检查；实际交互待验收 |
| 在手机和打印中阅读 | 同导航、自然高度，打印当前栏目并展开依据 | 样式已构建；视觉/打印待验收 |
| 查看旧资料 | 资料区完整保留，升级前存档 | 文件和目录覆盖检查 |

## 本轮复盘中修正的缺口

1. 不根据“同在一个章节”自动声称概念直接回答了问题，概念与引文的问题关联必须显式声明。
2. 同时出现长短概念名时，使用一次原始文本匹配，避免改写提示文本或在 HTML 属性内重复插入术语标记。
3. 引文关联入口使用原文作为可读标签，避免只有等级标记没有文字。
4. 问题的简洁展示标题与原话分开，原话仍可展开。
5. Tailwind CSS 本地编译后内嵌，阅读时不依赖网络或临时构建目录。
6. v1/v2 升级为 v3 时保留旧生成入口；手工定制仍需先检查，生成标记不是覆盖定制的理由。

## 已确认的阅读顺序与第二轮复盘

1. 当前问题答案在首屏；状态、来源身份和未解处一起可见，详细证据后置。
2. 全书主线在第二栏；生产仍需先核查原书，防止只围绕个人问题片面解读。
3. 独立概念和金句随后；20 / 15 是完整拆书目标，不通过同义改写或伪造引用凑数。样例仍是有限内容。
4. 书单在中段，既能看本书，也能在拆书总入口查看跨书题名排行。
5. 排行按不同来源书计数，同一本书重复提及只计一次；附录和整理者推荐可独立筛选，不混入默认排行。
6. 排行只能说明已覆盖书库的题名重复程度；未知作者、未核译名、同名不同作品及卷次保持缺口，不包装成推荐分数。
7. 每本书的资料与旧页面均保留；新增本地书单由总入口和汇总页可达。没有重写旧书的定制阅读页面。
8. 概念 hover 不是唯一理解入口：键盘聚焦、触屏点击和概念详情均提供定义；触屏实际表现仍待验收。
9. 下一轮可以讨论具体概念与金句的内部重要排序；栏目先后已经确定。

复盘后修正：非书籍材料不进入图书排行；单行出版的理论文本保留书目身份；明确“独立书还是篇名待核”的项目进入待核列表；混合来源与编辑附录使用独立类别。总书单由规范数据生成，每次新增或修订需重新运行汇总，未启用自动化。

## 当前验证边界

技能元数据校验、JavaScript 语法、Tailwind 实际编译、完整数据和旧数据的生成行为已检查。结构和负例校验见 `验证结果.json`。

本轮浏览器工具的 URL 安全策略拒绝打开本地 `file://`，并明确禁止绕过；没有执行浏览器视觉、手机 viewport 或打印 PDF 验收。本轮不把此前线程的测试结果记成本轮通过。

本轮书单结果：覆盖 9 本拆书，501 个原书提及题名，含编辑附录共 532 个题名。127 条待核或非书籍来源记录保留在各书书单与总数据中。1,280 个新增页面本地链接通过校验；来源书去重、分类分离、未核异名不强合并、重复构建稳定和定制页面保护通过，详见 `书单验证结果.json`。

---

## 追加：《精神健康讲记》按新版 skill 重建（2026-10-12）

用户决策（已锁定）：
1. 完整按新版 book-deep-dive skill 重做（不沿用增量补丁）
2. 沿用 Q01–Q05 五个问题，问题文字稳定不变
3. 改完同步部署到 `chaishu-6og.pages.dev`

备份与回滚：
- 备份 5 个文件到 `精神健康讲记/历史版本/`（`讲解结构-v1-2026-10-12.json` / `index-v1-2026-10-12.html` / `深度拆书-v1-2026-10-12.md` / `问题与章节对照-v1-2026-10-12.md` / `复述导读-v1-2026-10-12.md`）
- v1 拆书看板.html / 全文资料.html 保留未动；render_story.mjs / render_dashboard.mjs 不在本轮跑

字段新增：
- `讲解结构.json` 新增 `app.overview / app.priority / app.background / app.chapters (6) / app.concepts (20) / app.map / app.quotes (15) / app.books (31) / app.documents`
- 每个 concept 含 `definition / role / evidenceText / example / boundary / reflection / takeaway / chapterIds / questionIds / importance`
- 每个 chapter / question / quote / book 含 `importance: {level, reason, rank?}`
- 金句 ID 从 `Q01–Q15` 改名为 `G01–G15`（避免与 questionId `Q01–Q05` 撞名）
- `questionIds` 覆盖全部 20 个 concept（v1 仅 14 个；缺 C04/C12/C14/C15/C17/C18 现已补齐）

读取与生成：
- 直接消费 `证据/概念数据.json` (20) / `金句数据.json` (15) / `书目数据.json` (31) / `证据索引.json` (87) — 不必重做 OCR
- 用 Python 生成器一次性产出 `讲解结构.json`（110 KB），validation 通过：6 chapters + 20 concepts + 5 questions + 15 quotes + 31 books
- `render_index.mjs --replace-generated` 输出 7 views / 89 files / marker `book-deep-dive:reading-app:v3`

部署验证：
- iPad 访问 `https://chaishu-6og.pages.dev/精神健康讲记/` → HTTP 200 + 新版 marker
- `wrangler pages deploy` 仅上传 5 个变动文件，116 个复用

边界与缺口（未做）：
- 用户的具体训练经历仍未补充；"我的共鸣与行动"与"一个行动"暂缓
- 拆书看板.html / 全文资料.html 仍是 v1 版（render_story.mjs / render_dashboard.mjs 未跑）
- 不同印刷批次页码偏移未单独验证
- 浏览器视觉 / 移动 viewport / 打印 PDF 实际验收待做（skill 明确要求但本轮未实测）
- 概念 hover 与 questionIds 高亮的浏览器实际表现待 iPad 体验反馈