Install
openclaw skills install @thcjp/ai-artist-workstationopenclaw skills install @thcjp/ai-artist-workstation定位: 多引擎AI绘画+接单SOP全流程工作站 设计: 双引擎路由(写实→鹧应AI写真98%面部保持 / 艺术风格→通用绘画引擎)+接单交付闭环
解析用户指令,执行核心操作并返回处理结果。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
指令解析与执行操作,处理输入数据并返回结果指令解析与执行相关配置参数进行设置处理输入数据,执行转换操作并输出结果。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
数据处理与转换操作,处理输入数据并返回结果数据处理与转换相关配置参数进行设置验证处理结果的正确性,格式化输出并返回给用户。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
结果验证与输出操作,处理输入数据并返回结果结果验证与输出相关配置参数进行设置| 组件 | 说明 | 关键参数 |
|---|---|---|
parser | 解析输入指令 | format, encoding |
processor | 执行核心处理逻辑 | mode, timeout |
output | 格式化输出结果 | format, encoding |
| 场景 | 输入 | 输出 | 是否适用 |
|---|---|---|---|
| 电商AI头像定制接单 | 客户自拍+写实风格+1:1尺寸 | 98%面部保持的写实头像+网盘交付链接 | 适用 |
| 商业商品图批量生产 | 商品描述+商品图风格+数量1-10 | 多张商品图+预览图打包 | 适用 |
| 内容矩阵引流作品 | 风格图描述+古风/二次元风格 | 艺术风格图+社交展示帖文案 | 适用 |
| AI写真定制服务 | 参考图+写实/国风+面部保持需求 | 高保真面部保持写真图 | 适用 |
| 壁纸/头像批量生成 | 壁纸描述+尺寸+数量 | 多张壁纸图打包下载 | 适用 |
| 专业插画师级商业插画 | 高精度分层PSD源文件需求 | 不适用(仅输出PNG/JPG位图) | 不适用 |
| 矢量图形Logo设计 | 矢量SVG格式输出需求 | 不适用(仅支持位图输出) | 不适用 |
| 视频内容生成 | 视频生成需求 | 不适用(本Skill仅处理静态图片) | 不适用 |
| 风格 | style参数值 | 面部ID保持 | 推荐引擎 |
|---|---|---|---|
| 二次元 | anime | 否(艺术风格) | 通用绘画 T2I |
| 写实 | realistic | 是(98%,鹧应) | 鹧应AI写真→通用绘画 |
| 水彩 | watercolor | 否(艺术风格) | 通用绘画 T2I |
| 国风 | chinese_ink | 是(98%,鹧应) | 鹧应AI写真→通用绘画 |
| 赛博朋克 | cyberpunk | 否(艺术风格) | 通用绘画 T2I |
| 像素 | pixel | 否(艺术风格) | 通用绘画 T2I |
| 油画 | oil_painting | 否(艺术风格) | 通用绘画 T2I |
| 3D卡通 | 3d_cartoon | 否(艺术风格) | 通用绘画 T2I |
{
"style": "头像",
"prompt": "一个戴眼镜的程序员,赛博朋克风格,蓝色调",
"face_image": "d:/photos/selfie.jpg",
"avatar_style": "cyberpunk",
"template_id": "25f62a71-8255-431f-b0be-4e56f6b41921",
"count": 1,
"size": "1:1",
"channel": "ecommerce",
"order_id": "EC20240115002"
}
{
"success": true,
"data": {
"images": [{"url": "https://...", "local_path": "d:/output/arts/xxx.png"}],
"engine": "portrait_engine",
"style": "头像",
"face_preserved": true,
"prompt_used": "实际使用的prompt"
},
"error": null,
"code": null
}
| 异常场景 | 原因 | 处理方式 | 错误码 |
|---|---|---|---|
| 参数缺失 | style/prompt未提供 | 提示补全缺失字段 | MISSING_PARAMS |
| 首选引擎不可用 | API Key未配置或服务宕机 | 降级到备选引擎链 | ENGINE_FALLBACK |
| 生成超时(180s) | 引擎响应慢或任务排队 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令1次后换引擎 | GENERATION_TIMEOUT |
| prompt含违禁内容 | 敏感词检测命中 | 拒绝生成+退款流程 | FORBIDDEN_CONTENT |
| 发送失败 | 网盘上传失败或消息发送失败 | 记录待发送队列,稍后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 | DELIVERY_FAILED |
| count超限 | count>10 | 自动截断为10 | COUNT_TRUNCATED |
| 依赖项 | 类型 | 是否必需 | 获取方式 | 国内替代方案 |
|---|---|---|---|---|
| LLM API | API | 必需 | 任意LLM服务商,由Agent内置LLM提供 | DeepSeek/通义千问/文心一言/Kimi等国内模型 |
| AI绘画引擎 | API | 必需 | 通用绘画引擎(免费)/鹧应AI写真(面部保持) | 通义万相/文心一格/即时AI等国内绘画API |
| 图像生成API | API | 可选 | 视频生成/角色一致性引擎 | 可灵AI/即梦AI等国内视频生成服务 |
%IMAGE_API_KEY%),严禁硬编码在SKILL.md或脚本源码中;所有示例代码中Key位置使用占位符$ENV:IMAGE_API_KEY;禁止在日志、错误信息、输出JSON中打印Key明文通用绘画引擎支持免费text-to-image。鹧应AI写真用于写实头像98%面部保持。
只需将SKILL.md文件放入Agent的skills目录即可直接使用。 如果Skill中包含exec工具调用,需要Agent支持命令行执行能力。
输入:
{
"style": "头像",
"prompt": "一个戴眼镜的程序员,写实风格,蓝色调",
"face_image": "d:/photos/selfie.jpg",
"avatar_style": "realistic",
"count": 1,
"size": "1:1",
"channel": "ecommerce",
"order_id": "EC20240115002"
}
执行流程: 接收订单→提取需求(头像,写实风格,附自拍)→有参考图+写实风格→调用鹧应AI写真(face_image=自拍, style=realistic)→生成98%面部保持写实头像→敏感词审核通过→发送预览+网盘链接交付
输出:
{
"success": true,
"data": {
"images": [{"url": "https://cdn.example.com/arts/EC20240115002.png", "local_path": "d:/output/arts/EC20240115002.png"}],
"engine": "portrait_engine",
"style": "头像",
"face_preserved": true,
"prompt_used": "一个戴眼镜的程序员,写实风格,蓝色调"
},
"error": null,
"code": null
}
输入:
{
"style": "头像",
"prompt": "一个戴眼镜的程序员,赛博朋克风格,蓝色调",
"avatar_style": "cyberpunk",
"count": 1,
"size": "1:1"
}
执行流程: 接收订单→提取需求(头像,赛博朋克风格)→无参考图→调用通用绘画引擎纯text-to-image→生成1张1:1头像图(面部一致性弱)→敏感词审核通过→发送预览+网盘链接交付
输出:
{
"success": true,
"data": {
"images": [{"url": "https://cdn.example.com/arts/cyberpunk_001.png", "local_path": "d:/output/arts/cyberpunk_001.png"}],
"engine": "general_t2i",
"style": "头像",
"face_preserved": false,
"prompt_used": "一个戴眼镜的程序员,赛博朋克风格,蓝色调,霓虹光效"
},
"error": null,
"code": null
}
输入: 鹧应AI写真服务宕机时的写实头像订单
{
"style": "头像",
"prompt": "写实风格头像",
"face_image": "d:/photos/selfie.jpg",
"avatar_style": "realistic"
}
输出: 自动降级到通用绘画引擎,标注面部保持降级
{
"success": true,
"data": {
"images": [{"url": "https://cdn.example.com/arts/fallback_001.png", "local_path": "d:/output/arts/fallback_001.png"}],
"engine": "general_t2i",
"style": "头像",
"face_preserved": false,
"downgraded_from": "portrait_engine",
"downgrade_reason": "ENGINE_UNAVAILABLE"
},
"error": null,
"code": "ENGINE_FALLBACK"
}
以下案例展示了skill的工作流程和预期输出效果,由LLM按照skill定义的流程生成。
输入:
{
"style": "头像",
"prompt": "写实风格,商务女性,职业装,微笑,办公室背景",
"face_image": "d:/photos/client_selfie.jpg",
"avatar_style": "realistic",
"count": 1,
"size": "1:1",
"channel": "ecommerce",
"order_id": "EC20260720001"
}
LLM生成输出:
{
"success": true,
"data": {
"images": [
{
"url": "https://cdn.artstation.com/output/EC20260720001_001.png",
"local_path": "d:/output/arts/EC20260720001_001.png"
}
],
"engine": "portrait_engine",
"style": "头像",
"face_preserved": true,
"prompt_used": "写实风格,商务女性,职业装,微笑,办公室背景,高清,自然光线,面部细节保留98%"
},
"error": null,
"code": null
}
效果验证: ✓面部保持率98%(鹧应引擎) ✓引擎正确路由(portrait_engine) ✓敏感词审核通过 ✓电商交付流程完整(网盘链接生成) ✓输出格式合规
输入:
{
"style": "头像",
"prompt": "一个戴眼镜的程序员,赛博朋克风格,蓝色调,霓虹灯光",
"avatar_style": "cyberpunk",
"count": 1,
"size": "1:1",
"channel": "social_media"
}
LLM生成输出:
{
"success": true,
"data": {
"images": [
{
"url": "https://cdn.artstation.com/output/cyberpunk_001.png",
"local_path": "d:/output/arts/cyberpunk_001.png"
}
],
"engine": "general_t2i",
"style": "头像",
"face_preserved": false,
"prompt_used": "一个戴眼镜的程序员,赛博朋克风格,蓝色调,霓虹灯光,高清,细节丰富"
},
"error": null,
"code": null
}
效果验证: ✓艺术风格正确路由(通用T2I引擎) ✓通用引擎免费生成 ✓面部保持标记正确(false) ✓prompt自动优化补充 ✓输出格式合规
输入:
{
"style": "商品图",
"prompt": "白色陶瓷马克杯,简约设计,电商产品图,白色背景",
"count": 5,
"size": "1:1",
"channel": "ecommerce",
"order_id": "EC20260720002"
}
LLM生成输出:
{
"success": true,
"data": {
"images": [
{"url": "https://cdn.artstation.com/output/EC20260720002_001.png", "local_path": "d:/output/arts/EC20260720002_001.png"},
{"url": "https://cdn.artstation.com/output/EC20260720002_002.png", "local_path": "d:/output/arts/EC20260720002_002.png"},
{"url": "https://cdn.artstation.com/output/EC20260720002_003.png", "local_path": "d:/output/arts/EC20260720002_003.png"},
{"url": "https://cdn.artstation.com/output/EC20260720002_004.png", "local_path": "d:/output/arts/EC20260720002_004.png"},
{"url": "https://cdn.artstation.com/output/EC20260720002_005.png", "local_path": "d:/output/arts/EC20260720002_005.png"}
],
"engine": "general_t2i",
"style": "商品图",
"face_preserved": false,
"prompt_used": "白色陶瓷马克杯,简约设计,电商产品图,白色背景,高清,专业摄影,居中构图"
},
"error": null,
"code": null
}
效果验证: ✓批量生成5张商品图 ✓商品图模式正确路由 ✓count参数处理正确 ✓电商订单号绑定 ✓输出格式合规
输入:
{
"style": "头像",
"prompt": "写实风格,男性,西装,正式证件照",
"face_image": "d:/photos/client_photo.jpg",
"avatar_style": "realistic",
"count": 1,
"size": "1:1",
"channel": "ecommerce",
"order_id": "EC20260720003"
}
LLM生成输出:
{
"success": true,
"data": {
"images": [
{
"url": "https://cdn.artstation.com/output/EC20260720003_001.png",
"local_path": "d:/output/arts/EC20260720003_001.png"
}
],
"engine": "general_t2i",
"style": "头像",
"face_preserved": false,
"prompt_used": "写实风格,男性,西装,正式证件照,高清,自然光线"
},
"error": "鹧应AI写真引擎不可用,已降级到通用绘画引擎,面部保持能力减弱",
"code": "ENGINE_FALLBACK"
}
效果验证: ✓降级链正确触发(鹧应→通用T2I) ✓降级原因在error字段标注 ✓面部保持标记降级为false ✓错误码ENGINE_FALLBACK正确返回 ✓服务可用性保证(降级而非失败)
输入:
{
"style": "风格图",
"prompt": "古风山水画,水墨意境,远山近水,一位古人立于桥头",
"avatar_style": "chinese_ink",
"count": 3,
"size": "9:16",
"channel": "social_media"
}
LLM生成输出:
{
"success": true,
"data": {
"images": [
{"url": "https://cdn.artstation.com/output/ink_001.png", "local_path": "d:/output/arts/ink_001.png"},
{"url": "https://cdn.artstation.com/output/ink_002.png", "local_path": "d:/output/arts/ink_002.png"},
{"url": "https://cdn.artstation.com/output/ink_003.png", "local_path": "d:/output/arts/ink_003.png"}
],
"engine": "general_t2i",
"style": "风格图",
"face_preserved": false,
"prompt_used": "古风山水画,水墨意境,远山近水,一位古人立于桥头,中国传统水墨画风格,留白构图,高清"
},
"error": null,
"code": null
}
效果验证: ✓古风风格正确路由(通用T2I古风模式) ✓批量生成3张 ✓9:16竖版尺寸适配社交平台 ✓内容矩阵场景适配 ✓输出格式合规
A: 是的,使用鹧应AI写真引擎时,在提供清晰正面参考图(face_image)的前提下,面部保持率可达98%。若鹧应引擎不可用降级到通用绘画引擎,面部保持能力会减弱(降至约70-85%)。建议写实风格订单务必提供清晰正面参考图。
A: 通用绘画引擎支持免费text-to-image,无需API Key即可使用,适合艺术风格图片生成(二次元/水彩/像素等)。但写实面部保持需调用鹧应AI写真(0.08元/张),建议接单时根据客户需求选择合适引擎以控制成本。
A: 电商订单渠道(channel=ecommerce)下,生成完成后会自动:1)生成预览图;2)上传高清原图到网盘;3)生成网盘分享链接;4)通过电商平台消息发送给买家。发送失败会记录待发送队列,支持后续重试。
A: count参数最大支持10张,超过10张会自动截断为10(COUNT_TRUNCATED)。如需批量生成更多图片,建议分多次调用,每次不超过10张。
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接,执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
| 版本 | 日期 | 变更说明 |
|---|---|---|
| v1.0.0 | 2026-07-17 | 初版创建,双引擎路由+8种风格+接单SOP+引擎降级链 |