Fix/sherpa local asr state sync v2

[weikeyi]

User description

概要

• 放宽 Sherpa Qwen3-ASR 模型的 tokenizer 目录校验，支持两种布局：
  • tokenizer.json
  • vocab.json + merges.txt
• 修复 Sherpa 本地 ASR 的部分下载状态展示：
  • 页面刷新后可从 catalog 的 downloadedBytes 恢复 partial 状态
  • 继续下载、删除按钮、进度显示能正确反映本地残留/部分下载文件
• 放宽 Sherpa “准备”按钮逻辑，不再强制要求 cached === true，允许在本地文件存在但缓存状态未完整识别时尝试准备模型

背景

此前 Qwen3-ASR 的 tokenizer 校验只接受 tokenizer.json，但实际模型资产可能使用 vocab.json + merges.txt 的布局，导致本地文件已经存在时仍被判定为无效。

同时，Sherpa 的前端状态逻辑主要依赖实时下载事件中的 progress。页面刷新后，如果本地已有部分下载文件，但当前没有实时 progress，UI 可能无法正确显示继续下载/删除/进度状态。

说明

已同步检查 Foundry Local Whisper 的同类情况。当前 Foundry 模型资产仍是固定文件布局，没有发现类似 Qwen3 tokenizer 这种目录型资产多布局校验需求，因此本次不扩展 Foundry 后端校验逻辑。

验证

• cmd /c node_modules\.bin\tsc.cmd --noEmit --pretty false
• cargo test qwen3_tokenizer_accepts_supported_layouts --lib

---

PR Type

Enhancement, Bug fix, Tests, Documentation

---

Description

• Add sherpa-onnx runtime and downloads

• Sync active ASR provider during saves

• Refresh network, marketplace, and update flows

• Refactor settings UI for local ASR

---

Diagram Walkthrough

flowchart LR
  UI["Settings / Local ASR UI"] -- "invoke Tauri commands" --> CMD["commands.rs"]
  CMD -- "prepare / download / switch" --> SRV["sherpa_runtime.rs"]
  CMD -- "fetch / verify model files" --> DL["sherpa_download.rs"]
  CMD -- "retry HTTP requests" --> NET["net.rs"]
  SRV -- "persist preferences" --> CFG["types.rs"]

Loading

File Walkthrough

	Relevant files
Enhancement	17 files commands.rs Wire sherpa commands and retries                                                  +836/-182 sherpa_download.rs Implement sherpa model download verification                          +906/-0  sherpa_runtime.rs Add sherpa runtime lifecycle handling                                        +517/-0  sherpa.rs Define sherpa models and layouts                                                  +415/-0  sherpa_provider.rs Register sherpa provider entrypoints                                          +182/-0  mod.rs Export sherpa local ASR modules                                                    +12/-2    net.rs Add shared HTTP retry helper                                                          +72/-0    types.rs Persist sherpa ASR preferences                                                      +34/-1    persistence.rs Serialize new preferences safely                                                  +7/-0      lib.rs Register sherpa state and commands                                              +38/-1    LocalAsr.tsx Add sherpa local ASR screen                                                            +2927/-1136 localAsr.ts Extend local ASR client bindings                                                  +493/-224 ipc.ts Expose sherpa IPC contracts                                                            +1020/-784 SettingsModal.tsx Route settings into new sections                                                  +119/-495 ProvidersSection.tsx Add provider settings section                                                        +791/-0  MarketplaceSection.tsx Refresh marketplace management controls                                    +108/-0  CheckUpdateButton.tsx Add channel-aware update button                                                    +80/-0
Bug fix	1 files coordinator.rs Sync active provider into vault                                                    +99/-3
Configuration changes	1 files build.rs Adjust Windows build configuration                                              +22/-0
Tests	1 files backend_rust.rs Stub sherpa provider in tests                                                        +9/-0
Documentation	1 files windows-sherpa-onnx-asr-plan.md Document sherpa rollout plan                                                          +421/-0
Additional files	43 files Cargo.toml +4/-0      download.rs +5/-2      foundry_native.rs +2/-2      combo_hotkey.rs +3/-0      dictation.rs +74/-0    resources.rs +2/-0      polish.rs +5/-4      qa_hotkey.rs +3/-0      App.tsx +5/-4      AutoUpdate.tsx +6/-4      FloatingShell.tsx +3/-3      GithubLoginModal.tsx +218/-0  Icon.tsx +1/-0      MarketplaceModal.tsx +2/-2      Modal.tsx +51/-0    SelectLite.tsx +9/-0      en.ts +54/-27  ja.ts +54/-27  ko.ts +54/-27  zh-CN.ts +55/-28  zh-TW.ts +55/-28  stylePrefs.test.ts +3/-0      types.ts +6/-0      main.tsx +4/-1      Marketplace.tsx +20/-261 Overview.tsx +17/-3    QaPanel.tsx +2/-2      Settings.tsx +0/-2213 AboutSection.tsx +151/-0  AboutUpdateControl.tsx +0/-53    BetaChannelSection.tsx +51/-0    DataStorageSection.tsx +84/-0    DebugToolsSection.tsx +110/-0  LanguageSection.tsx +2/-6      LocalModelSection.tsx +54/-96  MicrophoneSelect.tsx +152/-0  PermissionsSection.tsx +7/-28    RecordingInputSection.tsx +336/-0  ShortcutsSection.tsx +1/-5      shared.tsx +168/-60 tabs.tsx +78/-0    HotkeySettingsContext.tsx +212/-161 global.css +23/-4

---

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Cancel handling The archive extraction step runs to completion even if cancel is set, because the spawn_blocking unpack/move work does not check the flag. If the user cancels after the release archive finishes downloading but before extraction ends, the model files can still be installed on disk while the UI reports the download as cancelled. let extract_result = tauri::async_runtime::spawn_blocking(move || { extract_release_archive( &archive_path_for_extract, &dir_for_extract, archive, &model_alias_for_extract, ) }) .await .map_err(|error| anyhow::anyhow!("extract join failed: {error:#}")) .and_then(|result| result); if let Err(error) = extract_result { emit_failed(app, model_alias, file_count, total_bytes, &error); return Err(error);