1688 Item Image Optimizer

1688-item-image-optimizer — 商品图片制作统一入口

编排流程（意图识别 → 权限校验 → 构建入口 → open_tab）由 workflow/1688-item-image-optimizer.js 确定性执行。本文件只描述能力：有哪些 CLI 命令、各自怎么调、返回什么、业务约束是什么。供纯问答 / 单命令调用 / 引擎委托时参考。

统一入口：python3 {baseDir}/cli.py <command> [options] 所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

命令速查

能力详述

verify_permission

• 签名：cli.py verify_permission（无参，商家身份由 AK 网关签名自动识别）
• 返回结构：业务数据嵌套在 data.data 内 —— {"success": true, "data": {"data": {"isAi": bool, "digitalModel": bool, "faceFix": bool}}}
• 关键字段：
  • isAi：是否高级版（保留字段，当前 skill 不做权限判断）
  • digitalModel：是否有数字模特权限（决定 digitalModel 能否使用）
  • faceFix：脸部修复权限（暂未使用）
• 业务含义：仅数字模特（digitalModel）路由前必须校验；一次会话内结果可复用。

build_tool_url

• 签名：cli.py build_tool_url --type <type> [--offer-id ID] [--img-url URL] [--img-url-list URL1,URL2]

• 返回结构：{"success": bool, "markdown": str, "data": {"open_tab": {"type": "open_tab", "url": "...", "title": "..."}}}

• --type 取值（CLI 支持 7 个；前 5 个为当前业务动线类型，后 2 个 CLI 支持但编排动线未独立暴露）：

  type	中文标题	图片参数	业务动线
  main	主图优化	--img-url（单图）	✅
  carousel	轮播图制作	--img-url-list（多图）	✅
  detail	详情图制作	--img-url-list（多图）	✅
  replaceSubject	背景替换	--img-url（单图）	✅
  digitalModel	数字模特	--img-url（单图）	✅
  matting	白底图	--img-url（单图）	CLI 支持
  outpainting	一键扩图	--img-url（单图）	CLI 支持

• 图片参数与工具类型必须匹配：单图工具传 --img-url、多图工具传 --img-url-list，错配 CLI 直接报错（让上游自纠）。空字符串视为无效图片报错；不传则跳过（工具页自带上传入口）。

• 业务含义：URL 由 CLI 构建（已 URL encode），禁止 LLM 编造/拼接。success=false 时禁止触发 open_tab。

configure

• 签名：cli.py configure [YOUR_AK] — 无参看状态，带 AK 写入配置
• 返回：data.configured（bool）
• AK 由 OpenClaw 配置注入，写入后需新开会话或 openclaw secrets reload 生效。

权限要求

图片参数规则

• 附件 path 即公网 URL：用户消息携带的图片以附件对象 {name, mime, path} 传入，path 即图片公网 URL（img.alicdn.com CDN）。有图必带——单图工具用 --img-url，多图工具用 --img-url-list（多张逗号分隔）。

• 无图不阻断：未识别到图片直接构建 URL，工具页自带上传入口。

• 图片超限阈值（超出需让用户选子集）：

  工具	上限
  主图优化 / 背景替换 / 数字模特	1 张
  轮播图	9 张
  详情图	20 张

触发词 → type 映射

安全声明

• open_tab 的 URL 必须来自 build_tool_url 返回，禁止编造/拼接；触发 open_tab 即为终态，不追加引导话术。
• 端侧工具页承担文件类型/大小/安全校验与上传后处理。

异常处理

铁律（最高优先级，覆盖下表所有行）

1. 权限结论只能来自 verify_permission 的 digitalModel 字段，严禁凭感觉编。 carousel / detail / main / replaceSubject / matting / outpainting 为基础功能，直接放行；只有 digitalModel==false 时才可按下表给出对应话术。严禁输出"权限校验未通过 / 未开通高级版 / 账号无权限"等任何未经 verify_permission 证实的措辞。
2. main / replaceSubject / carousel / detail / matting / outpainting 是基础功能，从不校验权限。 任何情况下都不得对它们提"高级版 / 权限 / 权益"。
3. 拿不到真实错误就别编原因。 只说"暂时无法完成，请稍后重试"，禁止虚构"权限 / 权益 / 账号状态 / 服务过期"等具体理由。
4. 不许救场。 workflow 已渲染的卡片 / 页面不要手动重开、重贴 URL 或 JSON；workflow 已是终态。

参考文档

• references/interaction-specs.md — 三个交互组件（open_tab / select_image_type / select_images）的字段结构与映射规则