name	image-generation
description	用宿主 generate_image 工具完成文生图与图生图编辑：先解析会话图片 file_id 再生成或基于原图编辑，区分搜图与生图。

文生图 / 图生图

不是本 Skill 的职责：找互联网上已有的图片（那是 search_images 文搜图/图搜图）；解释图片内容（那是视觉模型 / read_session_file）。搜图 ≠ 生图，先判断用户要的是"找"还是"造/改"。

search_images 返回的只是链接，沙箱无网无法直接访问。用户要"用图 / 看图 / 分析 / 存下来"时，必须接 download_external_image：

单张：url + destination_path（如 inputs/images/xxx.png）。
多张：urls 数组（2–8 张）+ destination_dir，宿主侧并行下载，每张图单独净化、哈希、出来源凭据。
下载走审批制：命中统一白名单自动放行，否则弹审批卡，用户批准后模型用相同参数重试。
下载成功后返回 file_id，后续引用/再编辑以 file_id 为准（读图走 read_session_file，编辑走 generate_image 图生图）。
部分失败不中断：结果里有 failed 列表，如实向用户汇报失败项与原因。

工具调用必须按顺序渐进，禁止跳步、禁止凭记忆描述旧图：

list_session_files：用户提到"上面的图 / 之前的图 / 这张图"时，先列出会话文件，解析出准确的 file_id。禁止用训练记忆或文字转述去"还原"一张旧图。
read_session_file（图生图前必做）：读取源图确认它就是用户指的那张（模型支持图像输入时可看到图），并拿到 file_id。
generate_image：
- 文生图：只传 prompt（详细、用用户语言的描述），省略 source_file_ids。
- 图生图：prompt + source_file_ids=[第 2 步解析到的 file_id]，让 provider 编辑原图像素；绝不重新描述旧图去生成一张"看起来像"的新图。
- 生成结果返回 file_id；后续引用、再编辑、再组合都以它为准。

搜图 ≠ 生图：找现成图 → search_images；造新图 / 改图 → 本 Skill 的 generate_image。搜图后要真实文件 → download_external_image（多张用 urls 并行下载）。
尺寸：16:9 → 2048x1152；9:16 → 1152x2048；4:3 → 1536x1152；3:4 → 1152x1536；不确定 → auto。
图生图一次最多 4 张源图（source_file_ids ≤ 4），且生成模型必须支持图片编辑（如 qwen-image-edit-max / gpt-image-2）。
未配置图片生成 Provider 时工具会明确失败；如实告知用户到 Provider 管理启用，不假装生成成功。
provider_id / model_id 默认省略（用工作区默认图片模型）；只有用户明确指定或默认不可用时才显式选择。

image-generation