前言¶
DeepSeek Harness（DSH）桌面端默认以英文界面为主；若要在设置里切换为西班牙语，需要有人把各 UI 插件里的文案键值整理成完整语言包，并以客户端插件形式注入，而不是去改 app.asar。社区维护者 Oskarosan 的 dsh-locale-es 就是面向这一需求的 castellano（es）包：覆盖 2603 个键、57 个 namespace，缺键时自动回退英文，避免界面因翻译不全而报错。
下面介绍它是什么、如何安装，以及使用时需要注意的事项。
这是什么¶
dsh-locale-es 是 DSH 的 客户端语言包插件（分类：客户端）。维护者为 Oskarosan，源码与说明见 GitHub 仓库，社区目录页为 skillhub.cn/plugins/Oskarosan/dsh-locale-es。
它解决的是：在不修改应用本体文件的前提下，为 DSH 界面提供西班牙语（标签「Español」，语言 ID es，回退语言 en）。README 中记录的覆盖率为 2603/2603 键（100%）、57/57 namespace；当前 package.json 版本为 1.0.1，许可证 MIT。
核心功能¶
客户端注入，不 patch 应用包¶
插件通过 DSH Loader 以 client plugin 方式加载：不 patch app.asar，也不改写应用目录里的其它文件。生成后的 lib/client.js 在浏览器侧通过 window.__ModuleLoader__.load 注册 locale 服务，向 ctx.locale 添加语言并逐 namespace 注册词典。
缺键自动回退英文¶
任意缺失的键，或新版本 DSH 新增的键，会自动落到英文，因此语言包不会把界面「译断」。
与 DSH 插件清单的契约¶
包内声明 dsh.bundle.patch（指向 cordis.patch.yml），加载 bundle 时由 DSH 插入 locale-es 插件行；dsh.client 注入 @deepseek-ai/dsh-client-locale。插件卡片元数据来自 locale/<语言>.json 的 meta.title、meta.description，并配合 package.json 与 icon.svg。
安装与启用¶
有两种路径：插件管理器（推荐）或手动编辑 profile。
方式一：插件管理器¶
在界面中：侧边栏 → Plugins → Add plugin，粘贴规格；或在终端执行（与界面等效）：
# 若包已发布到 npm，可按包名安装
dsh plugin --profile desktop add dsh-locale-es
# 直接从 GitHub 安装，无需 npm 发布
dsh plugin --profile desktop add github:Oskarosan/dsh-locale-es
# 或从本地目录安装
dsh plugin --profile desktop add C:\ruta\a\dsh-locale-es
管理器支持 npm 包名（可选版本）、github:作者/仓库、git URL、.tgz 或本地路径。安装前会检查包是否声明 dsh.bundle；完成后写入 profile 的 dsh.profile.bundles。
启用界面语言： 重新加载界面后，在 Ajustes → General → Idioma 中选择 Español。
若安装后设置里仍看不到「Español」，可在插件管理器中 关闭再开启 locale-es 行，强制重新解析 client bundle。
方式二：手动编辑 profile¶
在 ~/.dsh/profiles/<profile>/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"
]
}
}
}
在 profile 目录下执行：
pnpm install
同样在设置中选择 Español。
典型用法与维护者工作流¶
对 使用者 而言，典型流程就是：安装插件 → 重载 → 在 General 里选 Español；日常无需改仓库文件。
对 贡献翻译 的人，README 给出的可复现步骤是：
- 编辑
i18n/es/<namespace>.json（每个 namespace 一个文件）。 - 保留与
i18n/catalog.json一致的占位符（如{count}、{label}、{toolName}），编译器会拒绝丢键或自造占位符的译文。 - 重建并检查：
node tools/build-locale-pack.cjs i18n/catalog.json i18n/es . --check
node tools/audit-es.cjs i18n/catalog.json i18n/es
仓库还提供 check-portable.cjs、verify-pack.cjs 等工具，并在 CI 中跑覆盖、审计与 bundle 同步检查；维护者可在无 DSH 应用的情况下重复验证。
适用场景与注意¶
适合谁： 日常用 DSH 桌面端、希望界面为西班牙语（castellano）的用户；以及愿意按 namespace 维护或校对译文的贡献者。
权限与安全： 与其它 DSH 插件一样，client 插件在 当前 DSH 进程权限 下运行。安装前应自行查看 源码 与 MIT 许可证（及仓库中的 NOTICE.md），确认符合你的环境策略。
profile 热重载： README 注明，若在 DSH 会话内 修改 profile，热重载会结束当前会话并打开新对话（历史不会丢，但当前对话会中断）；建议在 DSH 外改 profile，或接受会话被切断。
安全模式： 桌面端「Disable third-party plugins」会恢复出厂 bundles，会移除此语言包；恢复后需重新安装。
生态说明： DSH 强调「一切皆插件」；skillhub.cn 上的插件目录是社区站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-locale-es 以客户端插件方式提供完整的西班牙语 UI 翻译，并在缺键时回退英文，适合需要 Español 界面的 DSH 用户。安装可用 dsh plugin --profile desktop add github:Oskarosan/dsh-locale-es（或 npm 包名 / 本地路径），然后在设置中选择 Español。
