用途:在 Codex 使用 ChatCut 插件(chatcut MCP 服务器)时,创建、手写、修补或放置动效图形(Motion Graphic)JSX 资产。适用于 Web 编辑器项目,需使用用户编辑器 URL 或插件项目结果中的项目 ID;不使用 ChatCut Desktop 或 chatcut_desktop。若 chatcut 工具不可用,应报告连接失败,不得改由编辑器原生 Agent 代办。
主要能力与流程:
- 设计前先浏览参考。生产环境沿用已接受的项目风格或用户提供的品牌/参考;需要新方向时用 browse_library references: {view: "style-overview"} 读取全部编号 contact sheets,按 nextOffset 读全;list_presets 只是旧目录子集,不能替代视觉总览。
- 语音主导视频需先理解口播内容并检查代表性画面帧,候选风格不超过 6 个并展示实际 heroPreview.url 图片,等待用户选择后再套用。
- 套用风格用 manage_design_style:apply_preset 直接用 presetId,apply 复用 designStyleId,create 仅对独立参考新建用户风格;套用后重新 get 完整规格。字体按实际屏幕文字使用 fontRecommendations["zh-Hans"] / .en,并用 search_fonts 返回的规范字体名,避免依赖本机字体。
- 按内容与目标帧选择 MG 形态,必要时在全部实例库检索;用 parts: ["summary", "hero"] 读取所选实例,动画看 motion、实现看 code。
- 用 create_motion_graphic_from_code 新建 JSX 资产,edit_asset 编辑已有 MG;此接口不提供 submit_motion_graphic,不要转成 Gemini 提示或生成简报。JSX 源码通过 chatcut MCP 工具内联传入,不要落到仓库、ai-working/、/tmp、本地 HTTP 服务或代码文件。
- 时间线放置用 edit_item,使用当前项目资产 ID;素材导入用 asset-import 的 import_media 会话/上传助手,导入不等于公开发布。
限制与注意:需暴露用户可见且可能变动的文本、颜色、数值、字体、图片、视频为可编辑属性,代码键须与属性 schema 键一致,值从 item.props 读取。区分参考截图、生产素材与当前项目素材;仅在视觉机制需要时才把媒体嵌入 MG。合成后需在入场与稳定帧核对素材、裁切、效果、图层顺序与时间;透明 MG 单独预览不含分开放置的图片/背景。资料未提供具体收费、价格、平台与效果数据。