前言¶
DeepSeek Harness (DSH) 的核心架構基於插件化,默認的網頁界面主要爲英文。對於需要使用俄語環境進行智能體開發或團隊協作的場景,原生的英文界面會增加溝通成本。dsh-locale-ru 插件通過接入公共語言包 API,在 DSH 的標準語言切換器中添加了“Русский”選項,並完成了主要界面表面的翻譯覆蓋。
插件概述¶
該插件由 AbsoluteMikhail 維護,採用 MIT 許可證。它不替換 DSH 的內部應用方法,也不在渲染後修改 DOM,而是通過擴展 LocaleRuntime 實現本地化。
核心功能¶
- 界面翻譯覆蓋:支持 48 個翻譯空間和 1600+ 行界面代碼,涵蓋聊天、設置、工作區、插件、權限、終端、文件、計劃、任務、子代理和服務面板。
- 語言切換:安裝後,通過“設置 → 通用設置 → 語言”即可在界面中找到“Русский”選項。選擇後會自動保存至配置文件。
- 數詞本地化:內置 CLDR 數詞支持,能正確顯示俄語變格(例如 1 вызов, 2 вызова, 5 вызовов)。
- 第三方插件兼容:對於插件中尚未翻譯的鍵值,插件會自動回退到英文顯示,不影響第三方插件的正常使用。
- 自動同步:內置安裝 smoke-test,安裝時會檢查配置並確保插件正確加載。
安裝與啓用¶
- 安裝插件:
使用 GitHub 源安裝:
dsh plugin --profile web add github:AbsoluteMikhail/dsh-locale-ru
(npm 發佈後也可使用 `dsh plugin --profile web add @absolutemikhail/dsh-locale-ru`)
-
重啓 Profile:
安裝命令執行後,需要重啓webprofile 以使更改生效。 -
啓用語言:
打開 DeepSeek Harness,進入“設置 → 通用設置 → 語言”,選擇“Русский”。
驗證安裝¶
執行以下命令檢查配置中是否已包含該插件:
dsh --profile web --dump-config
在輸出的配置中,應能看到類似 locale-ru 的條目。
技術細節與兼容性¶
- 運行環境:需要 Node.js 版本爲
^22.19.0或>=24.0.0。 - DSH 版本:當前版本兼容 DeepSeek Harness
0.1.6-alpha.2。 - CLDR 支持:對於
.few和.many這類擴展的 CLDR 數詞分類,需要 Harness 的 LocaleRuntime 支持 CLDR。在早期版本中,這些分類會回退到.one和.other。 - 無侵入性:插件僅作爲擴展存在,不修改 DSH 內部核心邏輯或渲染後的 DOM 結構。