wxyhgk/retain-pdf

在保留版面、公式与结构的前提下进行 PDF 翻译,适用于科研与技术文档

Python

2,628

1,568 commits

updated Oct 16, 2026

See the code

README

RetainPDF:PDF 保留排版翻译工具

中文 · English · Tiếng Việt

RetainPDF

RetainPDF 是目前唯一面向图片型 / 扫描版 PDF、支持保留排版翻译的开源项目,翻译与排版效果对标甚至超过同类商业产品。

自研字体排版算法,支持复杂公式与多栏论文的版式还原。扫描 PDF 翻译、PDF 结构优化、代码保护、自定义翻译策略和开放 API,一并支持。

翻译系统同样自研,针对跨栏、跨页、断句和段落续接等 PDF 常见难题做了专门处理:先恢复完整语义单元,再进行翻译,避免逐框翻译造成的上下文割裂。

在行内公式部分 RetainPDF 的断层领先:翻译后仍能稳定保留公式本体、前后文关系与行内排版,这是其他开源 PDF 翻译项目目前做不到的。

代码、API 与部署方式全部开放,支持自部署和二次开发。

核心能力对比:

项目扫描型 PDF复杂行内公式代码不误翻表格控制自定义翻译策略排版保留PDF 压缩优化API 自动化
PDFMathTranslate❌❌❌弱弱一般一般✅
PolyglotPDF❌❌❌弱弱一般一般✅
Doc2X✅✅❌中弱强弱❌ 不开放
RetainPDF✅✅ 强保留✅✅ 可开关✅ 可按规则配置强✅ 持续优化✅

产品界面

图书馆

在一个书架中管理论文、图书和扫描文档,集中查看翻译状态、合集与收藏。

RetainPDF 图书馆主页

原文与译文对照阅读

原 PDF 与译文 PDF 同页并排展示,便于核对公式、图表、引用和版面位置。

RetainPDF 原文与译文对照阅读

Markdown 阅读

PDF 与 Markdown 同屏阅读,保留公式和图片。

RetainPDF Markdown 阅读

文档 AI 问答

直接围绕当前文档提问,回答附带页码和原文引用;需要修改 PDF 时可显式切换到 PDF Agent。

RetainPDF 文档 AI 问答与引用

翻译效果

SCI 论文、图片型 / 扫描版 PDF 与图书教材的原文—译文对照样例:

RetainPDF SCI 论文、扫描 PDF 与图书教材翻译效果合集

第一行:SCI 论文 · 第二行:扫描与公式密集文档 · 第三行:图书教材

快速开始

从 GitHub Releases 下载对应版本:

  • Windows:Setup.exe
  • macOS:.dmg
  • Linux:.deb

桌面端

RetainPDF 桌面端图书馆

macOS 若提示应用“已损坏”,将应用拖入 /Applications 后执行:

sudo xattr -r -d com.apple.quarantine /Applications/RetainPDF.app

Docker 部署

git clone https://github.com/wxyhgk/retain-pdf.git
cd retain-pdf/ops/deployment/docker/delivery
docker compose up -d

启动后访问 http://127.0.0.1:40001。更新服务:

docker compose pull
docker compose up -d

更多配置见 Docker 部署说明;多账号登录、按页计费的多用户版(商业版)部署见其中的「多用户模式」一节。

交流

QQ 交流群:1101779791

RetainPDF QQ 交流群二维码

开发

参阅 贡献指南、项目文档和后端说明。

License

This project is distributed under the MIT License. See LICENSE for the full text.

document-ai
document-processing
layout-preserving
ocr
pdf
scientific-papers
translation
typst

Significant stargazers

myd7349

269 followers · starred Jun 2026

OrangeX4

855 followers · starred Apr 2026

Zhe Lee

35 followers · starred Oct 2026

Banghao Chi

34 followers · starred May 2026

wxyhgk/retain-pdf

在保留版面、公式与结构的前提下进行 PDF 翻译,适用于科研与技术文档

Python

2,628

1,568 commits

updated Oct 16, 2026

See the code

README

RetainPDF:PDF 保留排版翻译工具

中文 · English · Tiếng Việt

RetainPDF

RetainPDF 是目前唯一面向图片型 / 扫描版 PDF、支持保留排版翻译的开源项目,翻译与排版效果对标甚至超过同类商业产品。

自研字体排版算法,支持复杂公式与多栏论文的版式还原。扫描 PDF 翻译、PDF 结构优化、代码保护、自定义翻译策略和开放 API,一并支持。

翻译系统同样自研,针对跨栏、跨页、断句和段落续接等 PDF 常见难题做了专门处理:先恢复完整语义单元,再进行翻译,避免逐框翻译造成的上下文割裂。

在行内公式部分 RetainPDF 的断层领先:翻译后仍能稳定保留公式本体、前后文关系与行内排版,这是其他开源 PDF 翻译项目目前做不到的。

代码、API 与部署方式全部开放,支持自部署和二次开发。

核心能力对比:

项目扫描型 PDF复杂行内公式代码不误翻表格控制自定义翻译策略排版保留PDF 压缩优化API 自动化
PDFMathTranslate❌❌❌弱弱一般一般✅
PolyglotPDF❌❌❌弱弱一般一般✅
Doc2X✅✅❌中弱强弱❌ 不开放
RetainPDF✅✅ 强保留✅✅ 可开关✅ 可按规则配置强✅ 持续优化✅

产品界面

图书馆

在一个书架中管理论文、图书和扫描文档,集中查看翻译状态、合集与收藏。

RetainPDF 图书馆主页

原文与译文对照阅读

原 PDF 与译文 PDF 同页并排展示,便于核对公式、图表、引用和版面位置。

RetainPDF 原文与译文对照阅读

Markdown 阅读

PDF 与 Markdown 同屏阅读,保留公式和图片。

RetainPDF Markdown 阅读

文档 AI 问答

直接围绕当前文档提问,回答附带页码和原文引用;需要修改 PDF 时可显式切换到 PDF Agent。

RetainPDF 文档 AI 问答与引用

翻译效果

SCI 论文、图片型 / 扫描版 PDF 与图书教材的原文—译文对照样例:

RetainPDF SCI 论文、扫描 PDF 与图书教材翻译效果合集

第一行:SCI 论文 · 第二行:扫描与公式密集文档 · 第三行:图书教材

快速开始

从 GitHub Releases 下载对应版本:

  • Windows:Setup.exe
  • macOS:.dmg
  • Linux:.deb

桌面端

RetainPDF 桌面端图书馆

macOS 若提示应用“已损坏”,将应用拖入 /Applications 后执行:

sudo xattr -r -d com.apple.quarantine /Applications/RetainPDF.app

Docker 部署

git clone https://github.com/wxyhgk/retain-pdf.git
cd retain-pdf/ops/deployment/docker/delivery
docker compose up -d

启动后访问 http://127.0.0.1:40001。更新服务:

docker compose pull
docker compose up -d

更多配置见 Docker 部署说明;多账号登录、按页计费的多用户版(商业版)部署见其中的「多用户模式」一节。

交流

QQ 交流群:1101779791

RetainPDF QQ 交流群二维码

开发

参阅 贡献指南、项目文档和后端说明。

License

This project is distributed under the MIT License. See LICENSE for the full text.

document-ai
document-processing
layout-preserving
ocr
pdf
scientific-papers
translation
typst

Significant stargazers

myd7349

269 followers · starred Jun 2026

OrangeX4

855 followers · starred Apr 2026

Zhe Lee

35 followers · starred Oct 2026

Banghao Chi

34 followers · starred May 2026