口播插件手动安装指南

准备主客户端

先从下载页安装对应系统的 MMS AI 桌面客户端并完成登录。

确认版本号与扩展包文件名中的 v 版本一致（如 v1.1.0）。

下载扩展制品

在下载页「扩展插件包 → 口播插件」中，按当前系统与芯片架构下载两项：Python 运行环境包、口播模型资源包。

macOS 用户：M 系列芯片选 Apple Silicon（aarch64），Intel Mac 选 x86_64。

下载完成后建议核对 SHA256（页面提供时）。

安装 Python 运行环境

打开客户端「设置 → 插件市场 → 口播插件」，查看「安装路径」所示数据目录。

将 python-runtime-*.tar.gz 解压到该目录下的 runtime/（若不存在请新建）。

解压后目录内应包含可执行的 Python 与依赖，无需再单独安装系统 Python。

安装口播模型资源包

将 oral-models-*.tar.gz 解压到同一数据目录下的 models/。

目录结构应与客户端「安装模型」自动下载后一致（含 pretrained_models 等子目录）。

若已部分下载，可只解压缺失文件，或在客户端点击「安装模型」补全校验。

启动与验证

返回口播插件页，点击「刷新」确认模型已就绪，再点击「启动」拉起本地 8020 服务。

也可在客户端口播模块试生成一段短音频/视频验证。

仍失败请查看运行日志，或联系微信客服并说明系统版本与已下载的文件名。