前言¶
DeepSeek Harness (DSH) 旨在通過插件實現高度的模塊化。但默認的 DSH Web 介面僅內置了簡體中文和英文，且核心代碼結構固定。對於需要繁體中文環境的用戶，通常需要手動修改核心文件，這既不安全也不利於後續維護。dsh-locale-zh-tw 插件通過在瀏覽器端進行擴展，解決了這一痛點。
插件定位¶
這是一個由 wangsan71 維護的「客戶端」類插件。它的核心價值在於讓 DSH Web 介面原生支援繁體中文（臺灣），在不修改 DSH 核心檔案的基礎上，實現全介面的自動簡轉繁與瀏覽器自動切換。
核心功能¶
該插件主要包含以下能力：
- 介面本地化：提供 DSH Web 介面繁體中文（臺灣）語言包。
- 自動轉繁：全介面自動將簡體轉換爲繁體，採用臺灣用語標準（共 89 組片語 + 389 字符對照）。
- 瀏覽器適配：自動檢測瀏覽器語言，支持
zh-TW、zh-Hant、zh-HK、zh-MO四種地區設置並自動切換。 - 非侵入式擴展：不需修改 DSH 核心檔案，僅通過在瀏覽端擴充
LocaleRuntime，並使用cordis.patch.yml進行核心擴充。
安裝與啓用¶
安裝過程依賴 Node.js 環境，安裝後需重啓 DSH Web 才能生效。
# 1. 安裝插件包
npm install dsh-locale-zh-tw
# 2. 將其加入 profile 的 bundles（以 web profile 爲例）
dsh plugin --profile web add dsh-locale-zh-tw
安裝完成後，需要重新啟動 dsh web 服務。
使用方法¶
啓用插件後，可通過以下方式切換語言：
- 手動切換：在 DSH Web 介面中，前往「設定 → 一般 → 語言」，選擇「繁體中文」。整頁介面會立即變成繁體，並將偏好存入瀏覽器的
localStorage，下次開啟時會自動恢復。 - 自動切換：如果瀏覽器語言設為
zh-TW、zh-Hant、zh-HK或zh-MO，開啟插件後會自動選擇繁體中文。
原理與注意事項¶
該插件的設計基於以下事實與限制：
- 偏好存儲位置：由於 DSH 主機的
settings schema目前只認zh和en，zh-TW的偏好無法寫入主機。插件將偏好存儲在瀏覽器端（localStorage）。這意味著如果更換瀏覽器，需要重新選擇語言。 - 容錯機制：任何配置失敗或載入問題都會導致靜默降級，不會影響 dsh web 的正常載入。
- 適用範圍：插件僅在瀏覽器端運行，不依賴任何外部套件，安裝到任何 profile 都不會產生缺套件的問題。
結語¶
dsh-locale-zh-tw 通過瀏覽器端的攔截與擴展，繞過了核心對語言支持的硬編碼限制。對於需要在 DSH 環境中使用臺灣用語的開發者，這是一個無需修改核心代碼即可提升體驗的方案。
