dsh-auto-translate

dsh-auto-translate

悬停一块，就地翻成中文。不自动翻页、不花 token、文本不出本机。

真机三连 —— 同一段文字，真鼠标在三个位置（npm run capture:demo 可复现；画面是脚本注入的合成舞台，不含任何会话内容）

① 鼠标停在空白处 —— 原文不动

② 鼠标停在文字上约 0.6 秒 —— 就地换成中文

③ 移开后再停一次 —— 换回原文

光标箭头是 capture-demo.mjs 画上去的标记（headless 截图拍不到系统光标），位置是真鼠标当时的坐标， 悬停本身也是真实鼠标事件（page.mouse.move）。

30 秒看懂

• 你在读 DSH 的回复，某一块是英文 —— 鼠标停在那块上约 0.6 秒，那一块就地变成中文；再停一次换回原文，可反复。
• 也可以拖选一段文字松手即译：默认弹浮层（原文+译文，可复制），面板里可改成就地替换。
• 绝不自动翻译整页（0.4.0 起的刻意设计）：你没有主动操作时，插件完全不碰页面，不会改掉你正在读或正在输入的界面。
• 零 token：不经过 DSH 模型、不产生 API 费用；默认走浏览器内 WASM 推理（模型下载一次，之后完全离线），译文不出本机。

和「自动翻整页」那类插件有什么不同

如果你要的是「整页 + 思考链自动翻成 8 种语言」，那 dsh-think-translate 更合适 —— 它是另一种取舍（覆盖面换自动触发与云端引擎）。本插件选的是按需 + 零成本 + 不出本机。

安装

# 一条命令（npm）
dsh plugin --profile web add dsh-auto-translate
# 然后重启 dsh web，再刷新浏览器页面

左下角出现半透明「译 xx」小圆点即成功；找不到圆点时按 Ctrl+Alt+T 呼出面板。

# GitHub
dsh plugin --profile web add github:gst20060726/dsh-auto-translate

# 本地目录（开发 / 离线）
dsh plugin --profile web add link:/absolute/path/to/dsh-auto-translate

# 本地 tgz：先 npm pack 得到 dsh-auto-translate-<版本>.tgz，再把文件发给对方
dsh plugin --profile web add /对方/路径/dsh-auto-translate-<版本>.tgz

# Gitee 镜像（国内可推）
dsh plugin --profile web add 'git+https://gitee.com/nysjn/dsh-auto-translate.git#<commit>'

使用

面板按「常用 / 触发与框选 / 引擎与模型 / 高级 / 诊断与重置」分组折叠（默认只展开「常用」，顶部可一键展开/折叠全部，还能切「窄面板」）。面板里还有：目标语言、悬停延迟、由谁翻（本机离线 / 在线免密钥 / 自定义端点）、框选方式、最少选取字数、框选上限（0 = 不限）、在线端点、拉丁源语言、下载/预热、切到本机、重试、全部原文/译文、还原原文、清缓存、使用指南、保存/复制诊断。

覆盖范围（能翻 / 不能翻）

单次框选默认最多翻 4000 字符（面板可改，0 = 不限；另有 60000 字符硬兜底）；超出会明确提示「已按上限只翻前 N 字符」。

引擎对照

0.4.0 起引擎只决定「由谁来翻」，不决定触发方式（触发恒为按需）。

本地模型说明

• 模型经插件自带的同源代理路由下载（/dsh-auto-translate/model-v2/...），宿主端带断点续传 + 12 次重试并落盘缓存，避免浏览器直连镜像时的跨域与中断问题。
• 缓存在浏览器 Cache Storage；宿主缓存位于 $DSH_HOME/dsh-auto-translate/models。
• 想省流量可先只装 en↔zh；其它语向在首次遇到时再下载。
• 仓库体积：默认不含 ONNX Runtime 的 wasm（约 74MB）。首次使用时宿主端会从 CDN 取回并缓存到 $DSH_HOME/dsh-auto-translate/ort-cache；要完全离线运行，先执行 npm run fetch-vendor 把它们落到本地 vendor/ort/。

故障排查

架构

dsh-auto-translate/
|- index.js              # 宿主半：静态资源路由 + 模型同源代理 + 诊断落盘
|- client.js             # 浏览器半：扫描/翻译/悬停切换/设置面板
|- vendor/
|   |- worker.v5.js      # Web Worker：SharedWorker 单实例推理、按语向懒加载
|   |- transformers.esm.v2.js  # transformers.js 浏览器 ESM（ORT 引用已指向本地）
|   |- ort/              # ONNX Runtime 的 wasm 与加载器
|- scripts/fetch-vendor.mjs     # 重新生成 vendor/（仓库可不带大文件）
|- scripts/verify-browser.mjs   # 真浏览器验收（可选，见下）
|- demo/                 # README 用的图：hover-flow.svg 自制示意；panel.png 真机截图裁剪
|- package.json / cordis.patch.yml

• 宿主半只做三件事：/dsh-auto-translate/vendor/*（静态）、/model-v2/*（模型代理+缓存）、/diag（诊断落盘）。
• 浏览器半不注册工具、不调用模型；推理全在 Worker 中，主线程只做文本替换。

改代码后怎么验

npm test                  # 47 项：契约 + i18n + jsdom E2E（不需要浏览器）
npm run verify:browser    # 真浏览器：面板真实布局/是否滚动/是否裁字 + 真实鼠标悬停与框选

verify:browser 用你本机的 Edge/Chrome 起独立临时 profile（不碰你在用的浏览器数据），需要 puppeteer-core （DSH 配置目录里通常已有；没有就 npm i --no-save puppeteer-core）。它专治 jsdom 测不出的问题： 没有布局引擎就发现不了「面板装不下要滚动」「文字被裁」。输出截图 panel-preview.png 与 JSON 报告， 任一项不通过就以非 0 退出。

README 里的 demo/panel.png 就是这个脚本的产物，再裁掉四周 16px 的页面边带（只留插件面板本身， 不带你自己的会话内容）。整页截图只留本机 demo/raw/（已 gitignore）：那里面有真实会话。

悬停三连（demo/hover-1|2|3-*.png）由 npm run capture:demo 生成：脚本往页面注入一块白底舞台 ＋一个对话块＋一个光标标记 —— 这样「光标在空白处」那帧里的空白也是注入的，可以按舞台整块裁切 （560×150）而不带出真实会话。光标位置取真鼠标当时的坐标（系统光标截不到，箭头是画的标记）。 出图时把引擎切成了在线免密钥（否则要等 425MB 本机模型下载）；界面表现与引擎无关，只是「由谁翻」不同。

兼容性

• DeepSeek Harness 0.1.5-rc.1 及以上（profile web）。
• Chrome / Edge 116+（module worker + WASM）；端侧引擎需 Chrome/Edge 138+。

License

MIT