拉美西语界面 icarohope/deepseek-harness-espanol

dsh-locale-es

把 DeepSeek Harness 整个界面翻译成拉美西班牙语（es-419）。这是一个客户端插件：它为界面的每个命名空间注册一个语言包和一份词典，DSH 的语言选择器就会把它当成一种普通语言。

- 63 个命名空间、2 901 条文本已翻译（侧边栏、聊天、轨迹、设置、插件、定时任务、文档预览、快捷键、语音输入、插件市场等）。
- 语言会出现在设置 → 通用 → 语言里，名称为「Español (Latinoamérica)」。
- 语言包没覆盖到的文本会自动回退到英文，绝不会显示原始键名。
- 偏好保存在配置档里（locale.preference），重启后依然有效，并作用于本次安装的所有窗口。

环境要求

- macOS 上的 DeepSeek Harness 0.2.x（已在 Apple Silicon 上用 0.2.1-rc.2 测试）。安装器 Instalar-Espanol-DSH.command 和 scripts/install.sh 用的是 macOS 的路径和命令。
- 插件本身跨平台：只要 DSH 能跑，它就能用，因为它只在浏览器里注册一种语言。在 Windows 或 Linux 上，从插件页面安装 dsh-locale-es-1.0.0.tgz 即可。
- 不需要管理员权限，也不会改动 DeepSeek Harness.app。

下载

最新版本 · 仓库

安装

快速方式（macOS，单个文件）

dist/Instalar-Espanol-DSH.command 里打包了完整插件。把它复制到目标 Mac，双击即可：不需要联网，也不需要管理员权限。如果 macOS 因为它来自其他电脑而拦截，右键 → 打开。

从 DSH 的插件页面安装

把 dist/dsh-locale-es-1.0.0.tgz（或 .zip 文件夹）拖进插件页面并启用。这样它就由 DSH 管理，会出现在插件列表里。

从源码手动安装

cd dsh-locale-es
sh scripts/install.sh

安装器会：

1. 把包复制到 ~/.dsh/plugins/dsh-locale-es；
2. 把它链接为桌面配置档的依赖（pnpm link:，没有 pnpm 时改用手动链接）；
3. 把它加入 dsh.profile.bundles；
4. 在 ~/.dsh/cordis.patch.yml 里设置 locale.preference: es-419；
5. 动手之前先备份配置档的 package.json 和 cordis.patch.yml；
6. 如果应用正开着，就卸载再重新挂载该行，让它重新读取 bundle。

它是幂等的：想装、想修、想升级，跑多少次都行。之后按 ⌘R 重新加载界面。

sh scripts/install.sh --check # 只报告状态，不做任何改动 sh scripts/install.sh --uninstall # 卸载并恢复配置档原状 sh scripts/install.sh --help # 查看全部选项

想手动选语言，打开 设置 → 通用 → 语言，选择「Español (Latinoamérica)」。

迁移到另一台 Mac

sh scripts/make-dist.sh

在 dist/ 下生成：

| 文件 | 用途 |
| Instalar-Espanol-DSH.command | 单文件安装器，双击运行 |
| dsh-locale-es-1.0.0.tgz | npm 包，用于 Plugins 页面 |
| dsh-locale-es-1.0.0.zip | 完整文件夹，用 sh scripts/install.sh 安装 |
| LEER-PRIMERO.md | 目标 Mac 上的操作说明 |
| SHA256SUMS.txt | 校验和 |

目标 Mac 的要求：已安装 DeepSeek Harness，并且至少打开过一次。安装器要把插件注册到 ~/.dsh/profiles/desktop，这个目录由应用在首次启动时创建。

切回英文

设置 → 通用 → 语言 → English。选择会自动保存，插件仍保持安装状态（随时可以切回西班牙语）。

升级后会丢失吗？

| 情况 | 是否保留？ |
| 把 DeepSeek Harness 升级到新版本 | 保留。 插件位于 ~/.dsh/plugins，在签名应用之外。 |
| 重启应用或 Mac | 保留。 语言设置保存在配置档里。 |
| 在同一台 Mac 上重装 DSH | 通常保留（~/.dsh 不会被删除）。万一丢失，运行 --check 再重新安装。 |
| 手动删除 ~/.dsh | 不保留。 重新运行安装器。 |
| 换一台 Mac 或换一个 macOS 用户 | 不保留。 在那台机器上运行安装器。 |

