dsh-translator

dsh-translator

DeepSeek Harness（DSH） Web 插件。AI 回复的每一段（不含思维链）右下方会出现「翻译」按钮，点一下，就用你在 设置 → 模型 中已经配置好的模型把这一段翻译成你选的语言，译文显示在原文下方。

English: A DSH Web plugin that adds a Translate button under every AI reply segment (never the chain of thought). It translates the segment with a model you already configured under Settings → Models and shows the result right below the original.

• 兼容版本：DSH >=0.1.7-rc.1；Node >=22.19
• 插件形式：标准 DSH bundle。package.json 里声明了 dsh.bundle.patch 和 dsh.client，Host 半和 Browser 半都是纯 ESM，没有运行时依赖，安装时不需要构建
• 可通过 mikulo/dsh-plugins 插件清单一键安装

功能

安装

通过 dsh-plugins 清单（推荐）

git clone https://github.com/mikulo/dsh-plugins.git
cd dsh-plugins
node install.mjs --profile web --only dsh-translator

直接安装

dsh plugin --profile web add github:mikulo/dsh-translator

安装后重启 dsh web 并刷新页面。

• 更新：dsh plugin --profile web update @mikulo/dsh-translator，然后重启 dsh web
• 卸载：dsh plugin --profile web remove @mikulo/dsh-translator

插件的 Browser 半会随页面热更新，Host 半必须重启 dsh web 才会加载新代码。服务端没有加载时，设置页和按钮旁会提示「请重启 dsh web」。

使用

1. 打开 设置 → 回复翻译，选择翻译模型（或保持「跟随 DSH 默认模型」）、思考强度和目标语言，可在底部「测试」里先试一下。
2. 在对话中，AI 回复的段落下方右侧会出现「翻译」和「替换原文」两个按钮：「翻译」把译文显示在原文下方，「替换原文」把译文显示在原文的位置（仅显示层面，对话上下文不变）。

设置项

默认提示词：

将下面的文本翻译为{{target}}。要求：
- 只输出译文，不要添加任何解释、注释或前后缀；
- 保留原有的 Markdown 结构（标题、列表、表格、引用、链接）；
- 代码块、行内代码、命令、文件路径和 URL 保持原样，不要翻译；
- 专有名词和技术术语可保留原文。

{{text}}

数据保存位置

• 设置：~/.dsh/dsh-translator.json（设置了 DSH_HOME 时为 $DSH_HOME/dsh-translator.json）。与 DSH 自身设置分开保存，重装或更新插件不会丢失。
• 译文缓存：浏览器 localStorage 的 dsh-translator.cache.v1（最近 200 条），只在本机浏览器中。
• 翻译请求通过 DSH 自身的模型服务发出，使用你在 设置 → 模型 中配置的 API Key，插件不单独保存任何密钥。

工作原理

• Host 半（lib/index.js）：提供仅限本机访问的 /api/dsh-translator/* 接口；模型列表来自 DSH 的 llm 服务（listProviders → listModels → resolveModelInfo，与 DSH 自带的模型选择器相同）；翻译时调用一次 llm.stream()，只取正文文本块作为译文，丢弃思考内容。
• Browser 半（lib/client.js）：在设置中注册「回复翻译」页面；DSH 没有逐段的插槽（conversation.chat.assistant-actions 每轮只有一次），所以插件在每个已完成的 AI 文本块之后插入一个自己的容器，并由挂在 shell.overlay 中的组件通过 React portal 渲染按钮和译文。译文原文取自 DSH MarkdownText 组件的原始 Markdown；取不到时退回使用页面上显示的文本。

开发与构建

npm run build   # src/ → lib/（写入版本号并做语法检查）
npm test        # 检查 lib/ 是否最新 + Host / Browser / DOM 冒烟测试

• 源码在 src/，lib/ 是提交到仓库的构建产物，修改 src/ 后必须重新 npm run build。
• 没有 prepare / postinstall 等安装时构建脚本，dsh plugin add 直接使用仓库里的 lib/。

更新日志

1.0.1

• 目标语言改为十种常用语言：新增繁體中文、日本語、한국어、Deutsch，移除 हिन्दी、العربية、বাংলা、اردو。之前选了已移除语言的，会自动回到默认的简体中文。

1.0.0

• 首个版本：逐段「翻译」（译文显示在原文下方）与「替换原文」（译文在原处替换显示，仅改变显示、不改对话上下文）两个按钮、错误提示；设置页（模型同步、思考强度、目标语言、提示词、超时、只翻译英文、测试）。

许可证

MIT