前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的理念，旨在通過插件擴展功能。對於需要使用韓語界面的開發者，默認的英文界面可能帶來溝通成本。dsh-ko-locale 插件解決了這個問題，它爲 DSH 的桌面和 Web GUI 提供了完整的韓語本地化支持。
插件簡介¶
dsh-ko-locale 是由 ara-hwang 維護的客戶端插件，遵循 MIT 許可證。它是一個語言包，通過向 locale 目錄添加 ko 語言代碼，併爲註冊的命名空間提供韓語翻譯。
核心功能¶
- 完整覆蓋：支持 56 個命名空間，涵蓋 2,412 個字符串，覆蓋聊天、工作區、側邊欄、設置等主要界面區域。
- 語言選擇：在「設置 → 通用 → 語言」中會出現韓語選項，與英文、中文並列。
- 自動適配：在韓語系統的機器上，首次啓動時會自動選擇韓語；手動選擇的語言設置始終優先。
- 每鍵回退：如果該語言包未包含某個字符串（例如 DSH 更新新增的詞條或第三方插件新增的文案），系統會自動回退到內置的英語字典，而不是顯示原始的鍵名。
安裝與啓用¶
安裝命令會同時安裝依賴並選擇對應的 Bundle：
- 桌面客戶端：
dsh plugin --profile desktop add dsh-ko-locale
- Web 界面：
dsh plugin --profile web add dsh-ko-locale
安裝後刷新 GUI（桌面端通常爲 Ctrl+R）即可生效。
如果沒有 npm 訪問權限，可以使用倉庫地址直接安裝：
dsh plugin --profile desktop add github:ara-hwang/dsh-ko-locale
注意：後續對包的修改需要完全重啓應用，因爲宿主進程會保持已加載的模塊生成。
工作原理¶
該插件通過兩個主要部分工作：
1. 語言定義：調用 ctx.locale.addLanguage({ id: 'ko', label: '한국어', fallback: 'en' }) 註冊語言。
2. 字典疊加：在 LocaleRuntime.prototype.lookup 上安裝疊加層，覆蓋默認的翻譯查找邏輯。
插件包含 cordis.patch.yml 配置，用於加載瀏覽器端的 Bundle。
驗證與測試¶
倉庫提供了驗證腳本，用於確認插件是否正常工作：
node tools/smoke-test.mjs
該腳本會驗證 28 種行爲，包括 catalog 註冊、韓語激活、顯式選擇、每鍵回退以及插件卸載後的恢復。
如果需要確認 Bundle 是否在 Web 上正確服務：
node tools/probe-bundle-route.mjs
注意事項¶
- 重啓要求：安裝或更新插件後，必須完全重啓應用才能看到更改。
- 回退機制：語言包未包含的字符串不會導致界面崩潰，而是顯示英語。
- 優先級：如果一個插件自身攜帶了
ko字典，它會覆蓋dsh-ko-locale的疊加層效果。 - 許可證：插件使用 MIT 許可證。
總結¶
dsh-ko-locale 是一個爲 DeepSeek Harness 提供韓語支持的輕量級插件。它通過字典疊加技術，在保持系統回退機制的同時，爲用戶提供了完整的韓語界面體驗。
倉庫地址：https://github.com/ara-hwang/dsh-ko-locale
