用途：将带文本层的 PDF 书籍转换为结构化 EPUB，包含封面图像、每节一章以及可用的目录（nav + ncx）。转换路径完全确定，不经过 LLM。引擎为 scripts/pdf2epub.py，依赖 pymupdf、ebooklib、Pillow（见 requirements.txt），建议创建独立 venv。
用法： python scripts/pdf2epub.py input.pdf [-o out.epub] [--title T] [--author A] [--lang zh] [-v] 可用 --no-footnotes 保留脚注文本在正文流，--scan 强制转换扫描件。完成后应退出码 0，报告显示 sections ≥ 1 且章节标题符合预期。
主要能力：目录解析优先用内嵌 TOC，其次解析印刷目录页，再退化为字号离群标题；封面优先提取单张覆盖页面 ≥85% 面积的图像，否则整页 200 DPI 渲染；脚注按字号与位置分类，章末渲染为带 [n] 回链的尾注，ID 按章作用域；插图按页面区域裁剪提取，经面积、去重与体积过滤后用 Pillow 优化。
限制：仅支持带文本层的 PDF，纯图像扫描件会报错，需先用 document-toolkit OCR；不用于 PDF→Markdown 提取。正文行内 5pt 上标引用可能无法加锚点，其注释仍会出现在章末脚注列表。印刷页码与 PDF 索引不一致时依赖偏移学习，需查看 -v 输出。
验证：检查 sections ≥ 1、toc_source 与书籍一致、-v 章节页码合理，可用其提供的 zip 链接检查脚本确认无缺失目标与重复 id。