Final Cut Pro 助手

一个全自动的视频制作流水线——从脚本到成片。同时也是你日常的 FCP 剪辑助手。

🔥 核心功能：AI 自动视频制作

一条流水线。输入脚本，输出视频。

完整工作流

脚本 📝 → 获取素材 🔍 → TTS 配音 🎤 → 自动合成 🎞️ → 发布 🚀

第一步：获取视频素材

根据关键词自动搜索并从 Pexels 下载免费素材视频。

bash
bash scripts/media-collector.sh \
--keywords nature ocean sunset \
--count 5 --output ./my-project

• - 多关键词搜索（分别搜索每个词，然后合并结果）
• 方向（横屏/竖屏/方形）、质量（SD/HD/4K）、时长筛选
• 自动保存元数据和许可信息
• 设置 PEXELSAPIKEY 以扩展搜索功能

第二步：添加背景音乐

将你的 BGM 文件（mp3/wav/m4a）放入项目的 music/ 文件夹。合成器会自动检测到它们。

my-project/
├── videos/ ← 素材视频（由第一步自动填充）
├── music/ ← 你的 BGM 放在这里
└── meta/ ← 元数据（自动生成）

第三步：TTS 配音

使用 Qwen TTS 逐段生成配音。

bash
bash scripts/tts-voiceover.sh \
--script 第一段
第二段
第三段 \
--output ./my-project/voiceover

• - 逐段生成，自动修剪静音
• 可通过 --instruct 自定义声音（例如：温暖的女声，语速适中）
• 也可从文件读取：--script-file ./script.txt
• 需要 Qwen TTS WebUI 运行在 localhost:7860

第四步：自动合成

将素材、配音、字幕和 BGM 合成为完整的视频。

bash
bash scripts/auto-video-maker.sh \
--project ./my-project \
--script-file ./script.txt \
--voiceover ./my-project/voiceover \
--style vlog \
--output final.mp4

智能特性：

• - 📝 脚本按段落拆分，每段对应一个视频片段
• 🎤 片段时长自动与配音时间同步（当可用时）
• 📝 使用 PingFang SC 字体烧录字幕（位置/大小可调）
• 🎵 智能音频混合——配音 + BGM（BGM 自动降低至 15% 音量）
• 🎬 片段间淡入淡出转场
• 📐 统一分辨率（默认 1920x1080，支持竖屏 1080x1920）

风格预设：

更多选项：
bash
--resolution 1080x1920 # 竖屏模式
--no-subtitle # 无字幕
--subtitle-pos center # 字幕居中（默认：底部）
--font-size 50 # 自定义字号
--music ./specific.mp3 # 指定 BGM 文件
--transition none # 无转场

📂 FCP 项目管理

自动化日常 Final Cut Pro 任务。

bash
osascript scripts/check-fcp.scpt # 检查 FCP 状态
osascript scripts/list-projects.scpt # 列出所有项目
osascript scripts/open-project.scpt 名称 # 打开项目
osascript scripts/import-temp-media.scpt # 导入临时素材
osascript scripts/project-time-tracking.scpt # 时间追踪

✂️ 剪辑辅助

bash
bash scripts/scene-detect.sh video.mp4 # 场景检测
bash scripts/auto-rough-cut.sh video.mp4 # 自动粗剪（去除静音）
bash scripts/smart-tagger.sh ./media/ # AI 智能标签
bash scripts/auto-chapter-marker.sh video.mp4 # 自动章节标记

🔊 音频处理

bash
bash scripts/audio-normalizer.sh video.mp4 # 标准化至 -23 LUFS
bash scripts/auto-voiceover.sh 文本 out.wav # 单文件配音

🌍 字幕

bash
bash scripts/multi-lang-subtitles.sh video.mp4 en # 多语言（en/ja/ko/fr/de/es）

🖼️ 其他工具

bash
bash scripts/auto-thumbnail.sh video.mp4 ./thumbs # 关键帧缩略图 + 联系表
osascript scripts/create-script.scpt 标题 内容 # 在备忘录中创建脚本
osascript scripts/list-scripts.scpt # 列出脚本

系统要求

• - 必需：macOS, ffmpeg（含 drawtext/libass）, osascript
• TTS：Qwen TTS WebUI（localhost:7860）
• 素材搜索：互联网（Pexels API，免费）
• 推荐：brew install homebrew-ffmpeg/ffmpeg/ffmpeg（包含 drawtext + libass）

中文版

Final Cut Pro 助手

从脚本到成片的全自动视频制作流水线。同时也是你日常的 FCP 剪辑助手。

🔥 核心功能：AI 自动视频制作

一条流水线。输入脚本，输出视频。

完整工作流

脚本 📝 → 获取素材 🔍 → TTS 配音 🎤 → 自动合成 🎞️ → 发布 🚀

第一步：获取视频素材

根据关键词自动搜索并从 Pexels 下载免费素材视频。

bash
bash scripts/media-collector.sh \
--keywords nature ocean sunset \
--count 5 --output ./my-project

• - 多关键词自动逐词搜索
• 支持方向（横屏/竖屏/方形）、质量（SD/HD/4K）、时长范围筛选
• 自动保存素材元数据和版权信息
• 设置 PEXELSAPIKEY 解锁更多搜索能力

第二步：准备背景音乐

把你找的 BGM 放到项目的 music/ 目录即可，成片时自动检测。

my-project/
├── videos/ ← 素材（第一步自动填充）
├── music/ ← 你的 BGM 放这里（mp3/wav/m4a）
└── meta/ ← 元数据（自动生成）

第三步：TTS 配音

用 Qwen TTS 为每段文案生成配音。

bash
bash scripts/tts-voiceover.sh \
--script 第一段文案
第二段文案
第三段文案 \
--output ./my-project/voiceover

• - 逐段生成，自动修剪首尾静音
• 声音特征可自定义（--instruct）
• 也支持从文件读取：--script-file ./script.txt
• 需要 Qwen TTS WebUI 运行在 localhost:7860

第四步：自动成片

把素材、配音、字幕、BGM 全部组装成完整视频。

bash
bash scripts/auto-video-maker.sh \
--project ./my-project \
--script-file ./script.txt \
--voiceover ./my-project/voiceover \
--style vlog \
--output final.mp4

智能特性：

• - 📝 文案按段落拆分，每段对应一个视频片段
• 🎤 有配音时，片段时长自动匹配配音节奏
• 📝 PingFang SC 简体中文字幕烧入（位置/大小可调）
• 🎵 配音 + BGM 智能混合（BGM 自动降低到 15% 音量）
• 🎬 fade 转场效果
• 📐 统一分辨率（默认 1920x1080，支持竖屏 1080x1920）

风格预设：