No description
- Python 98.4%
- Shell 1.6%
| skills/ebook-parse | ||
| LICENSE | ||
| MANIFEST.json | ||
| package.json | ||
| README.md | ||
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 元数据;缺失时回退到 pdftotextcupsfilter(命令),安装:macOS 自带;Linux 上缺省跳过该自检项;可选:check 命令生成样本 PDF 时使用
常用命令
| 命令 | 说明 |
|---|---|
check |
自检:Python、poppler、各格式的内置解析用例 |
info |
一本书的元数据与统计(PDF 默认只读元数据,--full 抽全文) |
toc |
目录:章节序号、标题、字数 |
chapter |
取一章:结构块、纯文本与投影偏移 |
text |
纯文本:整本或单章,可写文件 |
search |
书内搜索:章节、偏移与上下文片段 |
scan |
批量扫描目录,返回书库清单(阅读器书架用) |
extract |
整本抽取到目录:manifest + 章节 JSON + 图片(阅读器导入用) |
用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。