前言¶
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 环境中使用台湾用语的开发者，这是一个无需修改核心代码即可提升体验的方案。
