句译随行 v1.1.2

句译随行 v1.1.2

新增一键全文预翻译及可控并行。完成后继续在原 PDF 中阅读，悬停直接显示缓存译文与词语对应高亮。

新增功能

• PDF 左下角只显示一个“全文翻译”按钮；进度显示在按钮上，再次点击即可取消。
• 默认 3 路并发，可在“设置 → 阅读行为 → 全文翻译并发”调整为 1–6 路。
• 后台翻译期间为悬停翻译保留额外请求空间，可以边翻译边阅读。
• 全文结果及所有识别出的英文词的对应记录保存在 PDF 同目录的独立缓存，不受普通缓存 1000 句上限影响。
• 支持取消、继续和失败重试，复用已完成的句子；读取或保存失败时不会误报完成。
• 处理重复句子、超长句子分段、结果乱序返回，并避免重复显示全文入口。

安装与更新

本 Release 只上传 sentence-hover-1.1.2.xpi。

Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File…，选择 XPI 覆盖安装。安装后重新打开 PDF，必要时重启 Zotero。API 配置和已有缓存保留。

更新地址调整： 为使 Release 仅包含 XPI，更新清单已移至仓库的 updates.json。安装 v1.0.x 或此前本地测试包的用户，本次需手动覆盖安装一次；新版随后会从仓库地址检查更新。

GitHub 自动提供的 Source code ZIP/TAR 是源码，不是插件安装包。

使用说明

全文翻译会调用已配置的 API，费用和限流规则由服务商决定。扫描页需先 OCR；跨页、复杂排版和词语对应质量仍受文本提取与模型结果影响。

完成的句子会保留；没有独立译法或模型未提供对应的单词记录为“未映射”，不会强行匹配无关译文。限流或认证失败后停止派发新句子。

77 项自动化测试全部通过，覆盖缓存恢复、1000 句以上文档、并发上限、乱序结果、取消继续、悬停共存和设置页交互。自动化测试使用模拟阅读器，不能代替所有平台和服务商的实际验证。

句译随行 v1.0.1

句译随行 v1.0.1

修复“保存并测试翻译”可能显示 can't access dead object，而阅读器仍可翻译的问题。

修复内容

• 保存设置、调整外观和切换原文高亮时，跳过并清理已关闭或重载的 PDF 窗口。
• 阅读器关闭时立即使待处理的界面更新失效，避免请求返回后继续访问旧窗口。
• 清理过程中即使某个窗口对象失效，也会继续移除其他事件监听。
• 连接测试不再等待其他文章的缓存写入；附加诊断错误不会把已成功的翻译标记为失败。
• 设置窗口关闭后，测试请求完成时不再更新已销毁的控件。

更新方法

已安装 v1.0.0 的用户可在 Zotero 插件管理器中检查更新。也可下载本页的 sentence-hover-1.0.1.xpi，通过“工具 → 插件 → 齿轮 → Install Plugin From File…”覆盖安装。

安装后建议重启 Zotero。原有 API 配置和文章缓存保留。0.3.x 开发版需要手动安装一次，因为其更新地址尚未指向 GitHub。

验证

• 33 项设置页与阅读器测试通过，包括失效窗口、请求迟到、设置页关闭以及翻译成功后的诊断异常。
• 安装清单检查、XPI 结构检查通过。
• 测试基于模拟阅读器，实际 Zotero 环境仍需验证。
• 提供 SHA256SUMS.txt 校验文件；updates.json 用于 Zotero 更新检查。

句译随行 v1.0.0

句译随行 v1.0.0

在 Zotero 内置 PDF 阅读器中，悬停英文句子即可查看中文翻译，并随鼠标所在单词联动高亮中文对应词语。

功能

• 悬停识别并翻译整句，弹窗居中显示、自动调整宽度。
• 中英文对应词语联动高亮；原文单词高亮可单独关闭。
• 字号、最大宽度和背景透明度可通过滑块调整并预览。
• 缓存保存在 PDF 所在目录，重启后可复用。
• 点击 ↻ 或按 Ctrl+Alt+R 重新翻译；macOS 使用 ⌘+Option+R。
• 自行配置 Chat Completions 兼容 API。

安装

1. 下载本 Release 附件中的 sentence-hover-1.0.0.xpi。
2. Zotero → 工具 → 插件 → 齿轮 → Install Plugin From File…，选择 XPI。
3. 编辑 → 设置 → 句译随行，配置 API 地址、模型名称和密钥。

升级安装保留原有配置和文章缓存。GitHub 自动生成的 Source code ZIP/TAR 是源码，不是插件安装包；请下载 XPI。

兼容性与验证

• 面向 Zotero 10.x 标准 PDF 视图，需要可提取文字的 PDF；扫描件需先 OCR。
• 跨页句子和复杂排版可能影响断句，翻译及词语对应质量取决于模型。
• 53 项自动化测试通过，覆盖设置交互、悬停行为、缓存读写及异常处理；不代表所有平台和服务商均已实测。
• 提供 SHA256SUMS.txt 校验文件。