DSH 升级后可能出现新文案：在翻译之前会显示英文（scripts/extract.mjs + scripts/check.mjs 能把它们找出来）。如果某个版本改动了语言 API，插件会停止加载，界面继续显示英文，不会破坏任何东西。

卸载

sh scripts/install.sh --uninstall

移除 bundle、依赖和语言偏好，把配置档恢复原状。

实现方式

package.json manifest，含 dsh.bundle.patch 和 dsh.client cordis.patch.yml bundle 层：插入 locale-es 行 lib/index.js host 部分：不做任何事（翻译在浏览器端完成） lib/client.js 生成的客户端 bundle：注册语言和词典 translations/en/.json 从应用提取的原始词典 translations/es/.json 译文 scripts/build.mjs 校验并生成 lib/client.js scripts/check.mjs 单个词典的校验器 scripts/extract.mjs 从 DSH 安装中重新提取英文词典 scripts/qa.mjs 译文质量报告 scripts/install.sh 安装器、校验器和卸载器 scripts/make-dist.sh 生成 dist/（tgz、zip、单文件安装器）

客户端 bundle 使用 dsh-client-modules 提供的格式：

window.__ModuleLoader__.load({
id: 'dsh-locale-es',
factory: (require) => { /* … exports.apply, exports.inject … / },
})

apply(ctx) 注册以下内容，作为插件的副作用：

ctx.locale.addLanguage({ id: 'es-419', label: 'Español (Latinoamérica)', fallback: 'en' })
ctx.locale.register('chat', 'es-419', { / … / })

语言声明了 fallback: 'en'，所以缺失的键会先回退到英文解析，再显示键本身。

持续集成

.github/workflows/check.yml 工作流在每次推送到 main 以及每个 pull request 时运行：

1. node scripts/check.mjs --all —— 每个英文键在西班牙语中都存在，{…} 占位符一致，且没有空值。
2. node scripts/build.mjs 和 git diff --exit-code lib/client.js —— 发布的 bundle 由 JSON 重新构建。

它能抓住两类典型错误：{…} 占位符被改动，以及改了翻译却没重新生成 bundle。

编辑翻译

1. 修改 translations/es/<空间>.json 中的值（键相同，{…} 占位符相同）。
2. 重新生成 bundle：

node scripts/build.mjs

缺少键、多出键或占位符变化时，脚本会报错。
3. 把 bundle 复制到安装目录：

sh scripts/install.sh

安装脚本会重新复制文件，并卸载/挂载插件所在行，让运行中的应用无需重启就能重新读取 lib/client.js。之后用 ⌘R 重新加载界面。

宿主会把组装配置档时提供的 bundle 保存在内存里：手动编辑 ~/.dsh/plugins/dsh-locale-es/lib/client.js 不够，因为 HMR 只监视清单和配置档补丁，不监视插件模块。重新安装（或重启应用）才能让改动生效。

升级 DeepSeek Harness 后的维护

每个 DSH 版本都可能新增文案。要重新生成基础词典：

node scripts/extract.mjs # reescribe translations/en/.json
node scripts/check.mjs --all # muestra qué claves faltan traducir

extract.mjs 读取已安装应用的 bundle（/Applications/DeepSeek Harness.app/Contents/Resources/app.asar），无需解压。新键会在 check.mjs 中显示为缺失；在翻译之前，界面会以英文显示它们。

在 macOS 上，node 不在 PATH 里：请使用应用自带的二进制文件。

export ELECTRON_RUN_AS_NODE=1
NODE="/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness"
"$NODE" scripts/build.mjs

范围与已知限制

- 翻译的是界面，不是内容：智能体的消息、模型生成的会话标题、命令输出和文件内容仍保持原语言。
- 宿主诊断信息（pnpm、插件加载器、网络错误）来自主进程，按原样显示，为英文。
- 插件在语言启用之前注册的文本，会保留注册时的语言，直到重新注册为止（这是 dsh-client-locale 记录的已知限制）；刷新页面即可解决。
- 插件按配置档固定语言。其他安装或配置档不受影响。

许可证与致谢

本包以 MIT 许可证发布（见 LICENSE）。

translations/en/ 里的词典是 DeepSeek Harness 的界面文本，从本地安装中提取，并在此处复现，以保证构建可复现；DeepSeek Harness 同样以 MIT 许可证分发（Copyright © 2026 DeepSeek，<https://github.com/deepseek-ai/deepseek-harness>）。详情见 NOTICE.md。

这是社区制作的非官方语言包：DeepSeek 未发布也未背书。