feat(providers): LLM/ASR 供应商改成渠道卡片——同一家可存多把 key，排序即优先级

[bigsongeth]

User description

这个 PR 解决什么

一个供应商只能存一份配置，换 key 只能把旧的覆盖掉；想在主号/备号之间来回切，每次都要重新粘贴。

把「服务 → AI 提供商」从「下拉选厂商 + 一组字段」改成一张张可命名、可排序、可开关的渠道卡片。同一家厂商可以有多张卡片、各自一把 key，切换只是把卡片拖到最上面，旧的那把原样留着。

心智只有一条：排序即优先级，列表里第一个启用的就是当前生效的渠道。关掉的渠道自动沉到末尾；后端不另存「当前选中」，避免「列表第一张是 A、实际请求打的是 B」这种两处真相。

设计与分期见 docs/provider-channels-plan.md。

范围（重要）

本 PR 只做多渠道的存储、编辑与切换，不含失败重试与故障转移。

现在的行为仍是：一次失败就是一次失败（润色失败照旧回落插入 ASR 原文），排在第二的卡片不会被自动用上。也就是说，多渠道当前的价值是「存档 + 手动切换」，不是「自动容错」。

重试要求「这次请求换用渠道 B」，而听写/润色主链路目前是隐式读全局 active 的（CredentialsVault::get(...) 自己去查 active.asr/llm，调用方无法指定渠道）。那几十处的显式化是独立的一步，留给后续 PR，本 PR 主链路一行没动。

存储与迁移

• ChannelMeta（providerType / order / enabled / lastTest）以 serde(flatten) 嵌进 ASR、LLM 两个 entry；v1 老 payload 照常反序列化。
• providerType 与渠道 id 解耦：同一家厂商的多张卡片各有自己的 id，但 providerType 都指向同一个厂商实现。coordinator::resolve_effective_asr_provider 与 commands 里几十处 == PROVIDER_ID 的比较依赖它，拿成 id 会让整个 ASR 路由失效。
• 迁移幂等：迁移出的渠道 id 沿用原 preset id，不生成 uuid —— 老用户的 map key 一个字节都不变，重复执行结果一致。
• 迁移只在内存里做、不主动落盘：启动时写 keyring 会在 macOS 触发钥匙串 ACL 弹窗，留给下一次真实写入顺带固化。
• 排序优先级：原 active → 填过凭据的 → 字母序。active 指向一个已不存在的 entry 是真实会发生的（前端 prefs 与凭据库里的 active 是两份数据），此时若纯按字母序挑，很容易把一张空卡排到第一，用户升级后就看到「未配置」，而配好的那张还在列表下面躺着。
• Windows 全新安装预置一张 Foundry 本地 ASR 卡片，保住开箱即用。

顺手修掉的既有缺陷

这些都不是本次改出来的，是渠道化把它们暴露了：

缺陷	后果
ChannelMeta 若 derive(Default)，enabled 默认为 false，而 write_account 用 entry().or_default() 建 entry	新写入的渠道一出生就是禁用的，表现为「填了 key 却不生效」
clean_credentials 会 retain(!is_empty) 删掉空 entry	刚点「添加渠道」、还没填 key 的卡片被静默删掉
set_credential / read_credential 的 provider 作用域硬性拒绝 LLM 账户	编辑列表里第 3 张 LLM 卡片时无处可写（已补 get/set_for_llm_provider）
Tauri webview 默认 dragDropEnabled，吞掉 HTML5 的 dragstart/drop	draggable 在打包后的 app 里完全不触发（浏览器预览里却是好的）。已改用 pointer 事件手写，Windows / Android 行为也一致
setPointerCapture 会把后续事件重定向到手柄，浏览器补发的 click 落到设置弹窗遮罩上（遮罩挂着 onClick={onClose}）	拖一下卡片，整个设置面板被关掉

UI

• 卡片列表：拖拽排序、开关沉底、当前那张用左侧竖条标示。
• 刻意不用绿点或「生效中」文字：它们会被读成「这张是健康的」，可它只代表排在最前面 —— 一张 key 已失效的卡片照样排第一。优先级与健康度是两个正交维度，不该压成一个视觉。
• 验证按钮在卡片上（开关左侧），按钮自己就是结果容器：没验过显示「验证」、通过显示延迟数字（284ms，既说明通了又能比快慢）、失败显示能指导行动的短标签（✗ 401 改 key / ✗ 429 等会儿 / ✗ 超时 查网络）。副行显示上次验证多久以前，超过一天褪色 —— 让「这条结论会过期」可见。
• 不做自动验证：验证是真实 API 调用（LLM 走一次真润色、ASR 传一段静音音频），打开设置就全部验一遍等于按卡片数烧额度，还容易撞进限流。
• 添加渠道一步完成：供应商、名字、密钥、地址、模型、连接检查都在同一个弹窗里。草稿卡片在后台先建（凭据必须按渠道 id 落盘），什么都没填就关掉时自动回收，不留空卡片。
• 本地引擎与 Codex OAuth 不做预置固定卡片，与云端厂商一样从「添加渠道」里选，只是编辑时没有 key/地址字段。
• 新手引导列表为空时直接摊开添加表单。
• 五种语言文案齐备。

