{"skill":{"slug":"pdf2zh-translator","displayName":"pdf2zh-next翻译","summary":"用统一脚本执行 pdf2zh-next。支持单/多PDF、目录批处理、按 glob 筛选；未指定 provider 时按 config.toml 生效；指定 provider 时按官方 --<Services> 参数传给主程序；支持实时监控与并行翻译。","description":"---\nname: translator-pdf2zh\ndescription: 用统一脚本执行 pdf2zh-next。支持单/多PDF、目录批处理、按 glob 筛选；未指定 provider 时按 config.toml 生效；指定 provider 时按官方 --<Services> 参数传给主程序；支持实时监控与并行翻译。\n---\n\n# translator-pdf2zh\n\n## 1) 强制安全边界\n1. 只允许读取 `skills/translator-pdf2zh/config.toml`（相对路径，跨电脑可识别）。\n2. 禁止读取 `openclaw.json` 或任何 agent 内部配置。\n3. 禁止读写全局 `~/.config/pdf2zh/config.v3.toml`。\n4. 运行子进程时必须隔离 HOME/USERPROFILE/XDG_CONFIG_HOME。\n5. 不做运行时 `pip install`。\n\n## 2) 审计声明（避免误判“隐式下载”）\n- 本脚本不内置外部下载逻辑。\n- `pdf2zh-next/babeldoc` 首次运行可能下载模型/字体/cmap（上游行为）。\n\n## 3) 输入能力\n- `--input-file`（可重复）\n- `--input-dir`（可重复）\n- `--include-glob`（可重复）\n- `--workers N`（并行，N>=1）\n- `--visible-monitor`（实时进度）\n\n## 4) Provider 规则\n- 不传 `--provider`：完全按 `config.toml`。\n- 传 `--provider`：\n  - 先校验 provider 在 `config.toml` 顶层存在；\n  - 再校验主程序存在官方 `--<Services>` 参数；\n  - 通过后仅传官方参数。\n\n## 5) 命令模板\n```bash\npython skills/translator-pdf2zh/scripts/run_pdf2zh_pipeline.py \\\n  --input-file \"{PDF路径}\" \\\n  --output-dir \"{输出目录}\" \\\n  --provider \"{可选: openai|deepseek|siliconflow|openaicompatible|...}\" \\\n  --config-path \"skills/translator-pdf2zh/config.toml\" \\\n  --visible-monitor \\\n  --workers 1\n```\n## 6) 帮助\n- 如果Agent无法将用户的需求正确转化为pdf2zh_next主程序所能读懂的参数，Agent需要使用参数`-h`功能运行主程序，读取pdf2zh_next主程序输出的参数说明，确定参数的正确用法。或者是读取官方参考文档`https://pdf2zh-next.com/zh/advanced/advanced.html`","tags":{"latest":"0.0.3"},"stats":{"comments":0,"downloads":605,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1773501472379,"updatedAt":1778491910241},"latestVersion":{"version":"0.0.3","createdAt":1773501907680,"changelog":"Version 0.0.3","license":"MIT-0"},"metadata":null,"owner":{"handle":"mxingchtongaelofficial2568","userId":"s17ch1t55wec4xszsst61bj5eh83hzpx","displayName":"Tiandoufayale","image":"https://avatars.githubusercontent.com/u/45908670?v=4"},"moderation":null}