WARNING
本文档由 AI 自动翻译，可能存在表述差异。如需核对，请参考英文原文。
翻译学术 PDF 并保留排版
PDFMathTranslate 是一款用于翻译学术 PDF 文档的应用，能够在保留原始排版和数学公式的同时完成翻译。
本教程使用兼容 OpenAI API 的本地模型在 Olares 上翻译 PDF。
学习目标
完成本教程后，你将能够：
- 配置本地 AI 模型用于 PDF 翻译。
- 翻译学术 PDF 并管理输出文件。
前提条件
开始前，你需要以下模型：
| 用途 | 模型 | 获取方式 |
|---|---|---|
| 翻译 | Qwen3.6-27B (llama.cpp) | 从 Market 安装 |
安装 PDFMathTranslate
打开 Olares Market，搜索 "PDFMathTranslate"。
点击 Get，然后点击 Install。
安装完成后，点击 Open。PDFMathTranslate 工作区将显示出来。
翻译
上传你的 PDF 文档
PDF 格式要求
请确保 PDF 文件是标准 PDF 文档，未受密码保护且未损坏。该应用无法处理无效的 PDF 文件。
在 File 区域，选择你的输入 Type：
如果选择 File，将 PDF 文档拖放到上传区域，或点击该区域浏览本地存储。
文档上传后，右侧 Preview 窗格中会显示其预览。
如果选择 Link，输入 PDF 文档的链接地址。
此步骤中 Preview 窗格保持空白。翻译完成后，文档内容才会显示在该区域。
获取模型连接信息
PDFMathTranslate 通过 Qwen3.6-27B 的 OpenAI-compatible API 与其连接。
模型连接的工作原理
Olares 上的独立模型作为与客户端应用分开的服务运行。要连接两者，客户端需要准确的 Model name，以及与其所需 API 格式相匹配的 Base URL。
你可以从模型控制台获取这两个值。有关更多信息，可参阅连接 AI 应用。
对于 Qwen3.6-27B (llama.cpp)：
从启动台打开模型应用。其模型控制台会自动打开。
等待模型显示就绪，且引擎显示运行中。
在模型部分，按显示内容原样复制模型名称。
在引擎部分：
a. 连接来源：选择 Olares 内应用。
b. API 格式：选择 OpenAI-Compatible。
c.按显示内容原样复制 Base URL 地址。
使用 OpenAI-Compatible API 格式。模型名称为 unsloth/Qwen3.6-27B-GGUF:Q4_K_M。
配置翻译服务
- 在 PDFMathTranslate 中，从 Service 列表选择 OpenAI。
- 在 OPENAI_BASE_URL 字段中，输入从模型控制台复制的 Base URL。
- 在 OPENAI_API_KEY 字段中，输入任意非空值，例如
none。本地模型 endpoint 不需要 API key。 - 在 OPENAI_MODEL 字段中，输入复制的 Model name。
选择语言和范围
选择源语言和目标语言：
a. Translate from 表示原始文档的语言。
b. Translate to 表示你想要阅读的语言。
INFO
PDFMathTranslate 不会自动检测语言。你必须手动选择。支持的语言包括英语、简体中文、繁体中文、法语、德语、日语、韩语、俄语、西班牙语和意大利语。
指定要翻译的页面：
- All：翻译整个文档。
- First：仅翻译第一页。
- First 5 pages：翻译前五页。
- Others：翻译自定义页面范围。
点击 Translate。翻译将立即开始。
WARNING
翻译过程中请勿点击 Cancel 按钮。这可能会导致进程报错。
下载你的文件
翻译完成后，翻译后的文件将显示在 Preview 窗格中，同时应用会生成三个文件：
- 原始源文件
- 翻译后的文件
- 双语版本
你可以在 Files 应用中找到这些文件。要将它们下载到本地计算机，可以直接从 PDFMathTranslate 工作区下载，或使用 Files 应用。
在 PDFMathTranslate 工作区中
在 pdfmathtranslate 工作区左侧的 Translated 部分，点击文件旁边的下载按钮。
从 Olares Files 应用
打开 Files 应用，然后前往 Data > pdfmathtranslate > pdfmathtranslate。
双击文件，然后点击右上角的下载图标。
常见问题
为什么翻译进度条消失了？
如果翻译过程中刷新页面，进度条可能会从屏幕上消失。这只是显示问题，翻译仍在后台处理中。
等待其完成或检查输出文件夹。
应用会保留同一文件的多个版本吗？
如果你多次翻译同一个文件名，系统会用新版本替换旧版本。它不会创建带编号的副本，例如 file_1.pdf。要保留多个版本，请在再次翻译前重命名你的源文件。
如果应用无响应或耗时异常长，该怎么办？
如果翻译耗时明显比平时长，或应用停止响应，后台进程可能已卡住。要解决此问题，请卸载然后重新安装 pdfmathtranslate。
如何彻底卸载 PDFMathTranslate？
要完全移除应用及其数据：
- 从 Market 或 Desktop 卸载应用。更多信息，请参阅 卸载应用。
- 打开 Files 应用，前往 Application > Data，然后删除
pdfmathtranslate文件夹。