前言¶
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