前言¶
DeepSeek Harness（DSH）在网页界面中划词翻译时，需要选中目标文本并点击浮动按钮，对连续多行选择或非文本区域支持有限。dsh-translator 通过独立输入面板与双引擎设计，解决选中范围受限、无 API Key 也能翻译、文本隐私可控等问题。
插件定位¶
dsh-translator 是 TuWeiZhi 维护的 DSH 插件，基于 upstream v0.4.3 的增强 fork，提供 Youdao 风格的划词翻译，并增加独立输入面板、无 Key 公共翻译端点、词典层（词性分组、拼音/IPA、双语示例）等能力。
核心功能¶
双引擎切换¶
插件在设置页提供两种翻译引擎，可在不重启 DSH 的情况下切换：
- Free API（默认）：使用腾讯、微软、火山引擎、MyMemory 的公开端点，无需注册或密钥，自动重试链路。请求由 DSH 进程发起，避免浏览器 CORS 与 Cookie 问题。
- Model：使用 harness 自带的大模型，翻译内容不经过公共端点，仅对已配置的模型可见。
独立输入面板¶
除选中文本外，插件支持在独立面板中输入或粘贴文本进行翻译，无需先做文本选择。
词典层¶
翻译卡片下方渲染词典层，包括词性分组、拼音/IPA、双语示例，方便快速核对词义与用法。
自动方向识别¶
方向自动识别：简体中文、繁體中文、日本語、한국어、Русский 作为主语言时，其他文本自动转为英文，主语言文本转为对应主语言。
卡片操作¶
- 拖拽卡片头部移动位置
- 固定卡片防止误关闭
- 点击翻译结果、源文本或错误信息进行复制
- 底部显示来源（Free API 的端点或 Model），并标记是否复用缓存
- 同一段落再次请求时从缓存返回，仅需一次请求；Retry 会忽略缓存重新请求
- 未发生变化的返回结果会被标记为未翻译
安装与启用¶
在 DSH 的 Plugins 页面，点击 Add plugin，输入以下任一地址即可安装：
@tuweizhi/dsh-translator
https://github.com/TuWeiZhi/dsh-translator
卸载后重新安装可更新到最新版本。插件安装后需重启 DSH 生效。
若希望通过插件市场安装，可按以下步骤操作：
- Plugins 页面 → Experimental plugins → More → 启用 Custom plugin market
- Discover → Index sources → 添加
https://raw.githubusercontent.com/TuWeiZhi/dsh-plugins-index/main/index.json - 在 Discover 中选择 dsh-translator 并安装
典型用法¶
- 在网页界面选中任意文本，浮动翻译按钮出现在选择处
- 点击按钮，翻译卡片展开
- 点击卡片中的文本即可复制
- 如需翻译面板内输入的内容，点击卡片右上角的输入框进行输入或粘贴，再次点击翻译按钮即可
适用场景与注意¶
适合需要在 DSH 网页界面中快速查看译文与词典信息的使用者。Free API 引擎使用非官方端点，无 SLA 且可能变更，不适合处理敏感内容；如需严格隐私，应使用 Model 引擎。
插件以当前 DSH 进程的权限运行，安装前建议查看源码与许可证（MIT）以确认安全性与合规性。
结语¶
dsh-translator 在原生划词翻译的基础上增加了独立输入面板、无 Key 公共端点、词典层等能力，使 DSH 网页界面的翻译与查阅更加灵活。更多细节与源码参见：
- 插件目录页：https://www.skillhub.cn/plugins/TuWeiZhi/dsh-translator
- GitHub 仓库：https://github.com/TuWeiZhi/dsh-translator
