DeepSeek Harness Web 繁體中文化怎麼安裝?用外掛把介面換成臺灣繁體中文
介紹 dsh-client-locale-zh-tw 外掛,從 GitHub 安裝 DeepSeek Harness Web 的臺灣繁體中文語言服務,並說明語言保存、移除與相容性限制。
DeepSeek Harness Web 繁體中文化怎麼安裝?用外掛把介面換成臺灣繁體中文
DeepSeek Harness Web 如果主要介面是英文或簡體中文,第一次使用時,常常不是功能不會用,而是介面文字增加了理解成本。
尤其當你要看設定、工作流程或外掛狀態時,語言不一致會讓操作變得不直覺。
這篇介紹一個可以直接安裝的臺灣繁體中文外掛:
dsh-client-locale-zh-tw
GitHub 原始碼與安裝來源:
https://github.com/hi18aa/dsh-client-locale-zh-tw
這個外掛的做法不是去修改 DeepSeek Harness 原始碼,而是替換官方的語言提供者,讓 Web Profile 使用外掛提供的語言服務。
這個外掛做了什麼?
外掛安裝後,Bundle 會停用官方的 locale provider,改由外掛提供相同的 ctx.locale 服務。
它支援:
- 簡體中文
- 英文
- 臺灣繁體中文
這個設計有一個好處:你不用直接修改 DeepSeek Harness 的原始碼。
之後如果要移除外掛,也不需要手動把改過的程式碼一段一段改回來。
從工程角度看,它是在既有介面上替換語言服務,不是把整個 Web Profile fork 出去重做。
安裝前先確認
先確認你已經可以使用 DeepSeek Harness 的 dsh 指令,並且知道自己要操作的是 Web Profile。
本文的安裝方式使用:
dsh plugindsh webwebProfile
如果你的 DSH 指令還不能執行,先處理 DeepSeek Harness 本身的安裝與環境設定,再進行語言外掛安裝。
方法一:直接從 GitHub 安裝
這是一般使用者最簡單的方式。
在 PowerShell 執行:
dsh plugin --profile web add github:hi18aa/dsh-client-locale-zh-tw
dsh web
第一行會把外掛加入 DeepSeek Harness 的 Web Profile。
第二行重新啟動 Web Profile,讓外掛載入。
這裡有一個容易漏掉的地方:
安裝完成後要重新啟動 Web Profile。
只安裝 Bundle、不重新啟動,畫面可能還是使用舊的語言服務。
方法二:從本機 checkout 安裝
如果你要修改翻譯、測試程式,或想使用本機版本,可以先把 GitHub 儲存庫 clone 到電腦,再從本機路徑安裝。
dsh plugin --profile web add C:\path\to\dsh-client-locale-zh-tw
dsh web
把 C:\path\to\dsh-client-locale-zh-tw 換成你實際的儲存庫路徑。
例如:
dsh plugin --profile web add C:\Projects\dsh-client-locale-zh-tw
dsh web
本機安裝適合這幾種情況:
- 你正在修改翻譯字典。
- 你想先測試某個介面文字。
- 你要確認外掛和目前的 DSH Web 版本是否相容。
- 你希望用 Git 管理自己的修改。
安裝後怎麼確認?
重新啟動 Web Profile 後,可以從三個方向確認:
- Web 介面是否出現臺灣繁體中文。
- 語言切換後,介面文字是否跟著變更。
- 重新開啟 Web Profile 後,語言選擇是否保留。
這個外掛會把語言選擇保存在目前瀏覽器的 localStorage。
所以它不會修改:
$DSH_HOME/settings.yaml
這點很重要。
語言偏好是瀏覽器端的使用狀態,不是寫入 DSH 全域設定檔。移除外掛後,也不會留下官方 DSH 無法解析的 zh-TW 設定。
它會自動選擇臺灣繁體中文嗎?
會有瀏覽器語言偵測。
當瀏覽器語言是以下其中一種時,第一次開啟會自動選擇臺灣繁體中文:
zh-TWzh-Hantzh-HKzh-MO
如果你的瀏覽器偏好是英文,外掛不一定會自動切到繁體中文。這時可以從介面語言設定手動選擇 zh-TW。
為什麼有些文字還是英文?
這不一定代表安裝失敗。
DeepSeek Harness 持續新增介面文字時,外掛字典不一定會同步更新。對於尚未翻譯的 key,外掛會暫時退回英文。
可以先用這個方式判斷:
- 大部分介面已經是繁體中文,只有新功能或少數文字是英文:通常是翻譯字典還沒補齊。
- 語言切換完全沒有反應:檢查 Web Profile 是否已重新啟動,以及外掛是否真的加到
webProfile。 - DSH 啟動時出現 provider 或 Bundle 錯誤:檢查 DSH 版本與外掛目前支援的
ctx.locale介面是否相容。
這個外掛目前實作的是 DSH Web 使用中的 ctx.locale 介面。
如果 DSH 未來修改這個介面,外掛也需要同步更新。
如何移除外掛?
如果你想回到官方語言提供者,可以執行:
dsh plugin --profile web remove dsh-client-locale-zh-tw
移除後重新啟動 Web Profile:
dsh web
重新啟動完成後,官方 locale provider 會恢復使用。
移除時不要只刪除外掛資料夾。最好透過 dsh plugin remove 讓 DSH 自己處理 Bundle 設定,避免留下不完整的外掛記錄。
如果你想一起修改外掛
這個 GitHub 儲存庫已經提交建置後的 lib/,而且沒有 prepare 安裝腳本。
因此從 GitHub 安裝時,不需要另外設定 pnpm 的 allowBuilds。
如果要進行開發,可以在本機執行:
pnpm install
pnpm run check
check 會依序處理型別檢查、測試與建置。
儲存庫裡也有語言 runtime 測試,包含:
- 瀏覽器語言偵測。
- 語言切換與 localStorage 保存。
- 繁體字典缺字時退回英文。
- HTML
lang標記同步。
這代表它不是只把幾個畫面文字硬編碼成中文,而是有一個可以切換、保存與通知訂閱者的語言 runtime。
這個外掛適合誰?
它適合:
- 想用繁體中文操作 DeepSeek Harness Web 的使用者。
- 在臺灣使用 DSH,希望介面用詞更接近繁體中文習慣的人。
- 想用外掛方式處理語言,而不想修改 DSH 原始碼的人。
- 想研究 DSH Web 外掛與
ctx.locale介面的開發者。
如果你只是想把介面切成繁體中文,直接從 GitHub 安裝即可。
如果你要修改字典或維護相容性,再把儲存庫 clone 到本機,用本機路徑安裝。
注意事項
安裝前記住幾件事:
- 安裝、移除或更新 Bundle 後,都要重新啟動 Web Profile。
- 語言偏好保存在目前瀏覽器,不會跨瀏覽器或跨裝置同步。
- 新增但尚未翻譯的介面文字會暫時退回英文。
- 外掛依賴 DSH Web 的
ctx.locale介面,DSH 更新後要留意相容性。 - 語言設定不是寫入 DSH 的
settings.yaml。
結語
DeepSeek Harness 的繁體中文化,不一定要從修改原始碼開始。
如果需求只是讓 Web 介面更容易閱讀,先用外掛把語言服務替換掉,會比直接 fork 或修改核心程式乾淨很多。
這個外掛的重點也不只是「把英文換成中文」。
它把安裝、移除、語言保存與未翻譯字串的退回行為整理成一個可管理的 Bundle。對使用者來說,安裝比較簡單;對開發者來說,後續維護也比較有邊界。
GitHub 原始碼與安裝說明: