Repository navigation
主要变化
保真排版 PDF 翻译不再局限于 Windows。
- 一键安装在 macOS/Linux 可用:新增
scripts/install-preserved-pdf-runtime.sh,在插件运行目录创建 Python 3.10–3.13 虚拟环境(有uv时自动取用 3.12),安装固定版本的pdf2zh_next 2.9.0/babeldoc 0.6.2/bitstring 4.3.1。 - 运行时解析抽成共享模块:
scripts/pdf-runtime-paths.mjs统一处理便携包、虚拟环境和自定义目录三种布局,并规范代理与HF_ENDPOINT默认值。 - 保留真实 HOME:macOS/Linux 不再隔离
HOME,BabelDOC 复用~/.cache/babeldoc,不会每次重复下载约 340 MB 模型与字体。 - macOS 路径探测:自动在
/opt/homebrew/bin、/usr/local/bin、/Applications/LibreOffice.app等位置查找引擎与辅助工具,Apple Silicon 默认降低并发。 - 修复双语 PDF 切字:内侧裁剪改为按像素测量真实空白,只裁空白、不碰正文,默认 80pt 也不会再裁掉译文首字。
- 其他:安装文案和路径占位符跨平台化、
npm test在没有python命令的系统上可用、新增 macOS CI 任务。
验证情况
在 macOS 15(Apple M4)上完成端到端验证:一键安装 → --check 预检 → 在 Zotero 内对测试论文执行翻译 → 自动导入 185 KB 双语 PDF 子附件,左右栏、公式、矢量图与表格均保持原样。
安装
下载 codex-bilingual-reader.xpi,在 Zotero 中通过 工具 → 插件 → 齿轮 → 从文件安装插件… 安装。macOS 用户首次使用需点击设置页的 一键安装/修复 PDF 翻译环境。