MPSTATS Photo Editor 是 MPSTATS 内部的 AI 视觉生成服务，面向电商平台商品卡图片处理，可生成商品照片、摄影图、信息图、换色、使用场景图，并支持背景移除/替换、图片放大等操作。
用途
该技能用于为电商平台商品卡生成和处理 AI 视觉素材，覆盖从简单的单步图片处理到完整的设计任务。
主要能力
技能提供两类操作模式：
A. 技术操作（单步）：包括 remove-background（移除背景）、upscale（放大分辨率）、replace-background（替换为模板背景）、in-action（商品置于使用场景）、recolor（按十六进制色值换色）、freeform（自由编辑）。适用于用户提出具体动作请求时，如“移除背景”“放大”“换成蓝色”。
B. 设计任务（多阶段）：包括 infographics（信息图）和 photoshoot（商品摄影）。适用于关注买家价值的请求，如“做一张信息图”“更新商品卡”“我需要一组摄影图”。该模式包含四个阶段：调研（references/01-research.md）、简报（references/02-brief.md）、生成（references/03-generate.md）、交付（references/04-deliver.md）。
使用方式
所有请求通过 scripts/ 目录下的现成脚本执行，使用 Bash 工具，不重写代码。接口为异步：每个脚本负责提交、轮询并保存文件。图片在脚本内部以 base64 编码。
配置：凭据位于 config/.env（已被 gitignore），需要 PHOTO_EDITOR_TOKEN（请求头 X-Mpstats-TOKEN），可选 PHOTO_EDITOR_BASE_URL（默认 https://mpstats.io/api/big_data/proxy）。若令牌缺失，需向用户索取 MPSTATS API 令牌。
输出位置：结果不放在技能文件夹内，默认输出到 ~/.claude/output/photo-editor/<event_id>/，可通过 PHOTO_EDITOR_OUTPUT_DIR 覆盖。模式 B 生成后，将文件复制到按 SKU 命名的干净文件夹并使用有意义的名字（如 slide_1_hero.png），因为 event_id 含冒号，可能影响部分 UI 客户端的图片渲染。
多角度输入 wb:<sku>：在 infographics.sh 和 photoshoot.sh 中，第一个参数可以是 wb:<sku> 或 wb:<wb-url> 而非文件路径。技能会从 WB CDN 下载所有商品照片（wb-fetch-photos.sh，缓存于 ~/.claude/cache/photo-editor/wb-photos/<sku>/）：第一张作为 main_image，其余作为 reference_images（最多 5 张）。多角度输入时，产品锁定指令应写“preserve product identity”，而非“preserve same orientation”。
信息图系列：infographics.sh generate <img> "<prompt>" <count> 一次调用生成 count 张幻灯片（1..6）。流程为：测试帧 → 批准 → 生成 N 张；或 auto（测试+生成一次完成）。最小输出为 4 帧，接口始终返回 max(4, image_count) 张图片。photoshoot 无此限制。提示词设定高层方向和帧主题，而非每张幻灯片的布局。
模型：提供 model_1（Standard，默认，除信息图外全部适用）、model_2（PRO，信息图默认）、model_3、model_4（PRO）、model_5（PRO，仅 freeform 和 photoshoot）。宽高比支持 1:1、3:4、4:3、2:3、3:2（model_5 仅 1:1、3:4、4:3）。后端不接受 model=auto，技能会解析为 model_1；信息图默认硬编码为 model_2。
脚本清单：remove-background.sh、upscale.sh、replace-background.sh、in-action.sh、recolor.sh、freeform.sh、photoshoot.sh（auto/test/generate）、infographics.sh（auto/test/generate）、templates.sh（backgrounds/in-action）、wb-fetch-photos.sh、health.sh、run.sh、poll.sh。
决策指南：清理背景→remove-background.sh；放大/锐化→upscale.sh；更换背景→templates.sh backgrounds 后 replace-background.sh；展示使用场景→templates.sh in-action 后 in-action.sh；换色→recolor.sh；修复光照/去反光/加阴影→freeform.sh；做信息图/摄影图→模式 B，从 references/01-research.md 开始。
错误处理：process_completed 表示完成；process_completed 且 output.image 为空表示内容过滤，需改写提示词；process_error 需读取 error.message 并展示给用户；process_timeout 需减少数量或更换模型；提示词长度超限通常由换行符引起，应作为单行传递；AUTH_ERROR 表示凭据无效；本地轮询超时可用 poll.sh <event_id> 继续。
适用场景
适用于电商平台商品卡图片的 AI 生成与处理，包括背景处理、分辨率提升、换色、场景图、信息图和商品摄影等。
限制
需要 MPSTATS API 令牌。信息图最小输出为 4 帧。多角度输入最多 5 张参考图。后端不接受 model=auto。提示词需作为单行传递以避免长度错误。部分模型和宽高比组合有限制。