epub

EPUB 阅读器技能

读取 EPUB 电子书文件，并将内容提取为整洁的 Markdown。

说明

使用 epub-reader CLI 工具与 EPUB 文件交互。该工具位于： ~/.claude/skills/epub/scripts/epub-reader/dist/index.js

可用命令

1. 查看元数据

获取图书信息（标题、作者、出版商、日期、简介）。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "<path-to-epub>"

2. 列出目录

查看所有章节及其结构。每个条目会显示 [ch: N]，表示要与 chapter 命令一起使用的章节编号。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "<path-to-epub>"

3. 阅读指定章节

按编号阅读单个章节（从 1 开始编号）。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "<path-to-epub>" <chapter-number>

4. 阅读全书

将整本书提取为 Markdown。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js full "<path-to-epub>"

5. 搜索文本

查找文本出现的位置及其上下文。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "<path-to-epub>" "<search-query>"

推荐工作流

1. 先查看元数据，了解要处理的图书
2. 查看目录，了解可用章节及其结构
3. 阅读指定章节进行定向分析，或使用 full 完整提取
4. 使用搜索查找特定主题、引文或参考内容

开放式搜索

对于“这本书的主要主题是什么？”或“查找所有关于主人公童年的引用”等宽泛或概念性查询，请使用查询扩展：

1. 扩展查询，利用领域知识将查询拆分为多个具体搜索词
   • 示例：“主人公的童年” → 搜索角色姓名、“年轻”、“童年”、“记忆”、“父亲”、“母亲”、“成长经历”等
2. 并行运行搜索，分别搜索每个扩展词
3. 综合结果，去重并整合各次搜索的发现

这种方法可利用 Claude 的领域知识，找到简单关键词搜索可能遗漏的同义词、相关概念和术语变体。

示例

用户提问：“这本书对作者的研究方法有什么介绍？”

扩展为以下搜索：

• “方法论”
• “研究”
• “研究过程”
• “分析”
• “数据”
• “发现”
• “证据”

然后整合结果，形成全面的回答。

输出格式

所有输出均为整洁的 Markdown：

• 保留标题格式，如 #、## 等
• 正确转换列表、链接和强调格式
• 清理多余空白
• 完整提取时包含章节分隔符

示例

# What book is this?
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "/path/to/book.epub"

# Show me the chapters
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "/path/to/book.epub"

# Read chapter 3
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "/path/to/book.epub" 3

# Find all mentions of "democracy"
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "/path/to/book.epub" "democracy"

注意事项

• 章节编号从 1 开始（第一章为 1，而不是 0）
• 使用目录输出中的 [ch: N] 引用查找正确的章节编号
• 路径中包含空格时必须加引号
• 使用 full 命令时，大型图书可能会产生大量输出
• 搜索结果每章最多显示 5 个匹配项及其上下文