前言¶
DeepSeek Harness 是一个面向编程任务的桌面应用,支持文件编辑、终端命令执行和智能体协作。该应用默认仅提供英语和简体中文界面。对于习惯使用其他语言进行交互的开发者,这种语言限制会带来阅读成本。dsh-locale-pack 插件通过引入多语言字典,填补了这一空白,使桌面界面支持 29 种语言。
插件简介¶
这是一个为 DeepSeek Harness 桌面端提供的本地化语言包插件。
* 维护者:sayho-pm
* 开源协议:MIT
* 核心价值:注册 29 种语言,提供完整字典,未翻译内容回退至英语,确保界面可读性。
核心能力¶
该插件提供以下具体能力:
1. 语言注册:在语言选择器中注册 29 种语言。
2. 字典分发:为每种语言提供完整的翻译字典。
3. 回退机制:未翻译的字符串自动回退到英语显示。
4. 子集构建:支持仅构建需要的语言子集,减少包体积。
5. 质量检查:提供翻译质量检查工具。
6. 注入支持:自动注入 @deepseek-ai/dsh-client-locale 库。
安装与启用¶
使用该插件前,需确保 DeepSeek Harness 桌面端已安装。安装步骤如下:
克隆与注册¶
- 克隆仓库到本地:
git clone https://github.com/sayho-pm/dsh-locale-pack.git
cd dsh-locale-pack
- 将当前目录注册为桌面端的插件链接:
dsh plugin --profile desktop add link:$(pwd)
Windows 用户¶
若使用 PowerShell,命令为:
dsh plugin --profile desktop add link:(Get-Location).Path
启用语言¶
注册完成后,打开 设置 -> 语言,从列表中选择目标语言即可。
典型用法¶
安装默认会包含所有 29 种语言。如需控制包体积或仅测试特定语言,可执行以下操作:
构建语言子集¶
仅构建韩语和日语,生成的包体积约为 320 KB,而非全量包的 4.2 MB:
node tools/build-client.mjs --langs ko,ja
运行翻译¶
翻译任务在独立进程运行,不会将会话内容发送至模型。运行翻译工作流:
python3 tools/translate_worker.py --all
编辑字符串¶
修改 locale/<language>/*.json 中的字典文件后,需重新构建客户端:
node tools/build-client.mjs
修改时需保持 {name} 等占位符的拼写和顺序不变,否则运行时可能报错。
注意事项¶
- 术语保留:产品名(如 DeepSeek Harness)、协议名(如 MCP、JSON)保持英文,不进行翻译。
- 界面范围:菜单栏、右键菜单、更新对话框属于桌面 Shell 组件,不在此插件范围内。
- 字体处理:简体中文字体栈优先显示简体字形。日语、繁体中文(台湾/香港)保持各自字形,插件通过 CSS 修正了字体栈。
- RTL 布局:阿拉伯语、希伯来语、波斯语由 DeepSeek Harness 原生处理 RTL 布局,插件仅提供字典。
- 版本兼容:构建字典基于 DeepSeek Harness
0.2.0-rc.2。
总结¶
dsh-locale-pack 通过提供 29 种语言的完整字典和自动化构建工具,解决了 DeepSeek Harness 桌面端多语言支持不足的问题。开发者可以根据需求安装全量包或构建语言子集,并通过内置工具维护翻译质量。
- GitHub: https://github.com/sayho-pm/dsh-locale-pack
- 目录页: https://www.skillhub.cn/plugins/sayho-pm/dsh-locale-pack