# 语音模型运行时下载方案

## ❌ **问题**

语音模型文件 `vosk-model-small-cn-0.22.zip` 大小为 **41.87 MB**，超过云端打包限制（40MB）。

---

## ✅ **解决方案：运行时下载**

### **原理**

1. 打包时**不包含**模型文件（减小 APK 大小）
2. 首次启动时从服务器下载模型
3. 下载后保存到本地存储
4. 后续使用本地模型

---

## 📝 **实施步骤**

### **步骤1：从 static 目录移除模型文件**

**方法A：移动到服务器（推荐）**

```bash
# 将模型文件上传到您的服务器
# 例如：https://app.liuyingyong.cn/static/vosk-model-small-cn-0.22.zip
```

**方法B：移动到项目外（临时）**

```bash
# 将文件移动到桌面备份
# fronted_uniapp/static/vosk-model-small-cn-0.22.zip
# → 桌面/vosk-model-backup/
```

---

### **步骤2：修改语音识别页面，添加模型下载逻辑**

在 `pages/speech/speech.vue` 中添加：

```vue
<script>
export default {
  data() {
    return {
      modelDownloaded: false,
      downloadProgress: 0,
      // 模型文件URL（改为您的服务器地址）
      modelUrl: 'https://app.liuyingyong.cn/static/vosk-model-small-cn-0.22.zip',
      // 本地存储路径
      modelPath: ''
    }
  },
  
  onLoad() {
    this.checkAndDownloadModel();
  },
  
  methods: {
    // 检查并下载模型
    async checkAndDownloadModel() {
      try {
        // 检查本地是否已有模型
        const localPath = plus.io.convertLocalFileSystemURL('_doc/vosk-model-small-cn-0.22.zip');
        const file = plus.io.resolveLocalFileSystemURL(localPath);
        
        file.getFile({
          success: (entry) => {
            console.log('模型文件已存在');
            this.modelPath = localPath;
            this.modelDownloaded = true;
          },
          fail: () => {
            console.log('模型文件不存在，开始下载');
            this.downloadModel();
          }
        });
      } catch (e) {
        console.log('检查模型失败，开始下载', e);
        this.downloadModel();
      }
    },
    
    // 下载模型
    downloadModel() {
      uni.showLoading({
        title: '下载语音模型...',
        mask: true
      });
      
      const downloadTask = uni.downloadFile({
        url: this.modelUrl,
        filePath: plus.io.convertLocalFileSystemURL('_doc/vosk-model-small-cn-0.22.zip'),
        success: (res) => {
          if (res.statusCode === 200) {
            console.log('模型下载成功', res.tempFilePath);
            this.modelPath = res.tempFilePath;
            this.modelDownloaded = true;
            
            uni.hideLoading();
            uni.showToast({
              title: '模型下载完成',
              icon: 'success'
            });
          }
        },
        fail: (err) => {
          console.error('模型下载失败', err);
          uni.hideLoading();
          uni.showModal({
            title: '下载失败',
            content: '语音模型下载失败，请检查网络后重试',
            confirmText: '重试',
            success: (res) => {
              if (res.confirm) {
                this.downloadModel();
              }
            }
          });
        }
      });
      
      // 监听下载进度
      downloadTask.onProgressUpdate((res) => {
        this.downloadProgress = res.progress;
        console.log('下载进度', res.progress + '%');
      });
    },
    
    // 修改原来的语音识别方法
    startRecognition() {
      if (!this.modelDownloaded) {
        uni.showToast({
          title: '模型未下载',
          icon: 'none'
        });
        return;
      }
      
      // 原来的语音识别代码
      // ...
    }
  }
}
</script>

<template>
  <view>
    <!-- 下载进度显示 -->
    <view v-if="!modelDownloaded" class="download-container">
      <text>正在下载语音模型...</text>
      <progress :percent="downloadProgress" show-info />
    </view>
    
    <!-- 原来的语音识别界面 -->
    <view v-else>
      <!-- ... -->
    </view>
  </view>
</template>
```

---

### **步骤3：更新插件代码，支持动态模型路径**

如果插件硬编码了模型路径，需要修改为接受外部传入的路径。

---

## 🎯 **优点**

- ✅ APK 大小减少 42MB
- ✅ 可以随时更新模型而不用重新打包
- ✅ 可以支持多个模型按需下载
- ✅ 用户可以选择下载时机（WiFi环境）

---

## ⚠️ **注意事项**

1. **服务器要求**
   - 需要有可访问的服务器存放模型文件
   - 建议使用 CDN 加速下载
   - 确保服务器支持大文件下载

2. **首次使用体验**
   - 首次使用需要下载 42MB
   - 建议在 WiFi 环境下载
   - 提供下载进度提示

3. **存储权限**
   - 确保 APP 有存储权限
   - 检查存储空间是否足够

---

## 📊 **效果对比**

| 项目 | 打包方案 | 运行时下载 |
|------|---------|-----------|
| APK大小 | ~100MB | ~58MB ✅ |
| 首次启动 | 即可使用 | 需下载 42MB |
| 更新模型 | 需重新打包 | 直接更新 ✅ |
| 灵活性 | 低 | 高 ✅ |

---

## 🚀 **快速实施**

如果现在着急打包，可以先：

1. **临时移除模型文件**
   ```
   移动 fronted_uniapp/static/vosk-model-small-cn-0.22.zip
   到桌面备份
   ```

2. **注释掉语音功能**
   ```vue
   <!-- 暂时隐藏语音按钮 -->
   <view v-if="false">
     语音识别按钮
   </view>
   ```

3. **先完成打包**

4. **之后再实施完整的运行时下载方案**

---