# 主题扩展

> Shoplazza CLI 的 theme-extension 命令（别名 te）：创建、本地调试、构建、部署、关联与发布 Theme 扩展。

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

## create

创建 Theme 扩展脚手架。

```shell
shoplazza theme-extension create [参数]
```

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

## serve

注册、推送并启动增量同步，监听文件变更。

```shell
shoplazza theme-extension serve [参数]
```

| 参数 | 类型 | 说明 |
|------|------|------|
| `--theme-id, -t <THEME_ID>` | string | 主题 ID（必填） |
| `--project-root <路径>` | string | 项目根目录 |

## build

构建新的扩展版本（打包、上传并在服务端创建版本）。

```shell
shoplazza theme-extension build [参数]
```

| 参数 | 类型 | 说明 |
|------|------|------|
| `--version <版本号>` | string | 新的语义化版本号，如 `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 扩展链接到应用。

```shell
shoplazza theme-extension connect [参数]
```

| 参数 | 类型 | 说明 |
|------|------|------|
| `--client-id <id>` | string | 要链接的应用 client_id（必填） |
| `--partner <id>` | string | Partner 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 扩展的版本。

```shell
shoplazza theme-extension versions [参数]
```

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