- name
SKILL.md
स्किल फ़ाइल पब्लिशर की रिपॉज़िटरी में ही रहती है।
कॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-image-gen -a cursor -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-image-gen -a claude-code -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-image-gen -a codex -yकॉपी की गई कमांड टर्मिनल में पेस्ट करें। यह इस SKILL.md को उस एजेंट में इंस्टॉल करती है।
npx skills add ZJU-REAL/Easel --skill ai-image-gen -a grok -yकॉपी किया गया संदेश Grok Bot चैट में भेजें। Bot यह SKILL.md GitHub से लाता है और उसे उन स्किल में जोड़ देता है जो आपके सभी Bot साझा करते हैं।
Install this skill: https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/builtin/ai-image-genपब्लिशर से
通用 AI 文生图 / 图生图 / 图像变体。用户自备图像生成 API key(OpenAI 兼容 或 apimart 异步),产物写入
outputs/。
调用共享脚本 skills/shared/scripts/ai_image.py(纯标准库,无第三方依赖)。
本 SKILL 不索要、不回显、不写入、不提交任何真实 API key —— key 只存在于用户自己的 .env。
配置检查路径铁律:先
cd到运行时说明给出的 Easel 项目根,确认当前目录有.env和skills/shared/scripts/ai_image.py,再运行下列命令。不得在任何执行引擎的 workspace 或共享脚本副本中检查,也不得用env/printenv代替读取项目.env;否则会把已配置的IMG_BASE_URL/Key 误判为缺失。
需在项目根目录 .env 中设置三项(脚本从当前目录向上自动查找 .env):
支持两类服务,脚本按 base_url 自动检测(也可 --mode sync|async 强制):
base_url 不含 apimart。走 /images/generations、/images/edits、/images/variations。
示例:IMG_BASE_URL=https://api.openai.com/v1,IMG_MODEL=gpt-image-1。base_url 含 apimart。提交任务 → 轮询 /tasks/<id> → 下载。
示例:IMG_BASE_URL=https://api.apimart.ai/v1。python skills/shared/scripts/ai_image.py check
打印三项配置状态(key 脱敏显示)、命中的别名、自动检测的模式。缺项时给出 .env 填写示例并以退出码 2 结束。配置未就绪就不要往下走,直接把缺什么、怎么配告诉用户。
先把用户诉求写成一条清晰的图像 Prompt(主体 + 风格 + 构图 + 光线 + 画质),再执行:
python skills/shared/scripts/ai_image.py text2img \
--prompt "一只戴墨镜的柴犬,扁平插画风,明亮撞色背景,高细节" \
--size 1024x1024 --n 1 \
--output outputs/主题名/ai-image
--size:同步模式用像素(1024x1024 / 1536x1024 / 1024x1536…);异步模式用比例(1:1 / 16:9 / 9:16…)。--n:生成张数(多张时按序号自动命名)。--output:目录(多张自动编号)或含扩展名的单文件;统一放 outputs/主题名/。--quality low|medium|high;异步可加 --resolution 1k|2k|4k。基于一张输入图 + 指令生成新图(OpenAI 走 /images/edits multipart,可选 --mask 局部编辑;apimart 把输入图作参考图走生成端点):
python skills/shared/scripts/ai_image.py img2img \
--prompt "把背景换成夜晚霓虹街道,保留主体" \
--image path/to/input.png \
--output outputs/主题名/edited.png
由一张图生成多个变体:
python skills/shared/scripts/ai_image.py variations \
--image path/to/input.png --n 3 \
--output outputs/主题名/variations
告诉用户产物路径、生成参数(模式/模型/尺寸/张数)。如需再改尺寸/加水印/压缩,转 image-editing。
统一输出到 outputs/主题名/。脚本会自动创建目录,多张按时间戳 + 序号命名。
有账号 Profile(=== EASEL ACCOUNT PROFILE ===)时,把品牌视觉风格(配色 / 调性 / 元素偏好)融入 Prompt,保持系列图统一;无 Profile 时按用户描述走通用生成。
check 会明确指出缺哪项及 .env 示例;报错为友好中文,不抛 traceback。--mode 可强制模式。通用 AI 生图:文生图 / 图生图 / 图像变体。当用户说 AI 生图、AI 画图、文生图、图生图、生成图片、生成配图、图像生成、AI 出图、AI 作图、换图、改图、图像编辑、给我画一张、生成一张图 时使用。支持 OpenAI 兼容 API 与 apimart 异步 API,用户自备 API key。
---name: ai-image-gendescription: 通用 AI 生图:文生图 / 图生图 / 图像变体。当用户说 AI 生图、AI 画图、文生图、图生图、生成图片、生成配图、图像生成、AI 出图、AI 作图、换图、改图、图像编辑、给我画一张、生成一张图 时使用。支持…---# skills/builtin/ai-image-gen/SKILL.mdFAQ
पब्लिशर से skills/builtin/ai-image-gen/SKILL.md डाउनलोड करें, या पाथ कॉपी करके रिपॉज़िटरी खोलें। PlugMCP स्किल को सूचीबद्ध करता है, फ़ाइल होस्ट नहीं करता।
पब्लिशर इसे https://github.com/ZJU-REAL/Easel पर रखता है।
Claude, Cursor, Codex और Grok Build वह SKILL.md पढ़ सकते हैं जिसे आप पब्लिशर की रिपॉज़िटरी से जोड़ते हैं। जब आप चैट में स्किल के GitHub फ़ोल्डर का लिंक भेजते हैं, तो Grok Bot उसे इंस्टॉल कर देता है।