班服文化衫设计-万维易源

概述

班服文化衫设计

任务目标

• 根据班级名/团队名、主题关键词、风格，一键生成T恤正背面差异化图案设计图（矢量感插画，1:1比例）
• 自动生成三人实穿效果图（两女一男中国人模特，两正一背，1:1比例），直观呈现印花融合与上身效果
• 确保正背面风格统一且背面比正面简化，成果可直接用于班服定制与打样沟通
• 触发场景：班服定制、毕业纪念衫设计、团队文化衫制作、社团/活动服装设计、图案创意生成

能力组成

能力流程描述

该技能采用「合规校验 → 设计策略解析 → 提示词生成 → 图像生成与轮询 → 实穿效果图合成」的流水线架构，共10个执行步骤，全程数据自动流转：

1. 合规校验优化（step_0）：接收班级名（name）、主题关键词（key_word）、风格（style）三项用户输入，先进行内容合规校验与自动优化，过滤敏感内容，保障设计安全可用。
2. 解析班服设计策略（step_1）：AI基于三项输入解析整体设计策略（配色方案、构图方式、核心视觉元素），为正背面图案奠定统一基调。
3. 生成T恤正背面图案提示词（step_2）：依据设计策略，分别产出正面图案提示词（front_prompt）与背面图案提示词（back_prompt），确保正背面风格统一且背面相对简化。
4. 正面图案生成（step_3 → step_4）：将 front_prompt 提交图像生成接口（1:1比例），随后按5秒间隔轮询生成状态（超时1200秒），成功后获得正面图案设计图URL。
5. 背面图案生成（step_5 → step_6）：将 back_prompt 提交图像生成接口（1:1比例），同样轮询至成功，获得背面图案设计图URL。
6. 生成实穿效果图提示词（step_7）：融合 front_prompt、back_prompt、风格与班级名，生成三人实穿效果图（两女一男、两正一背）专属提示词。
7. 实穿效果图生成（step_8 → step_9）：以正背面图案图为参考图（referImages），提交实穿效果图生成任务（1:1比例），轮询至成功，获得三人中国模特实穿效果图URL。
8. 结果输出：结构化返回 front_image_url（正面图案）、back_image_url（背面图案）、model_shot_url（实穿效果图）三项成果。

数据流转方式：各步骤通过工作流变量自动传递——用户输入经 {{@input.*}} 注入合规校验与策略解析；step_2 产出的正背面提示词分别供 step_3/step_5 使用；step_4/step_6 产出的图案图 URL 作为 step_8 实穿效果图的参考图（referImages）；最终由 step_9 的产出汇聚为三项输出字段。

人机协作节点：输入阶段由用户提供班级名、主题关键词与风格；任务提交与轮询查询由脚本自动完成；结果阶段由用户查看图片并下载使用。中间环节（策略解析、提示词生成、图像生成、轮询）全部自动执行，无需人工干预。

技能能力组成流程图

flowchart TD
    A["用户输入<br/>name 班级名/团队名<br/>key_word 主题关键词<br/>style 风格(简约/动漫/国潮/赛博朋克)"] --> B["step_0 合规校验优化"]
    B --> C["step_1 解析班服设计策略"]
    C --> D["step_2 生成T恤正背面图案提示词<br/>front_prompt / back_prompt"]
    D --> E["step_3 启动正面图案生成 (1:1)"]
    E --> F["step_4 轮询正面图案生成状态<br/>间隔5s / 超时1200s"]
    D --> G["step_5 启动背面图案生成 (1:1)"]
    G --> H["step_6 轮询背面图案生成状态<br/>间隔5s / 超时1200s"]
    F --> I["step_7 生成实穿效果图提示词"]
    H --> I
    I --> J["step_8 启动实穿效果图生成 (1:1)<br/>参考图: 正面图案 + 背面图案"]
    J --> K["step_9 轮询实穿效果图生成状态<br/>间隔5s / 超时1200s"]
    K --> L["最终输出<br/>front_image_url 正面图案设计图<br/>back_image_url 背面图案设计图<br/>model_shot_url 三人实穿效果图"]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 鉴权配置：

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：

1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：

“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded

phone={手机号} “ 成功响应：{"flag":true,"remark":"发送成功"}`

1. 请用户查看手机收到的6位验证码并告诉你
2. 调用验证接口获取 AppKey：

“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码} “ 成功响应：{"flag":true,"app_key":"你的AppKey"}`

1. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a72e07c3c51f2ec2101c4b3"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现正面图案、背面图案与三人实穿效果图等图片内容。

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

1. 收集用户需求

