Clair-ChenShoujie/Babeldoc4GPT

选用指南

AI 根据 README 整理 · 2026/10/27 01:12:27

适用场景

适用于阅读外文论文、技术文档和报告，需要在译文中查看公式、表格和原有页面结构的场景。

查看 README 依据

- 阅读外文论文、技术文档和报告，希望在译文中继续查看公式、表格和原有页面结构。 - 同时获得目标语言 PDF 与中外对照 PDF，方便阅读和核对。 - 先试译几页，再决定是否处理全文；长文需要时可以暂停、保存进度，之后继续。 ## 开始前需要什么 1. **ChatGPT Work，即至少是 PLUS 用户。** 安装器面向 Linux x86_64，支持 Python 3.11–3.13，包内验证使用 Python 3.12。 2. **首次运行所需的网络访问。** 包内含引擎源码；Python 依赖、排版模型和字体需要在沙箱中另外下载。 3. **你要翻译的 PDF。** 建议先用有文字层的文档试译；加密文档需要先提供已解锁的副本。 ChatGPT 服务费用与使用额度仍按账号适用条件执行。可处理的文档规模和耗时，取决于账号能力及沙箱的网络、内存和执行时间。 ## 📦 下载与使用 ### 方式一：导入为插件 1. 从 Releases 下载 [BabelDOC-Cloud.zip](https://github.com/Clair-ChenShoujie/Babeldoc4GPT/releases/download/v0.2.0/BabelDOC-Cloud.zip)。请选择这个安装包，GitHub 自动生成的 Source code 压缩包用于获取仓库源码。

目标用户

面向 ChatGPT Work 用户，至少为 PLUS 用户。

查看 README 依据

- 阅读外文论文、技术文档和报告，希望在译文中继续查看公式、表格和原有页面结构。 - 同时获得目标语言 PDF 与中外对照 PDF，方便阅读和核对。 - 先试译几页，再决定是否处理全文；长文需要时可以暂停、保存进度，之后继续。 ## 开始前需要什么 1. **ChatGPT Work，即至少是 PLUS 用户。** 安装器面向 Linux x86_64，支持 Python 3.11–3.13，包内验证使用 Python 3.12。 2. **首次运行所需的网络访问。** 包内含引擎源码；Python 依赖、排版模型和字体需要在沙箱中另外下载。 3. **你要翻译的 PDF。** 建议先用有文字层的文档试译；加密文档需要先提供已解锁的副本。 ChatGPT 服务费用与使用额度仍按账号适用条件执行。可处理的文档规模和耗时，取决于账号能力及沙箱的网络、内存和执行时间。 ## 📦 下载与使用 ### 方式一：导入为插件 1. 从 Releases 下载 [BabelDOC-Cloud.zip](https://github.com/Clair-ChenShoujie/Babeldoc4GPT/releases/download/v0.2.0/BabelDOC-Cloud.zip)。请选择这个安装包，GitHub 自动生成的 Source code 压缩包用于获取仓库源码。

使用方式

通过导入插件 ZIP 到 ChatGPT 界面，或上传 ZIP 到 Work 任务中使用；支持自然语言指令翻译 PDF。

查看 README 依据

2. **你的 ChatGPT 界面提供插件 ZIP**，通过该入口导入。 3. 在新的 Work 任务中启用 **BabelDOC 云端 PDF 翻译**，上传要处理的 PDF。 4. 发送下一节的试译请求：翻译该 PDF 到中文；翻译该 PDF，双语模式…… 导入入口的可用性以账号界面为准。如果你的账号没有该入口，可以尝试下面的单任务方式。 ### 方式二：在一个 Work 任务中直接使用 将 `BabelDOC-Cloud.zip` 和 PDF 一起上传到具备上述能力的 Work 任务，然后发送： ```text 请在本次 Work 的云沙箱中解压 BabelDOC-Cloud.zip，读取其中的 skills/translate-pdf-cloud/SKILL.md，并按该工作流实际处理附件 PDF。 先将 PDF 的第 1–5 页从英文翻译成中文；不足 5 页则处理全部页面。 使用当前对话完成翻译，不调用额外模型 API，不连接我的电脑。 尽量保留公式、表格和版式，生成中文 PDF、双语 PDF 和可恢复的进度包， 完成后给我可下载的文件。若环境缺少必要能力，请报告具体原因。 ``` 这种方式仅在当前任务中执行工作流，**不会将插件安装到账号**；同样需要可执行代码、可准备依赖的云沙箱。 ## 📝 第一次使用：先试译 5 页

