智利西语语言包 neobones/dsh-locale-es-cl

dsh-locale-es-cl

智利西班牙语（es-CL）语言包，用于 DeepSeek Harness（DSH）界面。

- 2603 个键全部翻译完成（100%），分布在 57 个命名空间中。
- 这 2603 条字符串中有 285 条（10.9%）与作为起点的卡斯蒂利亚西班牙语译文不同：这才是真正意义上的智利本地化适配，已逐条列出，并附上对应英文和参考出处，见 docs/revision-es-cl.md 和 docs/revision-es-cl.csv。
- 以 DSH Loader 客户端插件的形式接入：不修改 app.asar，也不改动应用中的任何文件。
- 任何缺失的键，或 DSH 新版本新增的键，都会自动回退到英文，所以不完整的目录只会退化为源语言，而不会出错。这个细节很重要：回退到英文的是缺失的键，因为运行时用 ?? key 来解析；如果某个命名空间一个字典都没注册，那就没有可回退的地方，会直接显示原始键名。这种情况在本语言包中不会出现——57 个命名空间都有字典——但这是这项保证的真实边界。

一行命令安装

dsh plugin --profile desktop add github:neobones/dsh-locale-es-cl

重新加载界面（Ctrl+R），然后选择 设置 → 通用 → 语言 → Español (Chile)。选择会被保存，重启后依然有效；浏览器语言为 es-CL（或 es）时会自动启用。

其他安装方式——npm、tarball、手动安装配置档，以及选择器不出现时该怎么办——见 安装。

状态

| 覆盖率 | 2603/2603 个键（100%），57/57 个命名空间 |
| 智利本地化适配 | 285/2603 条字符串（10.9%）与卡斯蒂利亚西班牙语参考不同 |
| 保留的英文术语 | 按政策保留 15 个，其中 11 个有键实际用到；增量报告以 protegidos 0 收尾 |
| 语言 | es-CL —— 标签「Español (Chile)」，回退语言 en |
| 包 | dsh-locale-es-cl 1.0.0 |
| 许可证 | MIT（见 LICENSE 和 NOTICE.md） |
| 已测试的 DSH 核心 | 桌面应用，app.asar 为 121 MB，70 个 UI 插件 |

英文术语政策涵盖十五个词，但应用目录中只有十一个词有对应文本：plugin（95 个键）、api（25）、tool call（23）、token（14）、json（14）、prompt（12）、log（6）、shell（5）、chat（5）、diff（4）和 markdown（4）。另外四个——commit、push、pull request 和 deploy——在目录中一次都没出现，所以它们作为声明政策保留，但没有任何键实际用到：protegidos 0 统计的是前十一项，不是十五项。

这些检查随时可以重复执行，不需要应用：

node tools/build-locale-pack.cjs i18n/catalog.json i18n/es-cl . --check # 覆盖率和标记
node tools/audit-es.cjs i18n/catalog.json i18n/es-cl # claves ausentes, desalineadas y repetidas
node tools/apply-terminology.cjs i18n/terminology.json i18n/es-cl --check # términos y fraseología prohibidas
node tools/check-coherence.cjs i18n/es-cl # concordancia y duplicados entre lotes
node tools/check-portable.cjs i18n # ni rutas ni secretos locales
node tools/delta-report.cjs i18n/catalog.json i18n/reference/es.json i18n/es-cl --strict-protegidos # protegidos 0 como puerta
node tools/verify-pack.cjs lib/client.js # ejecuta el bundle como lo hace DSH

delta-report.cjs 会把 protegidos 0 收口，加上 --strict-protegidos 后，只要这个总数不是零就以代码 1 退出：不带这个标志时，总数只是报告出来（中间批次需要这样），带上它就是一道门禁。check-coherence.cjs 分两部分：一部分检查与英文术语的对应，另一部分扫描重复项，当同一个英文原文产出不止一种西班牙语形式，或者两个不同原文共用同一句固定表达时，就报告出来。

安装

一行就够。DSH 自带的插件管理器会加上依赖，并且选中 bundle： powershell

desde npm (lo más simple)

dsh plugin --profile desktop add dsh-locale-es-cl

o directo desde GitHub, sin registro de por medio

dsh plugin --profile desktop add github:neobones/dsh-locale-es-cl

o desde un tarball ya empaquetado

dsh plugin --profile desktop add ./dsh-locale-es-cl-1.0.0.tgz

