常见问题

常规

什么是 Doco Translate？

Doco Translate 是一款用于翻译 PDF 文档的原生 macOS 应用程序。它支持本地 PDF 和在线 PDF 链接，具有布局保留、双语阅读、重排模式、扫描文档 OCR、术语表和多种导出格式等功能。

Doco Translate 是免费的吗？

Doco Translate 可在 Mac App Store 上获取。某些功能可能需要 Pro 订阅。基础翻译服务（Google、Microsoft、Yandex）可免费使用。AI 服务需要您从相应提供商获取自己的 API 密钥。

系统要求是什么？

Doco Translate 需要 macOS 15 (Sequoia) 或更高版本。

Doco Translate 支持哪些文件格式？

Doco Translate 专注于PDF 翻译。您可以打开本地 PDF 文件或从有效的在线 URL 翻译 PDF 文件。不支持其他文档格式（Word、PowerPoint 等）。

Doco Translate 可以离线使用吗？

Doco Translate 本身需要互联网连接来使用基于云的翻译服务。但是，如果您配置了本地 LLM 服务（Ollama 或 LM Studio），下载模型后可以完全离线翻译文档。

翻译

如何翻译扫描 PDF？

在 Doco Translate 中打开扫描 PDF。
应用会检测到它是扫描文档。
会出现提示要求您指定源语言。
选择正确的源语言以提高 OCR 准确性。
应用会对页面进行 OCR，然后翻译提取的文字。

为什么 OCR 质量差？

OCR 质量取决于几个因素：

源语言： 指定正确的源语言可以显著提高准确性。
文档质量： 低分辨率扫描或歪斜的页面会产生更差的结果。
字体类型： 装饰性或手写字体更难识别。

我可以翻译 PDF 中的图片吗？

可以。在翻译设置中启用翻译图片。Doco Translate 会 OCR 图片（图片和表格）中的文字，并使用您选择的服务进行翻译。图片翻译需要支持多模态输入的 AI/LLM 服务。

为什么某页翻译失败？

翻译失败的常见原因：

网络问题： 检查您的互联网连接。
API 密钥问题： 验证您的 API 密钥是否有效且未过期。
速率限制： 您可能已超出提供商的速率限制。稍等片刻后重试。
服务中断： 翻译提供商可能暂时不可用。

您可以在失败页面上点击重试或切换到其他翻译服务。

我可以对不同页面使用不同的服务吗？

可以。您可以使用不同的服务重新翻译单个段落或页面。选中段落，然后使用工具栏中的服务选择器选择替代服务。

术语表如何工作？

术语表为特定术语定义首选翻译。当术语表启用时，Doco Translate 会在将文本发送到翻译服务之前替换匹配的源术语。这确保文档中术语的一致性。

服务

我需要 API 密钥吗？

基础服务（Google、Microsoft、Yandex）：不需要 API 密钥。
AI 服务（Gemini、OpenAI、Claude 等）：是的，您需要自己的 API 密钥。
本地服务（Ollama、LM Studio）：不需要 API 密钥。

如何获取 API 密钥？

每个 AI 服务都有自己的 API 密钥生成流程。在 Doco Translate 中，前往设置 → 服务，选择服务，然后点击申请 API 密钥链接。这会打开提供商的网站，您可以在那里创建账户并生成密钥。

我可以添加自定义翻译服务吗？

可以。在设置 → 服务中点击自定义服务。您可以添加与以下格式兼容的服务：

OpenAI API 格式 — /v1/chat/completions
Anthropic API 格式 — /v1/messages
Gemini API 格式 — /v1beta/models
Ollama 格式 — /api/chat
LM Studio 格式 — /api/v1/chat

这适用于私有部署、代理端点或未包含在默认列表中的模型提供商。

PDF — 保留布局的翻译文本
图片（JPEG） — 所有页面合并为一张图片
纯文本 — 带段落的简单文本文件
Markdown — 文件夹中带图片的结构化文本

文档和翻译记录存储在您的设备上。
设置、服务配置和术语表存储在本地。
Doco Translate 不收集个人信息或使用分析。

我的文本会发送到外部服务器吗？

当您使用云翻译服务（Google、Microsoft、AI 服务等）时，翻译所需的文本内容会发送到该提供商。如果您使用本地服务（Ollama、LM Studio），数据不会离开您的机器。

如何最大化隐私？

要获得最私密的工作流程：

使用 Ollama 或 LM Studio 作为翻译服务。
保持所有设置为默认值（本地存储）。
避免使用基于云的服务。

始终审查您连接的任何第三方翻译服务的隐私政策和实践。

故障排除

应用运行缓慢或无响应

如果使用本地 LLM 服务，尝试较小的模型或降低最大并发页面数设置。
如果使用云服务，检查您的网络连接。
如果应用无响应，请重启应用。

翻译质量差

尝试其他翻译服务。AI 服务通常比基础服务产生更好的结果。
使用更大/更强大的模型（例如从 flash/mini 模型切换到 pro 模型）。
明确设置源语言，而不是使用自动检测。
为领域特定术语创建术语表。

我无法打开 PDF

确保文件是有效的 PDF 文档。
如果从 URL 打开，验证 URL 是否直接指向 PDF 文件。
检查文件是否损坏或受密码保护。

设置更改没有生效

某些设置（如界面语言）需要重启应用。
翻译服务更改会在下一个翻译操作时生效。
点击重新加载以使用新设置重新解析和重新翻译文档。

上一步： 自定义服务 · 下一步： 更新日志