fcpx-assistant（fcpx 助手）

Final Cut Pro 助手

全自动视频生产线 + FCP 日常剪辑助手。

核心工作流

主题 💡 → AI 文案 📝 → 搜素材 🔍 → TTS 配音 🎤 → 自动成片 🎞️ → 调色 🎨 → B-roll 🎬 → 发布 🚀

一键全流程

bash scripts/auto-video-from-topic.sh \
    --topic "如何制作一杯完美的咖啡" \
    --publish bilibili \
    --title "咖啡教程" --tags "咖啡，教程"

分步执行

Step 1: AI 文案 — 根据主题生成分镜脚本 + 配音文本 + 素材关键词

bash scripts/ai-script-generator.sh --topic "主题" --style 教程 --duration 90 --keywords

Step 2: 搜集素材 — 从 Pexels/Pixabay 下载免费素材

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

Step 3: 背景音乐 — 把 BGM (mp3/wav/m4a) 放入 ./my-project/music/

bash scripts/music-collector.sh --keywords "轻松 愉快" --count 3 --output ./my-project/music

Step 4: TTS 配音 — edge-tts 生成配音（免费、稳定、支持多声线）

bash scripts/tts-voiceover.sh --script-file ./script.txt --output ./my-project/voiceover --merge
# 可选声音：--voice zh-CN-YunxiNeural (男) / zh-CN-XiaoxiaoNeural (女)

Step 5: 自动成片 — 素材 + 配音 + 字幕 + BGM 组装成完整视频

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 自动降到 15%、fade 转场、自动清理中间文件。

Step 6: 调色（可选）

bash scripts/auto-color-grade.sh final.mp4 final-graded.mp4 --style cinematic --intensity 0.7

风格：natural / cinematic / vintage / fresh / warm / cool

Step 7: B-roll 插入（可选）

bash scripts/auto-broll-insert.sh final.mp4 ./broll/ output.mp4 --script script.txt --transition fade

自动在场景转换处插入，支持文案关键词智能匹配。

Step 8: 发布

bash scripts/auto-publish.sh --video final.mp4 --platform bilibili --title "标题" --tags "标签"

支持 bilibili / youtube / tiktok / xiaohongshu。配置详情见 references/publishing.md。

项目目录结构

my-project/
├── videos/     ← 素材（Step 2 自动填充）
├── music/      ← BGM（Step 3）
├── voiceover/  ← 配音（Step 4 自动生成：vo_000.wav, vo_001.wav...）
└── meta/       ← 元数据（自动生成）

FCP 项目管理

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  # 时间追踪
osascript scripts/create-script.scpt "标题" "内容"  # 创建文案
osascript scripts/list-scripts.scpt           # 列出文案

剪辑辅助

bash scripts/scene-detect.sh video.mp4          # 场景检测
bash scripts/auto-rough-cut.sh video.mp4         # 自动粗剪（去静音）
bash scripts/smart-tagger.sh ./media/            # 智能标签
bash scripts/auto-chapter-marker.sh video.mp4    # 自动章节标记
bash scripts/audio-normalizer.sh video.mp4       # 音频标准化 (-23 LUFS)
bash scripts/auto-voiceover.sh "文本" out.wav     # 单文件配音 (edge-tts)
bash scripts/multi-lang-subtitles.sh video.mp4 en  # 多语言字幕 (Whisper)
bash scripts/auto-thumbnail.sh video.mp4 ./thumbs  # 关键帧缩略图

新功能

bash scripts/auto-bgm-match.sh -v video.mp4 -m ./bgm/ -o output.mp4   # 智能 BGM 匹配
bash scripts/multi-platform-export.sh video.mp4 -p tiktok bilibili     # 多平台适配导出
bash scripts/subtitle-styler.sh --srt sub.srt --style cinematic        # 字幕样式增强
bash scripts/video-analyzer.sh video.mp4                                # 视频质量分析
bash scripts/intro-outro-generator.sh --title "标题" --type intro       # 片头片尾生成
bash scripts/cover-generator.sh --video video.mp4 --title "标题" --all  # 封面图生成

Web UI

bash start-webui.sh   # 启动后访问 http://localhost:7861

一键成片界面，含实时进度条、分步工具、项目历史、调色/B-roll 控制。

参考文档

• 风格预设 & 所有参数: references/styles-options.md
• 平台发布配置: references/publishing.md
• 依赖安装 & TTS 部署: references/dependencies.md

必需依赖速查

ffmpeg (drawtext) · osascript · curl · jq · edge-tts (pipx install edge-tts) · whisper (brew install openai-whisper)

安装详情见 references/dependencies.md。