前言¶
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 或幻方的官方應用商店。