前言¶
DeepSeek Harness(DSH)默认界面字典以简体中文为主。习惯台湾用语、繁体字形的使用者,若要在客户端语言选择器里直接选「繁體中文(台灣)」,需要一套与 DSH 内置 locale 机制对齐的语言包,而不是在外部做整页替换。下面介绍社区插件 dsh-lang-zhtw(维护者 Grasseed):它基于 DSH 随包分发的简体 UI 字典,用 OpenCC 的 s2twp 做字形与台湾措辞转换,并辅以少量台湾用法润色表,向 @deepseek-ai/dsh-client-locale 注册 zh-TW;未覆盖的键仍按 zh-TW → zh → en 回退,安装后不会破坏原有界面。
这是什么¶
dsh-lang-zhtw 是纯客户端语言包:一个 client 模块,无 Host 服务,运行时无需额外构建步骤。当前覆盖 63 个 namespace、2,676 条字串,来源为 DSH 0.2.1-rc.2 随包 UI 字典的抽取结果(以仓库 README 为准)。在 SkillHub 目录中分类为「趣味换装」——本质是界面语言层面的「换装」,不改变 DSH 核心逻辑。
核心功能¶
- 注册语言项:在语言选择器中加入 繁體中文(台灣)(
id: zh-TW,fallback: zh)。 - 批量注册字典:对每个 namespace 调用
ctx.locale.register(ns, 'zh-TW', dict)。 - OpenCC + 润色:字符与台湾用语由 OpenCC
s2twp处理;术语微调可在仓库tools/build-plugin.mjs的润色表中维护(例如 README 举例:权限 → 權限、计划 → 計畫、扩展 → 擴展)。 - 安全回退:查找链为
zh-TW → zh → en;自动未覆盖部分退回内置简体,README 明确说明安装此包不会弄坏界面。
安装与启用¶
插件以当前 DSH 进程权限加载;安装前建议通读 GitHub 仓库 源码与 MIT 许可证(© 2026 Grasseed)。package.json 中版本为 1.0.0。
开源 CLI(npx @deepseek-ai/dsh)¶
面向 web profile 的官方命令如下(须与资料原文一致,勿自行改 owner 大小写):
dsh plugin --profile web add github:Grasseed/dsh-lang-zhtw
Desktop 版由 Electron 应用自行管理 profile,应使用应用内 Plugins 面板,而非假定与 CLI profile 相同。
DSH Desktop¶
- 取得插件目录的本地副本(仓库地址:
https://github.com/Grasseed/dsh-lang-zhtw)。 - 打开 DSH Desktop:侧边栏 Plugins → Add plugin,指向该目录。
- Settings → General → Language 中选择 繁體中文(台灣)。
手动 patch(进阶)¶
在 profile 的 cordis.patch.yml 中增加一行,name 必须为 index.js 的绝对路径(Node 不能直接 import 目录):
- insert:
- id: lang-zhtw
name: '/absolute/path/to/dsh-lang-zhtw/index.js'
删除该段即卸载。仓库亦提供 cordis.patch.yml 供 bundle 使用(见 package.json 的 dsh.bundle.patch)。
典型用法与机制¶
语言包仅使用官方 API,逻辑等价于:
ctx.locale.addLanguage({ id: 'zh-TW', label: '繁體中文(台灣)', fallback: 'zh' })
ctx.locale.register(ns, 'zh-TW', dict) // for each namespace
启用后无需额外配置项;切换语言即可生效。CLI 安装完成后,同样进入客户端 Settings → General → Language 选择 繁體中文(台灣)。
适用场景与注意¶
适合谁:日常用 DSH Desktop 或 web profile CLI、希望界面统一为台湾繁体用语与字形的开发者与用户。
已知限制(来自 README):
- 少数字串存在于组件内联 text map,不经 locale 注册(例如较长的 mode 说明文案),仍会显示简体,需上游 DSH 修改才能彻底对齐。
- 字典与 DSH 版本绑定;升级 DSH 后需按仓库说明重新抽取与构建,否则可能出现键缺失或过时译文。
随 DSH 升级重新生成字典(维护者工作流,摘录自 README):
# 1. unpack the installed app (macOS example)
npx -y @electron/asar extract "/Applications/DeepSeek Harness.app/Contents/Resources/app.asar" /tmp/dsh-asar-x
# 2. harvest every locale dictionary via its register() call sites
node tools/extract-dicts4.mjs /tmp/dsh-asar-x/dsh
# 3. convert with OpenCC and re-emit client.js (run `npm install` once first)
node tools/build-plugin.mjs
结尾¶
dsh-lang-zhtw 用标准 locale 插件方式,把 DSH 已有简体 UI 字典转为台湾繁体覆盖,并在缺口处回退简体,适合作为 DSH「一切皆插件」生态里的界面语言扩展。目录页:SkillHub - dsh-lang-zhtw;源码与安装说明:GitHub - Grasseed/dsh-lang-zhtw。