Dragonk/dsh-locale-pl

dsh-locale-pl

DeepSeek Harness Web 界面的波兰语语言包——一个社区客户端插件，将波兰语 (pl) 添加到设置 → 通用 → 语言的语言列表中。

该包不会修改 DeepSeek Harness 的代码或 node_modules。它通过 DSH 官方本地化系统（@deepseek-ai/dsh-client-locale）注册：将语言添加到目录中，并按命名空间挂接词典。缺失的键会通过内置回退链自动用英语补全。

- 命名空间： 43
- 已翻译字符串： 1292（语料库的 100%）
- 回退： pl → en（DSH 官方机制）

已验证版本

| 组件 | 版本 |
| --- | --- |
| DeepSeek Harness（Web 客户端 / @deepseek-ai/ 包） | 0.1.5-rc.2 |
| 语料库来源的源码标签 | dsh-v0.1.5-rc.2 (fb2c4b9) |
| 测试机器上的 dsh --version | 0.1.5-rc.1 (CLI)；包为 0.1.5-rc.2 |
| Node.js | ≥ 22（在 24 上测试） |

DSH 处于开发者预览阶段，会有破坏性变更。该包仅使用 locale 注册表的公开 API（ctx.locale.addLanguage / ctx.locale.register），因此 DSH 更新不需要修改插件代码——只需补充新的字符串（参见更新）。

安装

dsh plugin --profile web add github:Dragonk/dsh-locale-pl

安装后重启 DSH（停止并重新启动 dsh --profile web）。DSH 会将包添加到配置文件的 dsh.profile.bundles，并将其作为插件层挂接。如果你的安装支持客户端热重载（HMR），语言可能会在无需完全重启的情况下出现——但重启始终是安全的。

你也可以从本地副本安装：

dsh plugin --profile web add file:/path/to/dsh-locale-pl

或者从 npm 安装（发布后）：

dsh plugin --profile web add dsh-locale-pl

选择语言

1. 打开设置。
2. 转到通用。
3. 在语言一行中选择Polski。

选择会保存在 DSH 用户设置文档（locale 部分）中，并在重启和重新打开浏览器后保持不变。

卸载

dsh plugin --profile web remove dsh-locale-pl

重启 DSH。界面将恢复为之前的语言；保存的偏好设置 locale.preference 可能会保留在 settings.yaml 中——如果你想恢复为浏览器语言，请手动删除它。

测试与一致性检查

npm run fetch:runtime # 安装 upstream/reference.json 中版本的 @deepseek-ai/dsh-client-locale
npm run build         # 从 dict/pl/.json 词典生成 lib/client.js
npm run check         # 将翻译与 upstream/corpus.json 进行比较（报告）
npm run check:strict  # 存在缺失时以非零代码退出（CI 门禁）
npm test              # 20 个测试：词典、bundle、drift、LocaleRuntime 集成
npm run drift -- --old a.json --new b.json   # 比较两个语料库
npm run verify        # fetch:runtime + build + check:strict + test（强制使用 LocaleRuntime）

npm run verify 是完整的发布门禁——它运行的正是 CI 所运行的内容，并强制
执行集成测试。单独运行 npm test 在本地更方便：如果找不到官方 locale
包，它只会跳过集成测试。在 CI 中设置了 DSH_REQUIRE_LOCALE_RUNTIME=1，
因此缺少 runtime 会以错误告终，而不是被跳过。

检查器（check.mjs）会检测：

- 相对于英文源缺失的 namespace 和键，
- 多余 / 源中不存在的键，
- 损坏的占位符（{...} 出现在与英文不同的集合中），
- 与英文相同的值（upstream/identical-allowlist.json 中
有意保留的列表除外），
- 复数对中缺失的对应项。

上游变更检测（scripts/lib/corpus-diff.mjs、scripts/drift.mjs）
会比较两个语料库并报告：

- 新增和删除的 namespace，
- 新增和删除的键，
- 现有英文字符串的内容变更——标记为
UPSTREAM STRING CHANGED — REVIEW REQUIRED（键仍然可以解析，但
波兰语翻译需要手动核实），
- 占位符集合的变更（{count} → {total}）。

运行 check 和漂移测试不需要 DSH 或网络——英文语料库已版本化在
upstream/corpus.json 中，漂移测试基于 tests/fixtures/ 中的本地
fixture 运行。只有集成测试需要下载 @deepseek-ai/dsh-client-locale。

