作为一个长期关注开源社区的技术爱好者，源码七号站今天要给大家分享两个我最近在GitHub上发现的宝藏项目。第一个是专门解决PDF翻译排版问题的BabelDOC，第二个是保护你隐私数据不被AI泄露的OneAIFW。这两个工具都非常实用，下面我会用最通俗的语言，手把手教你怎么用。
写在前面
相信很多朋友都有过这样的经历：
下载了一篇全英文的学术论文或技术文档，想翻译成中文来看。结果用了某些翻译工具之后，排版全乱了，公式变成了乱码，图表位置跑偏，原本清晰的PDF变得惨不忍睹。
又或者，你在使用ChatGPT、Claude这类AI工具时，不小心把公司邮箱、客户电话、甚至银行卡号这些敏感信息发了出去。事后想想，这些数据会不会被存储下来？会不会被用于模型训练？
如果你也有这些困扰，那今天源码七号站介绍的这两个开源项目，绝对能帮到你。
第一部分：BabelDOC——真正好用的PDF翻译工具
一、为什么说PDF翻译是个老大难问题？
在正式介绍BabelDOC之前，源码七号站想先跟大家聊聊，为什么PDF翻译这件事这么难搞。
PDF这种文件格式，设计的初衷是为了"所见即所得"的打印效果。它把文档的内容、字体、排版、图片全部"固化"在一起，保证你在任何设备上看到的效果都一样。
但问题来了，正是因为这种"固化"的特性，想要提取PDF里的文字进行翻译，再保持原有排版，就变得非常困难。
具体来说，你会遇到这些问题：
问题一：文字提取不完整
很多PDF文档，尤其是扫描版的，文字根本不是"真正的文字"，而是图片。普通的复制粘贴根本提取不出来。就算是文字版PDF，有些特殊字体、特殊编码的内容，提取出来也可能是乱码。
问题二：排版信息丢失
PDF里的标题、正文、页眉页脚、脚注，这些在视觉上能分辨出来的层级关系，在文件内部其实没有明确标记。翻译工具如果不能"理解"这个结构，翻译出来的内容就会乱成一团。
问题三：公式和图表处理困难
学术论文里最多的就是数学公式和各种图表。普通翻译工具要么把公式当成普通文字来翻译（结果变成一堆乱码），要么干脆跳过不处理。图表下面的英文说明，翻译后位置也经常对不上。
问题四：翻译质量参差不齐
很多免费的PDF翻译工具，用的还是几年前的机器翻译引擎。翻译出来的中文生硬、别扭，有些专业术语翻译得驴唇不对马嘴，看得人头疼。
二、BabelDOC是什么？
BabelDOC是一个基于Python开发的开源PDF翻译工具，由funstory-ai团队在GitHub上发布和维护。
项目地址：https://github.com/funstory-ai/BabelDOC
它的核心理念很简单：在保留原始排版的前提下，提供高质量的翻译。
源码七号站在实际测试后发现，这个工具确实做到了以下几点：
- 深度解析PDF结构：它能识别标题、正文、图片注释、表格等不同元素
- 智能保留排版：翻译后的文字会填回原来的位置，不会出现大面积错位
- 支持双语对照：可以生成左边英文、右边中文的对照版本，非常适合学习
- 接入大语言模型：支持GPT-4、DeepSeek、Qwen等主流大模型，翻译质量远超传统机翻
- 公式和特殊字符友好：数学公式不会被错误翻译
三、BabelDOC的技术原理（简单科普）
对于想深入了解这个工具的朋友，源码七号站这里简单讲讲它的工作原理。
整个翻译过程可以分为四个步骤：
步骤一：PDF解析
BabelDOC首先会对PDF文件进行深度解析。它不是简单地把所有文字提取出来，而是会分析每一块内容的位置、大小、字体、颜色等属性。通过这些信息，它能判断出哪些是标题（通常字号大、加粗），哪些是正文，哪些是页眉页脚，哪些是图片下方的说明文字。
步骤二：文本分块
解析完成后，工具会把需要翻译的文本按照逻辑块进行分组。比如一个段落作为一块，一个图片说明作为一块。这样做的好处是，翻译的时候能保持上下文的连贯性，不会出现把一句话拆成两半分别翻译的情况。
步骤三：调用大模型翻译
这一步是质量的关键。BabelDOC支持通过OpenAI兼容的接口调用各种大语言模型。你可以用OpenAI官方的GPT-4o，也可以用国产的DeepSeek、通义千问Qwen等模型。大模型的翻译质量，远远超过传统的统计机器翻译引擎，翻译出来的中文更加流畅自然。
步骤四：重组PDF
翻译完成后，BabelDOC会把译文按照原来的位置填回PDF中。它会自动调整字号和行距，确保译文能够完整显示在原来的区域内。如果选择了双语对照模式，还会生成两栏对照的版本。
四、BabelDOC详细安装教程
下面源码七号站来手把手教你安装这个工具。即使你是完全不懂编程的小白，跟着步骤走也能装好。
前置准备
在安装BabelDOC之前，你需要先确保电脑上有Python环境。
检查是否已安装Python：
打开命令行（Windows用户按Win+R，输入cmd回车；Mac用户打开终端），输入：
python --version
如果显示类似 Python 3.10.x 这样的版本号，说明已经安装好了。如果提示"不是内部或外部命令"，就需要先安装Python。
安装Python：
- 访问Python官网：
https://www.python.org/downloads/ - 下载最新的Python 3.x版本（建议3.10或更高）
- 安装时务必勾选"Add Python to PATH"这个选项
- 安装完成后，重新打开命令行，再次输入
python --version确认
方法一：使用uv工具安装（推荐）
uv是一个现代化的Python包管理工具，速度非常快。BabelDOC官方推荐使用这种方式安装。
第一步：安装uv
在命令行中输入：
# Windows用户
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Mac/Linux用户
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后，关闭命令行窗口，重新打开一个，输入 uv --version 确认安装成功。
第二步：安装BabelDOC
uv tool install babeldoc
等待几分钟，安装完成后，输入 babeldoc --help 查看是否安装成功。如果显示了帮助信息，说明安装成功了。
方法二：使用pip安装
如果你不想安装uv，也可以用Python自带的pip来安装。
pip install babeldoc
如果遇到权限问题，可以加上 --user 参数：
pip install babeldoc --user
方法三：从源码安装
这种方式适合想要修改代码或者使用最新功能的用户。
# 克隆项目代码
git clone https://github.com/funstory-ai/BabelDOC
# 进入项目目录
cd BabelDOC
# 安装依赖（如果使用uv）
uv sync
# 或者使用pip
pip install -e .
五、BabelDOC使用教程
安装完成后，源码七号站来教你怎么用这个工具翻译PDF。
准备工作：获取API Key
BabelDOC本身只是一个翻译框架，真正的翻译工作是由大语言模型完成的。所以你需要先申请一个大模型的API Key。
这里推荐几个选择：
选择一：DeepSeek（推荐，性价比最高）
- 官网：
https://platform.deepseek.com/ - 注册账号后，在控制台创建API Key
- 价格便宜，翻译质量很好，国内访问速度快
选择二：通义千问Qwen
- 官网：
https://dashscope.aliyun.com/ - 阿里云旗下的大模型服务
- 新用户有免费额度
选择三：OpenAI GPT-4o
- 官网：
https://platform.openai.com/ - 翻译质量最好，但价格较贵
- 国内需要特殊网络环境
源码七号站建议新手先用DeepSeek试试水，价格便宜，效果也不错。
基础使用：翻译一个PDF文件
假设你已经有了DeepSeek的API Key（类似 sk-xxxxxxxxxxxxxxxx 这样的字符串），现在要翻译一个名为 paper.pdf 的英文论文。
打开命令行，进入PDF文件所在的目录，输入：
babeldoc \
--files paper.pdf \
--openai \
--openai-model "deepseek-chat" \
--openai-base-url "https://api.deepseek.com" \
--openai-api-key "sk-你的实际key" \
--lang-out zh-CN
参数解释：
--files paper.pdf：指定要翻译的PDF文件--openai：使用OpenAI兼容接口--openai-model：模型名称，DeepSeek用deepseek-chat--openai-base-url：API地址，DeepSeek是https://api.deepseek.com--openai-api-key：你的API密钥--lang-out zh-CN：输出语言为简体中文
按回车后，程序就开始工作了。根据PDF的页数和大小，可能需要几分钟到十几分钟不等。翻译完成后，会在同一目录下生成一个新的PDF文件。
进阶使用：生成双语对照版本
如果你想同时保留英文原文，生成双语对照版本，可以加上 --bilingual 参数：
babeldoc \
--files paper.pdf \
--openai \
--openai-model "deepseek-chat" \
--openai-base-url "https://api.deepseek.com" \
--openai-api-key "sk-你的实际key" \
--lang-out zh-CN \
--bilingual
生成的PDF会显示为左右两栏或上下两栏的对照格式，非常适合学习英语或者需要对照原文确认翻译准确性的场景。
批量翻译多个文件
如果你有多个PDF需要翻译，可以用空格分隔多个文件名：
babeldoc \
--files paper1.pdf paper2.pdf paper3.pdf \
--openai \
--openai-model "deepseek-chat" \
--openai-base-url "https://api.deepseek.com" \
--openai-api-key "sk-你的实际key" \
--lang-out zh-CN
或者使用通配符：
babeldoc \
--files *.pdf \
--openai \
--openai-model "deepseek-chat" \
--openai-base-url "https://api.deepseek.com" \
--openai-api-key "sk-你的实际key" \
--lang-out zh-CN
使用其他大模型
使用通义千问Qwen：
babeldoc \
--files paper.pdf \
--openai \
--openai-model "qwen-turbo" \
--openai-base-url "https://dashscope.aliyuncs.com/compatible-mode/v1" \
--openai-api-key "你的通义千问key" \
--lang-out zh-CN
使用OpenAI GPT-4o：
babeldoc \
--files paper.pdf \
--openai \
--openai-model "gpt-4o" \
--openai-api-key "你的OpenAI key" \
--lang-out zh-CN
注意：使用OpenAI不需要指定base-url，因为默认就是OpenAI的地址。
在线版本：不想折腾命令行？
如果你觉得命令行操作太麻烦，BabelDOC也提供了在线版本：
https://app.immersivetranslate.com/babel-doc/
打开这个网址，直接上传你的PDF文件，选择目标语言，点击翻译即可。不需要安装任何软件，不需要申请API Key，非常方便。
当然，在线版本可能有文件大小限制，而且翻译速度取决于服务器负载。如果你需要翻译大量文件，或者对隐私比较在意，还是建议使用本地安装的版本。
六、BabelDOC实际翻译效果展示
源码七号站用这个工具翻译了几篇不同类型的PDF文档，来看看实际效果如何。
案例一：学术论文
测试文档是一篇关于机器学习的英文论文，包含大量数学公式和图表。
翻译前的问题：手动复制粘贴到翻译软件，公式全部变成乱码，图表说明和正文混在一起。
BabelDOC处理后：数学公式完整保留，没有被翻译成乱码；图表下方的说明文字准确翻译，位置对应正确；中英文对照版本排版整齐，方便对照阅读。
案例二：技术文档
测试文档是某开源软件的英文技术手册，包含大量代码示例。
BabelDOC处理后：代码块完整保留，没有被翻译；注释和说明文字翻译准确；目录和页码引用正确。
案例三：产品说明书
测试文档是某电子产品的英文说明书，包含很多图片和表格。
BabelDOC处理后：图片位置保持不变；表格内的文字翻译后仍在正确的单元格内；整体排版与原文档高度一致。
七、BabelDOC使用小技巧
源码七号站在实际使用过程中，总结了一些提高翻译效果的小技巧，分享给大家。
技巧一：选择合适的模型
不同的大模型，翻译效果和价格都不一样。一般来说：
- DeepSeek：性价比最高，翻译质量好，价格便宜，推荐日常使用
- GPT-4o：翻译质量最好，但价格贵，适合翻译重要文档
- Qwen：新用户有免费额度，可以先试试
技巧二：先预览再翻译
对于比较长的文档，可以先翻译前几页看看效果，确认没问题后再翻译全文。这样可以避免浪费API费用。
技巧三：保存配置
如果你经常使用同样的配置，可以把参数写成一个脚本文件，避免每次都输入一长串命令。
Windows用户可以创建一个 translate.bat 文件：
@echo off
babeldoc ^
--files %1 ^
--openai ^
--openai-model "deepseek-chat" ^
--openai-base-url "https://api.deepseek.com" ^
--openai-api-key "sk-你的实际key" ^
--lang-out zh-CN ^
--bilingual
以后只需要把PDF文件拖到这个bat文件上，就能自动开始翻译了。
Mac/Linux用户可以创建一个 translate.sh 文件：
#!/bin/bash
babeldoc \
--files "$1" \
--openai \
--openai-model "deepseek-chat" \
--openai-base-url "https://api.deepseek.com" \
--openai-api-key "sk-你的实际key" \
--lang-out zh-CN \
--bilingual
然后 chmod +x translate.sh 给脚本加上执行权限，以后运行 ./translate.sh paper.pdf 就可以了。
技巧四：处理扫描版PDF
如果你的PDF是扫描版的（文字其实是图片），BabelDOC可能无法直接处理。这种情况下，需要先用OCR工具把图片转成文字版PDF，再进行翻译。
推荐使用Adobe Acrobat的OCR功能，或者免费的在线OCR工具。
第二部分：OneAIFW——你的AI隐私保护卫士
一、为什么我们需要AI防火墙？
聊完PDF翻译工具，源码七号站再来介绍第二个宝藏项目：OneAIFW，一个专门保护你隐私的AI防火墙。
随着ChatGPT、Claude这类大语言模型的普及，越来越多人开始在工作和生活中使用AI工具。但你有没有想过，你发给AI的那些信息，都去哪了？
举几个常见的场景：
场景一：工作邮件
你让AI帮你写一封邮件，内容是"请帮我给张总（zhangsan@company.com）写封邮件，告诉他下周的会议改到3号会议室"。
这封邮件里包含了：真实的邮箱地址、同事的姓名、公司的会议室编号。
场景二：代码调试
你让AI帮你调试一段代码，代码里包含了数据库连接字符串、API密钥、服务器IP地址等敏感信息。
场景三：个人生活
你让AI帮你规划旅行，告诉它你的身份证号、银行卡号、家庭住址等信息。
这些信息一旦发送给AI，就会被传输到AI公司的服务器上。虽然大多数AI公司都声称会保护用户隐私，但谁也不能百分之百保证数据不会被泄露、不会被用于训练、不会被员工看到。
更何况，很多公司有明确的数据合规要求，禁止员工将公司敏感信息发送到外部服务器。如果你不小心这么做了，可能会面临严重的后果。
二、OneAIFW是什么？
OneAIFW（One AI Firewall）是funstory-ai团队开发的另一个开源项目，它的作用是在你和AI之间建立一道"防火墙"。
项目地址：https://github.com/funstory-ai/aifw
它的工作原理很简单，但非常巧妙：
- 拦截：当你向AI发送消息时，OneAIFW会先拦截这条消息
- 脱敏：检测并替换消息中的敏感信息（邮箱、电话、银行卡等）
- 转发：把脱敏后的消息发送给AI
- 还原：当AI回复时，再把占位符还原成原来的真实信息
整个过程对用户来说是透明的，你看到的是完整的对话，但AI那边收到的是经过处理的安全版本。
三、OneAIFW能检测哪些敏感信息？
源码七号站研究了一下这个项目的代码，它目前支持检测和替换以下类型的敏感信息：
个人身份信息
- 姓名（支持中英文）
- 身份证号
- 护照号码
- 社保号
联系方式
- 电子邮件地址
- 手机号码
- 固定电话号码
- 传真号码
金融信息
- 银行卡号
- 信用卡号
- 银行账户
网络信息
- IP地址
- MAC地址
- URL链接
企业信息
- 公司名称
- 项目代号
- 内部系统名称
地理信息
