1688 Item One Click — 1688 一键下单

1688-item-one-click — 商品一键操作 技能概述 1688 商品一键操作助手。提供商品快速修改能力，支持一键修改商品标题、商品主图和发布会员号动态。采用两步操作流程：先调用 before_check 检查是否可执行（含协议签署），用户确认后再调用 execute 执行修改。

使用场景 商品标题确认后需要一键应用修改 商品主图优化后需要一键替换 商品需要私域营销、上新通知时发布会员号动态 批量修改商品标题或主图 配合 1688-item-title-optimizer（标题优化）或 1688-item-image-optimizer（图片优化）的结果，直接应用修改

支持的操作类型 操作 spi_code spi_params 说明 修改标题 spi_hsf_automatic_title {"newTitle": "新标题"} 修改商品标题 修改主图 spi_hsf_modify_main_img {"newMainImg": "图片URL"} 修改商品主图 发布会员号动态 spi_hsf_offer_send_dynamics {"title": "动态标题", "description": "动态内容"} 发布会员号动态，用于私域营销、商品上新通知。参数可选，未提供时使用 before_check 返回的推荐值

CLI 命令 configure — 配置 AK # 查看 AK 状态 python {baseDir}/cli.py configure # 设置 AK python {baseDir}/cli.py configure YOUR_AK 配置网关鉴权所需的 AK。所有操作命令都依赖 AK，首次使用前需先配置。

before_check — 执行前检查 # 检查修改标题 python {baseDir}/cli.py before_check --item_id <商品ID> --spi_code spi_hsf_automatic_title --spi_params '{"newTitle": "新标题内容"}' # 检查修改主图 python {baseDir}/cli.py before_check --item_id <商品ID> --spi_code spi_hsf_modify_main_img --spi_params '{"newMainImg": "图片URL"}' # 检查发布会员号动态（参数可选，不传时使用推荐值） python {baseDir}/cli.py before_check --item_id <商品ID> --spi_code spi_hsf_offer_send_dynamics --spi_params '{}' # 检查发布会员号动态（用户指定内容） python {baseDir}/cli.py before_check --item_id <商品ID> --spi_code spi_hsf_offer_send_dynamics --spi_params '{"title": "动态标题", "description": "动态内容"}' 执行操作前的前置检查，判断是否可以执行、是否有协议需要签署。每次操作前必须先调用此命令。

execute — 执行操作 # 执行修改标题 python {baseDir}/cli.py execute --item_id <商品ID> --spi_code spi_hsf_automatic_title --spi_params '{"newTitle": "新标题内容"}' # 执行修改主图 python {baseDir}/cli.py execute --item_id <商品ID> --spi_code spi_hsf_modify_main_img --spi_params '{"newMainImg": "图片URL"}' # 执行设置限时折扣 python {baseDir}/cli.py execute --item_id <商品ID> --spi_code spi_hsf_offer_promotion_dszk --spi_params '{"discountRate": "9.5", "activityDay": "15"}' # 执行发布会员号动态 python {baseDir}/cli.py execute --item_id <商品ID> --spi_code spi_hsf_offer_send_dynamics --spi_params '{"title": "动态标题", "description": "动态内容"}' 执行实际的修改操作。必须在 before_check 通过且用户确认后才能调用。

⚠️ 重要：Agent 使用规范 规则1：严格两步操作流程 每一个修改操作必须按以下流程执行，不可跳过任何步骤： Step 1 — 前置检查（调用 before_check） python {baseDir}/cli.py before_check --item_id <商品ID> --spi_code <操作码> --spi_params '<参数JSON>' 根据返回结果判断： 返回情况 判断依据 Agent 行为 可以执行 markdown 含"让用户确认后可以执行" 向用户展示修改内容，请求确认 需签署协议 markdown 含"协议名称"和"协议链接" 向用户展示协议信息及链接，请用户阅读并确认协议后继续 不可执行 markdown 含"不可执行"或其他拒绝原因 向用户展示不可执行的原因，终止流程，不调用 execute Step 2 — 用户确认 如果 Step 1 返回"可以执行"：向用户展示待修改内容，等待用户确认 如果 Step 1 返回"需签署协议"：向用户展示协议名称和链接，等待用户确认已阅读协议 Step 3 — 执行修改（调用 execute） 仅当 Step 1 判断可执行/协议已确认 且 用户明确确认后，才调用： python {baseDir}/cli.py execute --item_id <商品ID> --spi_code <操作码> --spi_params '<参数JSON>'

规则2：结果展示规范 before_check 结果展示： 🔍 执行前检查结果： 【商品ID】{item_id} 【操作类型】修改标题 / 修改主图 / 设置限时折扣 / 发布会员号动态 【检查结果】可以执行 / 需签署协议 / 不可执行 【详细信息】{具体说明} 是否确认执行？ execute 成功展示： ✅ 操作成功！ 【商品ID】{item_id} 【操作类型】修改标题 / 修改主图 / 设置限时折扣 / 发布会员号动态 【执行结果】{成功信息} execute 失败展示： ❌ 操作失败 【商品ID】{item_id} 【失败原因】{失败原因}

规则3：设置限时折扣完整示例 用户："给商品944549591224设置限时折扣，打9.5折，持续15天" Step 1: Agent 调用 before_check → python cli.py before_check --item_id 944549591224 --spi_code spi_hsf_offer_promotion_dszk --spi_params '{"discountRate": "9.5", "activityDay": "15"}' Step 2: 检查通过，Agent 向用户确认 → "检查通过，即将为商品设置限时折扣：打9.5折，持续15天，是否确认？" Step 3: 用户确认后，Agent 调用 execute → python cli.py execute --item_id 944549591224 --spi_code spi_hsf_offer_promotion_dszk --spi_params '{"discountRate": "9.5", "activityDay": "15"}' Step 4: 展示结果 → "✅ 限时折扣设置成功！折扣：9.5折，活动时长：15天"

规则4：发布会员号动态完整示例 用户："给商品944549591224发一条会员号动态" Step 1: Agent 调用 before_check（用户未指定 title/description，传空对象获取推荐值） → python cli.py before_check --item_id 944549591224 --spi_code spi_hsf_offer_send_dynamics --spi_params '{}' Step 2: before_check 返回推荐的 title 和 description，Agent 向用户展示推荐内容并确认 → "检查通过，推荐动态标题：'xx商品上新'，推荐内容：'商品卖点描述...'，是否确认发布？" Step 3: 用户确认后，Agent 使用推荐值调用 execute → python cli.py execute --item_id 944549591224 --spi_code spi_hsf_offer_send_dynamics --spi_params '{"title": "xx商品上新", "description": "商品卖点描述..."}' Step 4: 展示结果 → "✅ 会员号动态发布成功！" 用户指定内容的场景： 用户："给商品944549591224发一条动态，标题是'夏季新品上架'，内容是'清凉透气面料，限时优惠中'" Step 1: Agent 调用 before_check → python cli.py before_check --item_id 944549591224 --spi_code spi_hsf_offer_send_dynamics --spi_params '{"title": "夏季新品上架", "description": "清凉透气面料，限时优惠中"}' Step 2: 检查通过，Agent 向用户确认 → "检查通过，即将发布动态：标题'夏季新品上架'，内容'清凉透气面料，限时优惠中'，是否确认？" Step 3: 用户确认后，Agent 调用 execute → python cli.py execute --item_id 944549591224 --spi_code spi_hsf_offer_send_dynamics --spi_params '{"title": "夏季新品上架", "description": "清凉透气面料，限时优惠中"}' Step 4: 展示结果 → "✅ 会员号动态发布成功！