把一个裸 Shopify 主题整备成「看起来像真店」：我的店铺上线基线技能

问题：店铺「装好了」和「能开张」之间隔着一百个细节

我们给自己的 Shopify 店（knightlynails.com，DS Nails 主题）做整备时，发现所谓「主题装好了」离「能开张」差得远：商品卡 hover 按钮压住标题价格、PDP 画廊主图下方一个大空档、政策页一个都没有、联系表单不存在、首页全是 Example product 占位符、favicon 还是 Shopify 默认的。

这些细节每一个都不难，但没人系统地列过。于是整备完之后，我们把整条流程沉淀成了技能 shopify-store-launch-baseline：裸主题 → 可运营真店的上线基线，六阶段，每个坑带根因和修法。

总原则：不看不算完成

每个阶段都按同一个闭环走：修主题 → 构建 → 精确推送 → curl 验证 → 截图亲眼看。字符串断言看不见嵌套样式，看过才算数。

六阶段（顺序是依赖关系决定的）

1. 通道与备份。 没有部署通道后面都是空谈。首选 Dev Dashboard 应用（一套凭证覆盖主题+内容，shpat_ token 直接当 CLI 的 theme token 用）；商家只想给主题权限时才退 Theme Access。推任何东西之前先 shopify theme pull 备份——线上有商家在主题编辑器里的改动，全量推会清掉。

2. 主题基线修复。 商品卡和 PDP 是转化主战场，先修 bug：hover 浮层按钮必须相对图片容器定位；白底产品图一律 object-fit: contain；PDP 画廊的 width/height 必须写真实尺寸（硬编码错误比例会让 lazy slide 预留错误空间）；单图商品 hover 不能淡出成空白；商家自填的标题不要接 t 过滤器。

3. 品牌资产兜底接线。 模式统一：主题自带默认图放 assets/，模板里写「商家设置 > 主题资产」的兜底链——商家后台传图自动覆盖，新装店铺开箱即有。favicon（512²）、logo（横版字标）、OG 分享图（1200×628）代码生成即可。

4. 合规与信任（A 级优先级）。 政策四件套：refund/privacy/terms 用 Shopify 模板生成后按业务改（**记得删 [INSERT RETURN ADDRESS] 占位**），shipping 无官方模板需手写。联系表单走 {% form 'contact' %}，handle 为 contact 的页面自动套用。页脚菜单拆 Quick links / Policies 两列。

5. 内容体系——「看起来像真店」的关键。 Hero 轮播 ≥3 张（白底产品图用 split 布局，别全幅 cover）；智能合集 New arrivals + Best sellers 消灭占位符；品牌故事页进主菜单；Guides 博客 4 篇核心指南；双层 FAQ（首页 6 问 + PDP 底部「Before you choose your set」）。

6. 后台运营核对。 非主题项必须店主亲自确认：配送费率与公告栏承诺一致、税务/Markets/币种、订单通知邮件品牌化、Cookie/GDPR 横幅、社媒占位链接换真实账号。

推送纪律：五步，每次都走

1. 改源码 → 构建；2. diff 待推文件 vs 线上备份；3. shopify theme push --only <每个文件> 永远精确推送；4. 页面没变立刻 --verbose 查静默失败（schema option label 限 50 字符、themeFilesUpsert 会静默拒绝）；5. curl 验证 + 截图。

还有个顺序铁律：先推 section（schema）再推 JSON 模板——Shopify 会剥离 schema 未注册的 setting，反着推自定义设置直接消失。

坑位速查（都是实测踩出来的）

• 导航菜单是独立 scope write_online_store_navigation，不是 write_content；合集=products、页面/博客=content、菜单=navigation，三个域别搞混。
• article.handle 带博客前缀（guides/slug），匹配用 handle | split: '/' | last。
• 后台 TinyMCE 填长文用单换行分段，双换行会生成空 <p><br></p>。
• 新版后台已无店内 custom app，迁到了 Dev Dashboard。

内容侧（合集/菜单/页面/博客）还能用脚本一键铺：store-bootstrap 工具，create-only 幂等，不覆盖商家编辑。

安装方式

git clone https://github.com/laojin1900/365Skill.git
./install.sh shopify-store-launch-baseline

仓库链接：github.com/laojin1900/365Skill/tree/main/skills/shopify-store-launch-baseline