妙手ERP-美客多产品编辑

在多站点跨境电商运营中，直接向 MercadoLibre（美客多）写入商品数据的风险往往不在“调用发布接口”这一步，而是发布前的数据准备阶段。运营人员常遇到类目挂载错误、必填属性缺失、SKU 映射被意外覆盖，或者因为字段类型不一致导致保存载荷校验失败。这些问题在前端界面上可能表现为保存后静默丢失，直到发布阶段才暴露。

核心能力与工作流

妙手ERP-美客多产品编辑 技能将工作边界严格限制在数据准备阶段，不涉及最终的发布动作。它围绕 MercadoLibre 采集箱（Collect Box）提供了一套闭环操作：

• 采集箱管理与查询：通过 scripts/mercadolibre_collectbox.py 支持列表查询、详情获取（detail）以及站点切换。能够精确保留 MercadoLibre 的站点/模式值，如 CBT、UP、BR(Full)。
• 就绪诊断（Preflight）：在保存前运行 preflight 检查，汇总缺失的必填字段、价格模式、库存及保修字段等，生成统一的缺失项列表，避免盲目写入。
• 结构化转换：使用 normalize 命令将平台规则支撑的 id 转换为可读的 name，处理属性值结构转换，并在存在映射时将销售属性的 skuKey 字符串转换为整数 ID。
• 数据试运行：通过 normalize --payload 与 --context 将当前 detail 格式适配为最终保存格式，但仅用于干跑测试，不实际写入数据库。

硬性校验与边界

为了确保数据不被污染，该技能设定了几项不可逾越的红线：

• 禁止未经审查的类目写入：cid 通常来自 claim 查询的自动映射或源平台继承。除非经过 miaoshou-erp-mercadolibre-category-recommend 审查并明确确认，否则不得直接将 cid 作为最终类目证明。
• 禁止擅自编造属性：严禁根据模型推测写入品牌、合规认证、材质或物流敏感值。若无法确定 Brand 或 Gender，必须留空或询问用户，严禁将 item_number 或 model_code 直接作为品牌名称。
• 全量载荷保存：保存端点 save_site_collect_item_info 要求提交完整的 siteCollectItemInfo 对象。即使是局部修改，也必须基于最新的全量详情构建载荷，确保 SKU 映射、图片、尺寸表等无关数组不被破坏。
• 发布解耦：无论就绪检查状态如何，该技能均不执行发布操作，发布动作交由专门的 miaoshou-erp-mercadolibre-product-publish 技能处理。

如果在保存前触发了任何 AI 推断或生成值，流程将立即中断并进入等待确认状态，直到人工介入决策。