dsh-zh-cn:为 DSH 已安装插件界面提供离线中文汉化

前言

DeepSeek Harness(DSH)按「一切皆插件」组织能力:插件市场里的第三方扩展往往只提供英文界面,插件名、说明、按钮和设置项清一色是英文。手动改源码不现实,在线翻译 API 又会引入联网依赖和误翻聊天、代码的风险。下面介绍社区客户端插件 dsh-zh-cn(维护者 2189166478-bot):用内置离线词典在 Web 渲染层做整串替换,在「设置 → 汉化」里一键开关,把已安装插件的界面文案换成中文。

这是什么

dsh-zh-cn 是 DSH 的界面汉化插件,分类为客户端,当前仓库版本 1.0.1(MIT 许可证)。它不翻译模型对话正文,只针对 DSH Web 客户端里各插件暴露的 UI 字符串:词典在构建期打入 client.js,运行时通过 DOM 监听做查表替换,默认开启,关闭后按节点记下的原文还原。

核心功能

资料中写明的能力如下:

  • 离线:词典内嵌客户端,运行时零联网,不调用翻译 API。
  • 可开关:路径为「设置 → 汉化 → 启用汉化」;状态保存在浏览器 localStorage,键名 dsh-zh-cn:enabled,默认开启。
  • 替换范围受控:只处理整串命中词典的文本(可忽略首尾标点、…、项目符号与大小写);聊天正文、代码块、输入框,以及 Monaco / xterm / CodeMirror 等编辑器区域不修改。
  • 覆盖面:随包约 4700+ 条词条,来源包括带 dsh.client 的已装插件客户端字符串、人工 UI 词表与插件中文名(README 提到抽取时对应约 40 个此类插件)。
  • 可扩展:词典为 JSON,改表后运行 python build_bundle.py 可重建;面板可查看词典条数、本次已替换文本数,并提供「重新扫描当前页面」。

工作原理简述:构建期由 extract_corpus.py、translate_bing.py 等生成 dictionary.json 等文件,build_bundle.py 合并后写入 client.template.js 的 __DICT__ 占位得到 client.js;运行期用 MutationObserver 扫描文本节点及 placeholder、title、aria-label 等属性,Shadow DOM 内内容也会扫描。

安装与启用

环境要求(来自 package.json 与 README):

  • DSH >= 0.2.0-rc.1(Web 界面)
  • Node >= 20(开发/构建脚本侧)

README 给出的安装方式为先取得仓库目录,再在 DSH 插件管理器中以绝对路径安装 bundle(link: 方式,移动或删除目录会导致插件失效,需重新 install_bundle 指向新路径):

git clone https://github.com/2189166478-bot/dsh-zh-cn.git
plugin_manager({ action: "install_bundle", target: "D:/path/to/dsh-zh-cn" })

将 target 换成你机器上 clone 目录的绝对路径。装完后若设置里未出现「汉化」,重启一次 DSH。

启用:打开「设置 → 汉化 → 启用汉化」。插件市场「已安装」列表中的插件名与说明也会变为中文(README 说明)。

典型用法与维护词典

日常使用只需在设置里切换汉化开关。若自行改词表或安装/更新了其他 DSH 插件后出现新英文 UI,可在汉化面板点「重新扫描当前页面」,或按 README 重建客户端:

# 仅改了词典文件
python build_bundle.py

# 插件更新后出现大量新英文:先抽词、机翻增量、再打包
python extract_corpus.py
python translate_bing.py
python build_bundle.py

三种词典文件分工(README 表格):

文件 用途
dictionary.json 机翻与整理后的主词典,一般少手改
glossary.json 通用 UI 词,优先级较高
curated.json 逐条覆盖(含插件中文名、具体文案),优先级最高

修正某条译文:在 curated.json 增加 "英文原文": "中文" 后执行 build_bundle.py;改 package.json 版本号后,在 DSH 里卸载再安装可使客户端半边热加载(README 说明)。

适用场景与注意

适合:主要使用 DSH Web 界面、已安装多个英文 UI 的社区插件、希望界面中文且不想为汉化单独接 API 的开发者。

限制(README「已知限制」):

  • 仅整串精确匹配;带变量的句子(如 Save 3 changes)保持英文。
  • 不作用于 <iframe> 或 canvas 内绘制文字;少数频繁重绘的节点可能仍为英文。
  • 机翻条目标注可在 curated.json 覆盖;词典条目版权归属各插件作者,本仓库仅提供译文映射。

安全与信任:插件以当前 DSH 进程与浏览器上下文运行,会读写页面 DOM 与 localStorage。安装前应阅读 GitHub 源码 与 MIT 许可证,确认符合你的使用环境。社区目录 SkillHub 上的 dsh-zh-cn 页 为第三方插件索引,与 DeepSeek / 幻方无官方从属关系。

结尾

dsh-zh-cn 用离线词典与 DOM 翻译层,在不动聊天与代码的前提下汉化已装 DSH 插件界面,适合需要中文控制台又希望保持本地、可关可开的场景。更多说明见仓库 README:

  • 目录页:https://www.skillhub.cn/plugins/2189166478-bot/dsh-zh-cn
  • GitHub:https://github.com/2189166478-bot/dsh-zh-cn
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye