# 可推广的拆书产品工作流

这份流程把一次拆书分成内容生产、阅读产品和质量验收三条同时推进的线。它服务于离线 `index.html`，不要求读者理解内部证据 ID。

## 0. 先定义交付对象

开始前记录：

- 书名、作者、译者、版本、输入文件和解析范围。
- 用户原始问题，保留原话；没有问题就明确标记为“原书导读模式”。
- 口述问题较长时，`question` 保留原话，`displayQuestion` 可整理为简洁完整的展示标题，读者仍可展开原话；不能增添新的主张。
- 读者完成阅读后要能做出的判断，例如“能解释作者怎样走到结论”“能找到我的问题对应的章节”“能区分作者观点和我的推断”。
- 本轮不做的事：个人行动、对外分享、自动回链或批量迁移，除非用户另行要求。

## 1. 建立证据底座

先解析 EPUB/PDF，建立稳定的章节、段落或页码定位。每条材料记录来源类型、位置、原文、上下文和核验状态。正文缺失时只能交付结构预览，不能用常识补齐原书内容。

## 2. 先画作者路线

把开头的问题、关键转折、证据或例子、限制和结尾收束成 5—8 步。每一步必须同时有：读者要回答的问题、当前结论、进入下一步的原因。不要把概念名串成因果链，也不要把整理者的重组写成作者原有顺序。

## 3. 再处理用户问题

每个问题先写一句话回答，再写机制、章节角色、证据和未解处。状态只使用“直接回答／部分回答／仅相关讨论／已检查范围内未找到／待核验”。问题与章节、概念、引文的关联写入 `questionIds`，供页面高亮和反向定位。

## 4. 标记重要内容

在投影到应用前做一次内容排序。重要程度是编辑判断，不是算法替代：

| 等级 | 用途 | 页面行为 |
| --- | --- | --- |
| `core` | 回答中心问题或决定论证走向 | 首屏“先看重点”、章节/概念/引文置前、使用高亮标记 |
| `supporting` | 解释机制、案例、限制或阅读桥梁 | 跟随核心内容出现，保留关联入口 |
| `reference` | 追查材料、完整书目、背景补充 | 放入深入资料或折叠区 |

每个标记至少写 `level` 和 `reason`；可选 `rank`（数字越小越靠前）。没有可靠依据的内容不因为“看起来重要”而升级为 `core`。

用户已确认栏目优先级：当前问题的答案第一，全书主线第二，20 个独立概念与 15 句金句随后，延伸书单在中段，详细证据最后。各栏目内部按相关性和理由细排；未确认的具体概念排序仍可讨论。“独立概念”指含义不同，覆盖全书，也包括与当前问题无直接关系的收获，不强求概念彼此无关。

## 5. 生成统一阅读入口

固定路线是：我的问题与答案 → 全书主线 → 概念与章节 → 金句与原文 → 延伸书单 → 脑图与细节 → 证据与资料。

首页首屏只承担三个动作：找到自己的问题、获得有边界的答案、知道下一步怎样深入。没有用户问题时默认进入全书主线，不代编问题。生产顺序仍先建立证据和理解作者，展示顺序不会倒置研究过程。问题高亮要能反向定位章节、概念和引文；概念词在正文和关联入口上可 hover 或键盘聚焦查看一句简介；点击后仍能进入稳定的栏目/项目地址。

页面使用本地编译的 Tailwind CSS，运行时不请求 CDN。所有内容投影到同一个主内容区，保留浏览器前进/后退、阅读位置恢复、打印当前栏目、证据展开和图片放大。

脑图同时提供文字解释和内部节点入口，不能把静态图片当成唯一主线。已有步骤视频、独立解读与旧版定制作为资料保留；本流程不默认重做视频或对外分享。

## 6. 产品经理复盘

发布前按“读者任务”检查：

1. **首次进入**：5 秒内找到自己的问题及答案，知道接下来可看全书主线。
2. **带问题阅读**：原始问题可见，一句话答案在前，章节依据和限制紧随其后。
3. **层层推演**：每个路线节点都解释“为什么进入下一步”，没有跳步或伪因果。
4. **重点识别**：核心内容有明确视觉标记，重要内容先出现，支持内容不会抢夺主线。
5. **概念理解**：术语不必离开当前阅读区就能查看简介；hover 之外可用键盘聚焦。
6. **追查证据**：引文有可读章节/页码/段落定位，来源边界和未解处可见。
7. **继续阅读**：章节、脑图节点、问题和引文互相可达，没有死链接。
8. **内容缺口**：没有问题、正文、引文或书目时显示真实缺口，不显示伪造的空卡片。
9. **设备与输出**：手机导航不溢出；桌面行宽舒适；打印只含当前栏目并展开证据。
10. **可维护性**：主笔记、JSON 投影和 HTML 的标题、答案、章节、概念、引文、书目一致；历史入口可恢复。

## 7. 验收证据

记录结构校验（JSON 引用、稳定 ID、文件路径、来源边界）、交互校验（定位、返回、刷新、位置恢复、hover/键盘提示、搜索、打印）和视觉校验（桌面、手机、打印 PDF）。没有实际打开某个原生应用时，不声称已经验证其兼容性。

## 8. 完整交付门槛

完整交付包括：`index.html` 阅读应用、完整主笔记、讲解结构 JSON、可复述导读、完整 Excalidraw 概念图、证据索引与验收记录；有用户问题时增加问题与章节对照。章节详解覆盖本版原书，20 个独立概念和 15 条可核验引文为默认目标，可靠内容不足时减量并写清原因。正文提及书目、注释参考文献、混合来源、编辑附录和整理者推荐分别整理；每本书维护本地书单，汇总到工作区总书单，以不同来源书去重计数，排除非书籍与待核身份。详见 [书单汇总规则.md](书单汇总规则.md)。

首页、问题回答、脑图、章节概念、原文引文、书单、完整资料应各有实际内容或可读的缺口说明。只生成模板、只扫描文件或只做两个问题的交互样例不等于完成全书。PPT 风格导出和视频都是可选产物，不作为阅读必经步骤。

只有用户希望结合个人经验时，才在原书分析后问一个具体场景问题；根据真实回应继续理解和应用。没有个人回应时，不代写个人判断与行动。