double6-pdf-translation v1.0.7A

Immutable. This exact content is served forever at /api/v1/blob/b159be048b712ddf.

---
name: double6-pdf-translation
version: 1.0.7
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、模型和凭据：

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

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

```bash
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`。

```bash
# 通过专用 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`：默认英文原文在左、中文译文在右；左右方向以打开文件后的几何核验为准，可用 `--bilingual-layout zh-left-en-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/` 中按需读取。