jimbb/dsh-i18n-zh-hant

dsh-i18n-zh-hant

繁體中文（香港）語言包，用於 DeepSeek Harness（DSH）網頁圖形介面。

在語言選擇器中新增繁體中文，並為每個核心與社群外掛的語言命名空間提供 zh-Hant 字典，讓整個介面以繁體中文顯示，而不會退回英文。

隨附的簡體中文（zh）語言環境不會被修改——兩者並存，你可以隨時切換。

功能說明

DSH 的網頁圖形介面透過每個命名空間的語言註冊表進行本地化。每個用戶端外掛會為自己的命名空間註冊字典，而註冊表會沿著目前語言的後備鏈解析查詢，接著在共用的 common 命名空間中重複此流程，最後顯示鍵值本身。

此套件是純瀏覽器外掛（其主機端刻意為空操作）。載入頁面時，它會：

1. 透過 ctx.locale.addLanguage 註冊語言定義 zh-Hant——標籤為 繁體中文，後備語言為 en——這正是讓它出現在設定 → 一般 → 語言中的原因。
2. 使用單一語言形式 ctx.locale.register(ns, 'zh-Hant', dict)，為每個涵蓋的命名空間註冊一個 zh-Hant 字典。

註冊是依語言累加的。每個命名空間都會保留其擁有套件已註冊的 zh 與 en 字典，因此簡體中文不受影響，且仍可完整選用。此套件未涵蓋的任何命名空間或鍵值都會退回英文，與來源套件的行為完全一致。

涵蓋範圍

| | |
|---|---|
| 命名空間 | 56 |
| 鍵值 | 2,860 |
| 範圍 | 核心 harness 用戶端套件 + 社群外掛系列 |

涵蓋的命名空間：

點擊展開完整清單

approval                  betterSidebar             chat
command                   common                    conversation
cordis                    deliverables              describe-image
documentHtml              documentMarkdown          dsh-skill-explorer
dsh-ssh                   dsh-web-ui-market         dsh-web-ui-preset-center
dsh-web-ui-session-archive dsh-web-ui-usage         feedback
git-graph                 goal                      job
model                     model-caps                open-in-app
permission.access         pet                       plan
question                  reference                 remote
schedule.catalog          session-log-download      setting-restart
settings                  settings.agentPreset      settings.locale
settings.models           settings.permission       settings.pluginInventory
settings.plugins          settings.theme            sidebar
sidebarDocumentPreview    sidebarFiles              sidebarImage
sidebarPdf                sidebarRight              skill
skinCenter                slash.menu                subagent
task-board                trajectory                web-ui-plugins
workflowRun               workspace

需求
- DSH >= 0.1.5-rc.1，并启用 web 配置文件。
- 仅当您打算运行维护者工具时，才需要 Node.js 20+。

安装

从本地检出安装

git clone https://github.com/jimbb/dsh-i18n-zh-hant.git
dsh plugin --profile web add link:./dsh-i18n-zh-hant

从配置文件内的目录安装

将此包复制或创建符号链接到您配置文件的 node_modules 中：

mkdir -p ~/.dsh/profiles/web/node_modules
cp -r dsh-i18n-zh-hant ~/.dsh/profiles/web/node_modules/

然后将该行添加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: web-ui-i18n-zh-hant
name: 'dsh-i18n-zh-hant'

激活

重启宿主——客户端包元数据会按加载器条目缓存，直到重启才会更新，因此正在运行的 dsh web 不会提供新添加的 bundle：

dsh web

重新加载页面，然后在 Settings → General → Language 中选择 繁體中文。

验证其是否正常工作

在宿主运行的情况下：

npm run check     # bundle structure + consistency with dictionaries.json
npm run verify    # OpenCC script audit (requires: pip install opencc)

npm run check 会在沙箱中针对模拟的 locale 服务加载 lib/client.js，并断言它恰好注册一种语言（zh-Hant，回退为 en）以及每个命名空间一个字典，且内容与 lib/dictionaries.json 完全相同。

npm run verify 从 OpenCC 的简体→繁体映射中推导出仅简体字符集，并断言任何翻译字符串中都不残留简体字符，且没有任何值为空。

仓库布局

lib/client.js          the browser bundle (generated — do not hand-edit)
lib/index.js           host half (intentional no-op)
lib/dictionaries.json  the translation data, namespace -> { key: text }
cordis.patch.yml       profile bundle patch that inserts the plugin row
dev/                   maintainer tooling (see below)
verify/                bundle + script verification

插件更新后重新生成

当上游插件添加或更改其中文字符串时，这些键会回退为英文，直到此包被重新生成。该工具链分为四步：

1. Read every installed client plugin half and collect its zh/en dictionaries.
node dev/extract-dictionaries.mjs \
~/.dsh/profiles/web/node_modules \
/node_modules \
--out /tmp/upstream.json

2. Build translatable batches (namespace, key, Simplified source, English ref).
node dev/make-batches.mjs /tmp/upstream.json /tmp/translation

3. Translate /tmp/translation/batches/NN.json into out/NN.json as
[{ "id": , "zhHant": "" }, ...]
Placeholders such as {count} must be preserved byte-for-byte.

4. Merge the translations and rebuild the bundle.
node dev/merge-translations.mjs /tmp/translation --out lib/dictionaries.json
node dev/build-bundle.mjs
node verify/check-bundle.mjs

lib/client.js 由 lib/dictionaries.json 生成；npm run check 会在以下情况失败
如果兩者出現分歧，就一併提交。

翻譯備註

- 變體： 繁體中文，採用香港術語 — 檔案、設定、
網絡、專案、軟件、列印、儲存、螢幕、快取、伺服器。
- 佔位符（{count}、{total}、{error} 等）會原樣保留，
並在每個階段進行檢查。
- 字串由機器產生，然後使用
OpenCC 驗證字型正確性。措辭仍可能不夠完美 —
歡迎指正。

已知限制

- dsh-web-ui-market/online 在上游的簡體及英文字典中均為空。
此處刻意省略該鍵，以便註冊表的後備鏈
能完全按照其對簡體地區的處理方式來處理它。
- 驗證器會將六個字（台、群、峰、划、游、床）回報為
「歧義」，因為 OpenCC 的 s2t 對應表偏好古語或台灣變體
（臺、羣、峯、劃、遊、牀）。它們在香港
用法中是合法的繁體字形（後台、社群、高峰、划選、上游、起床），因此
被排除在硬性檢查之外。
- 並非 GUI 中的每個字串都由來源套件本身進行本地化；
繞過地區註冊表的文案是任何語言包都無法觸及的。

貢獻

措辭指正是最有價值的貢獻。編輯
lib/dictionaries.json，執行 npm run check && npm run verify，然後
node dev/build-bundle.mjs，並在你的提取要求中包含這兩個檔案。

解除安裝

從 ~/.dsh/profiles/web/cordis.patch.yml 中刪除該行，並移除套件
目錄，然後重新啟動 dsh web。

授權條款

Apache-2.0。