← 所有作品
迁移Astro 案例研究 · 2026

D'SKIN — 按护肤流程编排的无头店铺

将一家智利护肤品牌的网站整体从 WordPress 迁移到 Astro,后端保留无头 WooCommerce。2026 年又把整个店铺重新编排:不再按品类浏览,而是按护肤流程的四个步骤浏览。

访问网站 ↗
01 · 概述
技术栈
  • Astro
  • TinaCMS
  • React
  • TypeScript
  • WooCommerce API
  • Supabase
角色
  • 全栈开发
时间线
  • 2026年11月
  • 2025 年 12 月迁移 · 2026 年 11 月改版
客户
  • D'SKIN
  • 智利
范围
  • 从 WordPress 迁移到 Astro + TinaCMS,后端保留无头 WooCommerce
  • 站内自有结账流程,2026 年 2 月起已在生产环境运行
  • 店铺改版:按护肤流程的四个步骤重新编排
  • 为市场团队提供可视化内容编辑
  • 双语支持(西班牙语/英语)与完整 i18n
  • 移动端 Lighthouse:性能 99、无障碍 100、SEO 100
02 · 详情

2026 年改版:把店铺做成一套流程

迁移一年之后,问题已经不在技术层面。店铺按 WooCommerce 的品类排列,而那套品类本身是乱的:「Beauty」「Cream」「Serum」「Skin care」,还有七件产品躺在「Uncategorized」里。刚进店的客人并不知道精华是什么,她需要知道的是:它排第二。

于是店铺改为按流程的四个步骤编排——清洁、调理、保湿、眼部护理——每款产品归入所属步骤,并标明使用频率与适用肤质。

真正改变设计的,是去读订单。 把历史上 486 笔已付款订单按人归并(196 位客人),得到的是:

  • 42.9% 的人是从保湿霜进来的,那是第 3 步;只有 6.1% 从第 1 步进来。
  • 68.9% 的人首单只买一件。
  • 在复购的人里,63.5% 是回购同一件,而不是沿流程往下走。

此前没人看过这组数字,而它恰恰推翻了那个看上去理所当然的设计。所以主视觉不是从第 1 步开场,而是从人们真正进来的地方开场;标题写的是「可以只从一件开始」;也因此有了那个先问「你架子上已经有哪一件」的版块,而不是把完整流程当成唯一路径摆出来。

改版里的三个决定

顺序只有一个来源,且不手写任何数据。 一个文件定义四个步骤以及每步放哪款产品。价格、图片与库存每次渲染都向 WooCommerce 取。缺货产品显示「已售罄 · 到货通知」且无法加入购物车——而这正是旧店铺允许发生的事。

一个 @media 都没有。 整次改版用的是容器查询、配合 clamp() 的 cqw 单位和 auto-fit 网格。每个版块在一栏里、在弹窗里、在整页宽度下表现一致,因为它量的是自己的容器,不是窗口。

品牌金色不作为文字色使用。 #d8c7a5 在浅色背景上的对比度只有 1.44:1:当文字读不清,当分隔线会消失。标签改用 #6f5733,在骨白底上达到 6.4:1,分隔线用中间色调。品牌色留在它有效的地方——背景与产品上——而不是对比度不允许的地方。

一个值得写下来的失误

版块的滚动入场原本写在 CSS 里,用的是 opacity: 0。一旦 IntersectionObserver 没能跑起来——在 768 与 390 的样机上就发生过——页面会整片空白:初始状态生效了,终态永远不来。现在隐藏状态改由 JavaScript 在挂载后设置,而且只对首屏以下的版块设置。没有 JavaScript,或开启 prefers-reduced-motion 时,页面从第一次绘制起就是完整的。

挑战

D’SKIN 是一家智利天然化妆品品牌,其现有的 WordPress + WooCommerce 网站已经显得过时。客户需要一个更快、更现代的网络形象,同时保持轻松管理内容的能力和电子商务功能。

主要目标是:

  • 大幅提升页面速度和 Core Web Vitals
  • 为营销团队提供可视化内容编辑体验
  • 保留 WooCommerce 用于产品管理和订单
  • 支持双语内容(西班牙语/英语)
  • 现代高端的美学设计,体现品牌的天然护肤身份

解决方案

我设计了一个混合架构:Astro 作为前端,配合 TinaCMS 进行可视化内容编辑,同时保持 WordPress + WooCommerce 作为无头后端处理产品数据和订单。

