Releases

主要变化

保真排版 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 翻译环境。

中文

适配 Zotero 10.0.x：strict_max_version 由 9.* 提升到 10.*，可在 Zotero 10.0.6 正常安装与启用。

已在 Zotero 10.0.6（Gecko 140）实机验证：bootstrap 启动、设置面板注册、侧栏 section 挂载均无异常。

对照 Zotero 10.0.6 源码核对 PreferencePanes / ItemPaneManager / Reader / FullText / Attachments / ProgressWindow 等接口，未发现破坏性变更。

仓库迁移至 fangchenghao/codex-bilingual-reader，自动更新指向本仓库 Release。原作者是Mengqi97/codex-bilingual-reader-for-zotero。