ai-tryon 是一个虚拟试穿 Agent 技能，围绕“服装图 → 模特 → 试穿合成 → 展示视频”的完整链路提供引导式操作。其职责限于试穿效果图和展示视频生成，不涉及商品上架、文案或定价；如有上架需求，资料建议使用 shopify-quick-listing。
【主要能力】
- 支持服装图片或文字描述作为输入，可先调用视觉模型分析服装类型、颜色、图案、风格和适用性别。
- 提供内置模特列表，可按服装描述推荐模特，也允许用户提供自有模特图。
- 支持两种合成模式：模式 A 使用阿里云百炼 aitryon-plus 试衣 API 进行精确试穿；模式 B 使用豆包 Seedream 或即梦 AI 进行纯生图或参考图生图。有参考图时仅支持豆包 Seedream。
- 支持按服装部位区分处理：上装、下装、上下装套装、单件连体，对应 --garment-part 的 top、bottom、full、one_piece。
- 支持多角度生成，提供电商标准拍、走秀动态、细节特写、生活场景等角度预设，并可组合使用。
- 支持局部试穿，可通过 partial_tryon.py 保留上装或下装，只替换目标部位。
- 支持生成展示视频：可单选一张图让模特动起来，也可选 2 至 4 张图进行多镜头切换；多图视频内部使用 doubao-seedance-1-0-lite 模型。
- 输出目录按会话隔离，自动创建 task_YYYYMMDD_HHMMSS 目录，内含 step1_garment、step2_model、step3_tryon、step4_variants、step5_video 等子目录及 session_log.jsonl 日志，不覆盖历史文件。
【使用方式】 该技能以 Agent 对话方式运行，核心脚本位于 scripts/ 目录。配置 .env 的唯一标准位置是 Skill 的 scripts 目录。对话开始时应先锁定本次任务的输出目录，命令为 python scripts/output_manager.py --get-session；用户明确要求新任务时使用 --new-session。之后每次调用脚本都必须传入同一个 --output-dir。
常用脚本包括：image_gen_tryon.py 用于生图或参考图试穿，tryon_runner.py 用于试衣 API 或提示词图生图合成，video_gen.py 用于视频生成与图片列表，model_manager.py 用于模特列表与推荐，garment_analyzer.py 用于服装分析，partial_tryon.py 用于局部试穿，oss_uploader.py 用于本地图片上传获取公网 URL，preprocess.py 用于去背景白底化。
【适用场景】 适合电商服装展示、模特换装效果预览、多角度商品图生成、局部换装对比以及短视频素材制作等场景。资料默认图片尺寸为 2K，视频比例为 9:16 竖屏，背景建议使用纯白或浅灰，并约束自然人体动作。
【限制与注意事项】 本地图片在模式 A 下需要先上传 OSS；未配置 OSS 时可使用公网 URL 或改用纯生图模式。即梦 AI 在有参考图时会被自动禁用并切换为豆包 Seedream。多图视频使用 Lite 模型，因为 reference_image 任务类型仅 Lite 支持。视频生成约需 1 至 3 分钟。具体收费、价格和平台开通信息暂未提供。