前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，命令、Skill 和插件列表會隨生態增長而變長。對中文用戶來說，常見情況是：看得懂英文，但每次在「看英文 → 腦內翻譯 → 理解」之間切換，都會佔用注意力；插件裝多了，也不容易從名稱上快速對應功能。
dsh-zh-layer 不修改 DSH 源碼，而是在運行時包裝元數據並調整前端展示，把命令、Skill 和插件列表渲染成「中文名稱 + 英文原名 + 中文功能說明」等形式，並支持一鍵切回英文原版。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-zh-layer 由 Lin-AxiomSight 維護，在 SkillHub 等社區目錄中歸類爲客戶端插件。項目以 MIT License 發佈，當前 package 版本爲 0.6.0。
它是一層可開關的雙語覆蓋層：通過 Cordis 補丁與客戶端注入（cordis.patch.yml、client.js），在不硬編碼、不改 DSH 核心代碼的前提下，爲插件、斜槓命令與 Skill 疊加中文名與說明；卸載或關閉顯示模式後，界面可恢復原版英文。
核心功能¶
雙語排版與三種顯示模式¶
命令菜單、Skill 與插件列表均支持中文主顯，並保留英文原名作爲索引。在 設置 → 翻譯設置 中可選擇：
- 只顯示中文（
zh）：界面僅保留中文。 - 中英都顯示（
both）：中文輔助理解，英文原名便於分辨（README 推薦此模式）。 - 不翻譯（
off）：關閉覆蓋層，刷新頁面即恢復英文原版，適合錄屏或演示。
AI 翻譯：手動觸發、增量提交¶
未內置譯文的條目需要補全時，由用戶在設置頁手動點擊翻譯按鈕發起請求，不會後臺靜默調用模型。插件會先對照已有翻譯緩存，僅提交尚未翻譯的條目；不點擊按鈕時不消耗 Token。
AI 翻譯默認使用 DeepSeek 官方通道的 deepseek-flash 模型（README 說明暫不支持自定義模型）。上傳內容限於待翻譯的插件名稱與描述、命令名與 Skill 名稱；不會上傳聊天記錄、本地文件或配置密鑰。README 給出的成本參考是：約 50 項插件 / 命令 / Skill 全量翻譯約 2–3 分錢，實際隨條目數量、文本長度與官方定價浮動。
實現方式與依賴¶
README 標明實現爲原生 Node.js 與瀏覽器 API，不引入第三方 npm 依賴。配置與詞典保存在全局目錄：
~/.dsh/zh-layer-config/
可在設置頁修改 AI 翻譯提示詞；需要微調譯文時，可通過設置頁打開配置文件夾手動編輯詞典（README 註明「打開配置文件夾」快捷按鈕目前僅支持 Windows）。
安裝與啓用¶
安裝前建議自行查看 GitHub 倉庫 源碼與許可證。插件在 DSH 進程權限下運行，與任何第三方插件一樣，安裝前應確認信任來源。
命令行¶
桌面端：
dsh plugin --profile desktop add dsh-zh-layer
Web 端：
dsh plugin --profile web add dsh-zh-layer
客戶端圖形界面¶
- 打開 DSH 客戶端，進入 插件 頁面，點擊 添加插件。
- 輸入包名
dsh-zh-layer，或指定版本例如dsh-zh-layer@0.6.0，然後安裝。
插件市場¶
在 DSH 的「發現」或「插件市場」中搜索 dsh-zh-layer 並安裝。
安裝完成後重啓 DSH，再在 設置 → 翻譯設置 中選擇顯示模式。
典型用法¶
- 安裝插件並重啓 DSH。
- 進入 設置 → 翻譯設置，選擇
zh、both或off。 - 設置頁會統計未翻譯條目；需要時點擊一鍵翻譯補全內容。
- 在聊天框輸入
/呼出命令菜單，或打開插件列表，查看雙語展示效果。
進階方面：插件的 AI 輸入來自插件元數據中的名稱與描述；命令與 Skill 則來自呼出菜單時抓取的名稱。關閉翻譯（off）後刷新頁面即可對比原版界面。
卸載與已知侷限¶
卸載（桌面端示例）：
dsh plugin --profile desktop remove dsh-zh-layer
Web 端將 desktop 換爲 web。也可在 設置 → 插件 中找到 dsh-zh-layer 卸載並重啓。若需刪除已生成的翻譯文件，可手動刪除 ~/.dsh/zh-layer-config/。
README 列出的侷限包括：排版依賴 DSH 現有 DOM 結構，DSH 大版本底層變動或特殊 UI 插件可能導致排版失效；AI 模型暫不可自定義。
適用場景¶
適合長期在 DSH 中使用大量插件與斜槓命令、希望減少英文菜單認知負擔的開發者。若你更習慣純英文界面，或演示時需要原版 UI，使用 off 模式即可。
社區目錄（如 SkillHub 插件頁）與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；安裝與翻譯行爲以你本地 DSH 配置與官方 API 策略爲準。
