ebook-parse-cli

把本地电子书（EPUB/TXT/Markdown/HTML/FB2/PDF）解析成统一结构：元数据、目录、章节块与纯文本投影、书内搜索；供阅读器应用与模型共用

由 Pi 技能 ebook-parse 发布（同一个源还有技能包出口），当前版本 v0.1.0。 命令名是 ebook-parse：仓库名带 -cli，命令不带。

• 平台：macOS / Linux / Windows
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

./scripts/install-cli.sh          # 链接到 ~/.local/bin/ebook-parse 并检查依赖
ebook-parse check                     # 自检：依赖与状态
ebook-parse help                      # 完整命令面

先准备什么

• python3（运行环境），全部格式的解析器；只用标准库
• pdftotext（命令），安装：brew install poppler；仅 PDF 需要；其余格式只靠 Python 标准库
• pdfinfo（命令），安装：brew install poppler；仅 PDF 元数据；缺失时回退到 pdftotext
• cupsfilter（命令），安装：macOS 自带；Linux 上缺省跳过该自检项；可选：check 命令生成样本 PDF 时使用

常用命令

命令	说明
check	自检：Python、poppler、各格式的内置解析用例
info	一本书的元数据与统计（PDF 默认只读元数据，--full 抽全文）
toc	目录：章节序号、标题、字数
chapter	取一章：结构块、纯文本与投影偏移
text	纯文本：整本或单章，可写文件
search	书内搜索：章节、偏移与上下文片段
scan	批量扫描目录，返回书库清单（阅读器书架用）
extract	整本抽取到目录：manifest + 章节 JSON + 图片（阅读器导入用）

消费方契约（JSON 字段 / 环境变量 / 状态目录 / 退出码）见 REFERENCE.md。