韩语语言包 Nolitor/dsh-korean-locale

DeepSeek Harness 韩语语言包

English · 한국어

状态：活跃 · v0.2.4 · 最后更新：2026-10-29 · DSH：0.2.2-alpha.2 · 上游：discussion #10687

目录

| 章节 | 用途 |
| 概览 | 语言包新增了什么，如何接入 DSH |
| 安装 | 配置档内安装、选择、卸载 |
| 覆盖范围 | 随包发布的命名空间与已知限制 |
| v0.2.4 引导 | 韩语首次运行引导与措辞 |
| v0.2.3 字体栈 | 重载安全的韩语排版 |
| 排版 | 韩语字体栈、作用范围与等宽字体安全 |
| 工作原理 | 公开 locale API、自有副作用、退出保护 |
| 构建与验证 | 从数据重新生成浏览器端 |
| 发布 | 包元数据与市场源 |
| 版本记录 | 版本历史与文档语言 |
| 许可 | MIT 与翻译署名 |

概览

在 DeepSeek Harness Web GUI 的 Settings → General → Language 中加入 한국어，并为每个随包发布的客户端字典提供韩语文案：DSH 0.2.2-alpha.2 共 68 个字典、3,019 条字符串。这套文案覆盖随包发布的 Web 界面和可选包；功能包未启用时，对应字典保持不生效。

韩语模式还会应用一套按语言限定的字体栈——Pretendard Variable → Pretendard → SUIT → Apple SD Gothic Neo → Malgun Gothic → Noto Sans KR——代码和终端界面仍使用 DSH 的等宽字体栈。字体栈只在本地生效：不打包、不下载任何 Web 字体。

这个语言包是普通的 DSH 语言包客户端插件。它使用文档化的 @deepseek-ai/dsh-client-locale API——addLanguage({ id: 'ko', … }) 加 register(namespace, 'ko', dictionary)——不新增任何 Host 行为。按配置档安装、禁用或移除；配置档之外不做任何改动。

安装

语言包无需构建步骤：生成的浏览器包已提交。

dsh plugin --profile web add @nolit/dsh-korean-locale

本地检出（本仓库）改用链接方式：

dsh plugin --profile web add link:<local-path>

命令会写入依赖，并在 ~/.dsh/profiles/web/package.json 中选中该包。运行中的 Host 通常通过 HMR 加载新的客户端包；如果语言行里没有出现 한국어，可靠的回退方式是重启 dsh web。只刷新浏览器不会替换 Host 已加载的模块代次。

然后在 Settings → General → Language 中选择 한국어。语言包激活后，韩语浏览器会自动选中它。选择结果通过 Host 设置服务写入当前配置档的 Cordis 补丁（locale.preference），与中文和英文完全一致。

卸载

dsh plugin --profile web remove @nolit/dsh-korean-locale

重启 Web 界面。语言定义和所有字典都是插件的自有副作用，移除后 GUI 恢复英文。A 配置档补丁里可能还留着 preference: ko；定义缺失时它不生效，可以删掉，也可以改成 en。

覆盖范围

词典覆盖 DSH 0.2.2-alpha.2 随包发布的各个包：chat、conversation、trajectory、workspace、sidebar 和文档预览、设置、插件与插件市场、日程、会话、任务、子代理、技能、交付物、语音输入、检查器面板，以及共享的 common 词汇。data/coverage.json 记录每个命名空间、键数量、英文键对齐情况、占位符对齐情况，以及来源提交。

已知限制：

- 仅限 Web GUI。桌面应用的原生菜单、欢迎窗口和更新对话框走另一套解析器，客户端插件无法打补丁。
- 第三方插件界面只有在语言包带有对应命名空间时才会翻译。语言包覆盖随包发布的词典；第三方包自己注册的韩语词典不会被覆盖。
- 排版只作用于 DSH 文档；iframe 或 Shadow DOM 内的内容（例如检查器的 DevTools 界面）保留自己的字体栈。
- 语言包没有的键回退到随包发布的英文字符串，绝不会回退成原始键名。
- DSH 0.2.2-alpha.2 没有内置 ko。如果未来版本自带韩语，语言包会在目录中检测到并退出，不去争抢同一个 (namespace, "ko") 注册。

v0.2.4 — 首次运行引导与措辞

DSH 0.2.2-alpha.2 随包发布的首次运行引导界面现在以韩语渲染。全部 39 条 settings.account.onboarding 字符串——欢迎、用途、详细程度、额度、跳过提示——都已翻译，不再回退英文。六条加载消息也改用省略号字符（…）代替三个点，与其余韩语文案保持一致。

v0.2.3 — alpha.2 覆盖刷新与字体栈持久化

