FilmCraft 是一个开源 Rust 视频编辑器。本技能提供基于上游固定提交（1fdfd8324db4aa23b08c69f518b086e632f75f84）的操作指引，资料检查日期为 2026-10-12。
用途 当用户提到 FilmCraft、filmcraft-cli、.fcproj、FilmCraft MCP 服务器或其控制通道时使用。适用于本地时间线编辑、项目/序列检查、媒体导入、预览渲染、导出以及 FilmCraft 自动化。若是可编程/模板化视频生成、OpenCut 仓库或 Palmier Pro 相关工作，应改用对应技能，不要从其他工具推断 FilmCraft 的无头 API。
主要能力 可通过无头 CLI/MCP 后端（--demo、--project /abs/project.fcproj 或空会话）或桌面桥后端（先 filmcraft --control 9876，再 filmcraft-cli --bridge 127.0.0.1:9876 或 MCP 桥模式）操作。桥通道仅限回环、无认证，应在需要时开启。MCP 模式下不要同时使用 --bridge 与 --project 或 --demo，桥后端优先且会静默忽略这些项目/演示标志。支持检查（inspect 项目或序列）、命令描述（commands/describe）、执行修改（exec/run 或 MCP command_run/command_batch）、渲染帧（render_frame）、桌面截图（ui_screenshot）、保存/导出，以及文档化的撤销命令。
使用方式 先检查二进制（filmcraft-cli --version）或确认源码检出与固定提交。动手前先 inspect，用 commands/describe 确认 id、参数、启用状态、媒体路径、后端和当前项目，解决目标不匹配后再修改。修改前确认用户已明确授权具体操作和路径；仅当缺少同意、目标不明确或操作新出现破坏性时才询问。修改后再次 inspect，并用 render/MCP render_frame 或桥 ui_screenshot 验证；结果不对时先用文档化撤销命令。保存/导出仅限授权路径，检查覆盖，报告确切路径和警告，不得隐瞒离线媒体或部分输出。示例命令包括 filmcraft-cli --demo inspect、filmcraft-cli --project /abs/project.fcproj commands、filmcraft-cli --project /abs/project.fcproj describe sequence.inspect、filmcraft-cli --project /abs/project.fcproj import /abs/clip.mov --save-as /abs/copy.fcproj、filmcraft-cli --project /abs/project.fcproj render --seconds 2 --out /abs/frame.png、filmcraft-cli --project /abs/project.fcproj export /abs/out.mp4 --format h264、filmcraft --control 9876、filmcraft-cli mcp --bridge 127.0.0.1:9876、filmcraft-cli mcp --project /abs/project.fcproj。示例路径仅为示意，须确认授权覆盖确切操作和路径并检查覆盖。
适用场景 本地时间线编辑、项目与序列检查、媒体导入、预览渲染、导出及 FilmCraft 自动化。
限制 FilmCraft 处于 alpha 阶段；上游路线图估计功能广度约 86%、实际工作就绪度约 56%（2026-10-10）。不支持 .prproj，应使用文档化的 FCP7 XML、AAF 或 OTIO 交换格式。没有插件托管、没有 AV1 导出，发布版语音转文本默认关闭。缺失或离线媒体可能渲染占位符；导出会报告 offlineMedia，CLI 退出码为 1（除非显式允许），不得将其视为成功的媒体渲染。资料未验证 filmcraft doctor、远程服务、文件夹限制标志或生产支持，不应声称存在。更多细节见 references/cli-mcp.md、control-channel.md、project-files.md、troubleshooting.md、upstream-evidence.md。