验证

cargo test --lib persistence::credentials   # 33 passed
cargo test --lib commands::                 # 104 passed
tsc --noEmit                                # 0
cargo check --lib                           # 0 error

新增测试覆盖：id 沿用 preset id、迁移幂等（逐字节比对）、迁移后 lookup_account 行为不变、迁移绝不碰凭据（即使 active 指向缺失 entry）、优先选已配置渠道、排序/开关边界（关掉沉底、重开落到启用组末尾、order 压实、前端漏报 id 不撞车）、新建空卡片不被 clean_credentials 删掉、v1 payload 兼容、同厂商多卡片的 providerType 独立。

已在 macOS 上装机自用：老配置迁移后 6 张 ASR 卡片一张没丢，实际在用的那张正确排在第一位，模型名按渠道正确隔离。

已 rebase 到含 #915（ZenMux）的最新 beta，ZenMux 的两处分支（vocabulary note、AsrAdvancedOptions）已并入新的渠道字段组件。

🤖 Generated with Claude Code

---

PR Type

Enhancement, Tests

---

Description

• Provider configs become reorderable, toggleable channel cards.

• Add idempotent in-memory v1→v2 credentials migration.

• Active provider derived from first enabled channel.

• Add channel management IPC, UI, and translations.

---

Diagram Walkthrough

flowchart LR
  A["Provider settings"] --> B["Channel cards: ordered & enabled"]
  B --> C["First enabled = active channel"]
  C --> D["providerType routes protocol"]
  D --> E["ASR / LLM request"]

Loading

File Walkthrough

	Relevant files
Enhancement	10 files credentials.rs Add channel metadata, migration, and management                    +1260/-21 providers.rs Scope validation and model listing per channel                      +180/-83 channels.rs Add Tauri IPC commands for channel management                        +157/-0  credentials.rs Route credential reads and writes by channel kind                +36/-22  channels.ts Add channel IPC wrapper with browser mock                                +176/-0  Onboarding.tsx Use channel list during onboarding with auto-create            +3/-3      ChannelList.tsx Add channel card list UI component                                              +793/-0  asr-credentials.ts Adapt ASR credentials helpers to channel ids                          +5/-2      tabs.tsx Route provider settings to channel list page                          +1/-1      ProvidersSection.tsx Refactor providers section to embed channel list                  +211/-407
Configuration changes	1 files lib.rs Register new channel commands in invoke handler                    +18/-0
Miscellaneous	2 files mod.rs Export channels module from commands                                          +4/-2      index.ts Export channel IPC functions from index                                    +14/-0
I18n	5 files ja.ts Add Japanese channel management translations                          +28/-0    zh-TW.ts Add Traditional Chinese channel translations                          +28/-0    ko.ts Add Korean channel management translations                              +28/-0    zh-CN.ts Add Simplified Chinese channel translations                            +28/-0    en.ts Add English channel management translations                            +28/-0
Documentation	1 files provider-channels-plan.md Document provider channels design and phasing                        +184/-0

---

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis 🔶 915 - Partially compliant Compliant requirements: (none) Non-compliant requirements: 未新增 ZenMuxJson 请求格式，diff 中没有任何 ZenMux / audio/transcriptions 相关改动。 未新增 language 的 ISO 639-1 映射逻辑。 未新增 enable_itn 高级配置或「数字归一化」开关。 未新增 zenmux ASR 预设与默认 endpoint/model。 未新增针对 ZenMux 的 30s 分片行为。 未新增 ZenMux 相关 i18n 键与测试。 Requires further human verification: (none)

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

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Possible Issue When every channel of a kind is disabled, sync_active_channels leaves active.asr / active.llm pointing at the previously active (now disabled) channel. lookup_account resolves credentials from the entry at active.* without checking the enabled flag, so the app keeps using a channel the user explicitly turned off. Repro: with a single ASR channel, toggle it off, then perform dictation; transcription still goes to that provider. The active id should be cleared (or lookups should treat disabled entries as unconfigured) so disabling the last channel actually disables the feature. fn sync_active_channels(root: &mut CredsRoot) { if let Some(id) = current_channel_id(&root.providers.asr) { root.active.asr = id; } if let Some(id) = current_channel_id(&root.providers.llm) { root.active.llm = id; } } Ordering Bug next_order only considers enabled channels, so when disabled channels exist (compact_orders keeps them at orders k+1..), a newly created channel is assigned the same order as the first disabled channel. create_channel does not re-compact and channel_summaries sorts purely by (order, id), so a disabled card can appear above the newly created enabled card until the user reorders. Example: enabled 'a' order 0, disabled 'b' order 1, create 'c' -> 'c' gets order 1 and, if 'b' < 'c' alphabetically, the disabled 'b' is listed before the enabled 'c', violating the 'disabled channels sink to the bottom' invariant. fn next_order<V: HasChannelMeta>(map: &HashMap<String, V>) -> u32 { map.values() .filter(|entry| entry.meta().enabled) .filter_map(|entry| entry.meta().order) .max() .map(|max| max.saturating_add(1)) .unwrap_or(0) }