Add EPUB translation skill and headless full-book QA with Luna validation

README.md

@@ -1,6 +1,6 @@
 # EPUB Bilingual Translator
 
-大段翻译、全书术语表、严格占位符校验和 Calibre 视觉 QA。
+大段翻译、全书术语表、严格占位符校验、agent 审校 skill 和无桌面 headless QA。
 
 ## 安装与使用
 
@@ -52,6 +52,30 @@ export ZENMUX_API_KEY="$ANTHROPIC_AUTH_TOKEN"
 .venv/bin/python scripts/corpus_regression.py
 ```
 
+### Skill + headless QA（推荐）
+
+[epub-translate skill](skills/epub-translate/SKILL.md) 将全书术语审读、完整批次翻译、工程检查和截图／语义审校串成闭环。已安装到 Codex 时可用 `$epub-translate`。本轮模型默认 Luna agent；不把 Luna 猜成 API 模型名称，不自动启动旧 Sonnet 任务。原生阅读器是可选补充，桌面锁屏不妨碍本流程。
+
+基础 QA 使用项目已有依赖，无需浏览器；可选渲染只增加 Playwright 与 Chromium headless shell：
+
+```bash
+.venv/bin/pip install -r requirements-qa.txt
+export PLAYWRIGHT_BROWSERS_PATH="$PWD/.work/playwright"
+.venv/bin/python -m playwright install chromium --only-shell
+.venv/bin/python scripts/headless_qa.py input/book.epub output/translated_book.epub \
+  --manifest .work/book/manifest.json --render --out .work/book/headless-qa
+```
+
+不加 `--render` 即只做基础审计。Linux 系统运行库和 CJK 字体按部署环境提供。headless 服务仅绑定 loopback，从 EPUB ZIP 读取原样式及资源；书内脚本与外网请求禁用，不用 Calibre／Poppler。渲染器是 Chromium 连续 XHTML，不能代表所有阅读器的分页效果。
+
+报告分别保留原书基线与新增问题；核对 OPF 相对路径、完整清单及源 SHA、实际回填文字、目录层级／目标、NAV 直接链接结构、NAV／NCX／书内目录标题和图片／字体摘要。采样截图检查两格缩进、部号字号、横向溢出与坏图，并实际点击注号及可用的返回链接。`visual_review` 和 `semantic_review` 仍为 pending，需由 agent 查看证据后记录验收。
+
+尾注分成书内注释、外部入口和非注释目标。例如 House of Huawei 原 EPUB 的 1,099 个注号均跳作者按语，该页指向作者尾注网站；报告明确列为 external_notes_gateway，不能把有效作者按语链接说成书内尾注已验收，也不会误判为翻译新增坏链。
+
+Luna agent 的完整测试不调用付费 API：`scripts/agent_book.py prepare/apply/build` 生成全书批次、校验结果摘要并拒绝不完整构建，同时生成中文和双语两版。不同模型使用独立工作目录。批次格式、术语审校及具体命令见 [skill 执行流程](skills/epub-translate/references/workflow.md)。
+
+### 可选 Calibre 辅助 QA
+
 安装 Calibre 和 Poppler，使 `ebook-convert`、`pdftoppm` 在 PATH 中。翻译主流程自动保存结构审计；加 `--visual-qa` 生成页面截图：
 
 ```bash