Python 运行环境 必装
口播本地服务依赖的 Python 与 wheel 依赖，不含模型权重。版本与当前客户端一致。
客户端下载
1.优化用户体验交互
系统要求 · macOS
- macOS 12 Monterey 或更高
- Apple Silicon（M 系列）或 Intel 64 位
- 4 GB 内存及以上（推荐 8 GB）
- 2 GB 可用磁盘空间
安装步骤
- 下载 macOS 安装包并解压
- 将 魔媒师AI.app 拖入「应用程序」文件夹
- 若提示无法打开，请在「系统设置 → 隐私与安全性」中允许
- 使用官网账号登录
芯片架构
正式版 v1.9.0开发版已至 v1.9.6
MMSAI_1.9.0_aarch64.dmg
文件大小 约 47.9 MB
SHA2568a2a13798208824c247a99ab26d71739176baa2243d0df69fa80b95b863b055a
macOS 安装帮助
安装包打不开？按提示选择解决方案
以下操作仅适用于从 魔媒师AI 官网下载的安装包。建议先重新下载，并核对上方文件大小或 SHA256。
1提示“已损坏，无法打开”最常见：macOS 隔离属性拦截
先将 MMSAI 拖入“应用程序”，再打开“终端”，粘贴并执行下面的命令，然后重新打开应用。
sudo xattr -rd com.apple.quarantine /Applications/MMSAI.app请勿对来源不明的应用执行此命令。若仍提示损坏，请删除安装包后重新下载。
2提示“无法验证开发者”或“无法打开”通过系统设置允许本次打开
在“应用程序”中按住 Control 点击 MMSAI，选择“打开”；或前往“系统设置 → 隐私与安全性”，找到被拦截的 MMSAI，点击“仍要打开”。
3安装后无法使用麦克风、文件或屏幕录制补充应用所需系统权限
前往“系统设置 → 隐私与安全性”，分别检查麦克风、屏幕与系统音频录制、文件与文件夹权限；开启 MMSAI 后退出并重新启动应用。
4安装包无法运行或提示架构不兼容确认 Apple 芯片或 Intel 版本
点击左上角苹果菜单 →“关于本机”，查看“芯片”或“处理器”。M1 / M2 / M3 / M4 请选择 Apple Silicon，Intel 处理器请选择 Intel。
扩展插件包
主客户端不含口播等本地算力资源。可按系统下载 Python 运行环境与模型包，或在客户端「设置 → 插件市场」一键安装。
口播插件
本地语音合成、数字人口播与唇形同步。需安装 Python 运行环境与口播模型资源包（与主客户端分开下载）。
当前系统macOS·芯片架构
口播模型资源包 必装
CosyVoice + Wav2Lip 等权重整包。解压到客户端口播数据目录的 models/ 下，或在客户端「设置 → 插件 → 口播插件 → 安装模型」自动下载同一套资源。
安装教程
适用于官网手动下载扩展包，或在客户端自动安装失败时排障。
准备主客户端
先从下载页安装对应系统的 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 服务。
也可在客户端口播模块试生成一段短音频/视频验证。
仍失败请查看运行日志，或联系微信客服并说明系统版本与已下载的文件名。
