前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的理念，旨在通过插件扩展功能。对于需要使用韩语界面的开发者，默认的英文界面可能带来沟通成本。dsh-ko-locale 插件解决了这个问题，它为 DSH 的桌面和 Web GUI 提供了完整的韩语本地化支持。

插件简介¶

dsh-ko-locale 是由 ara-hwang 维护的客户端插件，遵循 MIT 许可证。它是一个语言包，通过向 locale 目录添加 ko 语言代码，并为注册的命名空间提供韩语翻译。

核心功能¶

• 完整覆盖：支持 56 个命名空间，涵盖 2,412 个字符串，覆盖聊天、工作区、侧边栏、设置等主要界面区域。
• 语言选择：在「设置 → 通用 → 语言」中会出现韩语选项，与英文、中文并列。
• 自动适配：在韩语系统的机器上，首次启动时会自动选择韩语；手动选择的语言设置始终优先。
• 每键回退：如果该语言包未包含某个字符串（例如 DSH 更新新增的词条或第三方插件新增的文案），系统会自动回退到内置的英语字典，而不是显示原始的键名。

安装与启用¶

安装命令会同时安装依赖并选择对应的 Bundle：

• 桌面客户端：

    dsh plugin --profile desktop add dsh-ko-locale

• Web 界面：

    dsh plugin --profile web add dsh-ko-locale

安装后刷新 GUI（桌面端通常为 Ctrl+R）即可生效。

如果没有 npm 访问权限，可以使用仓库地址直接安装：

dsh plugin --profile desktop add github:ara-hwang/dsh-ko-locale

注意：后续对包的修改需要完全重启应用，因为宿主进程会保持已加载的模块生成。

工作原理¶

该插件通过两个主要部分工作：
1. 语言定义：调用 ctx.locale.addLanguage({ id: 'ko', label: '한국어', fallback: 'en' }) 注册语言。
2. 字典叠加：在 LocaleRuntime.prototype.lookup 上安装叠加层，覆盖默认的翻译查找逻辑。

插件包含 cordis.patch.yml 配置，用于加载浏览器端的 Bundle。

验证与测试¶

仓库提供了验证脚本，用于确认插件是否正常工作：

node tools/smoke-test.mjs

该脚本会验证 28 种行为，包括 catalog 注册、韩语激活、显式选择、每键回退以及插件卸载后的恢复。

如果需要确认 Bundle 是否在 Web 上正确服务：

node tools/probe-bundle-route.mjs

注意事项¶

• 重启要求：安装或更新插件后，必须完全重启应用才能看到更改。
• 回退机制：语言包未包含的字符串不会导致界面崩溃，而是显示英语。
• 优先级：如果一个插件自身携带了 ko 字典，它会覆盖 dsh-ko-locale 的叠加层效果。
• 许可证：插件使用 MIT 许可证。

总结¶

dsh-ko-locale 是一个为 DeepSeek Harness 提供韩语支持的轻量级插件。它通过字典叠加技术，在保持系统回退机制的同时，为用户提供了完整的韩语界面体验。

仓库地址：https://github.com/ara-hwang/dsh-ko-locale