Appearance
🚀 快速开始
只要 3 步，即可完成 Vynaro 桌面端 的安装、大模型 API 密钥配置与环境准备，开启自动化的短剧解说与视频剪辑流程。
📦 第一步：下载与安装桌面端
从 GitHub Releases 下载适合您操作系统的预编译安装包：
| 操作系统 | 安装包格式 | 安装与安装后权限说明 |
|---|---|---|
| Windows | .msi / .exe | 双击运行安装向导，自动关联 .draft 导出协议 |
| macOS | .dmg | 拖拽至 Applications。首次启动如提示开发者未验证，请前往「系统设置 → 隐私与安全性 → 仍要打开」 |
| Linux | .AppImage / .deb | 赋予可执行权限 chmod +x 后直接运行 |
💡 如果您是开发者并希望从源码构建，请参考 安装指南。
🗝️ 第二步：配置 LLM 与 TTS 秘钥
启动 Vynaro，点击左侧导航栏的 ⚙️ 设置 (Settings) → AI 配置，输入至少一个 AI 大模型与 TTS 服务的 API Key：
- LLM 供应商：支持通义千问 (Qwen)、DeepSeek R1、GPT-4o、Claude 3.5、Kimi 等 11 大服务商。
- API Key：粘贴您的 API 秘钥（秘钥通过 macOS Keychain / Windows Credential Manager 安全加密存储在本地）。
- 测试连接：点击「连通性测试」按钮，确认 API Key 响应正常。
常用 LLM 秘钥获取地址
- 🇨🇳 DeepSeek — platform.deepseek.com
- 🇨🇳 通义千问 (Aliyun Bailian) — bailian.console.aliyun.com
- 🇺🇸 OpenAI / GPT-4o — platform.openai.com
- 🇨🇳 Kimi (月之暗面) — platform.moonshot.cn
🎞️ 第三步：确认本地 FFmpeg 探针可用
Vynaro 核心底层使用 FFmpeg 进行场景切片、情绪检测与音画混流。桌面端内置探针，也可识别系统级 FFmpeg：
bash
# 在终端中验证 FFmpeg 版本：
ffmpeg -version
# 输出应当包含: ffmpeg version 6.0 或更高的版本信息若您的系统尚未安装 FFmpeg：
- macOS：
brew install ffmpeg - Windows：
winget install ffmpeg或下载后添加到 PATH 环境变量 - Linux：
sudo apt update && sudo apt install ffmpeg
🎬 创作您的第一条 AI 视频解说
环境准备就绪后，按照 7 步流水线开启创作：
- 📥 素材导入：点击「新建项目」，导入一段短剧或电影视频片段 (
.mp4/.mov)。 - ✂️ 智能拆条：点击「扫描场景切片」，AI 将根据镜头突变与情绪峰值自动打点。
- 🤖 脚本生成：选择角色语气（如【悬疑解说】或【吐槽风】），一键生成第一人称 Hook 与主体独白。
- 🎙️ 配音与对齐：选择 Edge-TTS 音色或零样本克隆，自动对齐 SRT 字幕（偏差 < 50ms）。
- 📤 草稿导出：点击「导出」，原生生成剪映工程草稿 (
.draft) 或 9:16 竖屏 1080P 成片！
❓ 常见问题快速排查
| 现象 / 报错 | 常见原因 | 解决方法 |
|---|---|---|
| API Key 报 401 Unauthorized | 秘钥复制不完整或包含首尾空格 | 重新从服务商控制台复制并点击「连通性测试」 |
拆条提示 FFmpeg executable missing | 系统 PATH 未找到 ffmpeg 可执行文件 | 按照第三步安装 FFmpeg 并重启 Vynaro |
| TTS 生成极慢或超时 | 网络波动或代理设置影响 | 在设置中开启【Edge-TTS 备用节点】或使用本地克隆 |