设计 Agent

设计 Agent 是 CodePilot 内置的 AI 图片生成功能。它通过 Claude 分析你的需求，然后调用 Gemini Image API 生成图片。

前提条件

使用设计 Agent 需要配置 Google Gemini (Image) 服务商：

1. 前往 设置 > 服务商
2. 点击 添加服务商，选择 Google Gemini (Image)
3. 填写 API 密钥
4. 点击 保存

单张生成

开启设计 Agent

在对话输入框右侧找到设计 Agent 开关，点击启用。启用后，你发送的消息会被 Claude 分析为图片生成意图。

生成流程

1. 开启 Design Agent 开关
2. 用自然语言描述你想要的图片
3. Claude 分析你的需求，生成结构化的图片描述
4. 弹出确认面板，你可以调整：
   • Prompt — 编辑生成提示词
   • 宽高比 — 选择比例（1:1、16:9、9:16、3:2、4:3 等 10 种）
   • 分辨率 — 选择 1K / 2K / 4K
5. 点击生成，等待结果
6. 生成的图片以卡片形式展示在对话中

参考图（垫图）

你可以上传参考图片来引导生成风格和构图。在输入框中附加图片，设计 Agent 会自动将其作为生成参考。

连续编辑

生成图片后，你可以直接描述修改需求（如"去掉右边的瓶子"），系统会自动将上一张生成结果作为参考图，实现连续迭代。

批量生成

设计 Agent 支持根据文档内容批量生成配图。

流程

1. 在对话中上传文档或提供内容
2. 描述你的配图需求和风格要求
3. Claude 分析文档，生成批量生成计划：
   • 每张图的提示词
   • 宽高比和分辨率
   • 标签和来源引用
4. 你可以逐一审核和编辑计划中的每一项
5. 确认后开始批量生成
6. 进度面板实时显示每张图的生成状态
7. 失败的项目可以单独重试

查看历史

所有生成的图片会自动保存到素材库中，你可以随时回顾、下载或收藏。