快速上手
- 新建项目:手机画面选竖屏,也可以选横屏或方形,都是 1080 画幅。
- 导入素材:先用几张不重要的图片、一小段视频或音乐。支持 PNG / JPEG / WebP、MP4 / WebM、WAV / MP3 / M4A,单个文件不超过 30 MiB。
- 加入剪辑:排好顺序,调整片段长短和音量。
- 更新预览:查看真正合成的画面和声音。
- 导出 MP4:核对设置并检查,确认导出后保存到你选择的位置,打开播放一遍。
导入只是把文件复制到本地工作区,不会上传。关闭导出窗口不会取消已开始的导出,可以在顶栏的任务里继续查看。
安装与视频工具
桌面试用版支持 macOS(Apple Silicon 与 Intel)。在下载页按芯片选择安装包,打开 DMG 并将 Mioon 拖到「应用程序」。
安装包不包含 FFmpeg 和 ffprobe。首次打开时可以点「下载并安装」,应用会校验下载的 7.1.5 版本。也可选择自己安装的工具,建议使用 7.1.5 或更新的完整功能构建,FFmpeg 4.4 不适用。
| 使用场景 | FFmpeg 需要提供 |
|---|---|
| 导出常见 MP4 | libx264、aac |
| 字幕与本地模拟画面 | subtitles、drawtext 滤镜和字体支持 |
| 颜色、响度分析与匹配 | zscale、loudnorm、ebur128 |
| 图片与缩略图 | PNG、WebP 编解码 |
已使用 Homebrew 的 Mac 可以安装完整版本,并显示工具位置:
brew install ffmpeg-full
echo "$(brew --prefix ffmpeg-full)/bin/ffmpeg"
echo "$(brew --prefix ffmpeg-full)/bin/ffprobe"使用自己的工具时,点「选择已安装的工具」,先选 ffmpeg 文件本身,再选 ffprobe。文件选择框里可以按 ⌘⇧G 粘贴上面得到的路径。之后可以在「设置 › 视频工具」查看状态。
系统阻止打开时,先确认文件来自官方发布页、架构选择正确。不要用删除隔离属性或关闭 Gatekeeper 的方式绕过。
画板、分镜与镜头
- 画板:摆放素材、文字和镜头,连接参考图,比较生成的版本。节点位置只是布局,不决定成片顺序。
- 分镜:按镜头顺序组织故事,「导出分镜」使用各镜头选中的版本。
- 版本:每次生成都是新版本,旧版本和当时的提示词都保留。「选用」决定镜头当前用哪个版本。
把图片连接为镜头的「首帧参考」后,生成会用到它;灰色的视觉连线只用于整理思路,不参与生成。
参考片可以在素材库右键「拆解镜头」,在本机检测切点,不产生费用。支持 MP4 和 WebM,最长 10 分钟。
剪辑与导出
- 剪辑界面:左侧素材库、中间大预览、右侧片段属性、下方多轨时间线。时间线按 30 帧 = 1 秒计算。
- 加入时间线的是固定版本。镜头之后改选新版本,时间线顶部会提示,点「全部更新」才会替换,并可一次撤销。
- 「时间线合成」预览由 FFmpeg 实际渲染,能听到片段音量、淡入淡出和混音;「源素材快速查看」只播放原文件。
导出设置
| 项目 | 可选 |
|---|---|
| 尺寸 | 原始(1080)、短边 720、短边 360 |
| 画质 | 小文件、标准、高画质,或固定码率 2000 / 4000 / 8000 kb/s |
| 固定参数 | MP4 · H.264 · AAC 128 kb/s · 30 fps |
打开导出窗口不会立即导出。先检查,检查通过后再确认;改了设置或时间线需要重新检查。导出记录保留每次的名称和规格,之后编辑时间线不会覆盖旧成片。
连接 Mio
- 打开右上角的设置,选择「Mio」。
- 选择服务商预设,确认接口地址、协议和模型,填入密钥后点「保存」。密钥可以选「系统加密保存」或「仅本次运行」。
- 点「测试连接」。测试只发送一条固定消息,不发送项目内容。
- 第一次发送时确认授权,弹窗会列出目标地址、模型、发送范围和费用提示。授权可以在「设置 › Mio › 已授权的模型」撤销。
执行方式、步数上限、撤销规则见 Mio 介绍。
连接生成服务
真实生成默认关闭,第一次试用可以先用「本地模拟」跑通流程。模拟画面带 SIMULATED MOCK 标识,不会按提示词生成真实内容。
需要真实生成时,在「设置 › 模型与服务」添加连接。每个连接有独立的地区和密钥,同一服务商的多个账号互不影响。
| 类型 | 可连接 |
|---|---|
| 视频 | 火山方舟 Seedance、Google Veo、MiniMax、Vidu、可灵、通义万相,以及兼容服务(HTTPS) |
| 图片 | OpenAI、兼容服务,以及本机的 ComfyUI |
生成服务可能按用量计费,费用计入你在该服务商的账户。付费生成默认需要逐次确认;停止等待不保证服务商取消请求或退款。结果未知时,先在任务中心核对,不要重复提交。
备份与恢复
项目默认保存在本机。正常打开和关闭项目时,Mioon 会尝试自动备份发生变化的项目,通常保留最近三份有效副本。
- 备份只包含
.mioon项目文件。素材、版本、Mio 对话和任务需要另行保管。 - 恢复会创建新项目并保留原项目。新项目仍引用原媒体,已经删除的媒体无法通过项目备份找回。
- 本版需要手动更新。更新前先保管项目文件、素材及需要的本机记录,正常退出 Mioon,再安装新版本。
恢复方式见项目自动备份说明。
常见问题排查
| 遇到的情况 | 先做什么 |
|---|---|
| 找不到工具或提示不是 FFmpeg | ffmpeg 和 ffprobe 要选已解压、可执行的文件本身 |
| 能打开,但字幕、颜色或导出失败 | 在「设置 › 视频工具」检查能力,多半是 FFmpeg 缺少滤镜,不是项目损坏 |
| 提示数据目录、权限或锁有问题 | 保留原数据,不要删除数据库、令牌或锁文件来绕过 |
| 生成失败或结果未知 | 保留原任务并查看详情,不要反复提交可能计费的同一操作 |
仍然无法解决,可以到 GitHub Issues 反馈,写明 Mioon 版本、系统、处理器、FFmpeg 版本、操作步骤和错误提示。截图前遮住密钥和私人内容。
