DeepSeek HarnessHub
提交插件

7gzgn/dsh-inpage-translator ↗★ 0

dsh-inpage-translator

在浏览器页面中添加一键整页翻译为中文的浮动按钮。 原地替换可见文本且不破坏样式，适合需要快速阅读外文网页并对照原文的用户。

Agent 协作
包名
dsh-inpage-translator
兼容性
待验证
Harness 依赖范围
>=0.2.0-rc.2 <0.3.0-0
Cordis 依赖范围
>=4.0.4 <5.0.0
版本
0.1.1
许可证
MIT
最近更新
2026年10月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:7gzgn/dsh-inpage-translator

说明文档

阅读完整 README ↗

dsh-inpage-translator（整页翻译）

你把页面给 AI 看，它替你把整页翻成中文。

调一次 translate_page，页面右下角多出一个浮层按钮「🈯 译」； 点一下，页面上每一个可见文本节点原地换成译文；再点一下，回到原文。

它是第 8 个作品，也是第一个"动别人的网页"的插件： 前 7 个动的是本机、文件、窗口、发布链路，这个动的是一张陌生的页面 —— 所以两条边界写在最前面：只改文本、只加内联样式；插件自己不持有任何 API key。

它做什么

步动作细节
①取浏览器会话默认用自己的会话键（dsh-inpage-translator），也支持 session 参数翻别的会话
②装浮层按钮内联样式 + position:fixed + z-index:2147483647，不注入 ``（页面 CSP 管不到它）
③打标TreeWalker 遍历文本节点，可译的父元素记下原始文本与编号（data-dsh-pt="12"）
④等点击（action=install）每 1.2 秒读一次页面状态，默认等 60 秒；用户点了就在同一次调用里翻好
⑤分块送翻相同字符串只翻一次；按字符/节点数分块；译文由宿主 LLM 服务生成
⑥回填按编号写回 textContent，并记下译文（再点按钮即还原）
⑦还原点按钮或 action='restore' → 全部回到原文

回执里一定有：送翻条数、回填条数、模型调用次数、字符数、唯一串数、 超限丢弃段数、兜底原文条数，以及任何一条警告。不编数字，不静默丢。

已知边界（先说清，再说好用）

边界说明
不是原生工具栏按钮内置浏览器的工具栏是宿主硬编码的 HTML（dsh-builtin-browser/host-main.js:123 的 TOOLBAR_HTML），宿主不读任何外部字段 —— 第三方插件没有加工具栏按钮的扩展点。所以按钮做进页面里。
导航后按钮会消失注入是运行期一次性的（宿主没有 addScriptToEvaluateOnNewDocument 这类通道）。再调一次 translate_page 即可重装；按钮状态原本也无法跨页保留。
跨域 iframe 翻不到只能进当前文档的 DOM。同源 iframe 有机会，跨域没有。
只翻可见文本节点图片、background-image、canvas 里的文字不动；/ 的值不动。
字符上限maxChars 默认 6000（省钱）。超出部分如实回报并跳过，不做静默丢弃。
文本节点被包了一层 ``元素上只打标、不重排子树（span 用 display:inherit），但页面自己重写这段 DOM 时译文可能被覆盖 —— 那时重跑一次即可。

它依赖什么

  • 内置浏览器插件（ctx.get('browser')）—— 没有时明确报错，不会假装能用。
  • 宿主的 LLM 服务（ctx.get('llm')）—— 翻译由它完成，插件不读任何 API key、不直接调任何 HTTP。 调用形状与宿主里已验证的两个先例一致（dsh-meme 的识图、dsh-better-sidebar 的提交信息）： resolveCallConfig → prepareCall → stream。

安装

市场收录后在 DSH 里搜 dsh-inpage-translator 安装。手动安装：

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-inpage-translator" -Target "D:\dsh\projects\dsh-inpage-translator"
# profile 的 package.json：dependencies 加 "dsh-inpage-translator": "link:D:/dsh/projects/dsh-inpage-translator"
# 并把 "dsh-inpage-translator" 加进 dsh.profile.bundles（漏了不加载）→ 重启 DSH

用法

translate_page action=install        # 装按钮并等用户点（默认等 60 秒）
translate_page action=translate      # 不等点击，立刻翻
translate_page action=restore        # 回到原文
translate_page action=status         # 只读状态

可选参数：target（zh 默认 / en / ja / ko / ru）、 mode（replace 默认 / bilingual 双语对照）、maxChars、waitSec、 session、provider、model。

典型流程：

  1. 让 AI 打开你要读的页面（浏览器窗口就在你眼前）；
  2. translate_page(action:"install") → 你点一下右下角的「🈯 译」；
  3. 同一次调用里页面就变成中文了；
  4. 想对照原文，再点一下按钮（或让 AI 调 restore）。

三条设计取舍（都被现场逼出来的）

  1. 按钮为什么在页面里、而不是工具栏里 宿主工具栏没有第三方扩展点（见上表），而"往页面里放一个浮层"是宿主自己就在用的姿势 （dsh-builtin-browser 的 virtual-cursor.ts:69-81 就是这么画那个虚拟光标的）。 零宿主改动、可随时卸载、升级不会被打回。

  2. 按钮点击为什么由插件处理，而不是页面自己翻译 页面里没有到宿主的 bridge（也没有凭据，也不该有）。所以按钮只写一个请求标记 （data-dsh-pt-req），插件轮询读到后去翻译 —— 这样凭据永远留在宿主侧。

  3. 为什么"相同文本只翻一次" 网页里菜单/按钮/表头经常重复几十次。去重发生在限额之前， 所以 6000 字符的额度能覆盖的页面比不去重时大得多。

安全与隐私

  • 不发外部请求：插件自己只做两件事 —— 在页面里跑脚本、调用宿主 LLM 服务； 没有任何 fetch、没有本地 HTTP 端口、没有凭据读写。
  • 不改页面结构以外的东西：只写文本、只加内联样式与三个 data-dsh-pt* 属性。
  • 翻译内容会经过你本机配置的模型（DSH 的 provider）—— 这是这类功能的固有代价， 页面上若有敏感信息，请自行判断要不要翻。

测试

node test/smoke.mjs        # 50 项：纯逻辑 / 页面脚本 / 编排层（假 LLM）/ 驱动层（假浏览器与假页面）

测试不联网、不碰真实浏览器、不读任何凭据。 在活代码树（D:\dsh\projects\dsh-inpage-translator）里跑会直接退出， 请先复制到 D:\dsh\sandbox\ 再跑（避免在真宿主上生效）。

许可

MIT