> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tayest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ 与故障排查

> AutoFit Custom 常见问题与故障排查：标签写法、选车框、无匹配、CSV 导入与授权。

常见问题集中在这里。更完整的操作步骤请回到对应专题页。

## 上手与配置

> [accordion] 怎么快速上手？
>
> 首页 4 步：开标签模式 → 给商品打标签 → 主题加选车框 → 前台试一下。详见 [快速开始](https://docs.tayest.com/zh/quickstart.md)。

> [accordion] 商品标签怎么写才同步得出适配？
>
> 优先用「一条写全」：`2020 Honda Civic` 或 `2018-2020 Audi A4`。多车型就多打几条完整标签。通用件：`ymm-universal`。拆开打多个车型 / 年份不会自动叉乘。详见 [标签模式](https://docs.tayest.com/zh/tag-mode.md)。

> [accordion] 选车框加在哪里？
>
> 主题编辑器 → 应用管理 → 打开 **YMM Fitment Embed** → 把 **YMM Vehicle Selector** 加到支持应用区块的分区 → 发布。选车结果在店铺搜索页由应用列出，不需要建集合。详见 [添加选车器](https://docs.tayest.com/zh/storefront-setup.md)。

> [accordion] 什么时候改用 CSV？
>
> 商品很多，或手头有厂家适配表时。搜索设置切成「上传适配表」，再用 CSV 导入。详见 [CSV 导入](https://docs.tayest.com/zh/csv-import.md)。

> [accordion] 「下单车型」是做什么的？
>
> 定制件用：建模板并挂商品后，仅这些商品详情页要求选 Year / Make / Model，并写入购物车 / 订单行属性。详见 [模板与挂商品](https://docs.tayest.com/zh/vehicle-spec.md)。

> [accordion] 怎样只让部分商品出现车型采集？
>
> 下单车型 → 新建模板 → 管理商品 → 添加商品。只有挂载的商品会显示。

## 故障排查

> [accordion] 主题加了选车框，但商品没变化？
>
> 逐项检查：
>
> **1. 确认有适配数据**
>
> 已开标签模式，或已用 CSV / 手建出适配行。
>
> **2. 核对标签与同步**
>
> 标签写法正确；**适配数据** 里能看到对应行（可点 **从商品标签同步**，注意 unmatched 提示）。
>
> **3. 确认主题与页面**
>
> 主题已发布，且当前页面确实放了选车组件。

> [accordion] 前台选车后显示「无匹配商品」？
>
> 选车组件在工作，但该车型没有适配数据。常见原因：标签拆开打了多个车型 / 年份、拼写与车型库不一致、尚未同步。到 **适配数据** 核对后再补。

> [accordion] CSV 导入失败怎么办？
>
> * 确认已切到「上传适配表」模式
> * 确认 UTF-8、列名正确、`product_id` 存在
> * `make` / `model` 先到车型库查一致拼写
> * 看导入进度里的失败明细（最多 100 条）

> [accordion] 应用打开后跳到套餐页？
>
> 若已开启店匠应用内计费：平台要求先有生效套餐。可选免费版「免费使用」，或付费档试用，完成后再进后台。

> [accordion] 刷新应用后报错 / 要重新授权？
>
> 请从店匠商家后台应用列表重新打开应用。长时间未使用会话过期时，同样从后台重新进入即可。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.