操作前准备
- 已安装并打开 SunGet 客户端
- 网络可访问 sherpa-onnx 官方模型发布地址
分步操作
打开设置中的语音转写分组
进入设置页，找到标题为「语音转写」的面板，其中「2. 本地模型设置」会显示 SenseVoiceSmall INT8 当前状态。
点「下载并校验模型」
状态行显示「模型尚未准备好」时，该分组会出现「下载并校验模型」按钮；点击后开始从官方稳定通道下载，进度条与状态文字实时刷新（如「正在下载 SenseVoiceSmall INT8 模型…」「正在解压并校验模型…」）。
等待校验完成
下载完成后程序自动解压、比对三个文件的字节数与 SHA-256，全部通过后状态变为「正常（本机下载）」或「正常（App 内置）」，此时即可开始本地转写。
下载中断或校验失败
下载过程中可点「取消更新」中止；若状态变成「完整性校验失败」，按界面提示删除损坏目录后重新点「下载并校验模型」，或点「检查并更新」从官方通道重新安装。需要时可用「打开插件位置」按钮在资源管理器中查看模型目录。
预期结果
状态行显示 SenseVoiceSmall INT8「正常」，视频库的「批量识别语音」可以直接以本地模式执行。
异常与解决
下载到一半提示「模型文件 SHA-256 校验值不匹配」
可能原因：网络中断、代理改写或文件不完整导致下载内容与官方发布的哈希不一致。
解决方法：程序会丢弃临时文件；重新点「下载并校验模型」即可，已通过校验的缓存不会被重复校验。
点「下载并校验模型」没有反应
可能原因：上一次下载仍在后台进行。
解决方法：界面出现「取消更新」按钮说明下载进行中；等它完成或先取消后再重新触发。
注意事项
- 模型目录位于用户数据目录下的 models/SenseVoiceSmall；程序同时校验安装包内置资源（App 内置）与本机下载两份来源，优先使用本机下载。
- 下载使用约 2 小时总超时；模型本体约 163MB 压缩包加约 640KB 的 VAD 模型，实际安装后约 240MB。
- 不要手动替换模型文件——大小或哈希不符会被直接判为「完整性校验失败」。