| name | epub-package-operator |
| description | Use when 需要合并或拆分 EPUB、修改书名作者等元数据、替换封面，且必须保留原文件并输出新 EPUB 与可审计 JSON 报告时。 |
EPUB 包操作
只执行用户明确选择的一个写操作。先审计输入，再写出新产物；不要把包结构审计和写操作混成自动修复。
选择入口
| 目标 | Harness |
|---|
| 合并两本或多本 EPUB | scripts/epub_package_merge_harness.py |
| 按 TOC 索引拆分 | scripts/epub_package_split_harness.py |
| 修改元数据 | scripts/epub_metadata_edit_harness.py |
| 替换封面 | scripts/epub_cover_replace_harness.py |
| 只检查 OPF/nav/NCX | 改用 $epub-package-nav-auditor |
工作流
-
保留输入文件并运行 preflight；真实加密资源、损坏 ZIP 或无效 OPF 时停止。
-
对拆分操作先运行旧兼容入口查看索引：
python3 scripts/epub_package_tool.py split-targets book.epub
-
运行一个具体 harness，并始终指定新输出：
python3 scripts/epub_package_merge_harness.py a.epub b.epub \
--output merged.epub --format json
python3 scripts/epub_package_split_harness.py book.epub \
--output-dir split-out --split-points 0,8 --format json
python3 scripts/epub_metadata_edit_harness.py book.epub \
--output metadata.epub --metadata-json '{"title":"新书名"}' --format json
python3 scripts/epub_cover_replace_harness.py book.epub \
--output covered.epub --cover cover.png --format json
-
运行 scripts/epub_lint.py、相关 OPF/nav XML 校验和 validate_text_invariance.py。合并或拆分会改变 package/spine，人工确认报告中的输入、输出、段数和重命名资源。
边界
- harness 拒绝覆盖已存在的输出；不要删除这一保护。
- 合并至少需要两个输入；拆分点必须来自当前书的
split-targets。
- 元数据 JSON 只接受字符串字段。
- 替换封面时同步 OPF cover metadata、
cover-image properties 和本地引用。
- 不在包操作中重写正文、改字体、转换图片或绕过 DRM。
验证
python3 scripts/test_epub_package_harnesses.py
python3 scripts/test_epub_package_tool.py
python3 scripts/validate_skills_basic.py
git diff --check
