先明确创建或更新目的
本工具是独立本地准备工具，不是Shopify官方产品、认证工具或合作伙伴。入口先选择创建新商品或更新已有商品，并选择实际计划采用的覆盖选项，不能根据是否有某列自动猜。只支持产品CSV流程，不扩展为订单、客户、多地点库存或完整迁移管理。
不索要商店密钥，不自动上传或修改商品，不访问用户图片URL。描述HTML在预览中按文本显示，不执行。当前只做结构与候选风险检查，没有授权隔离商店的真实导入证据。
输入、规则版本与表头映射
CSV、TSV、粘贴、XLSX已验证区域和当前表格均可作为来源；最终机器文件统一使用目标平台格式。每份输入独立确认解析，编号、SKU和条码保留文本。来源软件已经丢失的零或精度不能恢复。
规则版本shopify-product-csv-2026-09-29.1，页面展示核验日期和三份官方来源。当前字段文档为Barcodes，实际下载的官方样例仍有Barcode，说明文档与模板存在不同步；只通过明确别名映射处理，不凭相似名字猜列义。
每个来源列必须映射到唯一目标表头。未知列和商店自定义字段保留并标未验证，不删除后声称全部合格。产品分类、元字段定义、市场字段及自定义服务需要额外核验。
完整商品组而不是逐行必填
按产品handle组织主行、变体行与附加图片行。附属行可以不重复Title和Description，不能用通用逐行必填误删。摘要分别统计商品数、变体候选和图片行，CSV 记录数不等于商品数。
商品主行需有标题；同商品选项组合必须唯一，选项名和值及依赖需一致。重复handle可能是合法多行，重复选项组合则会阻断。无法识别所属或角色的行单独报错。
SKU重复默认风险提醒，可按用户业务策略改为阻断，但不宣称是平台统一规定。商品身份不能只看SKU，也不按名称模糊归并。不会自动补价格0或状态active；可能采用平台默认时先展示提醒。
不提交、明确设置、明确清空
每个字段选择按文件设置、不提交整列或明确提交空白。按文件设置包含原有空白，单元格空白不是不修改。整列缺失与一行空白的含义不同，而且依赖字段、行角色和实际覆盖选项会改变结果。
合成基线中Vendor为Acme，更新文件缺Vendor列和有Vendor但空白会显示不同候选影响。Status等默认或必需字段有专门处理。包装尺寸的空白会按变体行、产品行、图片行和配送设置区分，不能用统一清空规则。
商品A清空Description、B不提交Description时，在审阅区设置逐商品意图。工具按相同提交字段集合拆分完整商品组：A的文件含描述列，B的文件不含描述列，各自保留附属行。不会用两个相同空值表达相反意图，也不从不可靠基线悄悄回填。
基线只提供有范围的证据
可主动上传现有产品导出，填写日期、来源和覆盖范围并确认。超过30天、未来日期或资料不完整，按本工具策略仅作不可靠参考；这不是Shopify规则。即使近期基线也无法证明商店实时状态未变。
有合适证据时展示基线原值、文件值、提交值、意图、预计影响和不确定性；没有可靠基线只给潜在影响，不显示确定的商店更新数。变体选项变化与删除相关列属于额外风险，不声称完整模拟变体ID及外部系统影响。
映射、输入或规则改变后结果过期，需重新执行与审阅。支持规则撤销重做，逐商品意图可以撤销。原表保留，任何修改都只进入候选副本。
区分阻断、风险与未验证
检查数值、布尔、字段依赖、组归属、重复选项等已实现规则。未知字段、图片可访问性、分类和商店配置不算通过，也不生成没有定义的安全分数。每个问题保留位置、字段与来源。
图片URL只检格式和协议，不下载，所以格式正确不证明可访问、内容或尺寸符合要求。视频和3D模型不因写在图片列就获得支持，请使用适合的官方流程。
排除错误商品时，全部变体和图片附属行一并排除。不能只扔掉一条异常变体后说原商品完整准备好。全局映射与必需列问题阻断所有候选。
机器输出、回读和真实测试状态
候选文件按英文机器表头、UTF-8、逗号和LF换行生成，不随UI语言翻译列名。通用公式防护前缀不会自动加入机器文件，以免改变SKU或业务文本；公式风险先提示，用户明确审阅后原文输出。
下载前对每个拆分候选重新执行结构规则，再由CSV解析器逐值回读。输出摘要显示商品、行、文件和排除组数量；多个提交集合用中性编号CSV打包ZIP。变更与风险说明、错误商品报告需另外选择下载。
没有授权测试商店，本次真实导入未验证。结构检查通过不保证平台接受，更不自动执行生产导入。处理在可取消的本地Worker执行，数据内容不交第三方验证接口；网页仍请求静态资源。刷新清空会话，请主动保存经过审阅的结果。
常见问题
CSV 里留空，会不会把店铺原来的内容清掉？
开启覆盖导入后，某些字段留空可能清空原值，具体还取决于字段规则和这一行的用途。不能把所有空白都理解成“不修改”。更新前请逐列确认是按文件设置、不提交，还是明确清空。
只想改价格，其他资料不动，怎么准备文件？
先选择更新已有商品，并按实际计划确认覆盖选项。对不准备修改的字段检查“不提交整列”的意图，同时保留本次更新必须提供的商品标识、选项和依赖字段。不能简单删掉所有看似无关的列，也不能靠留空表示保留。
商品A要清空描述，商品B要保留描述，能放在一个文件里吗？
这两个意图不能用同一列里的两个空白同时表达。请按商品设置字段意图，工具会按需要提交的列集合拆成候选文件，并保持每个商品的变体和图片行完整。下载后要分别核对每份文件的表头。
同一个商品有好几行，后面的标题没填，是不是错误？
不一定。一个商品可以有多个变体和附加图片行，它们通过 handle 归属到同一商品，不需要每行重复全部商品资料。工具会按行的用途和完整商品组检查；重复的选项组合仍需要处理。
旧版导出的表头还能用吗？SKU 前面的0会保留吗？
已知旧表头有明确的映射建议，需要你确认。SKU 和条码按文本保留，不自动补零或转成数字。未知列会保留并标为未验证，不会删除后就宣称整份文件合格；仅靠 SKU 也不能确定商品身份。
图片链接格式没问题，为什么还是可能导入失败？
这里只检查链接格式和协议，不会主动访问图片。链接可能需要登录、已经失效或返回不合适的内容，因此“格式通过”不等于图片可访问，也不代表 Shopify 已经接受这张图片。
全部检查通过，就可以保证导入成功吗？
不能保证。本页做的是本地结构检查、分组核对和覆盖风险审阅，下载的是候选商品文件。现有商品导出可作为基线，但不能证明店铺此刻的状态。工具不会连接店铺或自动上传；实际导入效果仍需在获授权的测试环境中验证。