image-gen

图片生成（image-gen）

这是什么

当用户说「帮我画一张图」「生成一张海报」「做一个 logo」等请求时，用本技能 直接调用生图 API 出图。生成的图片保存为本地文件，交给用户在项目里使用。

生图供应商配置与「会话 LLM」完全分离：生图用的是 PiDeck 的 imagegen.json （或用户直接提供的 baseUrl / apiKey / 模型），不碰 AI 对话用的模型配置。

第一步：确定模型与凭据

生图请求最少需要三样：baseUrl + apiKey + 模型 id。按优先级取：

1. 读 PiDeck 生图配置（如果用户在用 PiDeck）：

   平台	配置路径
   Windows 安装版	%APPDATA%\PiDeck\imagegen.json（即 C:\Users\<用户>\AppData\Roaming\PiDeck\imagegen.json）
   Windows 便携版	<exe 同目录>\data\imagegen.json
   macOS	~/Library/Application Support/PiDeck/imagegen.json
   Linux	~/.config/PiDeck/imagegen.json

   旧版数据目录名为 pi-desktop，新首启已自动改名为 PiDeck；若 PiDeck 下没有该文件，再回退查同名 pi-desktop 路径。

   文件结构：

   {
     "providers": [
       {
         "id": "ig-1",
         "name": "OpenAI 或 Ark",
         "baseUrl": "https://api.openai.com",   // 根地址，端点按规则推导（见下）
         "apiKey": "sk-xxxx",
         "models": ["gpt-image-1"],             // 该供应商可选模型
         "extraParams": { "size": true, "output_format": false, "watermark": true },
         "referenceMode": "none | edits | image-field",   // 参考图 API 形态
         "apiStyle": "openai | siliconflow"                // 字段名/响应方言
       }
     ],
     "activeProviderId": "ig-1",   // 用户上次选中的供应商
     "activeModel": "gpt-image-1"  // 用户上次选中的模型
   }
   

   • 默认用 activeProviderId + activeModel：用户上次选的，通常是想要的。
   • 模型必须在该供应商的 models[] 里；如果有多个模型，让用户确认用哪个（用户会指定）。

2. 读不到配置 / 用户不在 PiDeck 里：询问用户三样东西—— baseUrl、apiKey、模型 id。并顺手问是否需要参考图（图生图）。

第二步：确定是否有参考图

用户可能要求「基于这张图改一下」（图生图 / 局部编辑）。有参考图时：

• 让用户提供图片的文件路径，或直接上传。
• 把图片转成 base64 / data URI 备用（见下文各形态）。
• 若供应商 referenceMode 是 none：该供应商不支持图生图，直接告诉用户 「这个供应商没开启参考图能力」，不要硬发图。

参考图约束（与 PiDeck 一致）：≤ 4 张，支持 png/jpeg/webp。

第三步：拼端点 URL

baseUrl 是根地址，生图端点按下面规则推导（不要盲猜）：

• 已经以 /images/generations 结尾 → 直接用。
• 以版本段结尾（/v1、/v1beta、/api、/api/v3 等）→ 直接追加 /images/generations。
  • 例：https://ark.cn-beijing.volces.com/api/v3 → .../api/v3/images/generations
• 裸根地址 → 补 /v1 再追加。
  • 例：https://api.openai.com → https://api.openai.com/v1/images/generations