# Qwen3.8-Flash 实测：Shopify 商品 CSV：保留变体列，只更新有依据的描述

虚构业务样本，真实 apizt API 调用。只跑低成本文字模型，不跑视频。

## 操作

1. 打开 input.json，先确认同一 handle 下的 Blue、Green 选项与 SKU 对应。不要让模型重建变体身份。
2. 运行 run.py，把 description 接回原始行；export.csv 使用当前 Title、URL handle、Description、Option1 name、Option1 value、SKU 列。
3. 用标准 CSV 解析器往返读取 export.csv；在店铺副本核对选项依赖后再决定导入。本教程没有导入线上商店。

## 复核已保存的结果（不花API费用）

```bash
python3 run.py
```

## 换成自己的资料再运行

先备份文件，修改case.json里的input（input.json是本次输入快照，不是脚本读取入口）。用--new-output创建全新的结果目录；它不会复制旧响应和人工审校记录。再运行：

```bash
python3 run.py --run --new-output ./my-run
```

按提示输入自己的apizt Key，输入不回显也不写入文件；也可使用tokenba_API_KEY环境变量。默认使用case.json指定的低成本文本模型（未指定时qwen3.8-flash）、1536输出tokens上限、45秒超时、0次自动重试。API按实际用量计费。不要直接运行不信任的代码，先阅读run.py。修改输入后，需要同步调整本例特定的expected与校验规则；旧断言不能证明新样本正确。

## 交付文件

- export.csv：经合同检查后的本地交付稿
- actual-result.json / response.json：原始模型结果及完整响应
- reviewed-result.json / human-review.json（如有）：显式审校与改动理由
- validation.json / local-result.json：程序检查与本地计算
- report-input.html / report-result.html：可离线查看的实测报告
- receipt.json：HTTP、usage、耗时和SHA-256；没有报价时不猜成本

## 实测边界

删掉 Option1 列再更新 SKU，可能改变变体结构。先备份商店导出，别把本地 CSV 生成当作导入成功。

只校验本例合同、编号、指定事实与格式；不证明业务事实在现实世界成立。

## 参考

- Shopify 当前商品 CSV 字段：https://help.shopify.com/en/manual/products/import-export/using-csv
- Qwen3.8-Flash 官方模型说明：https://docs.qwencloud.com/developer-guides/getting-started/latest-model