No description
  • Python 98.4%
  • Shell 1.6%
Find a file
2026-10-10 01:05:00 +08:00
skills/ebook-parse release v0.1.0 2026-10-10 01:05:00 +08:00
LICENSE release v0.1.0 2026-10-10 01:05:00 +08:00
MANIFEST.json release v0.1.0 2026-10-10 01:05:00 +08:00
package.json release v0.1.0 2026-10-10 01:05:00 +08:00
README.md release v0.1.0 2026-10-10 01:05:00 +08:00

ebook-parse

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

以 Pi package(技能形态)发布;同一个源还有 CLI 出口 ebook-parse-cli。技能本体在 skills/ebook-parse/。

  • 平台:macOS / Linux / Windows
  • 许可:GPL-3.0-or-later(全文见 LICENSE)

安装

pi install git:forgejo.vhkd.top/pi-hub/ebook-parse.git@v0.1.0

装完 pi-skill list 能看到 ebook-parse,pi-skill ebook-parse check 会告诉还缺什么。

先准备什么

  • 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 + 图片(阅读器导入用)

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。