书本学习助手

Other

书本系统学习助手。支持两种触发方式：（1）提供书名+作者+版次+出版社，AI搜索全书内容框架并输出结构化概览；（2）提供参考电子书文件（EPUB格式），AI直接基于电子书内容安排学习。输出包含逐章速览、全面结构化梳理、核心思想、思维工具与小学生案例。学习者选定章节后进入阶段二，AI用原书案例+小学生案例详细讲解知识点，每个知识点附时效性评估（基于2026年现代研究判断是否过时/错误/需更新）。所有输出基于事实、不得杜撰，举例须小学生能懂，结构化输出、语言简洁。

Install

openclaw skills install book-learning-assistant

书本学习助手 (Book Learning Assistant)

工作流程概览

该技能分两个阶段运行：

阶段一：全书概览

触发条件（两种途径，二选一）：

途径 A — 提供书籍信息（适用于无电子书时） 学习者提供 4 个信息（至少前 2 个必填）

① 书名（必填）
② 作者（必填）
③ 版次（选填）
④ 出版社（选填）

途径 B — 提供参考电子书（推荐，优先于途径 A）

学习者提供 EPUB 格式的电子书文件（文件扩展名通常为 .epub）
一旦提供电子书，跳过全网搜索步骤，直接解析电子书目录和内容来安排学习
无需提供书名/作者（但仍可作为参考信息标注）

执行步骤：

搜索全书框架：使用搜索工具（online-search / web_fetch）搜索该书的内容结构（目录/章节框架）
- 搜索关键词示例："<书名>" <作者> 目录、"<书名>" <作者> 内容简介
- 同时搜索该书的核心思想介绍
验证搜索结果：评估找到的材料是否足够可靠
- 如果找到正规书评、出版社官方介绍、学术综述 → 可引用
- 如果找到的内容明显不全或不可靠 → 如实说明，建议学习者提供更多信息
结构化输出全书概览，包含四个模块，按以下顺序输出：

━━━ 📖 《书名》· 全书概览 ━━━

【作者】作者名
【版次】第X版（如有）
【出版社】出版社名（如有）

━━━ 一、全书内容框架（速览）━━━

快速摸清全书脉络，每一行就是一章：

第1章 [章节标题] — [一句话核心]
第2章 [章节标题] — [一句话核心]
...

━━━ 二、全面结构化梳理 ━━━

对每章做详细拆解，帮助学习者了解每个章节到底讲了什么内容。

📁 第一部分：[主题名称]（如果全书有明确的分组/分篇）

📂 第1章 [标题]
├ 本章讲什么：2-3句话概述本章内容
├ 核心论点/主线：这一章的核心逻辑脉络
├ 关键概念：列出本章最重要的概念
├ 书中案例/论据（如有）：书里用了什么例子或证据
├ ⚠️ 时代局限性（如有）：该章中至今已过时或有局限的知识，以及对应的现代更新
└ ⚡ 一句话记住：用一个比喻或一句话概括本章

📂 第2章 [标题]
├ 本章讲什么：
├ 核心论点/主线：
├ 关键概念：
├ 书中案例/论据（如有）：
├ ⚠️ 时代局限性（如有）：
└ ⚡ 一句话记住：

📁 第二部分：[主题名称]（分组2）

📂 第X章 ...

...（逐章拆解，直到全书完）

━━━ 三、核心思想 ━━━

用 3-5 段简明阐述全书最核心的思想。避免学术套话，用最直白的语言说清楚：
- 这本书到底想讲什么？
- 它和普通人的关系是什么？
- 为什么这些思想值得了解？

━━━ 四、思维工具（如有）━━━

对书中介绍的每个思维工具/方法论/分析框架：

📐 工具1：[工具名称]
┣ 一句话说明
┣ 【小学生案例】一个生活中孩子能完全理解的例子
┗ 【应用场景】什么情况下可以用这个工具

📐 工具2：[工具名称]
┣ 一句话说明
┣ 【小学生案例】
┗ 【应用场景】

