用途:当 Cowart 画布中选中的形状是工具栏创建的“AI 图片”占位框(holder)时,用该技能生成最终 AI 位图并填充到占位框中。
前置条件:Cowart 服务需在用户当前项目下运行,通常地址为 http://127.0.0.1:43217。新占位框是带 meta.cowartAiImageHolder 的 tldraw frame 形状,旧画布可能仍是同样带该 meta 标记的 geo rectangle,两者都需支持。
工作流:先通过 curl -s http://127.0.0.1:43217/api/selection 读取选区(若可用也可用 Cowart MCP 的 get_cowart_selection 工具)。仅当恰好选中一个 isAiImageHolder 或 meta.cowartAiImageHolder 为 true 的形状时继续,否则提示用户选择 AI 图片 holder。以占位框的 props.w、props.h 作为尺寸约定,生成图像应尽量匹配其宽高比。frame 类型时把图像作为 frame 子元素插入(parentId 为 holder id,x、y、rotation 为 0,w、h 同 holder);旧 geo rectangle 则沿用旧放置约定(x、y、rotation、parentId、w、h 同 holder)。默认使用内置 imagegen 技能生成位图;若需可见文案、标签、海报文字、广告文字、UI 文字或排版,应把文字直接写进生成提示词,由图像模型产出最终位图,不要默认先出无字背景再本地加字,除非用户明确要求本地排版、确定性文字叠加、SVG/矢量输出等。项目内输出时将生成图像从 $CODEX_HOME/generated_images/... 复制到所选页面的资源目录 canvas/pages/<page-id-without-page-prefix>/assets/,并作为新的 tldraw image 形状精确覆盖在占位框上(type: image;frame 时 parentId 为 holder id,旧 geo 时与其父级一致;x、y、rotation 对 frame 为 0,0,0,对旧 geo 同 holder;props.w、props.h 同 holder;props.assetId 为新资源 id;meta.cowartGeneratedForAiImageHolder 为 holder 形状 id)。除非用户明确要求替换,不要删除占位框,保留它便于之后再次识别目标槽位。通过 Cowart API 保存或谨慎编辑页面快照:curl -s http://127.0.0.1:43217/api/canvas;图像资源优先使用页面本地资源 URL:/page-assets/<page-id-without-page-prefix>/<filename>。之后刷新或等待浏览器热重载,确认插入形状 id、holder id、最终尺寸与已保存资源路径。
限制与注意:若 holder 是旋转过的旧 geo rectangle,图像保持相同旋转;frame holder 由 frame 决定位置,子图像保持不旋转。若同一 holder 已有生成图像且用户说“替换”,应移除或更新该图像而非叠加。未明确要求替换时不得覆盖已存在的资源文件,使用带时间戳的文件名。资料未提供收费、价格、平台支持范围等信息。