菜单
用纯 Python 标准库整理已有 EPUB 的资源目录，并按固定顺序先格式化、再按 OPF manifest id 还原被混淆的资源文件名，同步重写 OPF、XHTML、CSS、NCX、SVG、SMIL 和标准字体混淆 URI。用于 EPUB 内部路径散乱、文件名不可读、需要先做结构规范化再精排，或用户明确要求文件名反混淆时；不用于 DRM 解密。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | epub-structure-normalizer |
| description | 用纯 Python 标准库整理已有 EPUB 的资源目录，并按固定顺序先格式化、再按 OPF manifest id 还原被混淆的资源文件名，同步重写 OPF、XHTML、CSS、NCX、SVG、SMIL 和标准字体混淆 URI。用于 EPUB 内部路径散乱、文件名不可读、需要先做结构规范化再精排，或用户明确要求文件名反混淆时；不用于 DRM 解密。 |
使用 scripts/epub_structure_tool.py 处理已有 EPUB。脚本只依赖 Python 标准库，始终写出新文件，不原地覆盖输入。
默认使用 normalize，固定执行：
原始 EPUB -> format 目录格式化 -> deobfuscate-filenames 文件名反混淆 -> normalized EPUB
normalize 内部使用临时中间 EPUB，并只保留最终输出。不要跳过格式化直接执行文件名反混淆，除非正在定位单步故障。
format：把 manifest 资源整理到 OPF 同级的 Text/、Styles/、Images/、Fonts/、Audio/、Video/、Misc/，保留原文件名。deobfuscate-filenames：整理目录，并优先按 OPF manifest id 生成可读文件名。normalize：先执行 format，再执行 deobfuscate-filenames。这是正常使用入口。META-INF/encryption.xml 的 URI，不修改字体字节。local() fallback，并把 missing-css-font-fallback 警告交给人工复核。epub-package-nav-auditor。mkdir -p work/before work/after
cp input.epub work/before/source.epub
python3 scripts/epub_structure_tool.py inspect \
work/before/source.epub \
--report-format json
python3 scripts/epub_structure_tool.py normalize \
work/before/source.epub \
--output work/after/step-0-normalized.epub \
--dry-run \
--report-format json > work/step-0-normalize.dry-run.json
mappings 和 warnings，移除 --dry-run 写出新 EPUB，并保存实际报告：python3 scripts/epub_structure_tool.py normalize \
work/before/source.epub \
--output work/after/step-0-normalized.epub \
--report-format json > work/step-0-normalize.json
python3 scripts/validate_text_invariance.py \
work/before/source.epub \
work/after/step-0-normalized.epub \
--check all \
--path-map work/step-0-normalize.json
python3 scripts/epub_preflight_harness.py \
work/after/step-0-normalized.epub \
--format json
如果 inspect 已确认 META-INF/encryption.xml 只含 EPUB 标准字体混淆，在红线命令额外添加 --allow-font-obfuscation。
只在定位故障时分别运行：
python3 scripts/epub_structure_tool.py format input.epub --output formatted.epub --dry-run
python3 scripts/epub_structure_tool.py deobfuscate-filenames formatted.epub --output deobfuscated.epub --dry-run
deobfuscate-filenames 描述成内容解密或 DRM 解密。mappings 的情况下批量覆盖输出。validate_text_invariance.py 和 diff review。scripts/epub3_migration_harness.py。修改脚本或本 skill 后至少运行：
python3 scripts/test_epub_structure_tool.py
python3 scripts/test_validate_text_invariance.py
python3 scripts/validate_skills_basic.py
git diff --check
行为目标参考 cnwxi/epub_tool 的 reformat 与文件名 decrypt 工作流。本仓脚本是重新实现的 stdlib-only 保守版本；第三方说明见 THIRD_PARTY.md。
用于 EPUB 出现生僻字、方块字、跨阅读器字形不一致、Kindle 字体回退失败，或需要验证嵌入字体、子集字体和候选大字库是否覆盖全书字符时。
优化中文/CJK EPUB 排版，包括正文节奏、font-family 链、嵌入字体、生僻字 fallback、标题字体、中西文混排和阅读器安全段落间距。用于文字拥挤、裁切、跨阅读器字体不一致或字体规则需要清理时。
将 EPUB 封面式页面、卷首、章首或海报页转换为项目的 A-lite 可重排全页方案，同时保留原有图文叠加构图、文字、图片和资源。
重构和维护 EPUB CSS 分层。用于 CSS 规则重复、放错文件、层级边界不清，或新增正文、弹注、文字效果、文学结构、图片混排、竖排、A-lite 海报等样式时。
优化英文 EPUB 书籍排版，包括书籍类型判断、英语语言标记、serif 字体链、段落缩进、标题层级、插图、断字、引用/诗歌/信件、Kindle/Readest/Apple Books 大字号回归。用于英文小说、散文、非虚构或英文为主的 EPUB 需要形成可重排、可验证的排版方案时。
优化 EPUB 图片版式、figure 环绕、图注、栅格格式、封面声明与阅读器兼容性。用于图片过小、裁切、Kindle 空白、图文环绕差、缺图注，或封面/海报图片处理需要 EPUB 安全规则时。