DeeplxFile 教程:免费不限大小的 DeepL 文档翻译工具

翻译一整份文档这件事,免费工具总是差一口气:DeepL 免费版不支持 Excel 文件翻译,谷歌翻译拒绝超过 10MB 的大文件,专业文档翻译服务则按页收费。一份几十兆的 Excel 报表、一本几百页的 Word 手册,想免费、完整、保格式地翻成中文,长期没有顺手的工具。

DeeplxFile 就是冲着这个痛点来的:它是一款开源(GPL-3.0)的桌面文件翻译工具,底层调用 DeepL 的翻译能力,主打四个卖点——免费、不限制文件大小、支持超长文本、跨平台。它不光能翻译纯文本,而是直接处理 Word、Excel、PowerPoint 等办公文档,翻译后保留原文档结构,连复杂公式的引用都能正确显示。本文从原理、安装到实操完整讲一遍它该怎么用、边界在哪。

一、功能与原理:三种翻译模式

DeeplxFile 本质上是一个「文档解析 + 翻译通道 + 文档回写」的桌面 GUI 程序:把文档里的文本抽出来,分段送进翻译通道,再把译文按原位置写回文档。它提供三种翻译模式,可用性与资源占用各不相同:

  • DeepLX 模式(默认):通过开源项目 DeepLX 提供的免费 DeepL 接口翻译,速度快、资源占用低,是日常使用的主力模式。代价是高频调用时可能触发 DeepL 的「请求频繁」限制
  • Playwright 模式(v0.5.0 起):不依赖 DeepLX,基于微软的 Playwright 自动化框架,模拟真人打开浏览器、在 DeepL 网页版里复制粘贴并取回译文。兼容性最强,官方称目前没有测出文本长度限制,也能规避 DeepLX 内核的「请求频繁」错误;缺点是速度较慢、占用系统资源较多,设置里可开启「隐藏操作过程」来降低占用。该模式需要 WebKit 浏览器内核(见安装部分的区别)
  • 直连模式:同样不依赖 DeepLX,直接请求 DeepL 服务。最省资源、最原生,但可用性最低,最容易被 DeepL 以「请求频繁」拒绝,适合轻量小文档碰运气

翻译质量方面,它用的是 DeepL 的引擎,多数场景下中英互译质量优于谷歌翻译;官方还特别对比了复杂文档的公式引用显示——谷歌翻译会翻乱的公式引用,DeeplxFile 能正确保留。

支持的文件格式

  • Word(.docx):完全支持
  • Excel(.xlsx):完全支持——这是它相对 DeepL 免费版最大的差异点,大表格也能翻
  • PowerPoint(.pptx):支持翻译大部分内容
  • TXT、Markdown:v0.5.3 起支持
  • PDF:以插件形式支持(仅 Windows):需要另行下载独立的 pdf2docxserver 转换服务,翻译时自动调用,先把 PDF 转成可编辑的 .docx 再翻译

LLM 大模型沉浸式翻译

除 DeepL 通道外,DeeplxFile 还支持用大模型做「沉浸式翻译」:与常规机器翻译不同,你可以给模型指定翻译风格或背景语境,例如自定义要求「这是一封商务信函,使用庄严体翻译」,让译文更贴合文档的实际场景。商务、技术、学术等风格差异明显的文档,用这种方式往往比一刀切的机翻更得体。

二、安装

项目在 GitHub Releases 提供编译好的安装包,Windows 与 macOS 下载即用;Linux 用户可从源码运行。

Windows

  • Full 版(推荐):下载 DeeplxFile_setup_windows_Full.exe 解压安装。自带完整的 WebKit 内核,Playwright 模式稳定性最好
  • Lite 版:不带 WebKit 内核,改调系统自带的 Edge 浏览器,体积小得多;但对 Edge 的支持目前仍在测试阶段,不太需要 Playwright 模式的话可以选它。也可以在设置里自行指定 WebKit 内核路径

macOS

下载 macOS 版本解压后,右键解压出的文件选择「打开终端」,在终端里运行程序(命令以官方说明为准):

# macOS:解压后在所在目录的终端中运行
./deelxfile

注意:macOS 下使用 Playwright 模式需要系统装有 Edge 浏览器,且要求 macOS 12 以上(v0.5.5/v0.5.6 起支持)。

从源码运行(Linux 等其他平台)

# 下载源码后,在项目目录运行 GUI 主程序
python deeplxfile_gui.py

源码运行时有两个额外事项:其一,Playwright 模式所需的 playwright-webkit 需手动下载并放到 ./Lib/webkit 目录(或在 Lib/playwright_process.py 中指定 Playwright 的运行目录);其二,非 Windows 系统需要在 deeplxfile_gui.py 中指定对应平台的 DeepLX,或从 DeepLX 官方项目另行下载一个 DeepLX 运行。