o el tarball publicado en la release (lo mismo, sin descargarlo a mano)

dsh plugin --profile desktop add https://github.com/neobones/dsh-locale-es-cl/releases/download/v1.0.0/dsh-locale-es-cl-1.0.0.tgz

用你实际运行的那个配置档：桌面应用用 desktop，dsh web 用 web。从 GitHub 安装不需要授权构建脚本，因为浏览器 bundle（lib/client.js）已经随仓库版本化：没有需要 pnpm 放行的编译步骤。

在界面里也能得到同样的结果：侧边栏 → Plugins → Add plugin，把规格粘贴进去。管理器接受 npm 包名（版本可选）、github:作者/仓库 或 git 仓库 URL、.tgz 以及本地路径；它会检查包是否声明了 dsh.bundle，完成后把它加到 dsh.profile.bundles。

之后重新加载界面（Ctrl+R），在设置 → 通用 → 语言 → Español (Chile) 里选择语言。选择会被保存，重启后依然有效；浏览器处于 es-CL（或 es）时会自动启用。

手动方式：编辑配置档

配置档的插件在 ~/.dsh/profiles/<perfil>/package.json 里声明。把包同时加为依赖和 bundle： json {
"dependencies": {
"dsh-locale-es-cl": "link:C:/ruta/a/dsh-locale-es-cl"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-locale-es-cl"
]
}
}
}

然后，在配置档目录下： powershell
pnpm install

DSH 列出插件时看什么

在应用代码（0.2.0-rc.2）里核实过，方便你排查某张卡片为什么不显示：

- package.json 里的 dsh.bundle.patch —— 必不可少：没有这个字段，包只会作为普通依赖安装，不会成为配置档的一层。
- 卡片渲染用的是 DSH 从 locale/<语言>.json 读到的元数据（meta.title、meta.description），并以 package.json 的 name 和 description 作为兜底；图标取自顶层 icon 字段。要让 ESM 解析器找到它们，exports 映射必须声明 ./locale/.json 和 ./package.json。
- tools/check-plugin-meta.cjs 复现了这些检查，并在持续集成里运行。
- DSH 不读取 npm 关键词，也不查询任何自己的目录：没有什么需要「建索引」。发现渠道就是 README、npm 或社区目录。

说明

- pnpm 支持 link: 和 github: 路径；这里验证过的是前者。
- 包里的 cordis.patch.yml 负责把 locale-es-cl 这一行插入插件树；DSH 在加载 bundle 时应用它，不需要手动复制。
- 如果安装后「设置」里看不到「Español (Chile)」，在插件管理器里停用再重新启用 locale-es-cl 这一行，强制重新拉取客户端 bundle。
- 实测提醒： 如果你在 DSH 会话内部修改配置档，热重载会销毁该会话，应用会打开一个新对话。请在外部修改，或者接受该对话被中断（历史记录不会丢失）。
- 桌面端的「Disable third-party plugins」救援功能会把配置档恢复为出厂 bundle，因此会一并干掉这个包：想再用就得重新安装。

工作原理

