西班牙语语言包 Oskarosan/dsh-locale-es

dsh-locale-es

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

- 2603 / 2603 个键已翻译（100%），分布在 57 个命名空间。
- 以 DSH Loader 的客户端插件形式接入：不修改 app.asar，也不动应用里任何文件。
- 任何缺失的键，或 DSH 新版本新增的键，都会自动回退到英语，所以这个语言包永远不会弄坏界面。

状态

| 覆盖率 | 2603/2603 个键（100%），57/57 个命名空间 |
| 语言 | es — 标签「Español」，回退 en |
| 包 | dsh-locale-es 1.0.0 |
| 许可证 | MIT（见 LICENSE 和 NOTICE.md） |
| 已测试的 DSH 内核 | 桌面应用，app.asar 为 121 MB，70 个 UI 插件 |

这三项检查随时都能重跑，不需要应用：

node tools/build-locale-pack.cjs i18n/catalog.json i18n/es . --check # cobertura y marcadores
node tools/audit-es.cjs i18n/catalog.json i18n/es # claves ausentes y repetidas
node tools/check-portable.cjs i18n # ni rutas ni secretos locales
node tools/verify-pack.cjs lib/client.js # ejecuta el bundle como lo hace DSH

安装

有两条路。短的一条用 DSH 自带的插件管理器；手动的一条改配置档。

短路径：插件管理器

在界面里：侧边栏 → Plugins → Add plugin，粘贴包标识。或者在终端里操作，结果一样：

por nombre, si el paquete está publicado en npm
dsh plugin --profile desktop add dsh-locale-es

directamente desde GitHub, sin publicar nada
dsh plugin --profile desktop add github:Oskarosan/dsh-locale-es

o desde una copia local
dsh plugin --profile desktop add C:\ruta\a\dsh-locale-es

管理器接受 npm 包名（可带版本号）、github:作者/仓库 或 git 仓库 URL、.tgz，以及本地路径。安装前它会检查包是否声明了 dsh.bundle；装完会把它加进配置档的 dsh.profile.bundles。之后重新加载界面，在 Ajustes → General → Idioma → Español 里选语言。

手动路径：改配置档

配置档的插件声明在 ~/.dsh/profiles/<perfil>/package.json。把语言包加为依赖和 bundle：

{
"dependencies": {
"dsh-locale-es": "link:C:/ruta/a/dsh-locale-es"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-locale-es"
]
}
}
}

然后在配置档目录里：

pnpm install

DSH 列出插件时会找什么

在应用代码（0.2.0-rc.2）里核实过，方便诊断卡片不显示的问题：

- package.json 里的 dsh.bundle.patch —— 必需：没有这个字段，包就作为扁平依赖安装，而不是作为配置档的层。
- 卡片用 DSH 从 locale/<idioma>.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 或社区目录。

说明

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

工作原理

DSH 的客户端插件是 lazy-CJS* 工厂，由加载器在浏览器中执行：

window.__ModuleLoader__.load({ id, factory: (require) => { /* … / return module.exports } })

lib/client.js ——生成产物，不手动编辑——注入 locale 服务，并在可用时注册语言和按 namespace 划分的字典，把每条注册声明为插件自身的副作用，这样卸载时能干净地移除：

const LANGUAGE = { id: 'es', label: 'Español', fallback: 'en' };

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

lib/index.js 是 host 那一半：它的存在是为了让包成为 Loader 可加载的一行，并让客户端插件扫描能找到 package.json 里的 dsh.client 声明。真正的工作全部发生在客户端。

仓库结构

dsh-locale-es/
├── package.json ficha del paquete y contrato con el Loader (dsh.bundle / dsh.client)
├── cordis.patch.yml fila que inserta el plugin en el árbol (generado)
├── lib/
│ ├── client.js bundle del cliente con los 57 diccionarios (generado)
│ └── index.js mitad host (generado)
├── i18n/
│ ├── catalog.json catálogo inglés extraído de la app (claves + textos de origen)
│ └── es/<namespace>.json un fichero por namespace con la traducción castellana
├── locale/
│ ├── en.json metadatos de la tarjeta del plugin (meta.title / meta.description)
│ └── es.json los mismos metadatos en castellano
├── icon.svg icono de la tarjeta (relativo, ≤256 KiB, SVG/PNG/JPEG/WebP)
├── tools/ cadena de herramientas, sin dependencias externas
│ ├── extract-app.cjs extrae el código de app.asar verificando SHA-256
│ ├── extract-locale.cjs extrae los diccionarios en/zh de los plugins de UI
│ ├── split-batches.cjs reparte el catálogo en lotes para traducir en paralelo
│ ├── split-by-namespace.cjs convierte los lotes en un fichero por namespace
│ ├── build-locale-pack.cjs emite lib/ y cordis.patch.yml, e informa de la cobertura
│ ├── audit-es.cjs busca claves ausentes, ficheros mal alineados y repetidas
│ ├── check-portable.cjs evita publicar rutas de la máquina que extrajo el catálogo
│ ├── check-plugin-meta.cjs comprueba lo que DSH exige para listar el plugin
│ └── verify-pack.cjs ejecuta el bundle en un cargador simulado y lo comprueba
├── .github/workflows/ci.yml cobertura, auditoría, portabilidad, metadatos y bundle sincronizado
└── CONTRIBUTING.md · NOTICE.md · CHANGELOG.md · LICENSE · README.md

Flujo de trabajo

Traducir o corregir

1. Edita i18n/es/<namespace>.json (un namespace por fichero).
2. Conserva los marcadores {count}, {label}, {toolName}… exactamente como están en i18n/catalog.json: el compilador rechaza cualquier traducción que pierda o invente uno.
3. Reconstruye y comprueba:

node tools/build-locale-pack.cjs i18n/catalog.json i18n/es . --check # cobertura y marcadores
node tools/audit-es.cjs i18n/catalog.json i18n/es # claves ausentes y repetidas
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es . # regenera lib/
node tools/verify-pack.cjs lib/client.js # el bundle carga como en DSH

--check sale con código 1 si falta alguna clave o hay marcadores mal, así que sirve como
puerta en integración continua, igual que audit-es.cjs.

Actualizar el catálogo tras una actualización de DSH

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
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es . --check # lista lo nuevo por traducir

Las claves nuevas aparecen como «sin traducir» y en la interfaz se ven en inglés hasta que
alguien las traduzca.

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

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

用智能体并行翻译，或者分批翻译

node tools/split-batches.cjs i18n/catalog.json _i18n/batches # 均衡分批
… 每一批翻译到 _i18n/es/batch-NN.json …
node tools/split-by-namespace.cjs _i18n/es i18n/es # 还原成仓库的格式

贡献

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

法律声明

DeepSeek Harness 是 DeepSeek 的应用；本仓库不包含该应用的代码。英文目录（i18n/catalog.json）从本地安装中提取，只用于核对覆盖率、键的对应关系和占位符。细节和商标说明见 NOTICE.md。MIT 协议覆盖本仓库的原创内容：译文和工具。

DeepSeek Harness（DSH）网页界面的西班牙语（es）语言包：57 个命名空间，2,603 个键全部覆盖，共 2,603 个（100 %），以客户端插件形式发布——从不修改应用的 app.asar，未翻译的键自动回退到英文。

安装方式：把 dsh-locale-es 加进 DSH 配置档 package.json 的 dependencies 和 dsh.profile.bundles，然后在配置档目录里运行 pnpm install，再到 Settings → General → Language* 里选 Español。插件协议见 工作原理，提交翻译修正见 CONTRIBUTING.md（{count} 这类占位符要保持原样）。MIT 协议授权。