部署要求

需要 ChatGPT Work（至少 PLUS 用户），安装器面向 Linux x86_64，支持 Python 3.11–3.13；首次运行需要网络访问下载依赖和模型；建议使用有文字层的 PDF。

查看 README 依据

- 阅读外文论文、技术文档和报告，希望在译文中继续查看公式、表格和原有页面结构。 - 同时获得目标语言 PDF 与中外对照 PDF，方便阅读和核对。 - 先试译几页，再决定是否处理全文；长文需要时可以暂停、保存进度，之后继续。 ## 开始前需要什么 1. **ChatGPT Work，即至少是 PLUS 用户。** 安装器面向 Linux x86_64，支持 Python 3.11–3.13，包内验证使用 Python 3.12。 2. **首次运行所需的网络访问。** 包内含引擎源码；Python 依赖、排版模型和字体需要在沙箱中另外下载。 3. **你要翻译的 PDF。** 建议先用有文字层的文档试译；加密文档需要先提供已解锁的副本。 ChatGPT 服务费用与使用额度仍按账号适用条件执行。可处理的文档规模和耗时，取决于账号能力及沙箱的网络、内存和执行时间。 ## 📦 下载与使用 ### 方式一：导入为插件 1. 从 Releases 下载 [BabelDOC-Cloud.zip](https://github.com/Clair-ChenShoujie/Babeldoc4GPT/releases/download/v0.2.0/BabelDOC-Cloud.zip)。请选择这个安装包，GitHub 自动生成的 Source code 压缩包用于获取仓库源码。

已知限制

无法保证逐像素复刻，复杂扫描件、特殊字体、密集表格、多栏排版可能影响结果；沙箱文件不宜长期存储。

查看 README 依据

反馈问题时，请附上语言、页码范围、使用方式和具体错误；如方便，可提供不含敏感内容的最小示例 PDF。请勿附带密钥。 ## 隐私与 API 模式 **默认对话模式：** PDF 解析和排版在 Work 云沙箱中执行，待翻译内容由当前对话模型处理，脚本不另行调用外部翻译模型 API。文档会在云端处理，上传前请确认内容适合交给所用的 ChatGPT 服务处理。 **可选 API 模式：** 仅在你明确选择后使用指定的 OpenAI 兼容模型接口，待翻译内容会交给该接口处理，可能产生额外费用。密钥通过环境变量提供，不应粘贴到聊天、配置文件、进度包或问题反馈中。 进度包含原文和译文，分享它就可能同时分享文档内容。 ## 效果与能力边界 目标是保留可读的文档结构，无法保证逐像素复刻。复杂扫描件、特殊字体、密集表格、多栏排版和段落切分都可能影响结果；重要的数字、公式及专业表述仍应对照原文检查。 下载包内提供了可自行查看的两页测试材料： - `tests/sample.pdf`：英文原文。 - `examples/`：对应的中文 PDF、双语 PDF 和术语表。 样例展示了公式、表格和双栏内容的处理形式，也保留了局部间距问题。包内验证来自 Linux 测试环境；你的文档和 Work 环境仍需通过首次试译确认效果。 <details>

**模型选择提示：** 普通文本可以先用支持该工作流的轻量模型试译，不必一开始就选最强的推理模型。专业术语和公式较多的页面建议重点抽查；如果出现漏译或反复的格式校验失败，再考虑换用能力更强的模型。 已导入插件的用户，上传 PDF 后可以使用插件，然后直接发送： ```text 将这份 PDF 的前 5 页从英文译成中文。 ``` 将“英文”和“中文”替换成所需语言。这里的页码按 **PDF 文件中的实际页面顺序，从 1 开始**，不是正文印刷页码。 首次运行需要检查环境、安装依赖并准备资源。试译后，先检查正文与术语，再查看公式、表格和双栏页面是否错位，然后决定是否处理全文。 ### 正式翻译 试译结果可以，请按相同语言设置处理全文。 如果任务需要暂停，请保存可恢复的进度包并给我下载。 长文也可以按 `1–20`、`21–40` 等页码分段处理，逐段检查并保存；需要合并时请另行说明。 完成后，主要文件包括： | 文件 | 用途 | | --- | --- | | 目标语言 PDF | 连续阅读译文 | | 双语 PDF（文件名通常含 `dual`） | 对照原文核查译文 | | 术语表 CSV（如有生成） | 查看、整理术语译法 | | 进度 ZIP | 中途保存，供后续恢复 | 请及时下载结果和进度包，沙箱文件不宜作为长期存储。