技能介绍

解决什么问题

妙手 ERP 公共采集箱记录需要被查询、新增、补全或修正：SPU 的标题、价格、库存、重量、尺寸、图片、备注，SKU 的价格、库存、商家编码、重量、属性，以及不再需要的商品删除。若直接写入，容易漏查原值、误改关联字段，批量或删除时也缺少边界。该技能把操作限定在公共采集箱，并按查询、预览、确认、分项报告推进。

技能如何工作

支持商品列表/详情查询、新增、SPU 编辑、SKU 编辑、删除或移除商品资产。流程先判断查询、新增、编辑、删除或批量，再收集 ID、目标字段和目标值；首次或环境变化时检查 python，不可用就换运行时重试。凭证可放在 resources/config.json 的 app_key/app_secret，或环境变量 MIAOSHOU_APP_KEY/MIAOSHOU_APP_SECRET；可选 MIAOSHOU_BASE_URL，默认 https://openapi-erp.91miaoshou.com。本地检查后可做只读连通性检查。

确定性操作由 scripts/collectbox_crud.py 执行；脚本不可用时可通过主机 HTTP 客户端或连接器调用文档 API。请求为 POST + application/json，带 x-app-key、x-timestamp、x-sign。签名使用 API path、秒级 Unix 时间戳（偏移超过 300 秒过期）、与发送体完全一致的 bodyJson，输出小写十六进制 HmacSHA256。授权错误按 signMissing、signExpired、signInvalid、appNotFound、appNoPermission、ipNotInWhitelist 处理。

业务校验与边界

写操作前必须查询详情，并一次汇总当前值、目标值、受影响字段和风险。编辑 SPU price 要检查 SPU stock 与 SKU 库存；编辑 SPU stock 要检查 SPU price 与 SKU 库存；编辑 SKU 价格 要检查 SKU 库存和原始库存；编辑 SKU 库存 要检查 SKU 价格和原始库存。skuMap 不能只提交改动字段，要保留详情返回的必填 SKU 字段。库存超过 99999 可能阻断保存，需提示修正、跳过或取消。批量要报告数量和 ID，删除必须精确 ID 并明确确认。

不采集货源 URL，不编辑认领后的平台专属采集箱，也不发布商品。货源 URL 交给 miaoshou-erp-source-import；TikTok、Ozon、Temu、Shopee、MercadoLibre 的认领后操作应路由到对应类目、尺码表、采集箱编辑、全球商品或发布技能。出错时停止后续写操作，区分成功、跳过、失败，且不要输出签名请求头、AppSecret 或含凭证的请求。重要操作前应加载 references/api_reference.md。