本次发布还针对 DSH 0.2.2-alpha.2 刷新了词典快照（新增 117 个键，移除 8 个已废弃的键）。下面的排版工作保留不变。

v0.2.1 的样式表只绑定了 body，所以整页刷新后，核心 token 处理或主题呈现器可能盖住韩语字体栈。v0.2.3 在 :root:lang(ko) 和 body 上同时绑定 --dsh-font-family-text 与 --dsw-font-family，把字体位直接应用到正文，代码和终端字体位保持不动。设置 → 外观里显式指定的字体仍然优先，因为规则没有用 !important。

排版

韩语模式应用一份作用域受限的样式表 styles/typography.css：

:root:lang(ko),
html:lang(ko),
html[lang^="ko" i] {
--dsh-font-family-text: "Pretendard Variable", Pretendard, / … / system-ui, sans-serif; --dsw-font-family: var(--dsh-font-family-text), var(--dsh-font-family-text-default); }

:root:lang(ko) body,
html:lang(ko) body,
html[lang^="ko" i] body {
/ same seats, plus: */
font-family: var(--dsw-font-family);
}
- 两处文本座位都已绑定 —— DSH 通过 --dsw-font-family 解析正文文本，核心 token 表基于 --dsh-font-family-text 的 body 构建。规则在根节点和 body 上同时绑定这两个变量，因此重载后的核心 token 处理和主题呈现器都无法遮蔽韩文字体栈。文本控件（input、contenteditable）沿用同一座位。
- 等宽字体保留 —— 代码、行内代码和终端界面使用独立的 --ds-font-family-code / --dsh-font-family-terminal 座位。样式表从不引用它们，并刻意排除 pre、code 和 textarea，让这些元素保留各自的等宽字体栈。
- 按语言限定 —— 选择器跟随 ，由 locale 插件维护，覆盖 ko-KR 这类区域标签。切换到英文或中文时规则自动失效，精确还原 DSH 自己的字体栈；不需要 JavaScript 监听器。
- 不加载网络字体 —— 每个字体族都是本地系统字体。除了 CSS 规则本身，不下载也不打包任何东西。
- 用户设置优先 —— 主题呈现器把 Settings 中显式设置的字体写成内联自定义属性，优先级高于样式表；规则不使用 !important。移除插件包时样式元素一并移除。

工作原理

浏览器端为每个命名空间注册一个语言定义和一个字典，各自作为受管 effect：

ctx.effect(() => ctx.locale.addLanguage({ id: 'ko', label: '한국어', fallback: 'en' }))
ctx.effect(() => injectScopedTypography(ctx))
ctx.effect(() => ctx.locale.register(namespace, 'ko', dictionary))

LocaleRuntime 把外部 ko 与内置语言完全同等对待，覆盖选择、持久化、查找、回退、、浏览器匹配和延迟字典注册。插件只补充外部语言所需的协调逻辑：

- 让位守卫 —— 如果插件应用时目录里已经有 ko（未来的内置语言或另一个韩语包），就什么都不注册。
- 按命名空间冲突守卫 —— 如果某个命名空间在 effect 运行前已有 ko 归属者，就跳过该命名空间，保留归属者的副本。
- 自包含打包 —— 不依赖协作的 DSH 包，不访问网络，不改动 Host。

构建与验证

Node 24+，无依赖：

node scripts/build.mjs # data/ko.json + styles/typography.css -> lib/client.js
node scripts/verify.mjs # metadata + coverage + typography + apply contract

data/ko.json 是从 discussion #10687 的源分支提取并提交的快照；data/coverage.json 记录提取与一致性结果。styles/typography.css 是可审计的排版源文件；构建时把它嵌入生成的浏览器端。lib/client.js 已提交，使用者无需自行构建。

发布

这个包是完整的 DSH bundle：dsh.manifestVersion、dsh.bundle.patch、dsh.client（platform: web、immediately: true）、host 空操作入口、本地化的包图标、locale/en.json/locale/ko.json、作用域限定的 styles/typography.css，以及 market/index.json feed。发布命令：

npm publish

prepublishOnly 会重新构建并校验产物。market feed 可以直接从仓库的 market/ 目录提供，也可以合并进更大的索引。

发布记录

- CHANGELOG.md — 版本历史，英文（默认）
- CHANGELOG.ko.md — 버전 기록, 한국어
- GitHub releases — 已发布的归档

README.md 是默认文档，README.ko.md 是它对应的韩文译本；两者章节和版本一致。

许可证

MIT。韩语词典部分源自 deepseek-harness 的 feat/korean-locale 分支（commit 1091f232fd），同样以 MIT 许可。详见 NOTICE。