前言¶
DSH 里的系统提示词、工具描述、运行时上下文和前端菜单默认以英文呈现。对需要长期阅读提示词、排查工具参数或做本地化协作的使用者来说,英文文本会形成额外阅读负担。已有做法通常要维护提示词字典、前端翻译或源码补丁,升级 DSH 后也可能失效。
下面介绍 zjl1989-li/dsh-harness-zh-cn。它是 DeepSeek Harness 中文汉化插件,在运行时把 DSH 的全部系统提示词、工具描述、运行时上下文以及前端 UI 文本翻译成中文。
定位¶
这是一个纯运行时插件,分宿主半与客户端半两部分。它通过 DSH 的扩展点工作,不修改任何 DSH 源码;卸载插件后还原英文。
仓库信息如下:
- 名称:
zjl1989-li/dsh-harness-zh-cn - 维护者:
zjl1989-li - 许可证:MIT
package.json声明版本:0.2.0package.json声明dsh.client.platform为webpackage.json声明peerDependencies:@deepseek-ai/cordis ^4.0.1@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6
它不碰 node_modules,升级 DSH 后依然有效。
核心功能¶
运行时汉化¶
插件会在运行时汉化以下内容:
- DSH 的系统提示
sections - 运行时上下文
contexts - 工具描述与参数描述
cordisAPI 目录- 前端 UI 标签
- 斜杠命令菜单描述
宿主半通过 system-prompt/assemble 瀑布钩子工作,在组装提示词后替换模型可见英文文本,并 patch commands.list 汉化斜杠命令菜单描述。
客户端半 patch ctx.locale.lookup,使自带 zh 词典的命名空间在 t() 标签上优先生效。该过程不修改 DSH 前端代码。
命令菜单汉化¶
命令菜单汉化只翻译展示用描述,命令 name 保持英文。
插件不改变命令解析、派发、模糊匹配和展示过滤行为。
插件市场描述翻译¶
配合 dsh-plugin-marketplace 时,插件市场里的英文描述会先通过词表即时翻译,再由 LLM 批量翻译并缓存刷新。
如果 LLM 不可用,会自动回退到词表翻译。
可配置开关¶
includeSections、includeContexts、includeTools 三类翻译可分别关闭。
默认配置如下:
includeSections:trueincludeContexts:trueincludeTools:trueverbose:false
安装¶
下面介绍几种安装方式。
npm 安装¶
npm install dsh-harness-zh-cn
pnpm 安装¶
pnpm add dsh-harness-zh-cn
从 GitHub 安装¶
npm install git+https://github.com/zjl1989-li/dsh-harness-zh-cn.git
启用¶
通过 DSH Web GUI 启用¶
在 DSH Web GUI 的 设置 → 插件管理 中添加 dsh-harness-zh-cn,重启后生效。
通过 profile bundle 列表启用¶
在 profile 的 package.json 的 dsh.profile.bundles 列表中加入 dsh-harness-zh-cn。
例如在已有 bundle 数组中追加:
{
"dsh": {
"profile": {
"bundles": [
"dsh-harness-zh-cn"
]
}
}
}
通过 cordis.patch.yml 启用¶
在 DSH profile 的 cordis.patch.yml 中追加插件条目,并配置翻译开关:
- $plugin: dsh-harness-zh-cn
config:
includeSections: true
includeContexts: true
includeTools: true
翻译边界¶
以下文本会保留原样:
[exit code: N][killed by signal: X][sandbox: ...][stderr]
代码标识符保留不译。
适用场景与注意¶
这个插件适合以下场景:
- 阅读 DSH 系统提示词、上下文和工具描述
- 在 Web GUI 中使用中文界面文本
- 汉化斜杠命令菜单展示描述
- 配合
dsh-plugin-marketplace汉化插件市场描述
安装前注意:
- 插件会作为 DSH 插件加载,并以当前
dsh进程权限运行。 - 安装前应检查源码与许可证。
- 插件市场描述翻译需要安装
dsh-plugin-marketplace。 - 该插件是 MIT 许可,不修改 DSH 源码,卸载后还原英文。
获取¶
GitHub 仓库:
https://github.com/zjl1989-li/dsh-harness-zh-cn
插件目录页:
https://www.skillhub.cn/plugins/zjl1989-li/dsh-harness-zh-cn
该目录页链接来自插件线索;已核实资料未提供该页面内容。它不应被理解为 DeepSeek 或幻方的官方应用商店。