DSH 的客户端插件是 lazy-CJS* 工厂，由加载器在浏览器里执行： js
window.__ModuleLoader__.load({ id, factory: (require) => { /* … / return module.exports } })

lib/client.js ——自动生成，不手工编辑——注入 locale 服务，并在可用时注册语言和按命名空间划分的词典，把每条注册声明为插件自身的副作用，这样卸载时能干净地移除： js const LANGUAGE = { id: 'es-CL', label: 'Español (Chile)', fallback: 'en' };

function apply(ctx) {
ctx.effect(() => ctx.locale.addLanguage(LANGUAGE), 'locale-es-cl: idioma');
for (const [ns, dict] of Object.entries(DICTIONARIES)) {
ctx.effect(() => ctx.locale.register(ns, 'es-CL', dict), 'locale-es-cl: ' + ns);
}
}

lib/index.js 是宿主侧的一半：它的存在是为了让这个包成为 Loader 里可加载的一行让客户端插件扫描能找到 package.json 里的 dsh.client 声明。真正的工作全在客户端完成。

仓库结构

dsh-locale-es-cl/
├── package.json 包信息，以及与 Loader 的约定（dsh.bundle / dsh.client） ├── cordis.patch.yml 把插件插入插件树的那一行（生成） ├── lib/ │ ├── client.js 客户端 bundle，含 57 份词典（生成） │ └── index.js host 那一半（生成） ├── i18n/ │ ├── catalog.json 从应用里抽出的英文目录（键 + 原文） │ ├── terminology.json 替换表和禁用词表（风格策略） │ ├── reference/es.json 西班牙语参考译文，只读（衍生作品） │ └── es-cl/<namespace>.json 每个 namespace 一个文件，放智利西班牙语译文 ├── locale/ │ ├── en.json 插件卡片元数据（meta.title / meta.description） │ ├── es-CL.json 同样的元数据，智利西班牙语版 │ └── es.json es-CL.json 的副本，以防解析器按子标签索引 ├── docs/ │ ├── revision-es-cl.md 增量审校表，按 namespace 分组 │ └── revision-es-cl.csv 同一张表的 CSV 版（namespace、键、英文、参考、es-CL） ├── icon.svg 卡片图标（相对路径，≤256 KiB，SVG/PNG/JPEG/WebP） ├── tools/ 工具链，不依赖外部包 │ ├── extract-app.cjs 解出 app.asar 代码，并校验 SHA-256 │ ├── extract-locale.cjs 从 UI 插件里解出 en/zh 词典 │ ├── split-batches.cjs 把目录拆成批次，方便并行翻译 │ ├── split-by-namespace.cjs 把批次转成每个 namespace 一个文件 │ ├── show-ns.cjs 打印指定 namespace 的英文词典 │ ├── apply-terminology.cjs 套用术语表（加 --check 则只检查） │ ├── delta-report.cjs 与参考对比，输出审校表；加 --strict-protegidos 就当门禁 │ ├── check-coherence.cjs 检查冠词与性数一致，并扫批次间的重复 │ ├── build-locale-pack.cjs 生成 lib/ 和 cordis.patch.yml，并报告覆盖率 │ ├── audit-es.cjs 找缺失的键、错位的文件和重复项 │ ├── check-portable.cjs 防止把抽目录那台机器的路径发出去 │ ├── check-plugin-meta.cjs 检查 DSH 列出插件所要求的元数据 │ └── verify-pack.cjs 在模拟加载器里跑 bundle 并校验 ├── .github/workflows/ci.yml 覆盖率、审计、可移植性、严格术语、一致性、元数据、bundle 同步 └── CONTRIBUTING.md · NOTICE.md · CHANGELOG.md · LICENSE · README.md

工作流

翻译或修正
1. 编辑 i18n/es-cl/<namespace>.json（每个文件一个 namespace）。
2. 保留占位符 {count}、{label}、{toolName}……必须和 i18n/catalog.json 里完全一致：只要译文丢失或凭空造出一个占位符，编译器就会拒绝。
3. 重新构建并检查： powershell
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es-cl . --check # cobertura y marcadores
node tools/audit-es.cjs i18n/catalog.json i18n/es-cl # claves ausentes y repetidas
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es-cl . # regenera lib/
node tools/verify-pack.cjs lib/client.js # el bundle carga como en DSH

只要缺少某个键或占位符有误，--check 就会以退出码 1 结束，所以它能当持续集成里的关卡，audit-es.cjs 也一样。

DSH 升级后更新 catalog powershell

1. Extraer el catálogo de la instalación nueva

node tools/extract-app.cjs "C:\ruta\a\resources\app.asar" _referencia-dsh
node tools/extract-locale.cjs _referencia-dsh/dsh/node_modules/@deepseek-ai i18n/catalog.json
node tools/check-portable.cjs i18n # el catálogo no lleva rutas locales

2. Ver qué falta y traducirlo en i18n/es-cl/<namespace>.json

node tools/build-locale-pack.cjs i18n/catalog.json i18n/es-cl . --check # lista lo nuevo por traducir

3. Volver a pasar las puertas de estilo y reconstruir el bundle

node tools/apply-terminology.cjs i18n/terminology.json i18n/es-cl --check
node tools/apply-terminology.cjs i18n/terminology.json i18n/es-cl # aplica lo que quede pendiente
node tools/check-coherence.cjs i18n/es-cl # concordancia y duplicados entre lotes
node tools/delta-report.cjs i18n/catalog.json i18n/reference/es.json i18n/es-cl --strict-protegidos # protegidos 0
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es-cl . # regenera lib/ y cordis.patch.yml
node tools/verify-pack.cjs lib/client.js

4. Refrescar la hoja de revisión que revisa el usuario

node tools/delta-report.cjs i18n/catalog.json i18n/reference/es.json i18n/es-cl --md docs/revision-es-cl.md --csv docs/revision-es-cl.csv

新键会显示为「未翻译」，在界面上则显示英文，直到有人翻译它们为止。docs/revision-es-cl.md 和它的 .csv 是生成的报告：用最后那条命令重新生成，不要手动编辑。

用这个仓库当模板，开始另一种语言

做一个 fork，然后改 tools/build-locale-pack.cjs 里的三个常量（PKG_NAME、LANG_ID、LANG_LABEL）、cordis.patch.yml 生成器里的行标识符（- id: locale-es-cl），以及 package.json 里的 name 字段。英文 catalog 和整条工具链都原样复用。

用智能体并行翻译，或者分批翻译 powershell
node tools/split-batches.cjs i18n/catalog.json _i18n/batches # 均衡分批
… 每批翻译到 _i18n/es-cl/batch-NN.json …
node tools/split-by-namespace.cjs _i18n/es-cl i18n/es-cl # 还原成仓库格式

贡献

欢迎提交翻译修正，也欢迎指出读起来像机器翻译的文本。请先读 CONTRIBUTING.md：内容很短，能避免提交因为丢了一个占位符而无法合并。

致谢

- 卡斯蒂利亚西班牙语基础翻译（i18n/reference/es.json）： Oskarosan/dsh-locale-es，MIT。智利本地化版本是它的衍生作品：见 NOTICE.md。
- en 和 zh 词典（i18n/catalog.json）：由 DeepSeek Harness 界面插件注册；仅从本地安装中提取，用来核对覆盖率、键一致性和占位符。
- 智利西班牙语本地化版本与工具（i18n/es-cl/、tools/）：本仓库，MIT。

法律声明

DeepSeek Harness 是 DeepSeek 的应用；本仓库不包含该应用的代码。英文目录（i18n/catalog.json）仅从本地安装中提取，用来核对覆盖率、键一致性和占位符。智利西班牙语本地化版本是 Oskarosan/dsh-locale-es（MIT）卡斯蒂利亚西班牙语翻译的衍生作品，保留为 i18n/reference/es.json，正是为了能审计这一差异。详情和商标说明见 NOTICE.md。MIT 协议覆盖本仓库自有内容：本地化版本、工具和文档。

Chilean Spanish (es-CL) language pack for the DeepSeek Harness (DSH) web interface:
2,603 of 2,603 keys (100 %) across 57 namespaces, shipped as a client plugin — the application's app.asar is never patched, and a missing key falls back to English through the runtime's ?? key, so an incomplete catalog degrades to the source language instead of breaking. The boundary matters: a namespace with no es-CL dictionary at all would have nothing to fall back from and would render its keys — that does not happen in this pack, where all 57 namespaces ship a dictionary, but it is the real edge of the guarantee. 285 of the 2,603 strings (10.9 %) differ from the Castilian base translation; every one of them is listed, with its English source and its reference, in docs/revision-es-cl.md (and the matching .csv).

The English-term policy names fifteen terms, but the catalog only has text for eleven of
them: plugin (95 keys), api (25), tool call (23), token (14), json (14), prompt
(12), log (6), shell (5), chat (5), diff (4) and markdown (4). The remaining four — commit、push、pull request 和 deploy —— 从不出现在目录里，所以 protegidos 0 统计的是前十一项，不是十五项。同一份报告用 --strict-protegidos 把这道关卡收成真正的检查（总数大于零时退出码为 1），tools/check-coherence.cjs 还会跨命名空间做一次系统性的重复扫描。

这个 fork 没有自己的公开远程仓库；从本地检出安装：在你的 DSH 配置档的 package.json 里，把 dsh-locale-es-cl 加进 dependencies 和 dsh.profile.bundles，然后在配置档目录里运行 pnpm install，再到 Settings → General → Language* 里选 Español (Chile)。插件协议见 Cómo funciona，想提交翻译修正见 CONTRIBUTING.md（保持 {count} 这类占位符原样不动）。基于 MIT 协议；智利本地化版本是 Oskarosan/dsh-locale-es 的衍生作品，en/zh 词典来自 DSH 本身 —— 见 NOTICE.md。