FlyLink 一键上架商品

解决什么问题

商品上架到 FlyLink 需要重复填写标题、描述、规格、价格、图片，多 SKU 商品还得逐个确认库存和售价。这个技能把图片识别、链接抓取、文件批量解析统一到一个流程里，并在调用 API 前强制走完逐项确认，避免把未核实的数据直接建品。

核心能力与关键步骤

支持三种输入入口：

• 图片：识别本地图片生成标题、描述和品类关键词，再上传图片并建品。
• 链接：通过 WebFetch 抓取页面内容，由 agent 提取商品信息并标注「自动提取，请核实」。
• Excel/CSV/TSV：智能推断列名含义，表格展示全部行供确认，再逐商品串行上架。

标准流程严格按序执行：

1. Step 0 收集输入：确认售价币种仅为 USD，默认库存 100，SKU 文案默认英文。
2. Step 0C / 1D-2 分销设置：先拉取店铺分销默认值，在价格确认后再向用户确认是否开启及佣金比例（commissionRate 格式为 4 位小数字符串）。
3. Step 1C SKU 确认：多 SKU 时必须逐行列出价格和库存，禁止静默填充统一值；多维度规格生成笛卡尔积全表。
4. Step 1D goodsDesc 格式化：使用 HTML 结构生成页面可读描述，长度 ≤6000 字符。
5. Step 1E 最终确认闸门：所有入口必经，逐项展示标题、描述、图片、品类、完整 specList + skuList，用户明确回复「确认发布」后才能建品。
6. Step 2 上传图片：每商品 1~10 张，外链图片需先下载再上传，禁止直接用外链 URL。

批量场景下建议每批不超过 20 行，逐商品串行处理；某个商品失败时记录原因并继续，不中断整批。

适用边界与注意点

• 依赖 XAILINKER_API_KEY（即 OpenAPI client_key），且账户需已绑定 FlyLink developer 凭证，否则接口返回 4401。
• Credit 余额不足（错误码 4020/4021）时会停止操作，需充值后重试，不会自动重试。
• 链接入口的抓取质量取决于目标网站结构，SPA 或反爬页面可能提取失败。
• 参数错误（422/4000）不重试，Key 过期（401）需重新鉴权，限流（429）等待 10 秒后重试一次。
• 联系方式字段不主动询问，用户未提供时整组 contact* 字段不传。