FilmCraft 技能用于通过 FilmCraft 的结构化自动化接口来操作用户指定的项目与序列，覆盖编辑、时间线、音频、调色以及导入导出的自动化。
用途与总体方式 该技能围绕 FilmCraft 的控制协议工作。在构造调用前，应阅读参考资料中的协议章节（references/control-protocol.md，为 2026-10-08 下载的未修改上游快照，含 MIT 许可）。桌面控制与 MCP 是两条主要路径：已打开的项目需要通过桌面桥接控制；无头会话是独立的进程内项目，无法编辑实时窗口。基于文件的无人值守任务应使用无头 MCP 或 CLI。
使用方式与示例 桌面控制与桥接示例（需按实际调整可执行文件路径与端口）： filmcraft --control 9876 filmcraft-cli mcp --bridge 127.0.0.1:9876
无头 MCP： filmcraft-cli mcp --project /absolute/path/project.fcproj
若不指定 --project 或 --demo，无头 MCP 会以空项目启动。UI 相关工具需要桥接模式。创建或使用本技能不会安装 FilmCraft，也不会注册 MCP 服务器；若不可用，应报告缺失的可执行文件或连接问题。
桌面 TCP 通道仅限本机回环且无认证，应仅在使用时开启。通信为原始 TCP（非 HTTP），每行一个 UTF-8 JSON 对象，含字符串 method、可选 params 与互不相同的请求 ID；读取回复并检查 ok。无效请求、超过 4 MiB 的行或过多连接可能导致连接关闭；出错后需重连再继续调用，且不要仅因连接关闭就重放不确定的修改操作。
检查与编辑 可通过 MCP 的 doc_inspect、project_inspect 与 sequence_inspect 识别项目条目、活动序列、轨道、片段、播放头、选区与效果；桌面控制下通过 engine.commands 发现检查命令，用 ui.inspect 检查 UI 状态。通过 MCP command_list 或桌面 engine.commands 获取命令 ID、参数文档与当前启用状态，并用 MCP command_run {id, params} 或桌面 engine.execute {command, params} 执行。优先使用文档中的显式 clips/clip 或 items/item 目标。命令注册表的启用状态基于选区，显示为禁用的命令仍可能接受显式目标，但其他前置条件依然适用。
时间使用整数 tick，每秒 254,016,000,000 ticks；有文档说明的秒、帧或时间码替代项时优先使用，切勿把秒填入 tick 字段。解释帧数前先检查序列帧率。使用真实轨道 ID 或既有名称（如 V1、A2），不存在的轨道会报错。移动片段前检查链接伙伴、锁定轨道与目标重叠；timeline.move 可能覆盖目标素材或以 insert 方式插入，链接伙伴默认按相同偏移移动，仅在确实只想移动指定片段时使用 linked: false，并核对返回的移动 ID 与最终时间（含音频同步与负序列时间的偏移）。替换编辑需检查 short 与 sourceInClamped 结果：成功替换可能保留最后一帧超出可用素材，或钳制保留的源入点。动态修剪操作需按文档以秒提供时钟，并在继续前完成或取消修剪手势。涉及混音自动化、闪避、LUT 或 HDR 时阅读音频或调色章节，并保留无关的序列设置。
对话框与手势方面，检查 ui.elements 并优先使用返回的稳定元素 ID；用 ui.set 设置文档化的对话框与视图字段，用 ui.timeline.locate / ui.timeline.hit 定位时间线；布局变化后重新检查。ui.type 作用于当前聚焦字段，只有 ui.focus 会显式夺取用户键盘焦点，仅当任务需要激活时调用。
保存、导出与验证 打开、保存或导出前先发现已安装的文件命令及参数。适当情况下将可编辑项目保存为 .fcproj，并遵循请求的输出路径与格式。一次性 CLI 编辑要持久化，需要配合 --project 使用 --save，或使用 --save-as <path>；不要把仅内存中的修改报告为已保存项目。已知命令序列可使用批处理，除非有意在失败后继续，否则设置 stop_on_error: true；批处理失败后检查各步骤结果与最终项目再决定后续。
file.exportMedia 中，wait: true 会等待完成；否则保留返回的任务 ID 并通过 jobs.list 轮询直至完成或失败，需要时用 jobs.cancel 取消特定任务。MCP 中取消等待中的导出会删除部分输出。依赖前先确认已安装版本支持进度与取消。超时或回复丢失后，先检查项目/任务状态与输出再重试；无法安全重试时应停止并报告不确定的结果。
验证方面，检查最终序列状态并查看代表性渲染帧或截图；MCP 的 render_frame / render_preview 可无头渲染，或在桥接模式下捕获节目监视器而不改变播放头与选区。桌面截图在 10 秒内无呈现帧时可能失败，应区分捕获失败与编辑失败。音频编辑还应检查播放或可用时的导出音频样本。最终报告保存路径、导出完成情况以及缺失素材、源范围被钳制、未完成任务等素材警告。
限制 本技能需要用户已安装 FilmCraft 并提供可执行文件与连接；不负责安装或注册 MCP 服务器。桌面通道仅限本机且无认证，应谨慎短时开启。无头会话不能编辑实时桌面窗口。若已安装行为与文档不同，应查看已安装的命令注册表与工具 schema，而非臆造参数。资料未提供具体的系统平台要求与收费信息。