ecommerce-material-studiolisted

# 电商素材工坊 / E-commerce Material Studio 生成电商产品素材（主图/详情图/场景图）的一站式工具链。输入产品图片 → 自动完成品类识别、风格匹配、场景合成、文字叠加、质检、多平台适配、批量交付。 **v2 新增：AI 场景融合合成器**（`scripts/ai_compositor.py`）——用 Qwen-Image-Edit 图生图把产品真实融入使用场景（AI 重绘光影/透视，非 PIL 贴图），支持卖点→场景自动匹配。 **One-stop pipeline for e-commerce product images: category detection → style matching → scene compositing → text overlay → quality check → platform adaptation → batch delivery.** > ⚠️ **本技能只做图，不做视频**（`scripts/` 里 0 处视频代码，已验证）。 > **视频侧**在 `ai-video-ad-production` 技能 —— 整机 = 它的 `scripts/make_ad.py`（一条命令出片： > 提交→轮询→抽帧核验→装配30s/15s→交付）。 > 两边**共用同一份产品档案**：本技能 `references/product_profiles.json`（例：`haier_hsq1_shaver`）。 > 生图脚本读 `image` 段；视频读 `video` + `video_lock` 段。**改档案一处，图/视频同时生效。** ## 何时使用 / When to use - 用户需要生成**电商主图/详情图**（如"帮我做一套剃须刀主图"） - 需要**产品图合成到场景**（白底图 → 场景图） - 需要**品牌叠加**（Logo/保障条/卖点文字/徽章） - 需要**多平台尺寸适配**（淘宝/快手/抖音/拼多多/京东等 7 平台） - 需要**批量生成**多个产品素材 ## 使用流程 / Workflow ```bash # 0. 环境依���（一次性） pip install Pillow numpy scipy # 1. 品类识别：输入产品图 → 识别品类/风格 python3 scripts/category_detector.py --image product.png # 2. 风格匹配：品类+价位+平台+品牌 → 推荐模板 python3 scripts/style_matcher.py --category 个护电器 --sub-category 剃须刀 --price 169 --platform kuaishou # 3. 场景感知合成（核心）：库调用（SceneAwareCompositor 是 Python 库，非 CLI） python3 -c " from PIL import Image from scripts.scene_aware_compositor import SceneAwareCompositor c = SceneAwareCompositor() scene = Image.open('scene.jpg'); product = Image.open('product.png') result = c.composite(scene_image=scene, product_image=produ