Skip to content

Releases

Interlinear v0.9.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 02:57
d4a6d3c

把免费翻译链路补完整,并让新装的阅读体验更适合长文对照。

新增功能

更多免费翻译后端

  • Microsoft Edge 翻译:零配置,不需要账号或密钥;整批段落一次请求,保留换行。默认排在 Google 各配额池之后作为备用,也可以在设置里固定使用。
  • 阿里云机器翻译:用 AccessKey 调用,每月 100 万字符免费额度;按 5000 字符自动分段并并行请求,与其它免费服务一样有限流保护。
  • Azure AI Translator:F0 每月 200 万字符、不限期;整批段落一次请求,支持可选区域与自定义端点。
  • Google 备用网关:免费链路新增 clients5.google.com 与 translate.google.com 两个内置网关,配额池被限流时多一层退路。
  • LibreTranslate:公共实例需在密钥门户购买 API Key;自建实例按文档启动后填 http://localhost:5000 即可,通常无需密钥。插件会自动补 /translate。

设置页引导

  • 阿里云、Azure、LibreTranslate 都有分步说明与官网直达链接:开通服务、创建密钥、填入保存。
  • AccessKey、Azure Key、LibreTranslate Key 与其它密钥一样通过系统密钥库加密;Azure 区域与端点作为普通偏好保存。
  • 自动轮换会在 Google 各池之后尝试已配置的阿里云、Azure,再到 Edge、MyMemory 与 LibreTranslate。固定某个服务但没填密钥时,会直接提示缺什么。

单段翻译切换

  • 鼠标停在段落上按快捷键(或 Alt+点击)翻译该段,再按一次撤下译文;缓存保留,再按立即恢复,不重新请求。
  • 失败的段落同样会被撤下;普通点击失败块仍是重试,右键「重新翻译」仍是强制重译。
  • 快捷键可以录单个字母、数字或 F1–F12;设置页会提示单键可能覆盖阅读器自身的同名快捷键,插件只在鼠标位于段落上或已选中文本时执行。默认仍是 Alt+Enter。

默认值调整

  • 新装默认左右并排、无左侧色带、译文块全宽;开始翻译时自动把阅读模式页宽切到 100%,让两栏用满阅读区。已经保存过显示与外观偏好的用户保持原样。
  • 默认免费服务改为 MyMemory;自动轮换仍从 Google 各池开始。Google、Edge、阿里云、Azure、LibreTranslate 都可在选择器中固定。

修复

  • Azure 引导改用微软官方「创建 Translator 资源」文档链接,避免登录门户的租户 OAuth 端点卡住。

安装与升级

  • 下载下方的 interlinear.xpi,在 Zotero 10 / 11 中通过「工具 → 插件 → 齿轮 → Install Plugin From File」安装。
  • 覆盖安装即可,原有偏好、术语表与翻译缓存都会保留;自动更新使用 update.json。
  • 免费接口按 IP 限流,大批量翻译建议使用模型后端或本机 Ollama;敏感文献请优先使用你信任的服务。

完整变更对比:v0.8.1...v0.9.0

Interlinear v0.8.1

Choose a tag to compare

@github-actions github-actions released this 12 Nov 12:31
9d7e4a6

这是一个以稳定性、测试与更新链路为主的修复版本。

修复

  • 免费翻译失败不再卡住整轮:只有真正的限流(429 / 配额)才会让整轮暂停冷却;响应形状无法解析、请求被拒绝等非限流错误现在立即返回具体错误,由调用方马上按段落重试,不再等待一个无法改变结果的计时器。
  • CI 测试不再挂起:测试报告器通过 Zotero.HTTP.request 上报结果,而测试会替换该函数;超时用例留下的替身让 fail / end 永远送不到运行器、进程无法退出。现在只把报告器发往本机 /update 的请求交回真实实现,其余测试替身不受影响。
  • 修复过期的 0.8.0 集成断言:Google 批量接口每个 q 返回一条结果、translate_a/t 端点、paragraph-mode 工具栏动作,并移除了误留的 it.only。
  • 布局回归测试适配 headless:headless 阅读器窗口可能完全暂停 requestAnimationFrame,测试改为用定时器驱动帧并等待真实静默期,避免随机失败。

更新元数据

  • 发布 0.8.1,使 release 标签上的 update.json / update-beta.json 从陈旧的 0.6.0 元数据前进到 0.8.1,Zotero 自动更新可以正确获取新版本。

