Double6 PDF Translation

Double6 PDF Translation

将英文 PDF 翻译为简体中文，尽量保持原始版式，并通过文本与视觉门禁检查成品。

⚠️ 适用范围：本 skill 只针对非扫描版 PDF。对于扫描版 / 图像版 PDF，可能翻译失败或效果较差，请谨慎使用。

运行

先配置用户选择的 OpenAI-compatible Chat Completions 服务；不得假设本地模型或使用内置 默认模型。模型必须显式指定，服务商 URL 推断规则见 references/provider-base-urls.md。

在 skill 根目录运行，并为本次调用显式传入 endpoint、模型和凭据：

python scripts/preflight_runtime.py --strict \
  --provider deepseek --model  --api-key-file 
# 用户确认目标 host 后才做带凭据的联网探测：追加 --allow-endpoint-check

先修复 required 级失败，再开始翻译；可选诊断依赖缺失只减少自动检查。

python scripts/run_pdf_translation.py  \
  --output-dir  \
  --provider deepseek --model  --api-key-file 

也可用参数提供 provider、base URL、model 和 API key；缺任一必要配置时 preflight 必须阻断。 兼容代理、LaTeX 源码、离线模式和诊断参数见 references/workflow.md。

最小依赖

必须安装 pdf2zh_next 并提供其 pdf2zh 命令；推荐安装 PyMuPDF 与 reportlab：

# 通过专用 venv 安装（也可使用 scripts/setup_venv.sh）
pip install pdf2zh_next pymupdf reportlab

PyPI 的旧同名 pdf2zh 不兼容。后端解析顺序和可选工具职责见 references/runtime-dependencies.md。

输出

普通交付只保留两份 PDF：

• <原文件名>.zh.pdf：最终中文单语 PDF。
• <原文件名>.bilingual.pdf：默认中文译文在左、英文原文在右的双语 PDF；可用 --bilingual-layout en-left-zh-right 切换旧布局。

同时保留 render_manifest.json；内部 gate 明细仅在调试或失败时报告。

LaTeX 与降级

只使用 --latex-source 或 --latex-source-root 显式批准的本地 LaTeX 源码。arXiv 和 Docker 默认关闭，分别只在用户 同意并显式传入 --allow-arxiv-source-autodownload、--latex-compile-runtime docker 时启用。

安全与副作用

• 权限为 file_read（用户 PDF／显式批准的可信源码）、file_write（默认仅 --output-dir）、 network（获批模型 endpoint）和 shell（本地 Python／PDF 工具）；宿主必须按此最小授权。
• 发送文档前须确认 endpoint；key 不得写入日志或产物，子进程只继承白名单环境变量。
• 输入只读；输出、QA 中间件和本地质量记录只写 --output-dir。
• arXiv 与 Docker 只接受上述显式 opt-in，不得自动代用户开启。
• 本地兼容代理默认关闭；仅 --translation-compat-proxy on 会监听回环地址。--engine-home 可显式选择输出目录之外的缓存路径。
• 本地代理忽略调用方的认证头，向上游只使用本次显式配置的 key，避免成为任意凭据中继。

翻译规则

使用准确、可读的简体中文，保护公式、标识符、引用和专名；完整规则见 references/academic-translation-policy.md。文本层为空时报告需要 OCR；版式不足、大段同文 回退或 delivery gate 为 partial/blocking 时交付诊断，不能接受退化 PDF。

参考

工作流、依赖、平台陷阱、翻译政策、术语模板和服务商 URL 映射均在 references/ 中按需读取。