Releases: Olekd21/Translate-Bridge-for-Zotero
Release list
译桥 1.4.5|句子识别修复 · 可调宽侧栏 · 报错显示优化
译桥 1.4.5:句子识别修复与侧栏改进
本次重点
- 修复 Fig.、公式编号及 e.g./i.e./vs. 等缩写误断句;句后引用归到前句,保留真正句界与原始字符偏移。
- 修复空翻译标记、交错引用、句尾引用及 Cre-negative 词头漂移引起的整句或整段定位失败。恢复仍需通过来源、顺序和文字覆盖校验。
- 拖选跨入独立文献引用时按 DOM 身份识别引用;未知短正文、图号和真实数值不按长度丢弃。未匹配块会给出具体提示。
- 侧栏可拖宽并记忆,桌面最小 400px;“已有 Zotero 批注”和“文章工具”默认收起。错误提示可完整换行,诊断按钮同排紧凑显示。
相比上一公开版本 1.2.0
包含已有批注编辑/删除、文章笔记、待同步队列管理、文章添加及 Zotero 阅读器跳转网页入口。一个英文句子被译成多个中文句子时,可预览并明确确认采用完整英文原句范围;不会静默扩大选区。继续改进引用范围、跨页及科学符号的 PDF 定位。
下载与升级
- 推荐下载
translate-bridge-for-zotero-1.4.5.zip,解压后打开START-HERE.html。 translate-bridge-chrome-1.4.5.zip:Chrome 扩展,解压后加载。translate-bridge-zotero-1.4.5.xpi:Zotero 插件。- GitHub 自动附带的 Source code 压缩包是源码,不是完整安装包。
从 1.2.0 升级须同时更新两端。Zotero 安装 XPI 后完全退出并重启;Chrome 重新加载扩展后,将论文恢复英文、刷新,再开启整页翻译,以重建原文缓存。通常无需重新配对。Zotero 已为 1.4.2+ 时,可仅更新 Chrome 至 1.4.5。
验证与限制
152 项自动测试及 PDF 几何检查通过;英文分句 42 项、故障重建与浏览器布局回归通过。对本次 Nature 论文缓存原文,105 块/429 句捕获通过;使用对应 31 页 PDF 原生坐标验证,429 单句、1313 连续多句和 105 整段均唯一定位,未创建文库批注。
以上包括诊断结构重建和原文到 PDF 验证,不等于用户当前 Chrome 中文翻译现场所有选区均已验收。未知正文、失效来源和单句歧义仍会阻止同步,避免错误高亮。详见 验证报告。
译桥 1.2|网页显示 Zotero 批注 · 中文选句与 PDF 同步增强
译桥 1.2(1.2.0)更新说明
本次合并自上一公开版本1.0.6以来的功能与修复,Chrome、Zotero和完整包统一为1.2.0。
新功能:网页显示 Zotero 已有批注
打开论文后,在“已有 Zotero 批注”中查看原文、笔记、颜色和页码。能可靠定位的文字在网页上标记,点击可查看笔记;不能定位的批注保留在侧栏。点击“刷新批注”读取 Zotero 中的新改动。此功能只读已有批注。
修复:中文选句、PDF定位与同步
- 改进 Chrome 整页翻译后的句子边界、跨标记片段、克隆节点、数字引用和英文缓存恢复。
- 诊断仅在出错时出现;复制诊断/边界详情后提示自动恢复,换选区可再次复制。
- PDF定位改进跨栏、跨页和部分稀疏图页间隔处理;修复断行与英美拼写替换冲突,以及引用数字坐标偏移。
- 对比正文内容而非要求字符格式完全相同,但不忽略科学数字、基因名、否定词;多处匹配仍拒绝自动写入。
- 状态提示区分“找回英文原文”和“PDF定位成功”;独立PDF读取任务带超时处理。
- 跨页高亮分开保存,失败时撤销本次已经创建的部分,避免残留半条批注。
必须这样升级
- 下载下面的 translate-bridge-for-zotero-1.2.0.zip 完整安装包,解压后打开 START-HERE.html。
- 在 Zotero 插件管理中安装 Translate-Bridge-Zotero-1.2.0.xpi,完全退出再启动 Zotero。
- 更新 Chrome 已加载的扩展文件夹,重新加载扩展;确认侧栏版本为 1.2.0。
- 将已翻译的论文恢复为英文,刷新页面,再开启 Chrome 整页翻译。一般无需重新配对。
也提供单独 Chrome ZIP 与 Zotero XPI。不要把 GitHub 自动生成的 Source code ZIP 当成安装包。没有安装器,不依赖 Better Notes。
验证结果与尚存限制
- 本地文库抽16篇,959个候选文本块中859个实际执行,845个唯一匹配且页码/段落矩形相符;12个未匹配、2个歧义。两篇加密PDF的100个候选未执行。
- 最近一轮修复新增找回12处;最终1.1.4构建在隔离 Zotero9.0.6及10.0.3中均成功保存这12处高亮。1.2.0沿用相同功能代码,更新统一版本号和说明。
- 60个改动科学数值的反例全部拒绝;保留正式文库和原始PDF。
- 1.2.0发布构建运行全部自动回归、扩展检查、TypeScript编译及安装包完整性/版本一致性检查。
- 加密PDF、特殊字体编码、重复文字仍可能无法定位;只有可可靠映射的已有批注会在网页正文标记。
- PDF语料测试不等同于所有网站的真实Chrome翻译DOM验证,不能保证任意半句、任意网页都成功。
译桥 1.0.2 — 中文单句定位
译桥 1.0.2:中文单句定位
修复 Chrome 整页翻译后整段能定位、段内单句容易匹配失败的问题。在英文页面阶段保存句子与原文的对应关系,翻译保留对应节点时,完整单句和连续几句可直接找回英文,不依赖再次翻译后比较文字相似度。没有针对特定论文或句子的白名单。
同时修复 Cannot read properties of null (reading 'matches'):页面移除文字节点后,观察回调跳过已脱离页面的节点,继续缓存后续有效段落。侧栏顶部显示版本号,方便确认当前标签页已加载新版。
Chrome、Zotero 和完整包版本均为 1.0.2,发行附件仅为 Chrome ZIP、Zotero XPI、完整 ZIP,不包含安装器。
更新
- Chrome ZIP 解压覆盖原扩展目录,在
chrome://extensions/重新加载译桥;保留原加载路径。 - 恢复论文英文并刷新页面,再开启 Chrome 自带翻译;确认译桥侧栏顶部显示 1.0.2。
- Zotero 通过“工具 → 插件 → 齿轮 → 从文件安装插件”安装 XPI,正常重启。此次单句修复不需要重新配对。
验证范围
- 构建、现有回归及包完整性检查通过。
- 重建页面的 Chromium 测试覆盖六个句子逐句选择、连续四句、含引用与斜体的三个句子,以及半句不静默扩大,共 11 项;空节点异常复现后修复测试通过。
- 2026-09-26,用户试用本地 1.0.2 后反馈“这次好了”,并授权发布。本次上传保留该本地测试包原样。
- 用户反馈确认当前使用场景恢复,不等于所有网站和任意句式的全覆盖保证。自动化测试仍使用重建 DOM;尚无真实 AHA 页面与 Chrome 整页翻译链路的自动验收。若翻译移除句子节点、扩展在翻译后才加载或仅选句内短语,保守匹配仍可能失败。
包内手册在用户确认前生成,其中“真实链路尚未完成验证”指自动化验证范围;最新用户确认记录见本说明。重启后插件消失的历史原因仍未确定,此版本不宣称根治该独立问题。
译桥 1.0.1
修复英文能定位、整页翻译后的中文选区无法恢复原文的问题:提前保存英文,支持更多正文结构、跨段选区和翻译替换节点,并用唯一稳定 ID 恢复原文。无法可靠对应时保持未匹配,避免错位高亮。
Chrome、Zotero 与完整包版本统一为 1.0.1。本次仅提供三个插件包,不包含安装器。
更新方式
- Chrome:解压 Chrome ZIP 覆盖原扩展目录,在扩展管理页重新加载。先恢复论文英文并刷新,再进行整页翻译;不要先移除扩展。
- Zotero:通过“工具 → 插件 → 齿轮 → 从文件安装插件”选择 XPI,然后正常重启。
- 完整 ZIP 包含两端插件与使用说明。当前仍需手动更新。
验证及限制
53 项命名回归、PDF 几何套件和 9 项 Chromium DOM 测试通过。最终 XPI 在 Zotero 9.0.6、10.0.3 的独立环境中,各完成首次安装及三次重启,插件持续启用;各创建并保留 4 条 AHA 论文第 3 页的原生批注。
浏览器测试使用真实论文摘录与重建 DOM,部分 API 为模拟接口。AHA 原网址受验证页限制,尚未完成该站实际页面与 Google 整页翻译的完整端到端验收。此前个别机器重启后插件消失的具体原因尚未确认,不能据上述独立测试宣称已根治。
Translate Bridge for Zotero 1.0.0 · 译桥正式版
Translate Bridge for Zotero 1.0.0
Chrome 扩展 1.0.0 + Zotero 插件 1.0.0,同一包用于 Zotero 9/10。
改进长论文重复定位性能、短句断词识别、上下文消歧和多栏高亮;保护数字、小数、负号、基因编号与数学比较符号,移除可能误标不同断言的宽松匹配。未写入批注不再报告为同步成功,也不会把旧版接口的未写入记录从待同步队列误删。
8 篇跨领域论文、306 页、1809 个选段分别在 Windows Zotero 9.0.6 和 10.0.3 的原生识别数据上检查;3618 次检查中 3463 次唯一定位,155 次保守拒绝,未观察到错页或越出目标文字块。最终 XPI 的 88 次真实 HTTP 请求及两库各 24 个落盘批注核验通过。42 项命名回归和原有几何套件通过。
数字来自明确测试集,并不保证覆盖所有论文。纯扫描、公式缺字、重复短句、三页以上连续选区仍有限制;未完成全出版商、所有操作系统及完整浏览器交互自动验收。详细方法与限制见稳定性核查。
更新:安装新 Zotero XPI 后完全重启;Chrome 重载新扩展目录并刷新论文页。无需 Better Notes 或其他 Zotero 插件。
Translate Bridge for Zotero 0.8.1 · Zotero 9/10 兼容修复
Translate Bridge for Zotero 0.8.1
完整包包含 Chrome 扩展 0.8.1 和 Zotero 插件 0.6.1。同一安装包同时用于 Zotero 9 和 10,无需选择不同版本。
修复 Zotero 10 上配对成功但 PDF 段落定位与同步一直等待的问题。Zotero 10 的原生读取指令由 getRecognizerData 改为 pdf.getRecognizerData,译桥现在识别实际接口并选择对应指令;遇到未知接口明确报错。
- PDF 读取使用独立的原生 worker,不再占用 Zotero 的共享 PDF 任务队列;保留全文覆盖与缓存。
- 增加页面读取、全文读取、阅读器打开和浏览器请求超时,避免无限等待。只停止译桥自己创建的 worker。
- 配对测试显示 Zotero 与译桥版本,定位和同步成功后显示耗时。
- 阻止操作进行时的重复点击;切换选段后忽略旧请求的侧栏更新。
- 同步超时且结果不明时,不自动进入重试队列,以免重复生成批注;用户笔记仍保留在侧栏。
更新时两端一起更新:Zotero 从文件安装新 XPI 并完全重启;Chrome 重新加载新扩展目录,再刷新论文页。无需补装 Better Notes、LLM 或 PDF Translate,也无需因本问题降级 Zotero。
Zotero 端已在 Windows 的 9.0.6 与 10.0.3 隔离测试库中检查真实本地 HTTP 请求;29 项自动回归及几何匹配套件通过,覆盖旧/新协议、超时、缓存和选段切换。浏览器端本轮完成逻辑与语法回归,完整浏览器交互尚未完成自动验收。其他 Zotero 小版本及 macOS/Linux 未逐一验证。
Translate Bridge for Zotero 0.8.0 · 全文定位
Translate Bridge for Zotero 0.8.0 · 译桥
连接 Chrome 内置 Google 翻译与 Zotero PDF 批注。本次修复讨论、结论等后半部分无法定位的问题。
下载与更新
下载 translate-bridge-for-zotero-0.8.0.zip,解压并打开 START-HERE.html。包含 Chrome 扩展 0.8.0、Zotero 插件 0.6.0 和离线手册。
全文定位修复在 Zotero 端,必须安装新的 XPI。 在 Zotero“工具 → 插件”选择“从文件安装插件”,安装本包的 Translate-Bridge-Zotero-0.6.0.xpi 并重启。Chrome 端用新版文件覆盖原加载文件夹,在扩展管理页重新加载,再刷新论文网页。原路径更新可保留配对配置。
扩展设置中的“保存并测试”现在会识别旧 Zotero 插件;连接成功但仍旧版本时,会提示更新。
修复与改进
- PDF 定位覆盖整篇文档,不再限于前 5 页。在内存中分批读取并恢复原页序,保持原 PDF 不变。
- 加入本机会话缓存,并在 PDF 文件变化后重新读取;读取不完整或失败不会被当成“全文中没有找到”。
- 区分读取失败、找不到对应文字和多处相似文字,提供对应提示。
- 合并同一位置的重复匹配结果;遇到不同位置的歧义时不写入批注。
- 保留相邻两页的跨页定位,包括内部读取批次边界两侧的页面。
验证与使用范围
在 Windows + Zotero 9.0.6 上对 22 页真实论文完成只读验证:读取全部页面,讨论部分完整段落唯一定位到第 13 页,原第 2–3 页跨页段落仍可定位;前 5 页的原生识别坐标与旧读取方式一致。未在正式文库创建测试批注。
全文分批读取、缓存失效、失败处理、歧义拒绝、跨页几何以及既有匹配和阅读界面回归通过,构建及分发包校验通过。
需要可检索文字的 PDF;纯扫描、加密文件、网页与 PDF 版本不同或跨三页以上的选区仍可能无法定位。Chrome 需 138+;其他系统与 Zotero 版本尚未完成同等实机验证。新增 pdf-lib 已打包,无需用户安装额外插件或开发工具。
Translate Bridge for Zotero 0.7.0 · 译桥
Translate Bridge for Zotero 0.7.0
连接 Chrome 内置 Google 翻译与 Zotero:阅读翻译后的论文网页,将选中文字匹配回 PDF 英文原文,并同步高亮、中文译文与笔记。
下载与安装
推荐下载 translate-bridge-for-zotero-0.7.0.zip,解压后打开 START-HERE.html。完整包包含 Chrome 扩展 0.7.0、Zotero 插件 0.5.0 和离线用户手册。无需安装开发工具或配置 AI API key。
Chrome 扩展尚未上架应用商店,需要在扩展管理页开启开发者模式并选择“加载已解压的扩展程序”。Zotero 端通过“从文件安装插件”安装 XPI,然后按手册配对。
本次改进
- Zotero 新增带图标的“网页阅读”按钮、右键入口和首次使用引导。
- 修复符合条件的相邻两页长句无法定位的问题。
- 改善网站 403、429、验证页与请求超时的提示和重试处理。
- 用户手册明确安装依赖、配对、更新方法与常见问题。
使用范围
已验证 Windows + Zotero 9.0.6;Chrome 需 138+。PDF 定位目前覆盖前 5 页,需要可检索的文字层。跨页匹配要求相邻两页均在读取范围内;网页与 PDF 版本不一致、纯扫描文件等情况可能无法定位。其他操作系统与 Zotero 版本尚未完成同等实机验证。
验证
文本匹配、PDF 跨页坐标、网页读取失败处理、阅读入口行为回归测试以及生产构建通过。分发包另经压缩完整性、版本、资源和离线手册一致性校验。