使用 Zalify CLI，在终端中发布独立站

发布一个独立站，需要准备商品目录、连接店铺、部署代码、配置域名，还要考虑后续如何升级主题并保留自定义修改。

Zalify CLI 将这些工作分为三个命令组：brand、shop 和 theme。

npm i -g zalify

zalify brand init brands/my-brand # 创建品牌资料文件夹
# 补充商品目录、品牌指南和图片清单后，校验数据
zalify brand validate brands/my-brand

zalify login
zalify workspace set <workspace-slug>
zalify shop create my-brand       # 部署店铺

# 后续在生成的店铺目录中运行：
# zalify theme upgrade

以上是建站流程的起点，不包含商品配置的全部步骤。创建店铺后，还需要推送准备好的商品目录，并生成或关联商品图片。具体操作和前置条件见 CLI 参考。

2026 年 9 月更新：site 命令组已更名为 shop，托管店铺使用 <slug>.myzalify.com 地址。新增的 ads 命令组还支持通过文件管理广告账户配置。

分别管理品牌数据、店铺部署和主题代码

brand 管理品牌数据。 品牌文件夹中保存商品目录、品牌文案风格指南和图片清单。zalify brand init 会生成目录结构及编写说明，包括数据格式和命名规范。无论由人工还是 AI 智能体准备资料，都可以先按说明编写，再通过校验后导入。zalify brand push 将商品目录推送到 Shopify；zalify brand images generate 根据清单生成图片，zalify brand images attach 将图片关联到对应商品。

shop 管理托管店铺。 zalify shop create 会创建私有 GitHub 仓库、关联部署、配置域名和店铺连接，再生成并推送本地代码。你无需自行配置托管平台的凭证。仓库推送使用权限受限的短期令牌，Shopify 请求通过 Zalify 的鉴权代理处理。部署耗时取决于构建过程和相关服务的状态。

theme 管理主题代码。 生成的店铺是可自行修改的 Next.js 项目，并附有记录文件初始版本的清单。主题设置、模板和多语言文案保存在 theme/ 目录中，升级时会保留。zalify theme upgrade 更新未修改的文件，尝试合并已修改的文件，并标出需要人工处理的冲突。代码由你掌控，部署前可以检查升级差异。

品牌资料和店铺代码保存在两个不同的目录中。建议用相同的品牌标识命名这两个文件夹，并按照参考文档在对应目录中执行命令。

五个品牌示例，覆盖不同品类

我们用这套流程准备了五个演示品牌：按照各自的品牌指南编写商品目录，根据图片清单生成商品图，通过主题设置调整页面风格。其中四家店铺已有下方的在线演示，第五个品牌已完成资料准备，等待部署。

• Voltra： 充电与电源产品，以石墨深色搭配青色点缀。
• Aurelle： 珠宝，以象牙白、金色和杂志风格的衬线字体呈现。
• Mirelle： 时尚服饰，采用浅粉和玫瑰色调。
• Pawfolk： 宠物用品，以奶油色、陶土色和圆角元素营造亲切感。
• Crown & Co.： 洗护发品牌，已准备好品牌文件夹，待执行部署步骤。

这些示例共用店铺引擎、组件体系和结账方式，通过不同的品牌资料和主题设置呈现各自的风格。

配合 AI 智能体使用

纯文本 CLI 参考包含命令说明、文件格式、错误码和资料编写规则。可以将它提供给 AI 智能体，用于指导品牌资料准备、数据校验、店铺发布、商品目录推送和图片生成。

从 zalify brand init 开始，阅读生成的说明，并在发布前完成数据校验。