读书之前，先让手里有一份地图
本文目录
多年前阅读《如何阅读一本书》，作者在开篇便提出一个核心主张：所谓主动的阅读，也就是能提出问题来。围绕一本书，至少需要提出四个基本问题：整体来说，这本书到底在谈些什么；作者细部说了什么，怎么说的；这本书说得有道理吗；这本书跟你有什么关系。道理当时便已认同，实践却屡屡落空。每当翻开一本书，便不自觉地顺着作者的思路，沿着线性章节顺序一路阅读至末尾，先前的问题早已遗忘在途中。
如今进入 AI 时代之后，“如何读书”乃至”还要不要读书”成为更宏大的疑问。这两个问题目前还无法给出一个可靠的回答，但有一件事是确定的：个人读书方式本身，已经可以先行改变。读书之前，先让手里有一份地图，带着问题进入正文（这正是 book-xray 想要做到的事）。
一本书，一份导读
book-xray 做的事情可以用一句话概括：把整本非虚构书籍，变成一份全书导读报告。
输入一本书，输出一份导读。读者在正式阅读之前，先了解全书的骨架与脉络，知道这本书解决什么问题、结论是什么、如何组织论证，从而带着方向进入正文。整个项目以原书为唯一内容源，最终交付一个单 HTML 文件。
需要说明的是，本技能并非替代阅读原书。恰恰相反，它的目的是辅助读者更好地阅读原著：先以概览掌握全局，再带着问题逐章深入，最后回到原文检验 AI 的理解是否准确。
带着问题读书，为何总是半途而废
再回到《如何阅读一本书》的命题。读书之前先提问题，这一步之所以难以坚持，根本上是因为麻烦。book-xray 试图把这件麻烦事先办妥。
概览层包含六个固定模块：全书主旨、核心结论、全书架构、价值评估、阅读指南、概念速览。它先回答读者最关心的问题：这本书解决什么问题，最终的答案是什么，如何组织论证，是否值得阅读，应该怎样阅读。这一层相当于替读者完成”先提问、先看答案”的动作，让手里先有一份地图。
每章透析层则针对单个章节展开，固定包含六个部分：本章结论、问题缘起、论证展开、关键概念、实践方法、局限与批判。在阅读任何一章之前，读者可以先了解该章解决什么问题、核心答案是什么，再决定深入的程度。
示例：一份现实中的导读
以《刘擎西方现代思想讲义》为例。将其交给 book-xray 处理，产出的导读报告首页如下：
点开任意一章，章节透析的版式是这样的：
查看完整的示例：《刘擎西方现代思想讲义》全书导读。
阅读体验分为两层。第一层是概览，大致五到八分钟可以读完，回答”这本书在讲什么、值不值得读、怎么读”；第二层是章节透析，按需展开，读者可以先知道该章解决什么问题，再决定是否回到原文细读。
从安装到运行
安装非常简单。将仓库克隆到技能目录即可，以 WorkBuddy 为例：
git clone https://github.com/tunggian/book-xray.git ~/.workbuddy/skills/book-xray/其他遵循 Agent Skills 约定的环境，将仓库放到各自约定的技能目录即可（技能目录即存放 SKILL.md 与配套脚本的文件夹）。渲染需要 Python 3.10+ 与 markdown 库。
使用流程分为六步：
- 提取书籍文本并生成工作目录；
- 确认分析目录，将最终结构写入 manifest.json（目录清单）；
- 逐章精读，每章撰写一份 Markdown；
- 全部章节完成后综合撰写概览；
- 渲染为单 HTML 文件；
- 运行自检脚本校验结构完整。
设计：AI 与程序的边界
这套系统的核心分工是：AI 只负责撰写 Markdown 内容，程序负责渲染。渲染程序将 Markdown 合成为带左侧导航、章节折叠、杂志风版式的单 HTML 文件，并完成内容校验与格式兜底。
之所以采用这一分工，出于四点考虑。其一，内容可复用，Markdown 可以随时修改、重新渲染；其二，方便修正，AI 直接编辑文本，无需触碰样式；其三，可更换渲染器，只要内容符合规范，任何人都可以编写自己的渲染程序；其四，不将原书全文塞进报告，导读只包含分析性内容，报告体积与版权风险都可控。
适用边界与局限
任何工具都有边界。book-xray 不支持扫描版 PDF 的 OCR，需要先进行文字识别；不处理 DRM、加密或严重乱码的书籍；单章过长时会按作者小节切分处理。此外，报告中的评论与判断由 AI 基于原书内容生成，可能存在误读与遗漏，请以原书为准。
结语：地图已经就绪
在 AI 出现之前，这样一份全书导读几乎绝难实现。读者若想在阅读之前了解全书，只能依赖报刊上的书评、他人的导读文章、网友分享的读书笔记，质量参差，且往往集中于畅销书。如今，任何一本非虚构书籍，都可以在几分钟内生成属于自己的导读。每个人都可以在正式阅读之前，先让自己手里拥有一份地图。