Checkout 扩展
构建、开发和管理 Shoplazza Checkout 扩展。别名：checkout。
init
创建新的 Checkout 扩展项目脚手架（本地操作，无需网络）。
shoplazza checkout-extension init --name <项目名> --extension <首个扩展名>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--name | string | 项目名称（在当前目录下创建同名目录） |
--extension | string | 首个扩展名称 |
示例
shoplazza checkout init --name my-project --extension my-ext
create
在已有项目中创建新扩展（本地操作，无需网络）。需在 init 创建的项目目录内执行。
shoplazza checkout-extension create --name <扩展名>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--name | string | 扩展名称 |
示例
shoplazza checkout create --name another-ext
dev
启动 Checkout 扩展开发服务器（自动重新构建 + 端口 8888 上的 HMR 热更新）。
shoplazza checkout-extension dev [flags]
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--extension-name | stringSlice | 要开发的扩展名称（可重复使用，支持逗号分隔） |
--all | bool | 开发 ./extensions 下的所有扩展 |
示例
# 开发单个扩展
shoplazza checkout dev --extension-name my-ext
# 开发多个扩展
shoplazza checkout dev --extension-name ext1,ext2
# 开发所有扩展
shoplazza checkout dev --all
build
使用内置 Vite 工具链构建 Checkout 扩展。
shoplazza checkout-extension build [flags]
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--name | string | 扩展名称（./extensions 下的目录名）；在扩展目录内运行时可省略 |
--debug | bool | 将详细构建日志输出到 stderr |
示例
# 从项目根目录构建
shoplazza checkout build --name my-ext
# 在扩展目录内构建
cd extensions/my-ext && shoplazza checkout build
push
构建并上传新的扩展版本（不会自动激活）。上传后需使用 deploy 命令激活。
shoplazza checkout-extension push --name <扩展名> [flags]
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--name | string | 扩展名称（./extensions 下的目录名）——必填 |
--version | string | 可选。推送前将此版本号写入 extension.json（必须大于上次推送的版本号） |
--debug | bool | 将详细构建日志输出到 stderr |
示例
shoplazza checkout push --name my-ext
shoplazza checkout push --name my-ext --version 1.1
deploy
激活一个已推送的扩展版本。
shoplazza checkout-extension deploy --extension-id <id> --version <版本号>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--extension-id | string | 服务端扩展 ID |
--version | string | 要激活的版本号，如 1.0（通过 checkout versions 解析为服务端 ID） |
--dry-run | bool | 仅打印将要发送的请求，不实际执行 |
示例
shoplazza checkout deploy --extension-id abc123 --version 1.0
undeploy
取消部署扩展（扩展级别操作，无需确认）。
shoplazza checkout-extension undeploy --extension-id <id>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--extension-id | string | 服务端扩展 ID——必填 |
--dry-run | bool | 仅打印将要发送的请求，不实际执行 |
示例
shoplazza checkout undeploy --extension-id abc123
list
列出 Checkout 扩展。默认仅显示已发布的扩展。
shoplazza checkout-extension list [flags]
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--all, -a | bool | 列出所有扩展（不仅限于已发布的） |
--dry-run | bool | 仅打印将要发送的请求，不实际执行 |
示例
shoplazza checkout list
shoplazza checkout list --all
versions
列出 Checkout 扩展的版本。
shoplazza checkout-extension versions --extension-id <id>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--extension-id | string | 服务端扩展 ID（可通过 checkout list 获取）——必填 |
--dry-run | bool | 仅打印将要发送的请求，不实际执行 |
示例
shoplazza checkout versions --extension-id abc123
preview
为扩展版本生成预览 URL。
shoplazza checkout-extension preview --extension-id <id> --version <版本号>
Flags
| Flag | 类型 | 说明 |
|---|---|---|
--extension-id | string | 服务端扩展 ID |
--version | string | 要预览的版本号，如 1.0（通过 checkout versions 解析为服务端 ID） |
--dry-run | bool | 仅打印将要发送的请求，不实际执行 |
示例
shoplazza checkout preview --extension-id abc123 --version 1.0