filmcraft-editor 是 filmcraft 系列中的编辑器接入技能，核心用途是在宿主环境中呈现 filmcraft 的真实编辑界面，并把当前任务工作区与之连接。它适合需要在同一页面内由 Agent 操作、用户同步观看编辑过程的场景。
主要能力围绕一组工具展开。open_editor 用于打开编辑器，首次调用需传入任务工作区的绝对路径；open_browser_editor 用于宿主未自动呈现面板时获取 editorUrl；open_in_codex 可在 Codex Desktop 中以 target 为 browser、url 为实际返回值的方式打开；editor_status 用于确认页面状态；command_list 读取当前 Web 引擎可用命令，command_run 在可见页面执行命令，inspect 用于核对结果；open_file 导入素材，list_files 检查导出文件，save_project 与 save_file 将成果写入工作区新路径。
使用方式上，宿主支持原生 MCP Apps 时会呈现 ui://filmcraft/panel.html；仅有工具文字结果并不代表界面已打开。同一实例只应打开一个编辑页，需等待 attached 或 ready 为 true 后再继续操作，加载失败应先处理页面错误。本轮所有编辑必须使用同一服务，原生 CLI 与 Web 编辑器并非同一内存文档，切换前必须保存并显式重开。若宿主仅支持 MCP，可在外部浏览器打开同一 editorUrl，但这不属于宿主内嵌验收。开发候选缺少 ui/dist/adapter.mjs 时需按插件 ui/README.md 构建；工具未注册时，可在得到插件实际目录后于项目终端运行 node ui/dist/adapter.mjs --serve，并通过环境变量 CRAFT_WORKSPACE_ROOT 指定工作区，同时保持进程存活，自动化仍须连接对应 MCP 实例。
适用场景包括需要在支持 MCP Apps 或内置浏览器的宿主中协同查看编辑界面、导入素材、执行引擎命令、核对状态并保存工程。限制方面：该技能独立安装不附带编辑器服务，需要安装配套插件或配置其 MCP 后端；浏览器存储、预览截图和已提交渲染任务不等于工作区交付，完成后应保存工程、重开检查并读取实际导出文件；不应猜测固定端口或任意缓存路径，也不应绕过校验。