安装与升级

  • 下载 interlinear.xpi,在 Zotero 10 / 11 中通过「工具 → 插件 → 齿轮 → Install Plugin From File」安装;覆盖安装保留偏好、术语表与缓存。
  • 0.8.1 是历史修复版本;当前最新版为 v0.9.0(新增 Microsoft Edge、阿里云、Azure 等免费后端并调整阅读默认值),建议直接使用最新版。

完整变更对比:v0.8.0...v0.8.1

Interlinear 0.8.0

Choose a tag to compare

@Muanyan-mjq Muanyan-mjq released this 12 Nov 08:46
693381b

Interlinear 0.8.0

免费翻译服务链(本轮重点)

  • Google 免费接口改为可配置服务链:it / at / gtx / dict-chrome-ex / firefox-a 五个独立配额池自动轮换,某个池被限流时在同一批次内切换,不再整篇报错。
  • 新增两个免费后端:MyMemory(无需密钥,可填联系邮箱提高每日额度)与 LibreTranslate(自建或公共实例,API Key 经系统密钥库加密保存)。
  • 设置页可固定某一服务或保持自动轮换、选择首选 Google 池、开关自动回退、配置自定义端点,并实时显示当前生效服务与冷却中的池;"测试连接"即时使用表单当前值。
  • 两个逃生口:额外 Google 网关主机(每行一个,最多 4 个,各自独立配额池)与通用自定义免费接口(GET 模板 {text}/{from}/{to} + JSON 结果路径),公共免费服务全部被封时可即填即接自建服务,无需重新编译。
  • 限流处理:绕过 Zotero 内置的最长 1 小时的 429 重试循环,并发工作线程共享整轮冷却,等待有上限,全部免费服务不可用时进入"已暂停"状态并可自动恢复。

平台支持

  • Zotero 11 兼容已声明:manifest strict_max_version 放宽到 11.*,Zotero 10.x 与 11.x 均可安装;已加 Zotero 11 回归守卫(内联处理器移除、OS 密钥库 API 变化),并在 Zotero 11 开发版上构建与测试通过。
  • Linux / macOS 源码层适配:
    • 文件选择器过滤器改用 GTK(Linux)/ Cocoa(macOS)兼容的空格分隔 glob(*.csv *.tsv *.txt、*),替代 Windows 专属的 ; 分隔与 *.*。
    • macOS Option(Alt)死键会改写 event.key 的问题,改为按物理键码 event.code 匹配快捷键,Alt+字母快捷键在 macOS 上可正确录制与触发;标签在 macOS 使用 ⌘/⌥ 符号且保持可解析。
    • 含空格与中日韩字符的 POSIX 路径原样透传。
  • 已知限制(如实说明):本版本的自动化端到端/GUI 测试仅在 Windows 上运行,Linux/macOS 未做真机全量实测;CI 已在 Ubuntu 与 macOS 上完成构建验证。Linux 无 Secret Service(libsecret)时,OS 密钥库 available = false 的检测是已知风险(见 test/platformCompat.node.test.mjs),建议 Linux 用户确保有可用的 Secret Service。

安全

  • API Key 经 Zotero OS 密钥库加密存储(macOS Keychain / Windows DPAPI / Linux libsecret);带密钥的请求不跟随重定向;明文 HTTP 仅限回环与私有网络;错误、日志与连接测试结果均脱敏。详见 SECURITY.md。

验证

  • TypeScript / ESLint 全绿;单元测试 229/229;平台兼容探针 15/15;语言键对齐 4/4;真实 Zotero 端到端测试通过(12 项通过,2 项按设计跳过);CI 在 Ubuntu 与 macOS 上构建成功。

安装

下载下方 interlinear.xpi,Zotero → 工具 → 插件 → 齿轮菜单 → Install Add-on From File。安装后请重启 Zotero。

Interlinear v0.6.0

Choose a tag to compare

@Muanyan-mjq Muanyan-mjq released this 11 Nov 05:21

Zotero 10 PDF 阅读模式段落中英对照翻译插件。内置 Google / OpenAI 兼容 / Claude / Gemini / Ollama 五种翻译后端,无需安装其他插件。

Interlinear 更新元数据

Choose a tag to compare

@Muanyan-mjq Muanyan-mjq released this 11 Nov 05:21

供 Zotero 自动更新使用的 update.json 与 update-beta.json。