技能介绍

解决什么问题

微信小店商家经常需要在多个店铺之间搬运商品：主店验证过的链接要复制到分店，或者把旧链接的内容整体替换成新链接的结构。听起来只是「复制」，实际坑很多：跨店复制时图片必须重新上传——微信 media_id 绑定上传时的 AppID，A 店的图片在 B 店不互通；运费模板、售后地址、品牌这些字段是店铺级独立的，沿用源店值会在目标店直接报 6600120/6600149；同店覆盖目标链接时要保留目标链接 ID，而跨店克隆要生成全新的 out_product_id / out_sku_id，两者的写入语义完全不同。

技能如何工作

核心是 wxshop_client.py 里的两个高层 API。clone_product() 在目标店新建链接，overwrite_product() 整内容覆盖到目标商品草稿并保留目标 ID；两者默认 dry_run=True，只返回 payload 不写库。overrides["fields"] 按店替换独立字段，跨店改 brand_id 时还要通过 brand_attr_value 对齐品牌属性值。图片跨店时自动走 _migrate_images_cross_store()：递归收集→下载→重传目标店，返回迁移报告。
标准流程是五步：先用 dry_run 审 payload，确认 SKU 对齐和字段覆盖无误；再从目标店在售品取真实的 template_id、after_sale_address_id、brand_id 填入 overrides；然后 dry_run=False 写草稿；接着 get_product_detail 核验图片 host、资质和价格；最后由用户在小店后台触发提审，审核通过再用 product_listing API 上架。

适用边界与注意点

提审 API 返回 40066 是微信服务端异常，目前只能在小店后台手动提审。商品挂有生效的「摇优惠专享券」时 product_update 会被拦截，要先作废券再更新。目标店未开通对应叶类目时 add 会报 6600145，必须先去商户后台申请类目。product_qua_infos 不能被剥离——同商户下 qua_id 跨店通用，误删会导致审核失败。价格单位是分，out_product_id 店铺内必须唯一。凭证只从本地 .env 读取且不覆盖已有环境变量，跨店所需的 B 店凭证同样走本地配置，文档里全部是脱敏占位符。