西语界面与听写 admzaddem-ia/deepseek-harness-es

DeepSeek Harness 西班牙语版

面向 DeepSeek Harness 的西班牙语界面和西班牙语语音听写。

DeepSeek Harness（DSH）只带两种界面语言，英语和中文，它本地的语音识别器（SenseVoice）也不认识西班牙语。本仓库把这两样东西作为本地插件补上，不改动 DSH 的安装，也不把音频发往任何服务：

| 包 | 增加的内容 |
| locale-es/ | 界面完整翻译：57 个区段、2,433 条文本，缺失时自动回退到英语 |
| speech-to-text-whisper/ | 基于 DSH 已内置的 sherpa-onnx 运行时，用多语言 Whisper 做本地听写；语言可选 auto、es、en |

一切都在你自己的机器上运行。音频从不离开设备，也不需要任何账号或 API 密钥。

状态

| 测试环境 | DeepSeek Harness 0.2.0-rc.2（桌面应用，配置档 desktop，Windows 11 x64） |
| 界面 | 已在运行中的应用里验证：整个窗口显示为西班牙语 |
| 听写 | 已用真实西班牙语音频验证：base int8 用 2.98 秒转写了 6.8 秒音频 |
| 安装 | Host 那一半热注册；界面刷新页面后切换语言 |

测试细节与复现方法：docs/VERIFICACION.md。

要求

- 已安装 DeepSeek Harness（桌面版，带配置档；0.2.0-rc.* 是测试过的版本）。
- Windows、macOS 或 Linux。三个平台路径相同：$DSH_HOME/profiles/<配置档>。
- 听写功能：每个模型变体需要约 162 MB（base int8）或约 377 MB（small int8）空闲磁盘空间（首次使用时下载），转写期间占用约 1 GB 内存。

安装

有两条路。如果你在 DSH 里用智能体，第一条最简单；第二条是手动安装，效果一样。

路线 A —— 让 DSH 的智能体来装

1. 把本仓库克隆或解压到你的机器上。例如： C:\Users\<你>\dsh-espanol
2. 打开 DSH，把两个文件夹的路径交给智能体：

用 plugin_manager 安装插件包，路径是 C:\Users\<你>\dsh-espanol\locale-es 和 C:\Users\<你>\dsh-espanol\speech-to-text-whisper， action: install_bundle。

智能体会对每个文件夹执行 install_bundle，它在配置档里跑 pnpm add 并启用这些 bundle。改动热生效。

路线 B —— 从界面安装，不用智能体

1. 在 DSH 里打开侧边栏的 Plugins。
2. 添加插件 → 粘贴克隆下来的仓库中 locale-es 文件夹的绝对路径。
3. 安装。完成后，用 speech-to-text-whisper 的路径重复一遍。
4. 如果界面没有自动变化，刷新页面（F5 / Ctrl+R）。

路线 C —— 从终端，用 DSH 的命令行

DSH 带一个命令行启动器。它只管理非桌面应用配置档，所以对 desktop 配置档无效（这个配置档请走方案 A 或 B）：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
plugin --profile web add "C:\Users\<vos>\dsh-espanol\locale-es"

用 desktop 配置档时，命令行会回一句「profile "desktop" is managed exclusively by the Electron application」。这个配置档只有方案 A（智能体）或方案 B（界面）能生效。

检查是否装好了

1. 界面： 设置 → General → Idioma。选项里应该出现 Español，界面也要变成西班牙语。
2. 听写： 打开麦克风面板（模型选择器旁边那个蓝色波形按钮）。里面应该显示服务商 「Whisper Base multilingüe (INT8)」，语言为 es。
3. 第一次录音： 如果所选变体的模型还没下载，面板会提供 Descargar y preparar。下载完成后先用 SHA-256 校验，再投入使用。

用法

切换界面语言

什么都不用做：除了注册「Español」，插件包还会在每次页面加载时用官方语言 API（setLocale('es')）自己把它设为激活状态。这个调用走的是偏好（settings）通道：服务端接受的话，还会存进配置档的补丁里。但无论如何，保证都不依赖那个文件，所以就算应用把它重写或弄丢，语言照样还在。

想用别的语言，得卸载 @local/dsh-locale-es：只要它还装着，西班牙语就会被重新选中。如果你只想把插件包留作语言登记（不让它自动选中），在它那一行的 config 里加上 preference: false：

- id: locale-es
name: '@local/dsh-locale-es'
config:
preference: false

切换语音模型变体

在 speech-to-text-whisper/cordis.patch.yml 里，speech-to-text-whisper 那一行的 config 已经带了 dataRoot；把你要的变体键加进去：

- insert:
- id: speech-to-text-whisper
name: '@local/dsh-speech-to-text-whisper'
config:
dataRoot: !!js dshHomePath('speech-to-text', 'whisper')
model: small # base (por defecto) o small: más preciso y ~2,7x más lento
precision: int8 # int8 (por defecto) o fp32

保存文件，等几秒：配置档会自己重新加载（HMR）。每个变体都有自己的文件夹（models/base-int8、models/small-int8……），所以第一次用别的变体要完整下载一遍，之后想换回原来的也不用再下。