确认三项必填输入：班级名/团队名（name）、主题关键词（key_word，决定图案核心叙事）、风格（style，可选：简约/动漫/国潮/赛博朋克），并收集用户补充的设计偏好（选填）。

1. 异步提交生成任务

调用脚本异步执行班服图案与实穿效果图生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --name "测控1班" --key-word "测量梦想，掌控未来" --style "赛博朋克" --async

1. 轮询查询任务结果（必选）

使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成。

1. 结果解析与落地应用

提取 front_image_url（正面图案）、back_image_url（背面图案）、model_shot_url（实穿效果图）三项图片链接，检查正背面风格统一性、班级名文字呈现与印花融合效果，可直接用于班服定制打样沟通。

1. 生成html页面

生成一个简单的html页面来融合返回的主要信息，特别是图片。

使用示例

示例1：班级班服定制

• 输入：name="测控1班"，key_word="测量梦想，掌控未来"，style="赛博朋克"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：正面图案设计图 + 背面图案设计图 + 三人实穿效果图
• 配置要点：key_word 提炼班级精神与专业特色，style 选"赛博朋克"突出科技感

示例2：毕业纪念衫设计

• 输入：name="2026届3班"，key_word="青春不散场，未来皆可期"，style="国潮"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：国潮风正背面图案 + 三人实穿效果图，适合毕业季留存纪念
• 配置要点：key_word 融合毕业情感元素，正面突出班级名，背面承载寄语

示例3：社团文化衫多风格对比

• 输入：同一班级名与关键词，分别以"简约""动漫"风格各提交一次任务
• 流程：异步提交任务（两次） → 分别轮询查询（每轮反馈进度/数据） → 对比筛选
• 产出：两套风格统一的完整设计方案，供班级投票选定
• 配置要点：并行提交多任务时分别记录 task_id，便于对比管理

生成效果示例

描述

该技能运行完成后，结构化输出三张相互配套的设计图：

• front_image_url（正面图案设计图）：1:1 比例的矢量感插画，围绕主题关键词的核心叙事展开，融合班级名文字元素，色彩与构图适合直接印花；
• back_image_url（背面图案设计图）：1:1 比例，与正面风格统一但构图更简化，常承载口号、编号或装饰元素；
• model_shot_url（三人实穿效果图）：1:1 比例，两女一男三位中国模特，两位展示正面印花、一位展示背面印花，真实呈现图案上身的融合效果与整体视觉。

三张图风格彼此呼应，可直接用于班服厂商打样沟通或班级投票展示。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

以下为「测控1班 + 测量梦想，掌控未来 + 赛博朋克」需求下的真实输出示例：

任务完成后查询接口返回的 JSON 数据形态如下：

{
  "showapi_res_body": {
    "front_image_url": "https://oss.showapi.com/workflow/result/6a72e07c3c51f2ec2101c4b3/front_ce1a09d3.png",
    "back_image_url": "https://oss.showapi.com/workflow/result/6a72e07c3c51f2ec2101c4b3/back_7f42be85.png",
    "model_shot_url": "https://oss.showapi.com/workflow/result/6a72e07c3c51f2ec2101c4b3/model_shot_2d95ac17.png"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

字段说明：

• front_image_url：T恤正面图案设计图URL，矢量感插画，1:1比例，适合直接印花；
• back_image_url：T恤背面图案设计图URL，与正面风格统一但比正面简化，1:1比例；
• model_shot_url：三人实穿效果图URL，两女一男、两正一背，中国人模特，1:1比例。

资源索引

• [scripts/execute_task.py](scripts/execute_task.py)：异步提交班服图案与实穿效果图生成任务（真实调用时使用）
• [scripts/query_task.py](scripts/query_task.py)：轮询查询异步任务结果（真实调用时使用）

响应数据结构

1. 异步任务提交响应

{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交，正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

2. 任务查询响应（单轮轮询返回数据，需实时同步给用户）

{
  "showapi_res_body": {
    "front_image_url": "T恤正面图案设计图URL（矢量感插画，1:1比例）",
    "back_image_url": "T恤背面图案设计图URL（比正面简化，1:1比例）",
    "model_shot_url": "三人实穿效果图URL（两女一男，两正一背，中国人模特，1:1比例）"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. name、key_word、style 均为必填项；style 仅支持 简约/动漫/国潮/赛博朋克 四种取值。
2. 所有任务强制异步执行，不支持同步模式。
3. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 任务内部包含正面、背面、实穿效果图三次图像生成与轮询（单图轮询间隔5秒、超时1200秒），整体耗时较长，请持续轮询直至完成，勿中途放弃。
5. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。