前言¶

dsh-zh 面向 DSH Web 界面。它要解決的是顯示層問題：把界面中殘留的英文 UI 文本換成中文，同時不改值、屬性、事件和會話內容；此外，它還會檢測官方是否已經自己適配，避免插件和官方文案重複。

這是什麼¶

dsh-zh 是一個 DSH client 插件，倉庫地址爲 https://github.com/HarryLi-7/dsh-zh。它只做顯示層漢化和官方適配檢測，不改動 DSH 的功能邏輯。

核心功能¶

界面漢化（顯示層）¶

插件只替換整文本節點的顯示內容。已覈實範圍包括：

• 命令面板命令描述漢化。
• 權限預設顯示漢化：Read Only、Workspace Write、Full access。
• 推理等級菜單內短通用詞漢化：Off、High、Max、Default。
• Full access 的文字與圖標使用橙紅強調色 #ff5722。

以下內容和取值保持原樣：

• 命令名不翻譯。
• 權限預設機器值、推理等級 id、命令名保持原樣。
• 會話內容、用戶消息、助手回覆、工具結果、代碼塊、輸入框不被替換。

短通用詞只在菜單類表面內替換，涉及 role="menu"、role="listbox"、aria-haspopup="menu"。這樣可以避免誤傷正文輸入和會話內容。

官方適配檢測¶

插件會靜默探測官方宿主數據，使用 3 條只讀 RPC。發現官方已適配時，會顯示一次性提示條。探測失敗不記錄，下次加載重試。

存儲與開關¶

存儲上，插件僅使用 localStorage 兩個固定鍵，不使用 ctx.logger。

功能開關爲：

設置 → 通用設置 → 「界面漢化（中文）」

開啓後開始漢化；關閉後立即停止漢化，並還原原文。

安裝與啓用¶

先安裝插件：

dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

新增插件需要重啓 harness 才載入；client 端改動刷新頁面即可。安裝並重啓後，進入 DSH Web 的設置面板，通過「設置 → 通用設置 → 「界面漢化（中文）」」開啓或關閉漢化。

典型用法¶

1、安裝：

dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

2、重啓 harness，打開 DSH Web。

3、進入「設置 → 通用設置 → 「界面漢化（中文）」」，開啓開關。

4、如需還原，關閉同一開關；關閉後立即停止漢化並還原原文。

5、卸載：

dsh plugin --profile web remove dsh-zh

適用場景與注意¶

適合希望 DSH Web 界面顯示中文，但不希望改變命令、權限、推理等級原始取值與會話內容的場景。它也適合需要判斷官方是否已經自行漢化的維護者。

需要注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。dsh-zh 只處理顯示層，不修改值、屬性、事件和會話內容；功能行爲仍以 DSH 自身權限和命令語義爲準。

相關資源¶

• GitHub：https://github.com/HarryLi-7/dsh-zh
• 社區目錄頁：當前資料未提供鏈接