妙手ERP Ozon产品发布

解决的问题

把商品提交到 Ozon 店铺不是一条简单的写接口调用。采集箱里可能混着就绪商品和缺字段商品，批量发布时用户也需要在动手前看清整批计划；而发布本身是高风险操作，一旦写错店铺或商品，恢复成本很高。妙手 ERP Ozon 产品发布这个技能把「能不能发、要发什么、确认后再发」拆开处理，避免误发和数据被静默修改。

核心能力

技能围绕五个关键步骤工作：

• 解析目标：先确认确切的 detailIds 和目标 shopIds，不明确时查询店铺，而不是猜测。
• 就绪检查：在构建发布计划前检查每个商品的字段状态，不跳过校验直接提交。
• 缺失即停：就绪检查失败时停止操作，把确切的缺失字段报告出来，并路由到 miaoshou-erp-ozon-product-edit，由用户决定怎么补，不自动修复标题、价格、库存、SKU、类目、属性、包装、VAT 或仓库。
• 预览与确认：展示发布计划以及已提交、已跳过、已失败和待处理的项，只有明确确认后才执行发布。
• 如实报告：返回 API 结果时区分提交成功、跳过、失败和仍需后续查询的异步项。

适用边界

• 发布是高风险操作，技能始终要求明确确认，不会在用户未确认前自动重试写入失败的请求。
• API 调用依赖已审批的开放平台应用、已配置的凭证和已启用的 IP 白名单；请求为签名的 POST JSON。密钥不通过对话获取，也不要泄露。
• 部分结果混合时，技能按项拆分展示，不会把失败说成成功。
• 异步任务的最终平台状态可能需要后续查询才能确认。
• 常用场景包括：

- “检查能不能发布”——只做就绪检查，不发布；
- “发布商品到店铺”——检查、预览、确认、发布；
- “批量发布采集箱商品”——询问缺失的 ID 并展示批量计划；
- “提交后汇总成功/失败”——区分已提交、已跳过、已失败和待处理项。

实际实现位于 scripts/ozon_publish.py，遇到失败时建议先阅读 references/api_reference.md 了解签名与授权错误。