Skip to content

Releases

v0.1.1 开发预览:Linux 支持与 PDF 配对修复

Choose a tag to compare

@666666lyc 666666lyc released this 21 Oct 15:22

v0.1.1 开发预览

修复已有中文 PDF 无法开启中英对照及原文、译文配对信息无法随条目恢复的问题,并新增 Linux 运行环境安装支持。

更新内容

  • 已有译文缺少关联时,唯一原文 PDF 候选自动配对,多个候选可手动选择。
  • 配对信息保存到译文附件笔记的独立信息块,保留已有笔记;其他设备安装新版后可从同步的笔记恢复配对。
  • 停止向 dc:relation 写入自定义 URN;旧标记备份后事务迁移,失败回滚。
  • 修复重启后的关联加载、附件变化后的按钮刷新,以及 Zotero 10 内置许可证读取。
  • 原文与译文页数不同时默认独立并排浏览;同页数支持页码同步,批注分别保存。
  • 新增 Linux x64 / Python 3.12 专用运行环境安装,锁定官方依赖及摘要;兼容声明扩展到 Zotero 10.0.x。

安装

下载附件 zotero-codex-translate-0.1.1.xpi,在 Zotero「工具 → 插件」中选择从文件安装,然后重启 Zotero。

Linux 用户请参阅安装说明。普通使用只需下载 XPI;源码、依赖清单、许可证及 SHA256 校验文件一并提供。

验证范围

44 项 JavaScript、40 项 Python、13 项 Zotero 集成检查通过。Linux Zotero 10.0.6 已完成本地验证;两个隔离配置间的标准条目 JSON/PDF 传递、重启恢复、双栏阅读与批注隔离已验证。

真实云端跨设备同步尚未验证;未追加 Windows Zotero 10 实机验收。 Windows 自动安装流程保留。完整验证记录及资源下载、空间和耗时说明见附件 VALIDATION.md、AUTO_INSTALL.md 及项目文档。

对应源码标签:v0.1.1;提交:4a8389a665f5458b13b47833470a4019d7254206。

v0.1.0:Codex 全文翻译与中英对照阅读

Choose a tag to compare

@666666lyc 666666lyc released this 21 Oct 11:53

v0.1.0 开发预览

在 Zotero 中通过本机 Codex 将英文 PDF 翻译为中文附件,并在同一标签页中英对照阅读。

适用环境:Windows x64 / Zotero 9,单篇有文本层的英文 PDF。

功能

  • 安装后从官方上游自动准备专用 Python、BabelDOC 和完整字体模型,无需手动安装桥接程序。
  • 后台全文翻译、段落缓存、批量请求、取消及手动续跑;完成后自动导入中文附件。
  • BabelDOC 0.6.4 官方 Python API 和翻译器扩展接入;不替换内部翻译或排版方法,不重排或修补其输出。
  • 工具栏直接开启中英对照,两侧双向同步页码及页内相对位置,可切换独立浏览;批注分别保存。
  • 工具栏首次点击与重绘处理修复,开启对照后显示选中背景及外围阴影圈。
  • 连接、登录与模型检测即时反馈,提供失败详情、重连及环境修复入口。
  • 缓存重新排版及既有 PDF 恢复保留旧任务、译文和批注。

安装

  1. 安装 Codex CLI,运行 codex login 并选择 ChatGPT 登录。
  2. 下载 Release 中的 zotero-codex-translate-0.1.0.xpi,在 Zotero「工具 → 插件」中从文件安装并重启。
  3. 在「工具 → Codex 文献翻译:连接设置」查看环境准备进度,完成后检测登录与模型。
  4. 通过文献右键菜单或阅读器「Codex 全文翻译」启动;点击「Codex 翻译任务」查看进度,已有译文可直接点击「中英对照」。

首次固定下载内容约 603.9 MB,不含 Codex CLI、HTTP 元数据和重试流量,建议至少预留 3 GB。后续启动复用已校验环境。普通用户只需下载 XPI;源码及清单供开发、审阅和校验使用。

本次以已部署的本地 0.1.6 功能为基线,统一公开版本号为 v0.1.0。已安装较高本地开发版本的测试用户可从文件手动安装;不会自动降级或覆盖本机正在运行的任务。

使用范围

默认一个文档、一个模型请求并发。长文耗时取决于段落数量、缓存及模型响应速度;本次发布没有改变并发或承诺提速。扫描件 OCR、批量文献和图片内文字翻译不在首版范围。

PDF 使用 BabelDOC 原生输出,复杂公式、表格和图文排版建议结合原文人工核对。页数无法对应时可单独打开译文。现有本机验证范围及开发阶段历史记录见 验证矩阵。

开源许可与源码

项目新增代码采用 AGPL-3.0-only;复用的 Split-View Reader 保留原作者声明及 AGPL-3.0-or-later 授权。BabelDOC、字体、模型和依赖保留各自许可,详见 第三方声明。

同版本源码包对应标签 v0.1.0,包含构建脚本、固定依赖与资源清单、原始许可证、修改记录及匹配的 BabelDOC 源码。使用 SHA256SUMS.txt 校验发行附件。