- name
- fcpx-assistant
- description
- Final Cut Pro X (FCPX) 助手 — 全自动视频生产（从主题到发布）、TTS 配音、素材搜集、自动成片、调色、B-roll 插入、FCP 项目管理、剪辑辅助。触发词: FCPX, FCP, Final Cut, 做视频, 自动成片, 配音, voiceover, 素材, 导入素材, 导出, 发布视频, 调色, B-roll, 视频制作, make video, auto video, import media, export, color grade, publish
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 --keywordsStep 2: 搜集素材 — 从 Pexels/Pixabay 下载免费素材
bash scripts/media-collector.sh --keywords "nature ocean sunset" --count 5 --output ./my-projectStep 3: 背景音乐 — 把 BGM (mp3/wav/m4a) 放入 ./my-project/music/
bash scripts/music-collector.sh --keywords "轻松 愉快" --count 3 --output ./my-project/musicStep 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。