前言¶
DeepSeek Harness(DSH)桌面端与 Web UI 默认以英文为主界面。对习惯韩语工作环境的开发者,要在聊天、侧边栏、设置、插件列表里反复对照英文,会拖慢日常操作。系统级或浏览器翻译往往无法覆盖 DSH 内部的术语与布局,且容易误改对话内容。
社区维护者 jjoni12 在 GitHub 开源了 dsh-locale-ko:通过 DSH 插件机制注册韩语语言包,在不改动应用安装目录的前提下,把界面文案切换为韩语。本文介绍其定位、安装方式、行为边界与适用注意点。事实以 仓库 README 为准;该包为社区翻译,与 DeepSeek 无隶属或背书关系。
这是什么¶
dsh-locale-ko(npm 包名 dsh-plugin-locale-ko,当前版本 0.4.0)是 DeepSeek Harness 的非官方韩语 UI 语言包。维护者:jjoni12。在 SkillHub 目录中归类为「趣味换装」。
插件覆盖 DSH 常见界面区域:聊天、侧边栏、设置、插件、自动化任务、文件预览、对话框等。安装与卸载均在 DSH 的插件界面完成,不直接编辑用户本地的 cordis.patch.yml(语言选择由 DSH 写入设置)。
核心功能¶
界面韩语化¶
- 通过 DSH 提供的语言包 API 注册
ko语言(回退语言为en),并按命名空间挂载韩语词典。README 写明:在 0.2.1 基准下,src/ko-dict.json含 56 个命名空间、2,566 个键。 - 部分不经过翻译系统的固定文案,由
src/ko-static.json在文本完全匹配时替换;分为global(全局)与plugins(仅插件界面内)两组。
明确不翻译的内容¶
为减少误伤用户数据与对话,语言包不改写:
- 对话正文(AI 回复、用户消息、推理过程、代码块)。
- 部分短标签(如 README 举例的 “Status”、”Tools”),避免与文件、文件夹、会话标题同名时被错误替换。
基准与支持版本¶
语言包以 DeepSeek 官网 DeepSeek Harness 提供的官方 Windows 64 位桌面应用为对照开发;同一页面说明的 Web UI(npx @deepseek-ai/dsh web)也可使用。README 给出的支持应用版本为 0.2.1-rc.2(桌面与 Web UI 一致)。其他版本可能出现部分英文残留或异常。
安装与启用¶
README 说明:不需要 Node.js 或终端即可完成安装。
- 在 DeepSeek Harness 左侧边栏打开 插件。
- 点击右上角 添加插件,在输入框填入仓库地址并 安装:
https://github.com/jjoni12/dsh-locale-ko
- 安装完成后点击 立即启用(README 韩文为「지금 켜기」);无需重启应用即可生效。
在 设置 → 常规 → 语言 中选择 한국어。若操作系统语言为韩语且未单独指定界面语言,README 说明会自动选用韩语。
关闭、移除与更新¶
- 关闭:插件 → 已安装插件 → 韩语语言包开关。
- 移除:进入该插件详情页,选择 移除。
- 更新:先移除,再用同一地址重新安装。
典型用法与项目结构¶
普通用户只需完成上述安装并在设置中选韩语。若参与翻译维护,可修改源词典后本地构建(维护者流程,非安装必需):
node src/build.mjs
可编辑文件为 src/ko-dict.json 或 src/ko-static.json;构建产物为 lib/client.js。仓库中主要文件职责如下(摘自 README):
| 文件 | 作用 |
|---|---|
package.json |
DSH 插件声明(bundle + 客户端插件) |
cordis.patch.yml |
启用 bundle 时加载语言包插件 |
lib/client.js |
构建后的语言包主体 |
locale/*.json |
插件列表中的名称与描述(英/中/韩) |
src/ko-dict.json |
注册到应用翻译系统的韩语条目 |
src/ko-static.json |
绕过翻译系统的静态文案替换 |
package.json 中 dsh.client 配置为注入 @deepseek-ai/dsh-client-locale,平台为 web,并设置 immediately: true。
适用场景与注意¶
适合谁:需要在 DSH 中以韩语操作界面、又希望用官方插件渠道一键开关语言的用户;韩语社区贡献者可通过 Issue 或 Pull Request 反馈漏译、错译。
权限与安全:与其它 DSH 插件相同,语言包在当前 DSH 进程权限下运行。安装前建议在 GitHub 查看源码、MIT 许可证 及 NOTICE(UI 原文来自 MIT 许可的 deepseek-harness)。
已知局限(README「한계」):
- 应用内置壳层界面无法翻译(例如官方桌面端窗口菜单 Application、Edit 等)。
- 设置里「预装插件」列表中的包描述属于各包开发者说明,官方中文版亦可能为英文,本语言包不翻译该项。
- 第三方插件、服务端下发的部分文案(工具名、原始错误信息等)可能仍为英文。
- 应用升级后可能出现新英文字符串,需等待语言包跟进。
SkillHub 等社区目录为独立站点,不是 DeepSeek 或幻方官方应用商店;插件星标以目录页为准(当前线索为 0)。
结尾¶
dsh-locale-ko 用插件方式把 DSH 主界面切换到韩语,可随时在插件页关闭或移除,适合韩语用户与愿意参与社区翻译的维护者。目录页:https://www.skillhub.cn/plugins/jjoni12/dsh-locale-ko;源码与完整说明:https://github.com/jjoni12/dsh-locale-ko。