fix(speaker): 修正说话人模型下载 URL 与脚本编码

Author: Aparencia

app/scripts/download-speaker-model.ps1

@@ -1,4 +1,4 @@
-# 下载说话人 embedding 模型（wespeaker，v0.7.2 REQ-153 弱化版讲者分离依赖）
+# 下载说话人 embedding 模型（wespeaker，v0.7.2 REQ-153 弱化版讲者分离依赖）
 #
 # @ai-context: sherpa-onnx SpeakerEmbeddingExtractor 使用 wespeaker 转换模型
 #              （Apache-2.0 许可）——单文件 ONNX，约 20-70MB。下载到
@@ -8,19 +8,20 @@
 #              TLS 拦截环境走 Windows 证书库（与 ffmpeg 下载同模式）。
 # @ai-context: 用法：powershell -ExecutionPolicy Bypass -File scripts/download-speaker-model.ps1
 #
-# 源：sherpa-onnx 模型仓库（wespeaker-zh：中文音色 embedding，sherpa-onnx 转换版）
+# 源：sherpa-onnx 模型仓库（wespeaker_zh_cnceleb_resnet34：中文音色 embedding，
+#      sherpa-onnx 转换版，约 26.5MB；曾误用不存在的 wespeaker-zh.onnx 导致 404）
 $ErrorActionPreference = "Stop"
 
 $targetDir = Join-Path $PSScriptRoot "..\src-tauri\models\speaker-embedding"
 $targetDir = [System.IO.Path]::GetFullPath($targetDir)
 $targetFile = Join-Path $targetDir "model.onnx"
 
 # 镜像源（多源回退防单点失效；模型经 sherpa-onnx 官方仓库分发）
-# 1) GitHub release（k2-fsa/sherpa-onnx 模型清单中的 wespeaker-zh 包）
-# 2) HuggingFace 镜像（k2-fsa 组织仓库）
+# 1) GitHub release（k2-fsa/sherpa-onnx 模型清单中的 wespeaker_zh_cnceleb_resnet34 包）
+# 2) HuggingFace 镜像（csukuangfj/speaker-embedding-models 仓库）
 $mirrors = @(
-    "https://github.com/k2-fsa/sherpa-onnx/releases/download/speaker-recongition-models/wespeaker-zh.onnx",
-    "https://hf-mirror.com/csukuangfj/sherpa-onnx-speaker-embedding/resolve/main/wespeaker-zh.onnx"
+    "https://github.com/k2-fsa/sherpa-onnx/releases/download/speaker-recongition-models/wespeaker_zh_cnceleb_resnet34.onnx",
+    "https://hf-mirror.com/csukuangfj/speaker-embedding-models/resolve/main/wespeaker_zh_cnceleb_resnet34.onnx"
 )
 
 if (Test-Path $targetFile) {

app/src-tauri/src/speaker_download.rs

@@ -17,9 +17,14 @@ use tauri::Emitter;
 use crate::error::{AppError, Result};
 
 /// 下载镜像源（与 scripts/download-speaker-model.ps1 同源；多源回退防单点失效）。
+///
+/// 上游文件名为 wespeaker_zh_cnceleb_resnet34.onnx（wespeaker 中文 CN-Celeb 模型，
+/// 约 26.5MB；曾误用不存在的 wespeaker-zh.onnx 导致双镜像 404）：
+/// 1) GitHub release（sherpa-onnx 官方分发，speaker-recongition-models 为官方 tag 名）
+/// 2) HuggingFace 镜像（csukuangfj/speaker-embedding-models，注意非 sherpa-onnx-speaker-embedding）
 const MIRRORS: &[&str] = &[
-    "https://github.com/k2-fsa/sherpa-onnx/releases/download/speaker-recongition-models/wespeaker-zh.onnx",
-    "https://hf-mirror.com/csukuangfj/sherpa-onnx-speaker-embedding/resolve/main/wespeaker-zh.onnx",
+    "https://github.com/k2-fsa/sherpa-onnx/releases/download/speaker-recongition-models/wespeaker_zh_cnceleb_resnet34.onnx",
+    "https://hf-mirror.com/csukuangfj/speaker-embedding-models/resolve/main/wespeaker_zh_cnceleb_resnet34.onnx",
 ];
 /// 下载超时（30 分钟；同 structure_models 口径）。
 const DOWNLOAD_TIMEOUT_SECS: u64 = 30 * 60;
@@ -191,7 +196,7 @@ fn download_one(
             let _ = app.emit(
                 "speaker-model:download-progress",
                 crate::model_downloader::DownloadProgress {
-                    file: "wespeaker-zh.onnx".to_string(),
+                    file: "wespeaker_zh_cnceleb_resnet34.onnx".to_string(),
                     downloaded_bytes: downloaded,
                     total_bytes: total,
                 },

docs/product/classroom-assistant-guide.md

@@ -52,7 +52,7 @@
 
 访谈、会议等多人视频的**讲者切换标记**——只标注"这里换人了"，不识别身份。
 
-- **启用方式（可选增强）**：运行 `app/scripts/download-speaker-model.ps1` 下载模型（wespeaker-zh，约 20-70MB，Apache-2.0 许可），重启应用
+- **启用方式（可选增强）**：运行 `app/scripts/download-speaker-model.ps1` 下载模型（wespeaker 中文模型 wespeaker_zh_cnceleb_resnet34，约 26.5MB，Apache-2.0 许可），重启应用
 - **使用场景**：访谈/会议档案的会话详情页会显示「👥 讲者切换 N 处」及时间点（按置信度排序标注）
 - **效果预期与局限（请务必了解）**：
   - **本地方案效果有限**：无云端说话人分离（如 pyannote 级服务）的精度——本地 wespeaker 音色向量 + 余弦阈值是"可用级"而非"准确级"：