┌─────────────────┐   ┌──────────────┐   ┌─────────────────┐
│  Astro 网站     │──▶│   TinaCMS    │──▶│   静态构建      │
│  (前端)         │   │  (内容)      │   │   (Hosting)     │
└─────────────────┘   └──────────────┘   └─────────────────┘
        │
        ▼
┌─────────────────┐
│   WordPress     │
│   WooCommerce   │
│   (产品)        │
└─────────────────┘

实现的关键功能

双语支持 (ES/EN) — 完整的 i18n 实现,西班牙语为默认语言:

  • 英文路由在 /en/*,完整翻译
  • 按语言分离的内容集合(每种语言 26+ 篇博客文章)
  • 本地化的 UI 元素、日期、货币格式和导航
  • 按语言的 SEO 元标签

TinaCMS 可视化内容管理 — 分屏实时预览编辑,带可视指示器的可编辑区域:

  • 主页英雄轮播(4 个可配置产品)
  • 畅销产品区域与 WooCommerce 集成
  • 关于页面及团队画廊
  • 护理服务目录
  • 博客文章富文本编辑

电子商务集成 — 实时的产品数据与结账衔接:

  • 从 WooCommerce REST API 实时获取产品目录
  • 客户端购物车抽屉,使用 localStorage 持久化
  • 结账最初是把购物车交接给 WooCommerce(带签名会话);自 2026 年 2 月起,付款发生在网站自身,WooCommerce 作为商品目录与订单记录
  • 库存状态和价格自动同步
  • API 不可用时的降级机制

交互组件 — 面向内容与转化的交互模块:

  • 购物车抽屉(桌面 380px 侧边栏,移动端全宽)
  • 可配置产品的英雄轮播
  • Google 评价轮播
  • 动态 Instagram 信息流集成
  • WhatsApp 悬浮按钮
  • Lenis 平滑滚动

性能优化 — 以静态生成和按需水合为核心:

  • 使用 Astro 的部分水合进行静态站点生成
  • React 组件仅在需要时水合(client:load、client:visible)
  • 图片优化并通过边缘 CDN 分发

成果

在生产环境用移动端 Lighthouse 实测,取三次运行的中位数:

  • 性能 99、无障碍 100、SEO 100
  • LCP 1.3 秒,CLS 0.001
  • 最佳实践 77,唯一的扣分来自广告像素的第三方 Cookie:这是品牌的决定,不是站点的问题

市场团队无需技术支持即可更新文章、护理项目、产品页与页面内容;自 2026 年 2 月起,结账就发生在网站自身,WooCommerce 则作为商品目录与订单记录。

技术亮点

TinaCMS 可视化编辑 — 自定义 React 包装器通过 useTina() hook 实现实时预览:

// 可视化编辑包装器示例
export default function BestSellersWrapper({ query, variables, data, products }) {
  const { data: tinaData } = useTina({ query, variables, data });
  return (
    <section data-tina-field={tinaField(bestSellers, 'title')}>
      {/* 带可视指示器的可编辑内容 */}
    </section>
  );
}

WooCommerce API 集成 — 实时产品数据,优雅降级:

// 获取畅销产品
const products = await getBestSellers(3);

// 按 ID 获取特定产品
const products = await getProductsByIds([7183, 7176, 7868]);

// 格式化为智利价格格式
formatPrice(21990); // "$21.990"

购物车转移系统 — 自定义 WordPress 插件处理带 SSO 的多产品购物车转移:

  • 签名令牌(有效期 5 分钟)使用共享密钥
  • 在 WordPress 上自动创建用户会话
  • 站内完成的结账体验

技术栈

技术用途
Astro 5.x带岛屿架构的静态站点生成器
TinaCMS 3.xGit 支持的可视化编辑
React交互组件(购物车、画廊、轮播)
TypeScript类型安全开发
Lenis高级平滑滚动
托管平台自动部署托管
WooCommerce REST API无头产品管理

这个项目展示了如何用无头架构现代化传统 WordPress 网站,结合静态站点性能的优势、可视化 CMS 的灵活性和 WooCommerce 在电子商务方面的稳健性。

03 · 截图
按流程编排的店铺:清洁、调理、保湿与眼部护理,每款产品归入所属步骤,并标注用法、评分与价格。
按流程编排的店铺:清洁、调理、保湿与眼部护理,每款产品归入所属步骤,并标注用法、评分与价格。

有类似的项目吗?