用途
EPUB Reader Skill 用于读取 EPUB 电子书文件，并将内容提取为干净的 Markdown。当用户想要阅读 EPUB 文件、从电子书中提取文本、查看 EPUB 元数据（标题、作者等）时，可使用此技能。
主要能力
该技能通过 epub-reader CLI 工具与 EPUB 文件交互，工具位于：
~/.claude/skills/epub/scripts/epub-reader/dist/index.js
提供以下命令：
- 查看元数据：获取书籍信息（标题、作者、出版社、日期、描述）。
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "<path-to-epub>"
- 列出目录：查看所有章节及其结构。每个条目显示
[ch: N]，表示与 chapter 命令配合使用的章节编号。
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "<path-to-epub>"
- 读取指定章节：按编号（从 1 开始）读取单个章节。
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "<path-to-epub>" <chapter-number>
- 读取整本书：将完整书籍提取为 Markdown。
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js full "<path-to-epub>"
- 搜索文本：查找文本出现位置及周围上下文。
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "<path-to-epub>" "<search-query>"
使用方式
推荐工作流：
- 先查看元数据，了解正在处理的是哪本书。
- 查看目录，了解可用章节和结构。
- 读取特定章节进行针对性分析，或使用 full 命令进行完整提取。
- 使用 search 查找特定主题、引文或参考。
开放式搜索
对于宽泛或概念性查询，例如“这本书的主要主题是什么？”或“找出所有关于主角童年的引用”，可使用查询扩展：
- 利用领域知识将查询扩展为多个具体搜索词。
- 示例：“主角的童年” → 搜索角色名、“young”、“childhood”、“memory”、“father”、“mother”、“grew up”等。
- 对每个扩展词并行运行搜索。
- 通过去重和整合各搜索结果来综合结果。
这种方法利用 Claude 的领域知识，捕捉简单关键词搜索可能遗漏的同义词、相关概念和术语变体。
示例
用户问：“书中关于作者研究方法论说了什么？”
扩展为搜索：
- "methodology"
- "research"
- "study"
- "analysis"
- "data"
- "findings"
- "evidence"
然后将结果整合为全面回答。
输出格式
所有输出均为干净的 Markdown：
- 标题保留为 #、## 等。
- 列表、链接和强调正确转换。
- 清理多余空白。
- 完整提取时包含章节分隔符。
命令示例
# 这是什么书？
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "/path/to/book.epub"
# 显示章节
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "/path/to/book.epub"
# 读取第 3 章
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "/path/to/book.epub" 3
# 查找所有提到 "democracy" 的地方
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "/path/to/book.epub" "democracy"
适用场景
- 需要阅读或分析 EPUB 电子书内容。
- 需要提取电子书文本用于引用、研究或整理。
- 需要查看电子书元数据或目录结构。
- 需要在电子书中搜索特定主题、引文或参考。
限制
- 章节编号从 1 开始（第一章是 1，不是 0）。
- 使用目录输出中的
[ch: N]参考来找到正确的章节编号。 - 包含空格的路径必须加引号。
- 大型书籍使用 full 命令可能产生大量输出。
- 搜索结果每章最多显示 5 个匹配项及上下文。
- 关于收费、价格、平台支持范围等信息暂未提供。