作为GPT插件，在 ChatGPT Work 中翻译 PDF。
该翻译有什么特殊？？
首先！！你使用自己的GPT官网额度！！
其次！！翻译的内容保留原文的公式、表格，以及原版式！！ 支持生成两类：中文翻译pdf，以及中外双语 PDF。
最后！！支持你自己的API！！
阅读外文论文或技术资料时，除了看懂文字，也需要让公式和图表与正文对应。Babeldoc4GPT 将当前对话模型的翻译能力与 BabelDOC 的 PDF 解析、排版能力结合起来：上传文档、说明语言和页码，即可在 Work 云沙箱中完成翻译与文件生成，无需在自己的电脑上部署服务。
默认使用当前对话完成翻译，也支持使用你提供的 API Key 进行翻译，本插件不会保留你的信息。
下面是 Attention Is All You Need 第 4 页的实际翻译结果，包含 3.2.1 节、缩放点积注意力公式和多头注意力示意图。左侧为英文原文，右侧为中文译文。
查看中文单页预览
示例由本工具实际导出，预览直接渲染自 PDF，未做图像修饰。图内英文标签保留，个别行内公式附近仍有细线残留，可下载 PDF 放大查看。
来源：Vaswani et al., Attention Is All You Need, arXiv:1706.03762v7，第 4 页。中文为非官方译文，用于展示翻译效果。
- 阅读外文论文、技术文档和报告，希望在译文中继续查看公式、表格和原有页面结构。
- 同时获得目标语言 PDF 与中外对照 PDF，方便阅读和核对。
- 先试译几页，再决定是否处理全文；长文需要时可以暂停、保存进度，之后继续。
- ChatGPT Work，即至少是 PLUS 用户。 安装器面向 Linux x86_64，支持 Python 3.11–3.13，包内验证使用 Python 3.12。
- 首次运行所需的网络访问。 包内含引擎源码；Python 依赖、排版模型和字体需要在沙箱中另外下载。
- 你要翻译的 PDF。 建议先用有文字层的文档试译；加密文档需要先提供已解锁的副本。
ChatGPT 服务费用与使用额度仍按账号适用条件执行。可处理的文档规模和耗时，取决于账号能力及沙箱的网络、内存和执行时间。
- 从 Releases 下载 BabelDOC-Cloud.zip。请选择这个安装包，GitHub 自动生成的 Source code 压缩包用于获取仓库源码。
- 你的 ChatGPT 界面提供插件 ZIP，通过该入口导入。
- 在新的 Work 任务中启用 BabelDOC 云端 PDF 翻译，上传要处理的 PDF。
- 发送下一节的试译请求：翻译该 PDF 到中文；翻译该 PDF，双语模式……
导入入口的可用性以账号界面为准。如果你的账号没有该入口，可以尝试下面的单任务方式。
将 BabelDOC-Cloud.zip 和 PDF 一起上传到具备上述能力的 Work 任务，然后发送：
请在本次 Work 的云沙箱中解压 BabelDOC-Cloud.zip，读取其中的
skills/translate-pdf-cloud/SKILL.md，并按该工作流实际处理附件 PDF。
先将 PDF 的第 1–5 页从英文翻译成中文；不足 5 页则处理全部页面。
使用当前对话完成翻译，不调用额外模型 API，不连接我的电脑。
尽量保留公式、表格和版式，生成中文 PDF、双语 PDF 和可恢复的进度包，
完成后给我可下载的文件。若环境缺少必要能力，请报告具体原因。
这种方式仅在当前任务中执行工作流，不会将插件安装到账号；同样需要可执行代码、可准备依赖的云沙箱。
模型选择提示： 普通文本可以先用支持该工作流的轻量模型试译，不必一开始就选最强的推理模型。专业术语和公式较多的页面建议重点抽查；如果出现漏译或反复的格式校验失败，再考虑换用能力更强的模型。
已导入插件的用户，上传 PDF 后可以使用插件，然后直接发送：
将这份 PDF 的前 5 页从英文译成中文。
将“英文”和“中文”替换成所需语言。这里的页码按 PDF 文件中的实际页面顺序，从 1 开始，不是正文印刷页码。
首次运行需要检查环境、安装依赖并准备资源。试译后，先检查正文与术语，再查看公式、表格和双栏页面是否错位，然后决定是否处理全文。
试译结果可以，请按相同语言设置处理全文。
如果任务需要暂停，请保存可恢复的进度包并给我下载。
长文也可以按 1–20、21–40 等页码分段处理，逐段检查并保存；需要合并时请另行说明。
完成后，主要文件包括：
| 文件 | 用途 |
|---|---|
| 目标语言 PDF | 连续阅读译文 |
双语 PDF（文件名通常含 dual） |
对照原文核查译文 |
| 术语表 CSV（如有生成） | 查看、整理术语译法 |
| 进度 ZIP | 中途保存，供后续恢复 |
请及时下载结果和进度包，沙箱文件不宜作为长期存储。
工作流会分批提交译文，并记录已经接受的结果。如果暂时不继续，可以说：
请暂停当前任务，等当前执行步骤结束后导出可恢复的进度 ZIP，并给我下载。
继续时：
- 仍在原来的可用沙箱中： 要求继续原任务，不要另建重复任务。
- 换了任务或沙箱： 准备好工作流，上传之前保存的进度 ZIP，要求导入并继续。
| 情况 | 建议处理方式 |
|---|---|
| 导入后没有加载工作流 | 尝试 ZIP 与 PDF 一起上传的单任务方式，并让 Work 读取包内 SKILL.md。 |
| 安装依赖、字体或模型失败 | 要求提供具体下载错误，确认沙箱网络是否允许访问资源。不要为了绕过安装失败而改用翻译 API。 |
| 单步执行超时或任务中断 | 先检查原任务状态和日志；在环境允许时调整单步时间后继续，避免反复新建任务。 |
| 提示译文格式校验失败 | 让工作流修复对应批次的段落 ID、公式占位符或格式，再提交。不要跳过校验直接交付。 |
| 排版错位、漏译或扫描件效果不佳 | 先缩小到有问题的几页复现并检查；必要时提供文字层更清晰的 PDF。 |
| 原沙箱文件已经丢失 | 上传已下载的进度包恢复；没有进度包时，不能保证找回已完成的译文。 |
反馈问题时，请附上语言、页码范围、使用方式和具体错误；如方便，可提供不含敏感内容的最小示例 PDF。请勿附带密钥。
默认对话模式： PDF 解析和排版在 Work 云沙箱中执行，待翻译内容由当前对话模型处理，脚本不另行调用外部翻译模型 API。文档会在云端处理，上传前请确认内容适合交给所用的 ChatGPT 服务处理。
可选 API 模式： 仅在你明确选择后使用指定的 OpenAI 兼容模型接口，待翻译内容会交给该接口处理，可能产生额外费用。密钥通过环境变量提供，不应粘贴到聊天、配置文件、进度包或问题反馈中。
进度包含原文和译文，分享它就可能同时分享文档内容。
目标是保留可读的文档结构，无法保证逐像素复刻。复杂扫描件、特殊字体、密集表格、多栏排版和段落切分都可能影响结果；重要的数字、公式及专业表述仍应对照原文检查。
下载包内提供了可自行查看的两页测试材料：
tests/sample.pdf：英文原文。examples/：对应的中文 PDF、双语 PDF 和术语表。
样例展示了公式、表格和双栏内容的处理形式，也保留了局部间距问题。包内验证来自 Linux 测试环境；你的文档和 Work 环境仍需通过首次试译确认效果。
进阶：实现与执行接口
当前工作流版本为 0.2.0，包含 BabelDOC 0.6.2 和 PDFMathTranslate Next 2.9.0 源码。普通用户通过自然语言使用即可，无需手动运行命令。
实现位于包内 skills/translate-pdf-cloud/，完整执行约定见该目录下的 SKILL.md。脚本以 UTF-8 JSON 文件接收参数，主要流程为：
环境检查与依赖安装 → prepare_assets → create_job
→ advance → 当前对话翻译 → submit_results（循环）
→ 确认 completed → export_files
export_checkpoint / import_checkpoint 用于导出和恢复进度；get_status 用于查看状态。没有待翻译请求不等于任务完成，PDF 仅在引擎完成后导出。
代码支持另行提供离线模型、字体及匹配的依赖 wheels；Releases 中的普通安装包不含这些资源。
新增云端适配代码采用 AGPL-3.0-or-later，许可证文本随 ZIP 中的 LICENSE 提供。所包含的上游代码、字体及模型资源保留各自的许可证与使用条件。
感谢 BabelDOC 与 PDFMathTranslate Next 提供 PDF 解析、翻译流程和排版基础。本项目围绕这些能力适配 Work 云端任务、当前对话翻译及可恢复进度。