前言¶
用 DeepSeek Harness 写代码或读文档时,英文思考链、报错信息和接口说明往往挡在理解前面。切到翻译网页或单独开词典,会打断当前会话;只靠模型全文翻译,又很难在「快查一个词」和「整段对照」之间兼顾。DSH-Translate 是 maintainer light-cheng 发布的 Web 客户端插件,挂在 DSH 对话界面里:思考链可逐段译成中文,划词先看本地词典再等模型补语境,输入框可把中文草稿换成英文,值得记的词条可进生词本。本文按官方 README 与 package.json(0.1.3)说明其能力与安装方式。
这是什么¶
DSH-Translate(npm 包名 @lightcheng/dsh-translate)属于模型推理类 Harness 插件:engines.dsh 要求 >=0.2.1-rc.5 <0.3.0,在浏览器侧注入会话 UI,在后端注册 /dsh-translate/api 等路由。它不替代 DSH 自带的对话逻辑,而是在展示层叠加翻译、词典与发音;卸载后原文渲染回到官方实现,插件不写 DSH 核心文件。
社区目录页:skillhub.cn/plugins/light-cheng/DSH-Translate。源码与说明:github.com/light-cheng/DSH-Translate(当前公开仓库星标为 0)。
核心功能¶
思考链中英对照¶
展开任意 reasoning 块,末尾点 Translate(中文界面为「译成中文」)。默认手动触发;设置里可改为展开即译。长块按约 2400 字符一段请求模型,卡片显示 x/y 进度,可停止、继续或重试失败段;已译段落写入 profile 下 dsh-translate/cache.json,不会重复调用模型。单次请求硬上限 60,000 字符,超出会提示而非静默截断。
划词与右键¶
云端引擎(默认)下选中英文会自动浮出译文卡:顶部先展示离线词典释义与美/英 IPA,模型返回后再补语境释义、说明与 3–6 张词汇 chip。本地 Ollama 因 CPU 推理较慢,改为点 Translate 才译;设置里也可关闭「选中即译」。右键菜单提供 Translate selection / Copy selection。
内置词典与发音¶
随包携带 data/dictionary.json.gz(约 1.9 MB,58,468 词条,含屈折反查),查词不联网、不调模型。发音按钮从有道 dictvoice 拉取短 mp3;失败约 4.5 秒后回退 speechSynthesis。词典数据整体为 GPL-3.0,插件代码为 MIT,详见仓库 THIRD-PARTY-NOTICES.md。
Composer 中译英与生词本¶
输入框有中文时出现 中→EN,一键替换为英文并尽量保留代码与路径,附带改写说明与撤销。译文卡里点词条可收藏;设置页生词本支持搜索、时间筛选、排序,点行可展开单词卡(云端可自动讲解,本地需手动触发)。
模型与隐私¶
只有你点击翻译、中译英或(云端下)选中的英文会送模型;词典只读本机 gz 文件。翻译引擎可选:云端 DSH 模型(默认)、本地 Ollama、本地优先失败回落云端。缓存与生词本位于 profile 的 dsh-translate/(cache.json、vocab.json、settings.json)。
安装与启用¶
DSH 桌面版自带 Node 运行时,通过 npm 安装插件时一般无需另装 Node;从源码构建或跑测试需 Node.js 22+。
1、在插件管理器市场中安装 DSH-Translate,或将 @lightcheng/dsh-translate 加入 profile 后重启 DSH。
2、命令行安装(README 原文):
dsh plugin --profile add @lightcheng/dsh-translate
将 <profile> 换成实际 profile 名时,与官方「从源码安装」示例一致:
dsh plugin --profile <profile> add <本目录绝对路径>
卸载可在管理器移除,或从 profile 的 package.json / cordis.patch.yml 删掉依赖;dsh-translate/ 目录需手动删除才会清掉设置与缓存。
典型用法¶
读长思考链: 展开 reasoning → 点末尾翻译 → 观察 x/y;中途可停止,稍后「继续」从未完成段接着译。
查词: 云端下选中单个词或 2–4 词短语,先看词典卡顶部的中文义项与音标,再读模型给出的语境释义;需要发音时点 🔊。
写英文提示词: 在 Composer 输入中文草稿 → 点 中→EN → 不满意用撤销;满意则直接发送英文。
记生词: 在译文卡点词汇 chip 收藏 → 打开设置页 DSH-Translate 第一组浏览、筛选、复制或清空生词本。
离线倾向: 设置选 Local Ollama,本地准备好 1.5B–4B 量级 instruct 模型(文档举例 qwen2.5:3b-instruct);纯 CPU 下速度约为「一分钟一段话」,且划词不会自动弹出,需手动点译。
适用场景与注意¶
适合在 Harness Web 里长期阅读英文思考链、划词学词汇、把中文草稿润成英文的开发者。云端模式体验最快;词典与浏览器语音合成可在无模型时做轻量查词。
插件随 DSH 进程运行,安装前请阅读仓库源码与许可证(代码 MIT,内置词典 GPL-3.0)。发往云端模型的内容限于你主动翻译或选中的文本;发音请求仅向公开词典音频接口索取单词读音。SkillHub 等为社区目录,与 DeepSeek / 幻方无官方从属关系。
结尾¶
DSH-Translate 把对照阅读、离线快查、Composer 润色和生词本收进同一 Web 会话,减少在 Harness 与外部工具之间切换。进一步细节见仓库 README_zh.md;目录入口:https://www.skillhub.cn/plugins/light-cheng/DSH-Translate,GitHub:https://github.com/light-cheng/DSH-Translate。