妙手ERP图片处理

要解决的问题

电商运营拿到的商品图通常带着平台水印、Logo、牛皮癣文字，背景也参差不齐。原样上架既不符合平台规范，也不利于转化；用 Photoshop 逐张处理又很慢，而且很难和 ERP 里的商品资料对齐。这个技能面向的是一个很窄但很实际的场景：你手里已经有一批远程图片 URL，需要批量做确定性变换——去水印、白底抠图、加水印、翻译图片文字，最后拿到派生图地址。

它是怎么工作的

只有一个 CLI 入口 scripts/miaoshou_image_processing.py，底层是妙手 ERP OpenAPI 的签名 JSON POST。

• 输入解析有严格优先级：先复用当前任务中采集箱商品信息或采集箱编辑技能已经返回的有效 HTTP(S) URL；没有则使用用户提供的直接图片 URL；两者都不存在时，才尝试通过可用的安全上传/托管能力把本地附件转成临时公共 URL。绝不编造，也不暴露仅限本地的路径。
• 意图路由到具体命令：remove 负责去水印、Logo、文字、牛皮癣；white-bg 做白底抠图；watermark 加水印；translate 翻译图片中的文字。search-watermarks、languages、check-config 是只读操作，可以直接执行。
• 预览与提交分离：任何消耗配额的处理操作，都必须先不带 --confirm 跑一次预览，把图片数量、是否消耗配额、操作与场景/选项摆出来，等用户明确批准后，用同一条命令加 --confirm 重新提交。「把这些图翻译成英文」这类直接请求只授权准备预览，不授权消耗配额。
• 输出是映射而非覆盖：API 返回的是原图到结果图的 URL 映射，原始 ERP 商品不会被改动。需要持久本地副本时传 --output-dir，响应中会带 localArtifacts[]。
• 结果要逐张核对：不能只看 HTTP 200 就认为批量成功，必须检查每张图的 result 字段；翻译还要把正常结果和分组错误结果分开，失败项按每 URL 一行展开。

适用边界与注意点

• 只处理已有图片。需要新生成一整套营销图片集时，应该走 miaoshouerp-product-image-generator，不要把商品图片包生成请求路由到这里。
• 凭证只从本地配置、环境变量或安全主机连接器读取。不要让用户在对话里粘贴 AppSecret、Cookie、访问令牌或授权头，也不要打印密钥、签名或携带完整凭证的请求。
• 水印输出必须让用户明确二选一：保留源尺寸比例，或固定 800x800 输出。
• 智能消除至少需要一个消除目标和一个区域，并严格执行 references/api.md 中记录的 trace 字段依赖关系。
• 上传是独立的预处理步骤。不要把本地附件发到未经批准的公共主机，也不要暗示妙手接受文件系统路径。
• 一次提交失败即停止，不自动重试可能消耗配额的处理请求。部分成功的结果要保留，并逐条汇报失败 URL 及 API 原因。
• 响应里缺少结果 URL 时，直接报告为不可用，不要猜。