用途:以研究者式方法精读长书与论文。先略读结构,再逐章深读并随手记录笔记,最后依据笔记而非原文做综合,避免长上下文注意力稀释与"中间遗忘"。方法源自 Adler《如何阅读一本书》、SQ3R 的 Recite 步骤与 Keshav 的论文三遍法。
主要能力:两种模式——overview 只做检视性阅读,产出书籍地图与按目的定向的章节摘要;study 走完整流程:明确阅读目的、检视地图、逐章分析笔记加 Recite 核对、按 Adler 四问做分层综合、机械式引文核验。工作区默认在源文件同级目录生成 <slug>-notes/,含分页 source.txt([[page N]] 坐标)、chapters.tsv、拆分后的 chapters/、map.md、terms.md、notes/ 和 synthesis.md,供跨会话复用。脚本共七个:prepare-text.sh、extract-structure.sh、read-pages.sh、search-book.sh、split-chapters.sh、build-diagram.sh、verify-quotes.sh。
使用方式:先运行 prepare-text.sh <input-file> [workspace-dir] 转换并分页,读取其 JSON 输出(pages、est_tokens、mode_hint);若已有笔记则直接基于笔记作答,不必重跑流程。随后 extract-structure.sh 得到结构种子并对照目录确认,写入 chapters.tsv 后用 split-chapters.sh 切分,build-diagram.sh --append 生成结构思维导图。study 模式逐章写笔记并通过 Recite 核对,最后写 synthesis.md 并用 verify-quotes.sh 校验引文,再手工复核关键转述,直到退出码为 0。
适用场景:长书精读、文献综述、跨书主题比较(syntopical reading,每本书各建工作区后写比较综合),以及后续向已有笔记追问。
限制:脚本需 pdftotext/pandoc,缺失时退出码 2,只能退化为直接用 Read 工具分批读取,此时失去机械引文校验;EPUB/DOCX/TXT/MD 无真实页码,引用指向 source.txt 自身分页;verify-quotes.sh 只能校验引文,不能校验转述,需人工复核。是否支持并行子代理取决于运行环境。其余如收费、价格、平台等资料暂未提供。