前言¶
在 DSH Web GUI 里阅读对话、侧栏或输入框时，常遇到需要临时翻译的句子。已有做法可能依赖外部翻译接口或额外 API key，配置和维护成本更高。dsh-translator 针对这个场景，提供有道风格的划词翻译：在界面中划选文本，点击悬浮按钮，由当前 DSH 已配置的模型管线生成译文。它不要求单独配置 API key，也不调用第三方端点。
DSH 的插件生态强调“一切皆插件”。这里的社区目录是独立站点，不是官方应用商店，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-translator 是一个 DSH 插件，用于在 Web 客户端中做划词翻译。npm 包名为 @nicearrack/dsh-translator，GitHub 仓库为 nicearrack/dsh-translator，由 nicearrack 维护，MIT 许可。
它解决的是“在 DSH 界面任意位置划词后快速获得译文”的问题。译文由 harness 的 LLM 产生，使用你已配置的模型管线，不引入额外 API key 或第三方端点。
核心功能¶
- 划词触发：在应用内任意位置划选文本，悬浮 translate 按钮会跟随选区出现，适配浅色/深色主题。
- 自动方向：配置的主语言文本会翻译成 English；其他文本会翻译成主语言。
- 主语言可配：支持
简体中文/繁體中文/日本語/한국어/Русский，默认简体中文。 - 设置卡片：在 DSH 设置
Settings → Plugins → 划词翻译中可配置主语言、模型、reasoning effort、timeout、max tokens、temperature。每个字段可显示overridden / restore default，并支持暂存修改、保存/丢弃。 - 翻译卡片：显示原文、方向标记、译文，失败时可重试；页脚显示
model · reasoning effort · tokens。 - 点击复制：可点击译文、原文或错误信息复制，并显示
已复制 / Copied提示。 - 可拖拽：拖动卡片头部即可移动位置，卡片会保留在你放置的位置。
- 可固定：固定后锁定拖动、Esc 和点击外部关闭，直到你主动关闭；同一时间只保留一张卡片，不支持嵌套。
- 流式稳健：可处理 live streaming 输出，避免闪烁；内容滚动时卡片位置保持不动。
安装与启用¶
从 npm 安装：
dsh plugin --profile web add @nicearrack/dsh-translator@latest
安装后，在 DSH 设置中进入 Settings → Plugins → 划词翻译，按需选择主语言、模型和推理强度。模型可以留空，以跟随会话默认。
典型用法¶
1、划选文本。
2、点击选区附近的悬浮 translate 按钮。
3、在翻译卡片中查看译文、方向和页脚信息。
4、拖动卡片头部调整位置，或固定卡片避免误触。
5、点击译文、原文或错误信息完成复制。
配置项¶
在 Settings → Plugins → 划词翻译 中可设置：
| 字段 | 说明 |
|---|---|
| 主语言 | 简体中文 / 繁體中文 / 日本語 / 한국어 / Русский，默认 简体中文 |
| model | 选择一个模型，或留空以跟随会话默认 |
| reasoning effort | off / low / high / max |
| timeout | 超时设置 |
| max tokens | 最大 token 数 |
| temperature | 温度 |
每个字段都支持 overridden / restore default 的显示与恢复，并可用暂存方式编辑后保存或丢弃。
更新、卸载与注意¶
更新后重启 DSH 实例，使新的 host bundle 加载：
dsh --profile web
客户端 bundle 会在下次页面刷新时更新。
卸载后同样需要重启实例：
dsh --profile web
通过 Git 安装会运行包的 prepare build script。如果首次安装被拒绝，且使用 pnpm ≥ 10，可一次性授权构建脚本：在 profile 的 pnpm-workspace.yaml 中加入：
allowBuilds:
"@nicearrack/dsh-translator": true
npm registry 元数据在发布后可能滞后。若 @latest 仍解析到旧版本，可改用精确版本。
插件以当前 DSH 进程权限运行，使用前应检查源码与 MIT 许可证。它适合希望在 DSH Web GUI 中划词获取译文、且希望译文始终来自当前模型管线的开发者。
链接¶
- 目录页：https://www.skillhub.cn/plugins/nicearrack/dsh-translator
- GitHub：https://github.com/nicearrack/dsh-translator
