繁中语言包 wangsan71/dsh-locale-zh-tw

dsh-locale-zh-tw

npm version
npm downloads
License: MIT

DSH Web 界面的繁体中文（台湾）语言包。npm install 安装后，设置 → 通用 → 语言 会多出「繁体中文」，全界面自动转成繁体；zh-TW / zh-Hant / zh-HK / zh-MO 的浏览器还会自动切换。

不需要改任何 DSH 核心文件，也不动其他插件的代码——其他插件的简体字典由本套件在浏览器端实时简转繁。

安装

在你的 profile 目录（例如 ~/.dsh/profiles/web）安装
npm install dsh-locale-zh-tw

然后把它加入 profile 的 bundles（或直接用 dsh CLI）
dsh plugin --profile web add dsh-locale-zh-tw

等价于手动在 profiles//package.json 加上：

{
"dependencies": {
"dsh-locale-zh-tw": "^0.1.1"
},
"dsh": {
"profile": {
"bundles": [
// ...原有 bundles... "dsh-locale-zh-tw" ] } } }

重新启动 dsh web 后生效（新增 bundle 需要重启；之后切换语言只需刷新页面）。

使用

- 设置 → 通用 → 语言 → 选「繁体中文」，整页立即变成繁体，并用 localStorage 记住（下次打开自动恢复）。
- 浏览器语言是 zh-TW / zh-Hant / zh-HK / zh-MO 时，打开后自动选繁体。
- 偏好存在浏览器端而非主机端：主机 settings schema 只认 zh/en，zh-TW 写主机从一开始就不被支持，这是刻意绕行、不改动核心的结果（代价：换浏览器需重选一次）。

原理（简短版）

核心 @deepseek-ai/dsh-client-locale 只内置 zh/en，语言清单是固定常量、没有对外注册新语言的 API。本套件完全不修改核心文件，改在浏览器端对 LocaleRuntime 实例做防呆扩展：

1. publish 守卫：LocaleRuntime.publish 是核心快照变更为数唯一的出口（setLocale / adopt / register 全走这里）。核心把主机设置视为语言偏好的事实来源：zh-TW 写入主机会被 schema 拒绝 → 客户端「恢复重载」设置 → 核心 adopt() 随即 publish 回 zh/en，界面刚切繁就立刻被翻回简。守卫拦截在这个出口：只要浏览器端偏好是 zh-TW，任何回退别的语言的 publish 都在快照落地前被改写回 zh-TW。
2. 把 zh-TW 加入语言快照（语言列可选）。
3. 查询链在 zh-TW 下变成「明确 zh-TW → zh 简转繁 → en」——任何命名空间只要有小字典就有繁体，不会掉回英文。
4. setLocale 重排：先把偏好写进 localStorage 再 publish（守卫读到新值才挡得住回退）；zh-TW 完全不写主机（写了必被拒、还触发回退链），zh/en 照常走核心持久化。
5. 繁中地区浏览器自动选繁体。
6. 在 zh-TW 时设为 zh-Hant-TW。

所有步骤都包在 try/catch：任何失败都只会静默降级，不会影响 dsh web 加载。若未来核心内置 zh-TW，补丁会自动检测并跳过。

兼容性

- 适用于 @deepseek-ai/dsh-client-locale@0.1.1-rc.2 系列的 LocaleRuntime 结构。
- 浏览器端 bundle 零外部依赖（不 require 任何套件），主机端零依赖，安装到任何 profile 都不会缺套件。
- 简转繁采用台湾用语（设置/保存/搜索/加载/消息/插件/文件夹/文件/缓存/密钥/超时/只读…），共 89 组短语 + 389 字符对照。

更新记录

- 0.1.1
- 修复「选了繁体中文却立刻被翻回简体 / 重新整理后记忆失效」：新增 publish 守卫 + setLocale 重排，zh-TW 不再触发主机写入与恢复回退链（详见 REPORT-zh-tw-cannot-switch.md）。
- 修复 package.json 缺 exports 根入口导致 ERR_PACKAGE_PATH_NOT_EXPORTED、dsh web 启动即崩（详见 REPORT-dsh-plugin-errors.md）。
- 0.1.0 首版：zh-TW 语言注册、实时简转繁、localStorage 偏好、繁中浏览器自动切换。

授权

MIT