三、使用教程

v0.5.0 之后 DeeplxFile 提供了完整的 GUI 界面与设置选项卡,操作流程很直白:

  • 第 1 步:启动程序。Windows 安装后直接打开;macOS 按上面的方式在终端运行
  • 第 2 步:选择要翻译的文件。把 Word / Excel / PowerPoint / TXT / Markdown 文档选入程序——文件大小没有限制,大文档放心拖
  • 第 3 步:选择翻译模式。默认 DeepLX 模式速度最快;遇到「请求频繁」报错或要翻超长文本时,去设置选项卡切换到 Playwright 模式;也可以在设置里开启登录选项,先登录自己的 DeepL 账号再翻译,可获得更大的字符翻译上限
  • 第 4 步:设定语言。选择源语言与目标语言;文档是多语言混合的,在 Playwright 模式下可强制指定目标语言,避免识别混乱
  • 第 5 步:开始翻译并取回结果。程序自动完成抽取、翻译、回写,生成翻译后的文档。需要对照原文时,按下一节的配置保留原文内容
  • PDF 特别流程(Windows):先下载并双击运行 pdf2docxserver 转换服务且保持它开着,再在 DeeplxFile 里翻译 PDF,程序会自动调用转换服务,先转成可编辑的 .docx 再完成翻译

模式选择建议:日常中小文档用默认 DeepLX 模式,图快;文件很大、文本超长或已经撞上「请求频繁」时,切 Playwright 模式慢慢磨,它胜在稳和不限长度;直连模式只当作前两者的临时备选。先在设置里把登录 DeepL 账号打开也是个稳妥习惯,更大的字符上限能减少中途被限流的概率。

四、配置说明

程序运行后会在其目录下生成 config.json 配置文件。其中最常用的是保留原文开关:

{ "save_original": true }

把 save_original 设为 true,翻译结果中会保留原文,方便逐段对照校对。其余常用选项集中在 GUI 的设置选项卡里:Playwright 模式开关、「隐藏操作过程」(降低 Playwright 模式的资源占用)、登录 DeepL 账号开关、指定 WebKit 内核路径等,改完即用,不必手改文件。

五、局限与注意事项

  • 「请求频繁」是头号坑:DeepLX 与直连模式都依赖 DeepL 的免费通道,高频或大批量翻译时容易被限流拒绝。真遇到时不要反复重试,切换 Playwright 模式或登录 DeepL 账号后再翻是官方给出的解法
  • Playwright 模式慢且占资源:它靠模拟浏览器操作完成翻译,长文档要有耐心;配置一般的机器建议开启「隐藏操作过程」
  • Lite 版的 Edge 路线尚在测试:追求 Playwright 模式稳定性请用 Full 版
  • PDF 能力是外挂式的:依赖单独的 pdf2docxserver,且仅限 Windows;转换效果受 PDF 本身排版复杂度影响,扫描版 PDF 不在它的能力范围内
  • PowerPoint 只支持大部分内容:复杂动画、特殊对象上的文字可能漏翻,翻完务必抽查
  • 非官方通道的固有风险:DeeplxFile 走的是 DeepL 免费接口与网页版,属于非官方使用方式,DeepL 侧策略变化可能导致某个模式阶段性失效;涉密文档也不应走任何在线翻译通道,请用本地化方案处理
  • 版本差异:Playwright 模式、完整 GUI、TXT/Markdown 支持都是 v0.5.x 之后才齐的,下载时认准较新的 Releases 版本
  • 遇到报错先查置顶 Issue:官方 README 明确提示,使用中遇到疑问或错误,先去仓库查看置顶的 issue——DeepL 通道类的常见故障与临时解法通常已经汇总在那里,比自己盲试高效

六、适用人群与小结

DeeplxFile 适合这几类人:经常要把英文 Word/Excel 资料整份翻成中文的办公与外贸从业者;被 10MB 上限卡住过的大文档用户;想白嫖 DeepL 翻译质量、又不想为文档翻译单独付费的个人用户;以及有风格化翻译需求、想试试大模型沉浸式翻译的人。它的边界也清楚:非官方通道决定了它不适合企业级稳定批量生产,更不适合涉密材料。

一句话总结:DeeplxFile 把「DeepL 的翻译质量」和「本地文档工具的自由度」拼在了一起——免费、不限大小、格式保留好,是目前个人文档翻译里性价比极高的一件工具。用好它的关键只有一条:默认模式被限流时,别死磕,切 Playwright 模式继续。

发表回复

后才能评论