好食期第三方商品与物流
当用户需要查询好食期订单、物流、配送信息，或需要同步好食期商品、类目时，按以下步骤执行。
- 先阅读 @references/api-spec.md，确认用户意图属于下列哪一项：
| 用户意图 | Action | 所需参数 |
|---|---|---|
| 同步全部第三方商品 | sync-product |
无 |
| 同步单个第三方商品 | sync-product-one |
productId、skuId |
| 同步第三方类目 | sync-category |
无 |
| 获取商品配送地址或配送范围 | delivery-range |
productId、skuId |
| 获取第三方快递列表 | delivery-list |
无 |
| 查询订单物流或物流轨迹 | delivery-detail |
好食期订单记录 id |
| 查询好食期订单详情 | order-detail |
好食期订单记录 id |
-
参数不足时，仅询问该接口缺少的参数。
id是好食期订单记录 ID，不是外部订单号；不能从现有信息确定时，向用户索取该 ID。 -
对查询操作，执行：
bash
python3 "$SKILL_PATH/scripts/hsq_third_api.py" --action <action> [required options]
如用户指定环境或地址，使用 HSQ_THIRD_API_BASE_URL 或 --base-url 覆盖默认服务地址。完整命令示例见 @templates/workflow.sh。
-
对
sync-product、sync-product-one、sync-category，执行前明确说明同步范围和影响；只有用户明确确认后，才附加--confirm调用脚本。 -
成功时按接口原始字段整理返回结果；无数据时如实说明。失败时报告 HTTP 状态或网络错误并停止，不自动重试同步操作，也不收集或输出 Token。
