主题扩展

构建、测试和部署 Theme 扩展。别名：te。

在终端中，create、build、connect 和 serve 缺少必填参数时会提示输入（connect 可选择应用，serve 可选择主题）。使用 --no-input、在 CI 中运行，或 stdin / stderr 不是终端时，缺少参数会立即报错。

create

在当前目录创建独立的 Theme 扩展项目脚手架（本地操作，无需网络），配置写入 extension.config.json。

shell

shoplazza theme-extension create [参数]

参数	类型	说明
--name <名称>	string	项目名称 / 目标目录（必填）
--type <类型>	string	模板类型：basic 或 embed（必填）

serve

在当前店铺上注册（仅首次）、推送开发构建，并监听 theme-app/ 的文件变更做增量同步。会打印后台和店面的预览 URL，持续运行直到中断。

shell

shoplazza theme-extension serve [参数]

参数	类型	说明
--theme-id, -t <THEME_ID>	string	用于预览扩展的主题（必填）
--path <路径>	string	项目路径（默认：当前目录）

build

构建新的扩展版本（打包、上传并在服务端创建版本）。压缩包由 theme-app/ 生成，其顶层除 assets-manifest.json 外的文件、任意层级的点文件/目录（.env、.gitignore、.DS_Store、.git/）以及 node_modules/ 都不会打包。

shell

shoplazza theme-extension build [参数]

参数	类型	说明
--version <版本号>	string	新的语义化版本号，格式为 X.Y.Z，如 1.0.0，须大于最新版本（必填）
--description <描述>	string	版本描述（必填）
--store-domain, -s <域名>	string	目标店铺（默认为当前店铺）
--path <路径>	string	项目路径（默认：当前目录）

deploy

在当前店铺启用指定版本。

shell

shoplazza theme-extension deploy [参数]

参数	类型	说明
--version <版本号>	string	要启用的版本号，如 1.0.0（默认为 te build 记录的版本）
--path <路径>	string	项目路径（默认：当前目录）
--debug	bool	打印原始发布请求/响应用于排查问题

connect

将 Theme 扩展链接到应用。应用所属的 Partner 由 --client-id 自动推导。

shell

shoplazza theme-extension connect [参数]

参数	类型	说明
--client-id <id>	string	要链接的应用 client_id（必填）
--path <路径>	string	项目路径（默认：当前目录）

release

在绑定的应用中发布版本。

shell

shoplazza theme-extension release [参数]

参数	类型	说明
--version <版本号>	string	要发布的版本号，如 1.0.0（默认为 te build 记录的版本）
--path <路径>	string	项目路径（默认：当前目录）
--debug	bool	打印解析后的发布请求用于排查问题

list

列出店铺的 Theme 扩展。

shell

shoplazza theme-extension list [参数]

参数	类型	说明
--store-domain, -s <域名>	string	目标店铺（默认为当前店铺）

versions

列出当前店铺上本项目 Theme 扩展的版本（扩展 ID 从 extension.config.json 读取）。

shell

shoplazza theme-extension versions [参数]

参数	类型	说明
--path <路径>	string	项目路径（默认：当前目录）