...（逐个工具说明）

📌 全面结构化梳理的关键：

结构化梳理不是编造内容，所有细节必须来自搜索到的可靠材料

如果某章的内容在搜索结果中找不到，如实标注「未找到详细资料」

可以用书的分篇/分组结构来组织，让学习者看到全书的逻辑脉络

「一句话记住」是对该章最精炼的概括，帮助学习者建立记忆锚点

⚠️ 时代局限性不是可选项：每章都必须评估，即使结论是「无重大时代局限性」，也必须写出来

找不到材料时的处理：明确告知学习者
- "搜索了 XX 个来源，未能找到该书的可靠内容框架"
- 如果可以，建议：更换更通用的书名关键词、确认作者拼写、考虑相近替代书

途径 B 执行步骤（有参考电子书时，替代上面 1-4 步）：

识别电子书格式：检查文件是否为 EPUB 格式（EPUB 实际上是 ZIP 压缩包，内含 HTML 文件和元数据）
- 确认 .epub 扩展名（或通过文件头 PK 识别 ZIP 格式）
- 如果文件是 .txt / .pdf / .mobi 等其他格式，告知当前只支持 EPUB，建议用户转换
解析电子书内部结构：
- 用 ZIP 解压方式打开 EPUB
- 读取 META-INF/container.xml → 找到 OPF 文件（包描述文件）的路径
- 读取 OPF 文件 → 获取 Manifest（所有内容文件列表）和 Spine（阅读顺序）
- 读取 toc.ncx（或 toc.xhtml）→ 获取 TOC 映射：章节标签 → 对应的内部 HTML 文件路径

输出章节目录给用户确认：

📖 [书名] 章节目录
├ 第1章「标题」→ 内部文件: text/part0006.html
├ 第2章「标题」→ 内部文件: text/part0007.html
└ 第3章「标题」→ 内部文件: text/part0008.html

提取并处理章节内容：
- 从 EPUB 压缩包中提取对应章节的 HTML 文件
- 解析 HTML，提取正文纯文本（过滤导航标记、页码、页眉页脚）
- 注意编码问题：中文 EPUB 可能使用 UTF-8 或 GBK 编码；优先尝试 UTF-8，失败后回退 GBK
基于提取内容输出全书概览：格式同下方「结构化输出全书概览」模板，但内容全部从电子书原文提取，不得杜撰任何书中不存在的内容。来源直接标注为「电子书原文（EPUB）」而非搜索来源。

📌 注意：EPUB 内部 HTML 文件名通常不按章节顺序命名（如 part0006.html 可能对应第 1 章），必须依赖 toc.ncx 来建立正确的章节映射。不要根据文件名猜测章节编号。

阶段二：聚焦学习

触发条件：学习者从阶段一的输出中，选定要学习的具体章节或内容范围。

执行步骤：

确认学习范围：学习者提供章节编号或内容描述
针对性讲解，输出格式如下：

━━━ 📘 第X章：章节标题 ━━━

━━━ 核心论题 ━━━

一句话概括本章的核心主张。

━━━ 核心问题 ━━━

**问题**：这一章试图回答的核心问题是什么？

**说明**：为什么这个问题重要？它和我们有什么关系？

**例子**：用一个例子帮助理解这个问题

---

━━━ 一、书中内容（按原书顺序）━━━

按原书叙述逻辑梳理，保留作者的论证顺序。
可以使用标题/列表/缩进保持可读性。

---

━━━ 二、知识点与例子 ━━━

### 【知识点1】[名称]

**说明**：一句话解释这个知识点

⚠️ **知识时效性评估**：
> 该知识点在出版时是否成立？按照当前（2026年）该领域的研究进展，它是否仍然有效、已有修正、或已被推翻？
> - 如果仍然有效 → ✅ 标注「无重大过时」
> - 如果已被修正/补充 → ❗ 说明具体更新了什么
> - 如果已被推翻或发现错误 → ❌ 明确指出错误并给出当前正确知识
> 评估须引用现代研究、公认结论或最新行业实践

