模板升级与本地改动如何共存

跟着模板升级，同时保留自己的改动，关键是分清哪些文件归你、哪些归模板。

冲突最小化

blocks、index.tsx、landing 文案属于你的定制区，升级时直接以本地版本为准；core、lib、components 是模板区，尽量少改，需要改就记录原因。

先读再合

升级前检查 UPGRADING.md，schema、环境变量、权限码和导出名变化都必须执行，否则会出现运行时才暴露的错误。

迁移策略

数据库变更先用 db:generate 生成 SQL，人工确认没有破坏性操作，再 db:migrate。升级和迁移不要放在同一批里混做。

回归范围

至少回归登录、下单、回调、积分扣减、后台写入五条链路，这五条覆盖了大部分隐式耦合。