allTranslate 基于 guaguastandup/zotero-pdf2zh 项目继续优化，重点改进了论文 PDF 中表格区域的识别、保留与翻译流程，使复杂版式下的译文质量和排版稳定性达到商用收费软件水平。
项目面向本地命令行和本地 WebUI 使用，不再提供容器相关启动方式。翻译器的 key、url、模型等信息被拆分到单独配置文件中：提交到 GitHub 的 translator_config.json 使用 xx 隐藏敏感值，本地运行时自动读取未提交的 translator_config.local.json。
allTranslate 不做整页 OCR，而是直接解析 PDF 内部文字、字体、坐标和图形结构。程序先用版面分析模型识别正文、标题、图片、表格等区域，再按段落或表格单元组织待翻译文本，调用配置的翻译服务生成译文，最后把译文写回原始版面，输出单语译文 PDF 和双语对照 PDF。
表格优化的核心思路是减少“把表格当普通正文”的误判：在布局检测阶段保留表格边界与单元结构，在翻译阶段按更细粒度处理表格内容，在回写阶段尽量维持原表格的列宽、行高和文字位置，从而减少错列、串行、遮挡和表格整体漂移。
- 安装 Python 3.11 或 3.12。
- 在项目根目录安装依赖：
pip install -e .- 按需编辑公开配置
config.json和translator_config.json。真实 key、url 请写入translator_config.local.json，该文件已加入.gitignore，不会提交到 GitHub。 - 使用命令行翻译 PDF：
allTranslate input.pdf -s qwen-mt -o output- 启动本地 WebUI：
allTranslate -i常用参数：
| 参数 | 说明 |
|---|---|
-s, --service |
指定翻译服务，例如 qwen-mt、openailiked、openai |
-li, --lang-in |
源语言，默认 en |
-lo, --lang-out |
目标语言，默认 zh |
-p, --pages |
指定页码，例如 1,3-5 |
-o, --output |
输出目录 |
-t, --thread |
翻译并发数 |
--config |
指定主配置文件 |
--ignore-cache |
忽略缓存，强制重新翻译 |
config.json 保存通用运行配置，例如默认语言、启用的服务、WebUI 显示策略等。
translator_config.json 保存可提交的翻译器配置模板，敏感字段统一写成 xx：
{
"translators": [
{
"name": "qwen-mt",
"envs": {
"ALI_DOMAINS": "scientific",
"ALI_API_KEY": "xx",
"ALI_MODEL": "qwen-mt-turbo"
}
}
]
}translator_config.local.json 保存本机真实 key 和 url。程序启动时会先读取公开配置，再用本地配置覆盖同名翻译器的字段，因此本地可直接使用，提交后敏感信息仍保持隐藏。
感谢 guaguastandup/zotero-pdf2zh 提供的开源基础与 Zotero/PDF 翻译实践，本项目在其思路上继续改进表格翻译与本地运行体验。