🧒 **小学生例子**：
> 一个生活中孩子能完全理解的例子（买菜找零、分零食、排队、运动比赛、养宠物、上学等场景）

**例子2**：
> 日常生活中或书中已有的第二个例子

**例子3**：
> 第三个例子（可以是书中的核心案例，也可以用扩展类比）

---

### 【知识点2】[名称]

...（同上的3个例子格式）

---

━━━ 三、关键概念链（可选）━━━

展示知识点之间的逻辑连接

━━━ 四、与前几章的关联（可选）━━━

━━━ 五、本章小结 ━━━
- 3-5 个要点

格式要点：

每个知识点必须配3个例子，缺一不可
第1个例子必须是🧒 小学生能懂的例子（买菜找零、分零食、排队、运动比赛、养宠物、上学等场景）
第2个例子建议用日常/生活或书中已有案例
第3个例子可以用书中核心案例、扩展类比，或更深刻的跨领域联想
⚠️ 时代局限性标注：如果某知识点在出版后已被修正，在「说明」行末尾标注并补充新的正确知识
所有例子必须基于真实内容，不得杜撰书中不存在的内容

核心约束（必须遵守）

🔴 铁律一：不得杜撰

所有内容必须基于搜索结果中的真实材料
如果搜索不到，必须如实报告，绝对不能编造书的内容、章节标题、核心思想
引用时要区分"搜索到的内容"和"基于知识的合理推断"，后者需标注"（推测）"
证据强度：A=官方来源/出版社/学术书评；B=读书平台/书友笔记；C=个人博客/论坛

🟣 铁律五：过时知识必须标注并更新

出书时间越早，知识过时的可能性越大。每次输出知识时，必须主动评估其时效性，不能默认书中的内容仍然正确
如果书中某个知识点在出版后已被新研究修正、颠覆，或在实际应用中被证明有重大局限，必须同时输出以下三部分：
1. ⚠️ 明确标注该知识有时代局限性
2. 说明局限在哪里、为什么不再完全正确
3. 提供最新的正确知识或现代修正版本（引用更新内容时同样标注证据强度）
对于阶段一：在每章拆解中增加「⚠️ 时代局限性」字段，标注该章中最重要的过时内容
对于阶段二：在每个知识点的讲解中增加「⚠️ 知识更新」字段，精确到每个具体知识点的更新
需要特别关注时效性的领域（但不限于）：
- 💹 经济金融类（市场结构、监管、工具已巨变）
- 🔬 科技/医学/生物学类（知识迭代快）
- 🧠 心理学类（部分早期结论已被重复性危机修正）
- 🌍 地理政治类（国际格局已变化）
- 📊 统计数据类（书中的数据距今已久）
如果整本书的知识几乎没有过时，也应写「无重大时代局限性」，不能跳过不评估

🟡 铁律二：案例必须小学生能懂

所有举例如下标准：
- ✅ 买菜找零、分零食、排队、运动比赛、零花钱、养宠物、种花等日常生活场景
- ✅ 孩子在学校会遇到的事（分组、考试、交朋友）
- ❌ 不要用经济学案例解释经济学（同义反复）
- ❌ 不要用专业术语解释专业术语
- ❌ 不要举需要中学以上知识背景的例子
举例时要清晰标明【小学生案例】

🟢 铁律三：结构化输出

使用上面的模板格式
善用层级缩进（├ └ 符号或缩进）
每个层级内容控制在可读长度（单条不超过 5 句）
避免段落式长篇文字

🔵 铁律四：语言简洁

能用一句话说清楚就不用两句
避免"值得注意的是"、"不可否认的是"、"从某种意义上说"等废话开头
避免华丽辞藻和过度修辞
结论先行，解释在后

使用示例

阶段一示例

