Smart Video macOS 安装指南

安装 Smart Video

1. 1

   先确认 Mac 芯片

   点击苹果菜单 →“关于本机”。看到 Apple M1/M2/M3/M4 即可安装；Intel 芯片不能使用当前安装包。

2. 2

   打开 DMG

   在“下载”文件夹中双击 SmartVideo_1.0.7_aarch64.dmg。系统询问时选择“打开”。

3. 3

   拖入“应用程序”

   把 Smart Video 图标拖到 Applications（应用程序）文件夹，复制完成后推出磁盘映像。

4. 4

   允许首次启动

   双击 Smart Video。出现“无法验证开发者”时，进入“系统设置 → 隐私与安全性”，找到被阻止说明并点击“仍要打开”。

注意：macOS 的首次安全确认通常只需要做一次。请先确认安装包来自可信渠道。

首次启动与模型配置

先让工作台正常启动，再配置模型。第一次测试建议从一个简单的英语知识点开始。

1. 1

   等待 Smart Video Studio 进入工作台

   第一次启动需要加载内置运行环境，通常等待几十秒。进入工作台后，可以先浏览模板库或创建项目。

2. 2

   打开“设置”并填写模型信息

   在 Agent / 模型配置区域填写 Base URL、API Key 和 Model。先点击“保存”，再点击“测试连接”。

   注意：Base URL 应填写兼容 Anthropic Messages API 的服务根地址。不要附加 /v1、/v1/messages 或 OpenAI chat/completions 地址。

3. 3

   确认配置只保存在本机

   模型配置路径：~/Library/Application Support/SmartVideo/data/agent-config.json

   请不要在聊天记录或截图中公开 API Key。

4. 4

   完成第一个视频测试

   • 创建一个简单主题，例如“用 30 秒讲清楚一个英语语法点”。
   • 确认 AI 能返回分镜，再选择模板预览画面。
   • 尝试只修改某一帧文案，熟悉局部调整。
   • 需要配音或音乐时再填写 MiniMax API Key；不配置音频也可以导出无配音视频。
   • 导出 MP4 前先预览全片，检查文案、画面比例、配音和字幕。

覆盖升级到新版本

1. 1

   完全退出 Smart Video

   在菜单栏或 Dock 中确认应用已经退出。

2. 2

   打开新版 DMG

   把新版 Smart Video 再次拖入“应用程序”。

3. 3

   选择“替换”

   系统询问时替换旧版本。

4. 4

   检查版本号

   启动新版，在设置或关于信息中确认版本号。

正常覆盖安装会保留项目、模型配置和日志。不要手动删除 SmartVideo 数据目录。

macOS 专项排查

1. 1

   提示“App 已损坏，无法打开”

   先确认安装包来源可靠，再请熟悉电脑操作的人打开“终端”，依次执行：

   xattr -dr com.apple.quarantine /Applications/Smart\ Video.app
   open /Applications/Smart\ Video.app

   注意：只对可信安装包执行，不要全局关闭 macOS 安全保护。

2. 2

   一直停留在启动中

   等待几十秒，不要连续点击。超过 2 分钟仍未进入工作台时，退出应用后重新打开。

3. 3

   模型测试连接失败

   • 确认电脑能访问模型服务。
   • 检查 Base URL、API Key 和 Model 是否属于同一服务商。
   • Base URL 不要附加 /v1 或 /v1/messages。
4. 4

   申请麦克风、文件或屏幕录制权限

   这些权限只在配音录制、素材读取或自动化任务中需要。按任务需要开启，不使用相关功能时可以关闭。