ecommerce-material-studiolisted

# 电商素材工坊 / E-commerce Material Studio 生成电商产品素材（主图/详情图/场景图）的一站式工具链。输入产品图片 → 自动完成品类识别、风格匹配、场景合成、文字叠加、质检、多平台适配、批量交付。 **One-stop pipeline for e-commerce product images: category detection → style matching → scene compositing → text overlay → quality check → platform adaptation → batch delivery.** ## 何时使用 / 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=product, scene_type='lifestyle_bathroom', position=(0.5, 0.45)) result.save('result.png') " # 4. 统一文字叠加（处理 plan.json 里所有文字层） python3 scripts/text_engine.py --plan output/plan.json --brand langke --scene-tone dark # 5. 自动质检（读取 plan.json + 检查成品图） python3 scripts/quality_check.py --plan output/plan.json # 6. 多平台尺寸适配 python3 scripts/platform_adapter.py --input-dir ./output --platforms kuaishou --output-dir ./platform_output #