wordtranslator 6.17.0

本次更新历经 17 个测试版（6.17.0b1–b17），两大主题：鼠标侧键适配扩展、单词卡片高亮美化。

鼠标侧键：覆盖几乎所有鼠标（Windows）

• 三层按键捕获：标准 XButton1/2（WH_MOUSE_LL）、多媒体键形态（蓝牙鼠标/厂商改键，WH_KEYBOARD_LL 捕获 VK_BROWSER_BACK/FORWARD，同样可吞掉）、消费页 HID 报文（Raw Input 检测触发）。
• 录制绑定：新增「绑定侧键」录制框，点击后按一下侧键即完成绑定，人在哪儿按都行（桌面/浏览器/PDF）；录制不重启钩子进程（参数热更新，几十毫秒生效）。
• 第三颗侧键可绑：录制窗口内上报所有多媒体键/消费页键（泛化键指纹 vk:0xNN / hid:0xNNNN），游戏鼠标第三侧键也能录入。
• 任意侧键模式（推荐）：侧键 1/2 不分哪颗都能触发，规避 2.4G 与蓝牙模式下编号对调导致的"侧键没反应"。
• 兼容模式（默认开启，原两个开关合并）：开 = 捕获多媒体键形态并吞键（后退/前进接管为翻译）；关 = 只认标准侧键、完全不吞键，与罗技/XMBC 等鼠标软件共存。开启提示只弹一次。
• 状态与诊断面板：实时显示生效状态、模式、当前绑定、最近一次触发；未触发时给出原因与自检三步。选区缓存过期后自动读取仍高亮的实时选区。
• 绑定互斥：侧键与键盘组合键四选一，切换自动解除另一边。

单词卡片高亮美化

• 文字降噪：未高亮单词恢复正文色，不再满屏系统高亮色；只有高亮卡片的单词继承高亮色。
• 去除涂层：高亮卡片不再整卡染色，高亮信号为左侧 3px 色条 + 单词变色，卡片底色与普通卡片统一。
• 所见即所得：右键色板、偏好页默认色色板、色条、高亮单词四处同源同色（高亮色单一来源表生成）。
• 深浅主题自适应：颜色跟随 Zotero 深色/浅色主题，无需手动切换。
• 四色：琥珀 / 苔绿 / 雾蓝 / 玫瑰，与已有高亮数据完全兼容。

其他

• 偏好页侧键配置 UI 全套（绑定录制框、任意侧键勾选、兼容模式、状态与诊断）。
• 回归断言大幅扩充（侧键桥接、配置归一化、UI 守门）。

安装：下载 wordtranslator-6.17.0.xpi，Zotero → 工具 → 插件 → 从文件安装（或直接拖入），安装后建议重启。

wordtranslator 6.16.3

小版本 0.0.1 级更新（6.16.2 → 6.16.3）：

• 偏好页「免费翻译」描述润色：去掉"新手"等不雅表述，统一措辞
• 服务商列表的「服务商」列改为只显示短名（如 Google 翻译），表格不再挤入长描述

wordtranslator 6.16.2

偏好页全新改版：全部分区卡片化，新增「翻译 / 划词 / 数据与关于」三组页内导航，保存状态栏置底；新增三处 issue 反馈入口（翻译 API 区、关于区、免费直连失效报错文案末尾）。本次均为界面与入口调整，翻译功能逻辑不变。

wordtranslator 6.16.1

新增「免费直连」零配置翻译通道：全新安装无需注册任何账号即可划词翻译。智能切换链 Bing → 腾讯交互翻译 → 有道 → Google → MyMemory，通道失效自动降级；「免费翻译」分组提前并新增 Bing、腾讯交互翻译、有道三个免注册接口。均为网页版逆向接口，无官方保障，可能随网站改版失效。

wordtranslator-6.16.0

本版本新增与修复：

【新增】单词卡片右键菜单新增「修」——可原地编辑 [单词--翻译]，保存只写本地数据，不触发翻译、不动词典。

【修复】鼠标侧键桥接在部分新电脑上彻底失效（表现为数据目录生成了 bridge-hook.cs，却没有 bridge-hook.exe）：

• 侧键钩子改为在后台 powershell.exe 中用 Add-Type「内存编译」加载 WH_MOUSE_LL 钩子，磁盘上不再生成任何 .exe。旧方案现场编译出的 bridge-hook.exe 会被杀软当成可疑全局钩子静默秒删（现象：bridge-hook.exe-tmp.exe 闪现即消失），导致没有 exe 可启动、侧键失效；内存加载不落 PE 文件，绕开该误报。
• 修正数据目录里 bridge-hook.cs 被反复「追加」成多份源码拼接、导致 Add-Type 报「using 子句必须位于…」而编译失败的问题：改为写文件前先删除旧文件、保证每次都是单份干净源码。
• 编译失败时错误信息会写入事件文件并在 debug 日志显示为「hook init failed: ...」，便于定位。

