feat(asr): 接入 ZenMux 语音转写（JSON + base64）作为可选云端 ASR（#837）

[H-Chris233]

User description

背景

Closes#837

OpenLess 已支持多路云端 ASR，但聚合平台 ZenMux（zenmux.ai）的语音转写接口是 JSON 请求体 + base64 内联音频的私有格式，现有「OpenAI Whisper（兼容）」provider 对不上。已在使用 ZenMux 做 LLM 润色的用户无法复用同一把 Key 做语音识别。

变更

• 协议：WhisperBatchASR 新增 ZenMuxJson 请求格式（POST /audio/transcriptions + application/json，input_audio.data 走标准 base64），与 OpenRouter 的 JSON 路径隔离，避免互相污染。
• 语言跟随：language 字段取 working_languages 主语言 → ISO 639-1 映射（zh/en/ja/ko/fr/de/es/it/pt/ru/ar/vi/th/hi），未收录语言省略字段由服务端自动检测。
• enable_itn 开关：per-provider 高级配置（复用 asr.advanced_config vault），默认开启；设置页对 zenmux 预设显示「数字归一化」开关。
• 命名预设：ASR_PRESETS 新增 zenmux，默认 https://zenmux.ai/api/v1 + qwen/qwen3-asr-flash；模型 slug 自由输入（可填 bytedance/doubao-seed-asr-2.0、xiaomi/mimo-v2.5-asr 等）。后端空槽回落同款默认值。
• 分片：与 OpenRouter 一致按 30s 切分（base64 进 JSON body 体积膨胀约 33%）。
• i18n/测试：五语言同步新增键；后端新增请求体/语言映射/路由单测，前端单测与 i18n 一致性脚本保持通过。

测试

• 后端：zenmux 相关单测 5 个、whisper 模块 29 个、coordinator 82 个全部通过；cargo check --lib 无错误。
• 前端：tsc --noEmit 零错误，完整前端测试套件通过。

说明

ZenMux 官方文档在实现时不可访问，协议以 issue #837 提供的请求/响应形状为准（与已实现的 OpenRouter JSON 格式一致）；如联调发现 language/enable_itn 字段校验更严，仅需微调映射或开关发送策略。

---

PR Type

Enhancement

---

Description

• Add ZenMux ASR preset using JSON+base64 transcription

• Follow working language and expose enable_itn toggle

• Make test connection match provider real request format

• Update i18n, docs, and tests across the app

---

Diagram Walkthrough

flowchart LR
A["ASR request"] --> B{"Request format"}
B -- "zenmux" --> C["ZenMuxJson JSON+base64"]
B -- "openrouter" --> D["OpenRouterJson"]
B -- "others" --> E["Multipart"]
C --> F["ZenMux /audio/transcriptions"]
F --> G["Transcript text"]

Loading

File Walkthrough

	Relevant files
Enhancement	8 files whisper.rs Add ZenMuxJson request format with language/itn options +168/-0 providers.rs Validate ASR connection using provider-specific JSON or multipart +61/-16 coordinator.rs Add zenmux provider id, defaults, and enable_itn config +91/-13 asr_wiring.rs Wire zenmux format, language mapping, and ASR options +99/-4 dictation.rs Apply ZenMux options in dictation session construction +4/-2 advancedAsrConfig.ts Add enableItn field to advanced ASR config +11/-6 ProvidersSection.tsx Show enable_itn toggle and ZenMux vocabulary note +54/-29 shared.tsx Add ZenMux preset with default endpoint and model +4/-0
I18n	5 files en.ts Add English translations for ZenMux and enable_itn +5/-1 ja.ts Add Japanese translations for ZenMux and enable_itn +5/-1 ko.ts Add Korean translations for ZenMux and enable_itn +5/-1 zh-CN.ts Add Simplified Chinese translations for ZenMux and enable_itn +5/-1 zh-TW.ts Add Traditional Chinese translations for ZenMux and enable_itn +5/-1
Tests	2 files advancedAsrConfig.test.ts Update tests for enable_itn config parsing +20/-10 ProvidersSection.test.ts Add test for ZenMux ASR preset defaults +14/-0
Documentation	2 files README.md Document ZenMux ASR and hotword exception +2/-2 README.zh.md Document ZenMux ASR and hotword exception in Chinese +2/-2

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 7331f7f)

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis ✅ 837 - PR Code Verified Compliant requirements: ZenMux preset added with default base URL and model; API Key and model slug are user-configurable. ZenMuxJson request format implements POST /audio/transcriptions with application/json and base64 input_audio; language is derived from the primary working language; the response text is handled by the existing Whisper transcription pipeline. Failures propagate through the existing Whisper transcription error paths. Requires further human verification: Live verification against the actual ZenMux endpoint with a real API key (request/response shape and 4xx error surfacing). Manual UI verification of the new ZenMux preset and the enable_itn toggle in Settings.

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 PR contains tests

🔒 No security concerns identified

⚡ No major issues detected

[github-actions]

Persistent review updated to latest commit 7331f7f