前言¶

DeepSeek Harness（DSH）的 Web 界面默認以英文爲主。若團隊或用戶更習慣越南語，需要在不改動 DSH 核心的前提下，把聊天、會話、工作區、設置等界面文案換成越南語，並在缺譯時仍能正常閱讀。

下面介紹社區插件 dsh-vietnamese-lang：它通過 DSH 官方的 LocaleRuntime 與 Cordis 客戶端插件機制，爲 Web UI 註冊越南語語言包，並在設置裏與內置語言並列可選。

這是什麼¶

dsh-vietnamese-lang 是面向 DeepSeek Harness Web UI 的越南語語言包插件，維護者爲 lphuxhuq，源碼託管於 GitHub，當前 manifest 版本爲 0.1.0，採用 MIT 許可證。

插件不修改 DSH 核心代碼，僅作爲 Cordis 客戶端插件經標準 ModuleLoader 加載；安裝後在 Settings > General > Language 中選擇 Tiếng Việt 即可切換界面語言。

核心功能¶

README 中列出的能力如下，均可在倉庫說明中核對：

1. 核心 UI 覆蓋：在 50 個命名空間內提供越南語本地化，涵蓋 Chat、Conversation、Trajectory、Workspace、Settings、Model Selection、Approvals、File Explorer、Terminal、Deliverables、Diff Viewer、Document Previews 等模塊。
2. 原生集成：通過官方 LocaleRuntime API 註冊，語言項出現在 Settings > General > Language。
3. 自動回退：第三方或尚未翻譯的 key 缺失時，回退爲英文，避免空白或報錯。
4. 零核心補丁：完全以 Cordis 客戶端插件運行，依賴 @deepseek-ai/dsh-client-locale 注入（見 package.json 中 dsh.client 配置）。

package.json 聲明的對等依賴爲：@deepseek-ai/cordis（>=4.0.0-rc.8 <5.0.0）、@deepseek-ai/dsh-client-locale（>=0.1.0-rc.1 <0.2.0-0）；客戶端平臺爲 web。

安裝與啓用¶

安裝前請確認本機已安裝可用的 dsh CLI，且你使用的是 Web 配置檔（--profile web）。插件會以當前 dsh 進程權限運行，安裝前建議瀏覽倉庫源碼與 LICENSE，再決定是否安裝。

方式一：通過插件名安裝

dsh plugin --profile web add dsh-vietnamese-lang

方式二：從 GitHub 倉庫 URL 安裝

dsh plugin --profile web add https://github.com/lphuxhuq/dsh-vietnamese-lang

安裝完成後：

1. 刷新 DeepSeek Harness Web GUI。
2. 打開 Settings（Cài đặt）> General（Cài đặt chung）> Language（Ngôn ngữ）。
3. 選擇 Tiếng Việt。

經上述步驟，界面應切換爲越南語；未覆蓋的文案會按插件說明回退爲英文。

典型用法與倉庫結構¶

本插件的「用法」即安裝並在設置中選擇語言，無額外 CLI 或配置文件字段。若需瞭解實現佈局，README 給出的目錄結構如下：

dsh-vietnamese-lang/
├── cordis.patch.yml   # Plugin entry for DSH loader
├── index.mjs          # Host entry (no-op)
├── lib/
│   └── client.js      # Client bundle with 50 localized namespaces
├── package.json       # Manifest with dsh.bundle & dsh.client
└── README.md

cordis.patch.yml 供 DSH 加載器識別插件入口；lib/client.js 承載 50 個命名空間的客戶端翻譯 bundle。倉庫另提供 README.vi.md 越南語版說明。

適用場景與注意¶

適合誰

• 在 DSH Web UI 上工作、希望界面爲越南語的開發者或團隊。
• 需要完整核心 UI 越南語覆蓋、且接受缺譯 key 英文回退的場景。

注意事項

• 插件分類爲 Web 客戶端語言包（dsh.client.platform: web），不適用於非 Web 檔或未聲明支持的環境。
• DSH 生態強調「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝來源以 README 命令爲準。
• 版本與依賴以倉庫 package.json 爲準；升級 DSH 或 Cordis 大版本時，需覈對 peerDependencies 是否仍滿足。

鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/lphuxhuq/dsh-vietnamese-lang
• GitHub：https://github.com/lphuxhuq/dsh-vietnamese-lang

經過上面的步驟，你可以在不動 DSH 核心的前提下，爲 Web 界面啓用越南語，並在設置中與內置語言一樣切換。