支持 Zotero 7.9.9 及以上（适配 Zotero 7 / 8 / 9 / 10）。

wordtranslator-6.15.1

6.15.1

• Google 免费翻译改走 client=dict-chrome-ex，绕过 gtx（2026-08 起被全局 429 限流）；候选 client 自动 failover；移除不再需要的 tk 算法
• 新增 MyMemory 无密钥可选服务商（Google 全灭时可在列表中选择）
• 下线失效的 DeepL 免费逆向接口（deeplx）
• 修复：侧栏服务商/字典源下拉被长名称撑宽，改为吃剩余空间、完整名称悬停展示

wordtranslator-6.15.0

本版聚焦离线词典体验。

新功能：
一、离线屈折反查表（26957 条变形到原形映射，来自 ECDICT exchange 字段）：ran、children、went、mice 这类不规则变形断网也能查到音标和中文释义。
二、词典查询排序优化：离线词库优先、屈折变体先过，断网划变形词不再白烧两趟五秒超时，本地秒命中。

包体变化：离线词库重新生成，正式包 2.62MB（净增 121KB）。

升级方式：直接安装本 xpi 覆盖旧版，重启 Zotero 生效。

wordtranslator-6.14.0

新增

• 单词本导出：一键导出 CSV / Markdown / Anki 三种格式，可选当前条目或全部条目。
• 译文缓存：已翻译的词自动缓存（最多 2000 条），下次划词免调 API，秒出结果。
• 上下文智能提示词：开启后把单词所在上下文一并交给 AI，翻译更贴合语境（默认关）。
• TTS 发音自定义：可自由设定发音模型与音色（不再写死 tts-1 / alloy）。
• 离线例句自动补全：离线词典查到的词若缺例句，后台自动抓取补全。

修复

• 划词后状态被清：连续划词第二次失效、「Alt+Tab 切回后修饰键残留」。
• 流式翻译解析失败：SSE 数据被截断时解析出错。
• 翻译失败后卡死：失败后重复划词被当「已有译文」跳过、永不重试。
• 保存成功但面板不显示：单词本保存了数据、界面却迟迟不刷新。
• 长译文文本框卡高度：译文过长出现滚动条时，文本框高度卡在中间。
• 长译文冲出面板：译文过长撑破下拉面板、被右侧栏遮挡。
• 删除条目残留垃圾文件：删除条目时自动清理对应单词数据文件。
• 关闭插件丢词：防抖窗口内关闭、临时数据未落盘导致词条丢失。

优化

• 单词本局部刷新：搜索不丢焦点、翻页不闪屏、增删不整板重绘。
• 关闭强落盘：退出时强制把待写数据全部写盘，不再丢词。

说明

• 鼠标侧键桥接编译可能触发杀软误报，放行即可；系统级钩子在启用期间会接管侧键。
• Google / DeepL 免费为非官方接口，随时可能失效。
• API Key 以明文存于本地 api-config.json，请勿外传该文件。

wordtranslator-6.13.1

单词翻译 6.12.1 → 6.13.1 完整更新说明

核心新功能：内置离线词典

• 内置 3 万常用词离线词库（ECDICT 子集，约 2.4MB 进 XPI）：断网也能出音标、词性、中文释义。
• 离线优先降级链：离线词库 → 有道网页词典 → FreeDictionary，断网自动落到离线命中，无需联网检测。
• 词形回退：studies → study、-ing/-ed/-es 等变形自动还原到词根查询。

单词卡字典显示模式

• 全局 合/单/典 三态切换：合=显示翻译+词典；单=只显示翻译；典=只显示词典（保留单词行）。
• 单词本头部新增字典行：字典源下拉（自动/有道/FreeDict/本地离线）+ 合/单/典按钮。
• 卡片右键可单独设置该卡显示模式，单独控制；再点同项取消单独控制。
• provider 失败/超时但有词典时优雅展示：多义项 [单词 -- 首义项] + 词典行剩余义项；单义项 [单词] + 完整释义。这类卡片不受合/单/典影响。

发音（TTS）

• 新增 词典原生音频 引擎：优先条目音频，无则用有道字典音频兜底，源失效自动回落系统 TTS——任何词点 🔊 都有声。
• TTS 总开关：偏好页关闭后单词卡隐藏 🔊 按钮，实时更新。
• 修复：切换引擎后旧卡仍用旧引擎、句子卡在词典引擎下报 media resource 错误。

体验优化

• 词典提前补全：划词后词典行独立异步填充，不必等翻译返回。
• 翻译超时兜底：provider 长时间无响应（如 DeepL 免费版挂起）按失败处理，自动走词典展示，不再卡在翻译中。
• 重新翻译 ↻ 同时重跑词典：切换字典源后点 ↻ 即生效。

wordtranslator-6.12.1

v6.12.1 修复：

• 测试翻译 API 不再卡在『测试中』（超时兜底，显示具体失败原因）
• 切换服务商时清空残留的名称/模型/地址字段