技能介绍

要解决什么问题

小米汽车在官方商城（xiaomiev.com）按配置维护 SU7、YU7、SU7 Ultra 各版本的交付周期。用户想比较“哪个版本提车最快”时，通常要逐个打开车型页面、逐条读文案（例如“锁定订单后预计4-7周交付”或“暂未排产”），再把不同车型手工拼在一起。本技能把这一步自动化：直接调用小米官方商城 API 拉取全系各配置的交付周期，并要求 Agent 用统一表格呈现，减少手工摘抄和口径不一致。

技能如何工作

核心入口是 scripts/fetch_xiaomi_delivery.js。运行方式为 node scripts/fetch_xiaomi_delivery.js [all|SU7|YU7|SU7 Ultra]，可查询全系或指定车型。它访问的端点是 website-api.xiaomiev.com/mtop/guidemarketing/product/car/versionList，请求参数使用车型 goodsId。脚本内部维护车型到 goodsId 的映射：SU7 为 900010301（3 个版本），YU7 为 500015457（5 个版本），SU7 Ultra 为 500010402（3 个版本）。整个调用无需登录。

脚本以 JSON 形式向 stdout 输出每个配置的字段：deliveryWeeks 保留官方原始文案；minWeeks 与 maxWeeks 是解析出的周数数值，遇到“暂未排产”时为 null；price 为人民币价格。Agent 拿到结果后按车型分别生成表格，并用颜色标注相对快慢：同一车型内交付最短标绿，偏长但非最长标琥珀，最长或“暂未排产”标红，表格底部附颜色图例。查询多个车型时，先按车型各出一张表，再可选地追加一张总览对比表。

适用边界与注意点

所有 HTTP 请求都必须由 scripts/fetch_xiaomi_delivery.js 发起，Agent 不要用 curl、Python、WebFetch 等方式直接请求该端点。脚本失败时只能重跑同一脚本或上报错误，不改用替代抓取手段。交付周期单位是周，不要按天换算。价格单位为元。

字段语义要按定义处理：deliveryWeeks 是原始文本，minWeeks/maxWeeks 是数值化结果；“暂未排产”不应被解释为 0 周。当配置名称 slogan 为空时，用 ssuId 作为后备标识。异常处理方面，API 返回 code != 0 时重试 2-3 次，仍失败则报告错误；网络错误由脚本内置退避策略自动重试。