Double6 PDF Translation

读取用户提供的非扫描版 PDF（可选显式批准的本地 LaTeX 源码），把抽取文本发送到用户显式指定的 OpenAI 兼容服务进行翻译，在本地运行 Python/PDF 子进程，输出中文单语 PDF、双语 PDF 与运行清单，并通过文本残留、版式和交付门禁检查成品质量。

double6-ai

热度 46.46

最近更新 2026-09-03 17:52:19

分类：效率依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：翻译 / 文件转换 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add double6-pdf-translation

Metadata

name: double6-pdf-translation
version: 1.0.5
description: Translate user-supplied text PDFs into Simplified Chinese and bilingual PDFs. Reads the PDF and only explicitly selected local LaTeX, sends extracted text to an explicitly approved OpenAI-compatible endpoint, runs local PDF/Python subprocesses, and writes outputs, diagnostics, and the default runtime cache under the chosen directory. Local proxy, arXiv download, Docker compilation, and external cache paths require explicit command-line opt-in.
metadata: {"openclaw":{"homepage":"https://github.com/double6-ai/double6-skills/tree/main/skills/double6-pdf-translation","emoji":"📑","requires":{"anyBins":["python3","python","py"]}}}

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 <model-name> --api-key-file <key-file>
# 用户确认目标 host 后才做带凭据的联网探测：追加 --allow-endpoint-check

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

python scripts/run_pdf_translation.py <input-file.pdf> \
  --output-dir <output-dir> \
  --provider deepseek --model <model-name> --api-key-file <key-file>

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

最小依赖

必须安装 PyPI 包 pdf2zh_next。它会提供本 skill 使用的 pdf2zh 命令；不要安装同名旧包 pdf2zh。

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

PyMuPDF 会随 pdf2zh_next 带入，不必再单独安装。Poppler、reportlab、TeX Live、Docker、RapidOCR 只用于可选诊断或显式 LaTeX 路径，不是主翻译所需。后端解析顺序见 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/ 中按需读取。