fcpx-assistant

# Final Cut Pro 助手 全自动视频生产线 + FCP 日常剪辑助手。 ## 核心工作流 ``` 主题 💡 → AI 文案 📝 → 搜素材 🔍 → TTS 配音 🎤 → 自动成片 🎞️ → 调色 🎨 → B-roll 🎬 → 发布 🚀 ``` ### 一键全流程 ```bash bash scripts/auto-video-from-topic.sh \ --topic "如何制作一杯完美的咖啡" \ --publish bilibili \ --title "咖啡教程" --tags "咖啡，教程" ``` ### 分步执行 **Step 1: AI 文案** — 根据主题生成分镜脚本 + 配音文本 + 素材关键词 ```bash bash scripts/ai-script-generator.sh --topic "主题" --style 教程 --duration 90 --keywords ``` **Step 2: 搜集素材** — 从 Pexels/Pixabay 下载免费素材 ```bash bash scripts/media-collector.sh --keywords "nature ocean sunset" --count 5 --output ./my-project ``` **Step 3: 背景音乐** — 把 BGM (mp3/wav/m4a) 放入 `./my-project/music/` ```bash bash scripts/music-collector.sh --keywords "轻松 愉快" --count 3 --output ./my-project/music ``` **Step 4: TTS 配音** — edge-tts 生成配音（免费、稳定、支持多声线） ```bash 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 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 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 bash scripts/auto-broll-insert.sh final.mp4 ./broll/ output.mp4 --script script.txt --transition fade ``` 自动在场景转换处插入，支持文案关键词智能匹配。 **Step 8: 发布** ```bash bash scripts/auto-publish.sh --video final.mp4 --platform bilibili --title "标题" --tags "标签" ``` 支持 bilibili / youtube / tiktok / xiaohongshu。配置详情见 [references/publishing.md](references/publishing.md)。 --- ## 项目目录结构 ``` my-project/ ├── videos/ ← 素材（Step 2 自动填充） ├── music/ ← BGM（Step 3） ├── voiceover/ ← 配音（Step 4 自动生成：vo_000.wav, vo_001.wav...） └── meta/ ← 元数据（自动生成） ``` --- ## FCP 项目管理 ```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 # 时间追踪 osascript scripts/create-script.scpt "标题" "内容" # 创建文案 osascript scripts/list-scripts.scpt # 列出文案 ``` ## 剪辑辅助 ```bash 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 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 bash start-webui.sh # 启动后访问 http://localhost:7861 ``` 一键成片界面，含实时进度条、分步工具、项目历史、调色/B-roll 控制。 --- ## 参考文档 - **风格预设 & 所有参数**: [references/styles-options.md](references/styles-options.md) - **平台发布配置**: [references/publishing.md](references/publishing.md) - **依赖安装 & TTS 部署**: [references/dependencies.md](references/dependencies.md) ## 必需依赖速查 ffmpeg (drawtext) · osascript · curl · jq · edge-tts (pipx install edge-tts) · whisper (brew install openai-whisper) 安装详情见 [references/dependencies.md](references/dependencies.md)。