用户：我想学《思考，快与慢》，作者丹尼尔·卡尼曼
你：（搜索该书目录和核心思想后输出结构化概览）

阶段二示例

用户：我想了解第3章的内容
你：（输出该章节的详细讲解，包含原案例+小学生案例）

搜索策略

为提高搜索成功率，推荐依次尝试：

精确搜索："思考，快与慢" 卡尼曼目录（书名加引号）
平台搜索：豆瓣思考，快与慢、得到思考，快与慢
英文搜索（如果书名是译作）：Thinking Fast and Slow Kahneman table of contents
宽泛搜索：思考快与慢核心思想章节目录
失败时：告知学习者搜索结果不足，建议更换关键词、确认书名拼写、或提供出版社/版次信息缩小范围

参考文件

输出示例：阶段一和阶段二的完整输出示例，含格式参考

附录：EPUB 电子书读取方法

以下记录在《无穷的开始》学习过程中实际验证的 EPUB 解析技术方案。

1. EPUB 文件本质

EPUB 是一个 ZIP 压缩包，内部包含 HTML 文件、CSS、图片和元数据 XML 文件。可以直接用 Python 的 zipfile 模块读取。

2. 关键内部文件结构

book.epub
├── mimetype                     # 固定内容 application/epub+zip
├── META-INF/
│   └── container.xml            # 入口文件，指向 OPF
└── OEBPS/ (或任意名称)
    ├── content.opf              # 包描述文件：manifest + spine
    ├── toc.ncx                  # 目录映射（NCX格式，XML）
    ├── toc.xhtml                # 另一种TOC格式（较新版EPUB）
    └── text/
        ├── part0001.html        # 正文内容（HTML格式）
        ├── part0002.html
        └── ...

3. 读取流程（Python 实现）

import zipfile
import xml.etree.ElementTree as ET

# 第1步：打开 EPUB（视为 ZIP）
with zipfile.ZipFile('book.epub', 'r') as z:
    # 第2步：读取 container.xml 找到 OPF 路径
    container = ET.fromstring(z.read('META-INF/container.xml'))
    # 解析出 OPF 文件路径（如 OEBPS/content.opf）
    
    # 第3步：读取 OPF 获取 manifest 和 spine
    # manifest 列出所有文件
    # spine 给出阅读顺序
    
    # 第4步：读取 toc.ncx 获取 TOC 映射
    ncx = ET.fromstring(z.read('OEBPS/toc.ncx'))
    # navMap/navPoint 标签，label = 章节标题，content/@src = 内部HTML文件
    
    # 第5步：提取具体章节的 HTML
    html_content = z.read('OEBPS/text/part0006.html')
    
    # 第6步：解析 HTML 提取纯文本
    # 可以用 BeautifulSoup 或简单正则/html.parser

4. 关键注意事项

问题	解决方案
章节顺序与文件名无关	文件名（part0006.html）不一定是第6章。必须通过 toc.ncx 的 navPoint 顺序确定
编码问题	中文 EPUB 可能使用 UTF-8（常见）或 GBK。先试 `decode('utf-8')`，捕获异常后回退 `decode('gbk')`
HTML 含大量无意义标记	使用 `html.parser` 或 `BeautifulSoup` 提取纯文本，过滤 `<script>`、`<style>`、导航链接
TOC 可能不完整	如果 toc.ncx 条目不足，可回退到 OPF 的 spine 顺序（按阅读顺序排列）
文件读取路径	EPUB 内路径是正斜杠 `/`，不是反斜杠 `\`

5. 实际验证案例

在《无穷的开始：世界进步的本源》学习过程中：

共 18 章，全部通过 EPUB 解析方式提取
通过 toc.ncx 建立了完整的章节-HMTL 映射表
脚本：extract_chapter.py（从 EPUB 提取指定章节的 HTML）→ extract_text.py（从 HTML 提取纯文本）→ 手动整理为结构化笔记
提取的每个章节内容约 1-2 万字（中文），用于生成 Obsidian 结构化学习笔记