换回 SenseVoice

插件 → 语音面板 → 选 SenseVoiceSmall (INT8) 和它的某个语言（auto、zh、en、yue、ja、ko）。用 SenseVoice 要西班牙语会故意报错：那个模型不认识西班牙语。

卸载

插件 → 插件卡片 → 卸载。界面恢复为英文，听写只提供 SenseVoice；不会留下任何损坏。

仓库结构

deepseek-harness-es/
├── locale-es/ 语言包（注册「Español」及其词典） │ ├── client.js 浏览器 bundle，包含 2,433 条译文 │ ├── index.js Host 半部分（故意留空：这是数据包） │ └── cordis.patch.yml 把插件行插入配置档 ├── speech-to-text-whisper/ 语音识别器包 │ ├── index.js Host 半部分：下载、SHA-256 校验和 worker 生命周期 │ ├── whisper-worker.js 子进程，内含原生识别器和 Silero VAD │ └── cordis.patch.yml 插入服务商并默认选中它 ├── tools/ 维护工具（见 tools/README.md） │ └── corpus/ 英文原始键、批次和最终译文 ├── samples/prueba-es.wav 西班牙语测试音频 ├── docs/ 安装、验证、开发和限制 └── .github/workflows/verify.yml CI：校验清单和语言 bundle

工作原理

- 界面。 DSH 在客户端暴露 locale 服务。这个包注册新语言
（addLanguage({ id: 'es', label: 'Español', fallback: 'en' })），并为界面的每个区块注册词典
（register(ns, 'es', {...})）。如果某个键没有译文，查找会沿 es → en 链回退，显示英文文本；
永远不会出现原始键。
- 语音。 DSH 暴露 speechToText 服务，接受带元数据的服务商（语言、下载源、磁盘占用估算）、准备生命周期和 transcribe 函数。服务商从 Hugging Face 下载 Whisper 权重，用 SHA-256 校验，启动带识别器的子进程，并通过本地认证 socket 把音频发给它。
- 可复现性。 模型按 Hugging Face 修订版本、大小和 SHA-256 固定。如果文件不匹配，就丢弃它，并在面板中报告错误。

已知限制

- 听写的语言选择器显示代码 es，而不是「Español」：DSH 的语音 bundle 只为 auto/zh/en/yue/ja/ko 提供翻译后的名称。
- 电子表格预览保持英文（sidebarExcel.language 是渲染器标识符，不是界面文本）。
- 译文是中性西班牙语（es-419）。欢迎提出修改，尤其是术语方面。
- 约 127 条文本与英文相同，因为它们是技术术语或专有名词（token、plugin、JSON、MCP、DeepSeek……）。
- 语音包不分发模型：首次使用时从 huggingface.co 或其镜像 hf-mirror.com 下载（约 162 MB base int8，约 377 MB small int8）。
- 克隆下来的仓库一旦移动或删除，插件就停止加载（配置档用符号链接指向那个文件夹）。

更多细节见 docs/LIMITACIONES.md。

常见问题

| 现象 | 怎么办 |
| 全都装好了，界面还是英文 | 刷新页面（F5 / Ctrl+R）。如果还是英文，检查「设置 → 通用 → 语言」 |
| 语言列表里没有「Español」 | 确认插件里 @local/dsh-locale-es 这个 bundle 已启用 |
| 麦克风里没有 Whisper 选项 | 确认插件里 @local/dsh-speech-to-text-whisper 已启用；如果安装路径变了，配置档会要求重启 DSH |
| 选了英文，语言还是回到西班牙语 | 这是预期行为：这个包每次加载都会把西班牙语设为启用状态。想用别的语言，就卸载它（或把它那一行的 preference 设为 false） |
| 模型下载因网络失败 | 面板提供 hf-mirror.com 作为备用源；你可以在 config 里用 modelOrigin: 'https://hf-mirror.com' 强制指定 |
| 「Speech provider sensevoice-local does not support language: es」 | 你用 SenseVoice 选了西班牙语；改选 Whisper，或选一个 SenseVoice 支持的语言 |
| 听写很慢 | base int8 比 small 快约 2.7 倍；fp32 比 int8 慢不少 |

参与贡献

欢迎贡献：术语、读起来别扭的文案、其他语言，或者对语音服务商的改进。先看 CONTRIBUTING.md 和 docs/DESARROLLO.md，里面讲了怎么从已安装的 DSH 构建里重新生成翻译。

英文原文来自 DeepSeek Harness（MIT），模型权重从 Hugging Face 下载。许可证与署名的细节见 LICENSE 和 docs/CREDITOS.md。

English quick start

DSH ships English and Chinese only, and its bundled speech recognizer does not support Spanish.
This repository adds both as local plugins:

1. Clone it and install each folder with the DSH plugin manager (install_bundle with the absolute
path), or use the Web GUI: Plugins → Add plugin → absolute path of locale-es and then
speech-to-text-whisper.
2. Settings → General → Language → Español (this becomes the default automatically).
3. The microphone panel will list Whisper Base multilingüe (INT8) with language es; the first
recording offers Download and prepare (~162 MB, verified by SHA-256).

Everything runs locally; audio never leaves the machine.