yuanflow-cli 0.1.8 → 0.1.10

package/README.md

@@ -115,6 +115,16 @@ yuanflow-cli oss copy --source-key temp/cover.png --target-key final/cover.png -
 
 上传本地文件前必须确认用户授权，不能上传密钥、cookie、账号凭据或隐私文件。
 
+### 生图技能
+
+`生图技能` 随 npm 包安装到 Skill bundle。YuanFlow 主程序内优先使用受控工具 `yuanflow_image_request`，自动注入当前用户 token 并缓存返回图片。
+
+- 生成图片：`/v1/images/generations`，主模型 `gpt-image-2-c`，备用模型 `gpt-image-2`，请求体使用 `prompt`。
+- 编辑图片：`/v1/images/edits`，必须使用 multipart/form-data 上传本地图片文件。
+- `gpt-image-2-c` 通常返回 URL，`gpt-image-2` 通常返回 `b64_json`；两种返回都应缓存后再展示。
+- 生成图片必填参数：`prompt`。可选参数：`size`（默认 `1024x1024`）、`quality`（默认 `standard`）、`style`（默认 `vivid`）、`n`（默认 `1`，范围 `1~10`）、`response_format`（默认 `url`）。
+- 编辑图片除 `prompt` 外还必须上传本地图片文件，Skill 内使用 `image_path` 表示本地文件路径，实际请求以 `multipart/form-data` 的 `image` 字段上传。
+
 ## Skill 安装器
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/SKILL.md

@@ -20,12 +20,13 @@ description: Use when the user asks about social-media API workflows, platform d
 - `综合用户搜索工具/`
 - `自媒体知识库/`
 - `OSS文件中转工具/`
+- `生图技能/`
 
 ## 环境判断
 
 执行本 Skill 前，先判断当前运行环境：
 
-1. 如果当前 Agent 可用 YuanFlow 内置工具，例如 `yuanflow_cli_call` 或 `yuanflow_gateway_request`，优先使用 YuanFlow 内置工具。不要要求用户安装 npm，也不要要求用户配置 token。
+1. 如果当前 Agent 可用 YuanFlow 内置工具，例如 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，优先使用 YuanFlow 内置工具。不要要求用户安装 npm，也不要要求用户配置 token。
 2. 如果当前不在 YuanFlow 内，且本地可执行 `yuanflow-cli --help`，使用本地 CLI。
 3. 如果当前不在 YuanFlow 内，且本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
 
@@ -139,6 +140,18 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `OSS文件中转工具`
 
+### 9. 走 `生图技能`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 生成图片、画图、出图、做海报、生成视觉素材。
+- 编辑图片、修改本地图片、基于已有图片做变化。
+- 调用 YuanFlow 内置图片生成或图片编辑接口。
+
+子 Skill 名称：
+
+- `生图技能`
+
 ## 多需求时怎么处理
 
 如果用户一次提了多段流程，不要强行塞进一个子 Skill，按阶段拆开：

package/skills/yuanflow-skill//347/224/237/345/233/276/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: 生图技能
+description: Use when the user asks to generate images, create pictures, make posters or visual assets, edit images, modify local pictures, or call YuanFlow image generation/edit APIs.
+---
+
+# 生图技能
+
+当用户提到生成图片、画图、出图、做海报、生成视觉素材、编辑图片或修改本地图片时，优先使用本 Skill。
+
+## YuanFlow 内置环境
+
+如果当前 Agent 可用 `yuanflow_image_request`，优先使用该受控工具。它会自动注入当前用户 token，并把接口返回的 URL 或 base64 图片缓存为可预览资源。
+
+生成图片：
+
+```json
+{
+  "mode": "generate",
+  "model": "gpt-image-2-c",
+  "prompt": "一张写实产品图：白色马克杯放在木桌上，自然光",
+  "size": "1024x1024",
+  "quality": "standard",
+  "style": "vivid",
+  "n": 1,
+  "response_format": "url"
+}
+```
+
+编辑图片：
+
+```json
+{
+  "mode": "edit",
+  "model": "gpt-image-2-c",
+  "prompt": "把杯子改成红色，保持背景不变",
+  "image_path": "D:\\path\\to\\source.png"
+}
+```
+
+## 接口顺序
+
+生成图片只走 `/v1/images/generations`，请求体使用 `prompt`：
+
+1. 主模型：`gpt-image-2-c`
+2. 备用模型：`gpt-image-2`
+
+只有主模型请求失败或返回失败时，才切换到备用模型。不要使用 `gpt-image`、`doubao-生图` 或 chat completions/responses 端点作为本 Skill 的生图路径。
+
+编辑图片只走 `/v1/images/edits`。编辑模式必须使用 `multipart/form-data` 上传本地图片文件，不能用 JSON 直接传图片路径。
+
+已确认返回差异：
+
+- `gpt-image-2-c` 通常返回图片 URL。
+- `gpt-image-2` 通常返回 `b64_json` 图片数据。
+- 两种返回都需要缓存成本地资源，并在最终回复中给出可显示的图片链接。
+
+## 参数说明
+
+生成图片参数：
+
+| 参数 | 必填 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `prompt` | 是 | `string` | 无 | 想要生成图像的文字描述。 |
+| `size` | 否 | `enum` | `1024x1024` | 输出图像尺寸。 |
+| `quality` | 否 | `enum` | `standard` | 生成质量预设。 |
+| `style` | 否 | `enum` | `vivid` | 画风。 |
+| `n` | 否 | `integer` | `1` | 生成的图像数量，范围 `1~10`。 |
+| `response_format` | 否 | `enum` | `url` | 图像结果的返回方式。 |
+
+编辑图片参数：
+
+| 参数 | 必填 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `image_path` / `image` | 是 | 本地文件 | 无 | 被编辑的本地图片，必须通过 `multipart/form-data` 以文件上传。 |
+| `prompt` | 是 | `string` | 无 | 想要修改图片的文字描述。 |
+| `model` | 否 | `enum` | `gpt-image-2-c` | 优先使用 `gpt-image-2-c`，失败后再尝试 `gpt-image-2`。 |
+| `size` | 否 | `enum` | `1024x1024` | 输出图像尺寸。 |
+| `response_format` | 否 | `enum` | `url` | 图像结果的返回方式。 |
+
+## 外部 Agent 或手工调用
+
+生成图片请求示例：
+
+```bash
+curl https://open.yuanchuangai.com/v1/images/generations \
+  -H "Authorization: Bearer $YUAN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-image-2-c",
+    "prompt": "一张写实产品图：白色马克杯放在木桌上，自然光",
+    "size": "1024x1024",
+    "quality": "standard",
+    "style": "vivid",
+    "n": 1,
+    "response_format": "url"
+  }'
+```
+
+如果主模型失败，把 `model` 改为 `gpt-image-2` 后重试。
+
+编辑图片请求示例：
+
+```bash
+curl https://open.yuanchuangai.com/v1/images/edits \
+  -H "Authorization: Bearer $YUAN_API_KEY" \
+  -F "model=gpt-image-2-c" \
+  -F "prompt=把杯子改成红色，保持背景不变" \
+  -F "image=@D:/path/to/source.png"
+```
+
+## 输出要求
+
+- 返回图片 URL 时，先缓存图片，再回复缓存后的可预览 URL。
+- 返回 `b64_json` 时，先解码保存为图片文件，再回复缓存后的可预览 URL。
+- 用户未指定保存目录时，使用 YuanFlow 程序资源缓存目录。
+- 回复中不要暴露 token、Authorization header 或完整鉴权配置。