| name | image-forge |
| description | 画图技能路由中枢（统一入口）。三维路由体系（用途 × 风格 × 主体），双后端调度。
- Signature 风格：18 种有独立 YAML 的视觉方案（构成主义/克莱因/Risograph/故障艺术/平面几何字体/霓虹线稿/黑白光学/人物信息图/电影角色卡等）
- Rendering 风格：16 种通用渲染技法 modifier（写真/动漫/3D/水彩/赛博朋克等），prompt 源自实战案例
- Logo 展示背景：12 种专业展示场景（来源 logo-generator，已内化）
- 用途库：16 类场景 + 全实战 prompt 案例，含推荐风格 + 后端默认 + pitfalls 防坑
- 后端调度：GPT Image 2（写实/产品/文字/4K）/ Gemini（仅多参考图合成备选，2026-05-02起）
- 支持：文生图、风格库生图、参考图风格反推、参考图编辑、多参考图合成、logo 展示图
Use when: 用户想画图/生图/做海报/插画/风格迁移/图片编辑/logo展示图 — 这是唯一的图像生成入口。
【铁律】绝对禁止使用 image_generate 工具（configured: no，不可用）。所有画图请求必须走本 skill。
【注意】SVG logo 代码生成 → 请用专属 logo-generator skill。
|
| pinned | false |
| source | user_created |
| created_at | "2026-04-25T00:00:00.000Z" |
Image Forge — 统一画图路由
目录结构
{baseDir}/
├── SKILL.md # 本文件（唯一用户入口）
├── backends.yaml # 后端注册表 + 优先级 + 调度策略
├── styles/
│ ├── index.yaml # 风格库（双层：10 Signature + 15 Rendering）
│ └── *.yaml # 10 个 Signature Style 独立文件
├── use-cases/
│ └── index.yaml # 11 个用途 + 推荐风格 + 默认后端
├── references/ # 用途提示词 JSON（11 个场景）
└── scripts/
├── reverse_style.py # Gemini Vision 15 维风格反推
└── generate_image.py # Gemini/Nano Banana 2 生图
三维框架
用途（Use Case）× 风格（Style）× 主体（Subject）
↓ ↓ ↓
结构指令 视觉语言 用户描述
（布局/元素） （色彩/技法/质感） （画什么）
三者独立路由、组合注入 prompt。用途和风格可以各自单独触发，也可以同时命中。
风格库：双层结构（读取 styles/index.yaml）
Tier 1: Signature Styles（有独立 YAML，10 种）
高度具体的视觉方案，命中后加载对应 YAML 文件，默认走 nano-banana-2。
| 触发词示例 | 风格 id | 擅长用途 |
|---|
| 新中式窗景、中式窗景美学、借景/框景、园林窗棂、婉约版、豪放版 | chinese-window-aesthetic | 海报、社媒 |
| 俄国构成主义、苏联海报、几何宣传 | constructivism | 海报、社媒 |
| 故障艺术、错位矩形、glitch | glitch-window-v1 | 头像、社媒 |
| 窗口重叠、数字拼贴 | glitch-window-v2 | 头像、社媒 |
| 混合媒介、线稿摄影 | mixed-media | 头像、海报 |
| 黑蓝红、三色极简剪影 | tri-color | 海报、封面 |
| 半调雕刻、铜版画、etching | engraving-halftone | 海报、头像 |
| risograph、半调杂志、印刷风 | risograph-magazine | 海报、社媒 |
| 波普水墨、pop art、ink splash | pop-ink-splash | 头像、社媒 |
| 克莱因蓝、克莱因秩序、极简仰拍 | klein-blue-order | 头像、社媒 |
| 高对比度工业、电光蓝故障 | high-contrast-industrial | 海报、产品、封面 |
| 霓虹线稿、发光素描、写实+线稿 | neon-sketch | 社媒、头像 |
| 表情包贴纸、kawaii贴纸、贴纸山海、chibi贴纸 | kawaii-sticker-sheet | 社媒、头像 |
| 日签、日签海报、天气日签、软陶地景 | daily-weather-poster | 日签、社媒 |
| 水墨羽流、墨水扩散、ink bloom | ink-bloom-reverie | 海报、社媒 |
| 微缩模型、韦斯安德森、tilt-shift diorama | miniature-wes | 社媒、产品 |
| 世界观设定、角色设定资料、world building | world-character-sheet | 海报、游戏素材 |
| 散景仙境、梦幻光斑、bokeh wonderland | bokeh-wonderland | 社媒、海报 |
| 商务证件照、档案头像、business headshot | business-headshot | 头像、海报 |
| 动漫双重曝光、剪影海报、character poster | anime-double-exposure | 海报、社媒 |
| 蜡笔画、蜡笔风、儿童画、crayon style | crayon-kid | 社媒、头像 |
| 手绘涂鸦、涂鸦叠层、照片涂鸦、手绘贴纸 | photo-doodle | 社媒、头像 |
| 黑白光学、Op Art、单色概念、光学错觉海报 | mono-optical-poster | 海报、封面 |
| CEO海报、人物信息图、人物简介、企业档案 | corporate-profile-poster | 海报、社媒 |
| 字体海报、平面几何、概念海报 | geo-typography | 海报、社媒 |
| 没骨写意、没骨写意水墨、白綿水墨、湿墨晴染、墨气人物、boneless ink | boneless-ink-xieyi | 头像、海报、社媒 |
| Q版水墨、数位水墨古风、古风萌系、Q版数位水墨、voxcat风格、Q版仙气、清透Q版、chibi ink wash | chibi-ink-wash | 头像、社媒、游戏素材 |
| 纪念碑谷、几何治愈、等距美学、埃舍尔建筑、不可能几何、geometric healing | monument-valley | 海报、社媒 |
| 高密度线蚀刻、铜版画动漫、蚀刻肖像、线刻风格、黑白蚀刻、dense etching | dense-line-etching | 头像、游戏素材、海报 |
| 极简高定线描、高定线描肖像、时装插画、疏朗线描、留白线稿、couture line art | couture-line-portrait | 头像、社媒、海报 |
| 极简线条城市海报、城市线条海报、线条城市、旅行海报、收藏级城市海报、人民币插画风、city line poster | city-line-poster | 海报、社媒 |
| 琳派、琳派装饰、金云银云、金泥流水、金箔日本画、rinpa style、japanese decorative | rinpa-decorative | 海报、社媒、古风 |
| 波普街头漫画、波普街头、波普漫画、pop street、ben-day dots、本戴点、街头波普、霓虹波普 | pop-street-manga | 海报、社媒、头像 |
| 角色卡片、角色设计卡、电影角色卡、视频角色卡、Seedance角色卡、人物一致性卡、character card、character design sheet | cinematic-character-sheet | 视频生产、游戏素材 |
| 宁静植物线稿、植物线稿、线条插画、botanical sketch、flora line art、ink botanical、monochrome botanical | tranquil-botanical-sketch | 社媒、头像、海报 |
注： geo-typography 有必填变量。命中后若用户未提供核心词语，必须主动问其前再生成。
Tier 2: Rendering Styles（inline modifier，15 种）
通用渲染技法类别，命中后取 modifier 字段直接注入 prompt。按 preferred_backend 调度。
| 触发词示例 | 风格 id | 推荐后端 |
|---|
| 摄影、写真、真实照片 | photography | GPT Image 2 |
| 电影感、胶片、cinematic | cinematic-film-still | GPT Image 2 |
| 3D渲染、三维、CGI | 3d-render | GPT Image 2 |
| 等距视角、isometric、2.5D | isometric | GPT Image 2 |
| 复古、retro、vintage | retro-vintage | GPT Image 2 |
| 赛博朋克、霓虹、cyberpunk | cyberpunk-sci-fi | GPT Image 2 |
| 极简线稿、线稿配色、色彩点缀插画 | minimal-line-accent | GPT Image 2 |
| 极简、minimalism、简约 | minimalism | GPT Image 2 |
| 动漫、二次元、anime | anime-manga | Gemini |
| 插画、手绘插画 | illustration | Gemini |
| 素描、线稿、sketch | sketch-line-art | Gemini |
| Q版、chibi、可爱 | chibi-q-style | Gemini |
| 像素艺术、pixel art、8-bit | pixel-art | Gemini |
| 油画、古典油画 | oil-painting | Gemini |
| 水彩、aquarelle | watercolor | Gemini |
| 水墨、国画、中国画 | ink-chinese-style | Gemini |
用途库（读取 use-cases/index.yaml）
15 类场景，每类携带推荐风格、默认后端与防坑指南（pitfalls）：
| 触发词 | use-case id | 默认后端 | 推荐 Rendering 风格 |
|---|
| 海报、传单、poster | poster-flyer | GPT Image 2 | cinematic, retro, cyberpunk |
| 头像、肖像、avatar | profile-avatar | Gemini | anime, illustration, photography |
| 产品图、营销图 | product-marketing | GPT Image 2 | photography, 3d-render, minimalism |
| 电商、主图、白底 | ecommerce-main-image | GPT Image 2 | photography, 3d-render |
| 视频封面、YouTube | youtube-thumbnail | GPT Image 2 | cinematic, photography |
| 小红书、社交配图 | social-media-post | GPT Image 2 | illustration, photography, watercolor |
| UI、App、网页 | app-web-design | GPT Image 2 | 3d-render, isometric, minimalism |
| 漫画、分镜 | comic-storyboard | Gemini | anime-manga, illustration, sketch |
| 游戏素材、角色 | game-asset | Gemini | 3d-render, pixel-art, illustration |
| 信息图、教育图 | infographic-edu-visual | GPT Image 2 | illustration, isometric, minimalism |
| 建筑、室内、效果图 | architectural-space | GPT Image 2 | photography, 3d-render, minimalism |
| 古风、历史、汉服 | historical-oriental | GPT Image 2 | photography, ink-chinese-style |
| 版式、杂志、出版 | document-publication | GPT Image 2 | photography, minimalism |
| 科普、动物、Apple风海报 | natural-science-poster | GPT Image 2 | photography, minimalism |
| 个人色彩诊断、形象报告 | personal-color-diagnosis | GPT Image 2 (edit) | photography, minimalism |
| 穿搭升级、衣品改造报告 | style-upgrade-report | GPT Image 2 (edit) | photography, minimalism |
| 五官升级、面部美学报告 | facial-aesthetic-report | GPT Image 2 (edit) | photography, minimalism |
| 发型升级、发型美学报告 | hairstyle-upgrade-report | GPT Image 2 (edit) | photography, minimalism |
注： personal-color-diagnosis 为特殊两阶段工作流。命中后：
- 必须确认用户已提供素颜参考图（正面/自然光/无滤镜）
- 先运行 Stage 1 色彩诊断卡 → 再运行 Stage 2 综合形象报告
- 两次均使用 gpt-image-2 edit endpoint + 参考图
- 简版可选四卡方案 (4-Card Variant)
「个人形象升级」家族（family: personal-image-upgrade）路由规则：
- personal-color-diagnosis（色彩/季节/肤色/穿搭色系）→ 两阶段工作流，素颜自拍
- style-upgrade-report（衣品/穿搭/穿衣升级/改造报告）→ 单次生成，横向 4:3
- facial-aesthetic-report（五官/颜值/面部/医美报告）→ 单次生成，横向 4:3
- hairstyle-upgrade-report（发型/发型升级/换发型/发型美学）→ 单次生成，横向 4:3
全家族共用规则：① 必须确认用户已提供本人照片 ② GPT Image 2 edit endpoint ③ 输出单张横向 4:3 报告图 ④ 飞书渠道用 message filePath 发送
路由决策树（7 条路径）
用户输入
│
├── 用户直接输入 JSON/YAML 结构体（包含 type/subject/style/constraints 字段）
│ → [Path J] Prompt-as-Code 直接执行
│ 解析结构体山u5404字段 → 合并为自然语言 prompt → 按 type 字段匹配用途后端
│ 如无 type 字段 → 解析 subject 内容 → 按 Path D 处理
│
├── 有参考图 + "用这个风格"/"反推"
│ → [Path R] 风格反推：reverse_style.py → 提取风格 → 生成
│
├── 有参考图 + "修改"/"编辑"
│ → [Path E] 参考图编辑
│ 1张图 → gpt-image-2 edit endpoint
│ 2+张图 → nano-banana-2 多参考图
│
├── 命中 Signature Style aliases（构成主义/glitch/risograph…）
│ → [Path S] 加载 YAML → prompt recipe → nano-banana-2
│
├── 命中 Rendering Style aliases（动漫/写真/3D/水彩…）
│ → [Path R2] 取 modifier → 注入 prompt → 按 preferred_backend 调度
│
├── 命中用途关键词（海报/头像/电商…）
│ → [Path U] 加载 use-cases/index.yaml → 检索 references JSON
│ → 注入 layout_hints + pitfalls 为防坑层
│ → 若无指定风格，展示推荐风格（可跳过直接生成）
│ → 按 use-case.default_backend
│
└── 直接描述主体，无信号
→ [Path D] 优化/翻译英文 → gpt-image-2（默认最高 priority）
后端调度决策（读取 backends.yaml）
1. 用户显式覆盖（最高优先级）
"用 GPT 画"/"4K高清"/"写实" → gpt-image-2
"用 Gemini 画"/"动漫" → nano-banana-2
2. Style preferred_backend
Signature 风格命中 → nano-banana-2（全部 10 种）
Rendering 风格命中 → 按各风格的 preferred_backend（见上表）
3. Use-case default_backend
无风格指定时，按用途默认后端
4. 全局默认
gpt-image-2（priority 最高）
GPT Image 2 强项：写实摄影、产品展示、文字渲染、4K 高清、海报、UI
Gemini 备选：仅在用户提供 2+ 张参考图时使用（多图合成能力更强）
[Generation] — 后端执行
GPT Image 2（CRS 路由）
推荐使用 wrapper 脚本（支持 generate + edit，多图 edit，自动处理 base64）：
uv run {baseDir}/scripts/gpt_image2.py generate \
--prompt "<prompt>" \
--output /path/out.png \
--size 1536x1024 \
--quality high
uv run {baseDir}/scripts/gpt_image2.py edit \
--prompt "<edit instruction>" \
-i /path/ref.png \
--output /path/out.png \
--size 1024x1536
uv run {baseDir}/scripts/gpt_image2.py edit \
--prompt "<instruction>" \
-i ref1.png -i ref2.png \
--output /path/out.png
注意：edit 接口不支持 input_fidelity 参数（已验证 2026-04-25）。
Python API（内联使用）：
import os, requests, base64, time
CRS_BASE = os.environ.get('CRS_BASE_URL', 'http://127.0.0.1:8765')
CRS_KEY = os.environ['CRS_API_KEY']
def gpt_image2_generate(prompt, size='1536x1024', quality='high',
output_format='png', filename=None):
resp = requests.post(
f'{CRS_BASE}/openai/v1/images/generations',
headers={'Authorization': f'Bearer {CRS_KEY}'},
json={'model': 'gpt-image-2', 'prompt': prompt, 'size': size,
'quality': quality, 'output_format': output_format,
'response_format': 'b64_json'},
timeout=180,
)
data = resp.json()['data'][0]
out = filename or f'/tmp/image-forge-{int(time.time())}.{output_format}'
with open(out, 'wb') as f:
f.write(base64.b64decode(data['b64_json']))
return out, data.get('revised_prompt', '')
def gpt_image2_edit(prompt, image_path, size='1536x1024', quality='high',
output_format='png', filename=None):
with open(image_path, 'rb') as f:
b64_img = base64.b64encode(f.read()).decode()
resp = requests.post(
f'{CRS_BASE}/openai/v1/images/edits',
headers={'Authorization': f'Bearer {CRS_KEY}'},
json={'model': 'gpt-image-2', 'prompt': prompt,
'images': [{'image_url': f'data:image/png;base64,{b64_img}'}],
'size': size, 'quality': quality,
'output_format': output_format, 'response_format': 'b64_json'},
timeout=180,
)
data = resp.json()['data'][0]
out = filename or f'/tmp/image-forge-edit-{int(time.time())}.{output_format}'
with open(out, 'wb') as f:
f.write(base64.b64decode(data['b64_json']))
return out, data.get('revised_prompt', '')
GPT Image 2 尺寸：1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 3840x2160 (4K横) / 2160x3840 (4K竖)
Gemini / Nano Banana 2
uv run {baseDir}/scripts/generate_image.py \
--prompt "<optimized_english_prompt>" \
--filename "~/.openclaw/workspace/tmp/image-forge/$(date +%Y-%m-%d-%H-%M-%S)-<slug>.png" \
--aspect-ratio "<1:1|3:4|4:3|9:16|16:9>"
uv run {baseDir}/scripts/generate_image.py \
--prompt "<e.g.: keep character, change background to warm sunset>" \
--filename "~/.openclaw/workspace/tmp/image-forge/$(date +%Y-%m-%d-%H-%M-%S)-<slug>.png" \
-i "/path/to/ref1.jpg" -i "/path/to/ref2.jpg" \
--aspect-ratio "3:4"
Gemini edit vs GPT Image 2 edit
- Gemini：多图合成、风格迁移更自由，但对原图布局保留能力较弱
- GPT Image 2：保留原图布局/文字/边框精确修改时更强，推荐用于卡牌、产品展示图的约束性编辑
Prompt 组合逻辑（Prompt-as-Code 原子化模型）
Final Prompt =
[Rendering Style modifier（如有）]
+ [Signature Style prompt（如有，替换主体后）]
+ [Use-case 结构指令（如有，从 references JSON 取）]
+ [Layout Hints（版式/空间坐标约束，来自 use-cases.layout_hints）]
+ [用户主体描述（中→英翻译优化）]
+ [技术参数（lighting / composition / quality）]
+ [Pitfall constraints（来自 use-cases.pitfalls，自动追加防坑语句）]
Prompt-as-Code 原子层（复杂任务时结构化拆分）：
-
Subject：主体描述（人/物/场景）
-
Layout：版式/比例/空间位置约束
-
Lighting：光源方向/冷暖/时段
-
Material：材质/质感关键词
-
Typography：文字内容（硬编码）/位置/语言
-
Color：色彩方案
-
Constraints：禁止项（No modern elements / No watermarks 等）
-
中文输入全部翻译为英文后发给两个后端
-
Signature Style prompt 已含完整视觉语言，Rendering modifier 作补充层
-
两者同时命中时：Signature 优先（更具体），Rendering 作辅助修饰
输出交付
- 保存目录：
~/.openclaw/workspace/tmp/image-forge/
- 文件名：
YYYY-MM-DD-HH-MM-SS-<slug>.png
- 回复：说明所选路径 + 后端 + 关键 prompt 要点，不读取二进制
渠道交付规则
| 渠道 | 交付方式 |
|---|
| 飞书 | message tool + filePath（发送原生飞书图片消息） |
| Discord / 其他渠道 | MEDIA: /absolute/path （自动 inline） |
飞书交付示例：
message action=send filePath=/abs/path/to/image.png
【注意】一次生成多张图时，分次发送每张图片。
典型示例
# [Path S] geo-typography — 平面几何字体海报
"帮我做一张字体海报‘失控的秩序’"
→ geo-typography.yaml → GPT Image 2
Prompt = 核心词: 失控的秩序 / 语言: 中文 / 情绪: auto-detect
"设计一张 Less is more 的 typographic poster"
→ geo-typography 命中 → 诞辨 → 输入: Less is more / 英文 / auto
"字体语义海报：孤独"
→ geo-typography / 情绪型 → 色块留白+图形距离 → GPT Image 2, 3:4
# [Path D] 默认 GPT Image 2
"画一只在宇宙中游泳的猫"
→ gpt-image-2，size=1536x1024
# [Path S] Signature 风格 + Gemini
"帮我画一张俄国构成主义风格的 AI 机器人海报"
→ constructivism.yaml → nano-banana-2，aspect=3:4
# [Path R2] Rendering 风格 → 自动按强项调度
"帮我画一张动漫风格的城市夜景"
→ anime-manga modifier → nano-banana-2
"帮我画一张赛博朋克风城市"
→ cyberpunk-sci-fi modifier → gpt-image-2
# [Path U] 用途路由 + 推荐风格
"帮我做一张 YouTube 视频封面，科技感"
→ youtube-thumbnail.json → 推荐 cinematic/photography → gpt-image-2
# [Path U + R2] 用途 + 风格同时命中
"帮我做一张水彩风格的社交配图，主题是咖啡和阅读"
→ social-media-post + watercolor → nano-banana-2，aspect=1:1
# [Path E] 参考图编辑
1张图 + "改成极简风格" → gpt-image-2 edit endpoint
2张图 + "合成一张" → nano-banana-2 (-i ref1 -i ref2)
# [Path R] 风格反推
1张图 + "用这个风格给我画一只猫" → reverse_style.py → gpt-image-2
# 显式后端覆盖
"用 Gemini 画一张产品图" → nano-banana-2（覆盖用途默认）
"4K高清画一张产品海报" → gpt-image-2，size=3840x2160
