下载与安装

Mosael 是本地优先的桌面应用：本地素材剪辑与导出可离线。工作流是否需要联网取决于节点；远端 AI 需配置服务商或授权登录，本地转写和本机声音克隆需先下载模型(克隆的音色也能交给百炼 CosyVoice 念，不用下载)。

下载#

两条路下载的是同一份安装包:

应用启动后会静默比对 Releases 的最新稳定版，发现新版会提示前往下载；设置 → 本机应用 → 版本 里也有 「检查更新」按钮。GitHub 预发布版不会主动推送，需要从 Releases 页面明确选择下载。

• 内置后端引擎与 ffmpeg，开箱即用。
• 本地转写 / 声音克隆 / 人声分离的运行环境由部署管理员在「管理 → 引擎」里装(桌面版上你就是部署管理员)，部分模型权重首次使用时按需下载；合计数百 MB 至数 GB，建议预留 10GB+ 磁盘。

从源码运行(开发)#

仓库根目录：

pnpm install
pnpm dev          # 起后端 + 前端 + Electron

打包桌面版：

pnpm build:mac    # 前端 + 边车 + 发布器 + 后端(PyInstaller)+ .app
pnpm dist:mac     # 同流程,产出 .dmg(分发时用)

macOS 本地打包需要签名证书、描述文件与公证凭据，配置步骤见仓库的 macOS 签名说明。

正式发版由 CI 完成：维护者推送 v* tag，GitHub Actions 自动打包 macOS / Windows 双平台并挂到 Releases。带 -beta1 等后缀的 tag 保持为预发布，不会覆盖当前稳定版（详见仓库 README）。

数据在哪#

默认本地模式下，账号、项目、素材与后端配置保存在 ~/.mosael(Windows:C:\Users\<你>\.mosael),app 本体之外——升级 / 重装不丢数据。「管理 → 部署设置 → 数据与诊断」可以做完整备份、从备份恢复。

界面主题、背景与字体在「设置 → 外观」中调整，详见外观与字体。连接远程后端时，工程数据保存在远端；升级前建议备份所用后端的数据目录。

下一步：快速上手。