Model Import

模型手动导入

v1.3.3 新增

背景

部分用户因网络受限（GitHub 访问不稳、防火墙等）无法在应用内直接下载 ASR 模型。手动导入功能提供备用方案。

使用方式

方式一：设置页导入

1. 打开 设置 → 语音模型
2. 找到想要的模型，点击 🔗 图标在浏览器中打开 GitHub 下载链接
3. 下载 .tar.bz2 文件到本地
4. 点击 导入 按钮，选择刚下载的文件
5. 等待解压完成，模型自动激活

方式二：引导页导入

首次使用时如果下载失败：

1. 点击 手动下载 链接，在浏览器中下载模型文件
2. 点击 导入 按钮，选择下载好的 .tar.bz2 文件
3. 等待导入完成

技术实现

数据流

用户选择 .tar.bz2 文件
  → pickFile (NSOpenPanel)
  → importModel: 复制到 ~/Library/App Support/.../Models/
  → _extractAndInstallModel: 解压 → tokens 验证 → 激活

关键设计

• 文件复制优先：先将用户选择的文件复制到 App Support/Models 目录，避免沙盒权限问题
• 共用解压逻辑：downloadAndExtractModel 和 importModel 共用 _extractAndInstallModel 方法
• 原生文件选择器：通过 MethodChannel 调用 NSOpenPanel，过滤 .bz2 文件类型