Repository navigation
Releases
Releases · Muanyan-mjq/zotero-interlinear
Interlinear v0.9.0
把免费翻译链路补完整,并让新装的阅读体验更适合长文对照。
新增功能
更多免费翻译后端
- 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
这是一个以稳定性、测试与更新链路为主的修复版本。
修复
- 免费翻译失败不再卡住整轮:只有真正的限流(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
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 路径原样透传。
- 文件选择器过滤器改用 GTK(Linux)/ Cocoa(macOS)兼容的空格分隔 glob(
- 已知限制(如实说明):本版本的自动化端到端/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
Zotero 10 PDF 阅读模式段落中英对照翻译插件。内置 Google / OpenAI 兼容 / Claude / Gemini / Ollama 五种翻译后端,无需安装其他插件。
Interlinear 更新元数据
供 Zotero 自动更新使用的 update.json 与 update-beta.json。