报告翻译错误

在仓库中打开 issue：。

请提供：

- namespace 和键（例如 settings/connection.error），如果你知道的话，
- 可见的波兰语文本和建议的版本，
- 截图和 DSH 版本（dsh --version）。

文本修改请直接在 dict/pl/.json 中进行，然后
运行 npm run build——lib/client.js 文件是生成的，必须与词典
一起提交。

仓库结构

dict/pl/.json        词典：namespace → { 键: "波兰语文本" }  （唯一事实来源）
lib/client.js         生成的客户端 bundle（window.__ModuleLoader__.load）
index.js              插件的宿主端部分（为空——注册发生在浏览器中）
cordis.patch.yml      配置层：将插件挂载为 loader 行
scripts/extract.mjs   从 DSH 源码中提取英文语料库
scripts/build.mjs     从词典组装 lib/client.js
scripts/check.mjs     一致性和完整性检查
scripts/lib/corpus-diff.mjs  比较两个语料库（纯函数）
scripts/drift.mjs     CLI：报告两个语料库之间的变更
scripts/update-upstream.mjs  从选定的 DSH 标签刷新语料库并报告漂移
scripts/fetch-locale-runtime.mjs  安装官方 locale 包用于测试
scripts/verify.mjs    完整门禁：runtime + build + check:strict + 测试
upstream/corpus.json  英文源（键 → {en, zh}）
upstream/reference.json  语料来自哪个标签/提交
tests/                单元测试、漂移测试和集成测试
tests/fixtures/       用于漂移测试的本地语料 fixture
docs/publishing.md    发布新版本并提交到 DSH 生态系统
GLOSSARY.md           术语契约

更新

当 DSH 添加新字符串时：
bash
1. 从新标签刷新英文源并查看漂移报告
node scripts/update-upstream.mjs --ref dsh-v0.1.5-rc.2 --fail-on-drift
报告也会写入 upstream/drift-report.md

2. 检查缺少什么
npm run check

3. 在 dict/pl/.json 中翻译新键
（同时添加新的 namespace；参照 GLOSSARY.md）
对于 UPSTREAM STRING CHANGED 条目——验证现有翻译

4. 构建并通过完整门禁测试
npm run verify

5. 发布版本
更新 CHANGELOG.md，提升 package.json 中的 version，commit，tag，push

CI（GitHub Actions）在每次 push 和 pull request 时运行：build、lib/client.js
的新鲜度检查、check:strict 以及带有强制真实 LocaleRuntime 的测试。
每周有一个单独的 job 拉取最新的 DSH 标签，计算漂移报告，并在上游添加、删除或
更改任何内容时以错误结束——包括更改现有英文字符串的内容。该 job 仅报告：
不提交、不推送、不自动翻译。

安全与回退

- 我们不 patch node_modules 或上游文件。
- 我们不创建自己的 i18n 机制——我们使用官方的 ctx.locale 注册表。
- 对于未翻译的键，DSH 注册表会自动使用英文（链 pl → en），因此更新的 DSH
不会破坏界面。
- 当上游更改名称或删除键时，npm run check 会将其报告为错误。

无法通过 locale 系统翻译的内容

DSH 中有几个地方不经过 locale 注册表，保持英文：

- 权限预设名称（Read Only、Workspace Write、Full access）——
核心定义它们时没有显示名称，因此界面显示机器标识符，任何 locale 词典
都无法覆盖它们；
- 工具名称（Bash、Read、Write、Edit）在某些地方是技术标识符，
而非 locale 字符串；
- 来自模型的内容和路径/标识符——当然无法翻译。

此包有意不覆盖配置文件中的权限预设表（不同于例如俄语包）。因此它不会
重复核心配置，也不会在上游更改时损坏；在所有 DSH 提供 locale 字符串的地方，
翻译都能正常工作。

社区

该插件已在 DeepSeek Harness 社区中公布：

- GitHub Discussion（类别 Show Your Plugins!*）：

翻译意见和更好的措辞建议请通过
issues — 或在讨论帖中。

许可证

MIT — 参见 LICENSE。词典和脚本基于公开的
DSH 语料库创建；参见 THIRD_PARTY_NOTICES.md。