# 命令参考

> 按主题分组的 Shoplazza CLI 命令总目录：认证、应用、主题、扩展、店铺数据、平台功能与工具命令，并附全局参数。

本参考文档列出所有 Shoplazza CLI 命令，按主题分组。

## 命令语法

```
shoplazza [主题] [命令] [参数]
```

## 三层命令体系

| 层级 | 语法 | 适用场景 |
|------|------|---------|
| **快捷命令** | `shoplazza <主题> +<操作>` | 日常操作，智能默认值 |
| **API 命令** | `shoplazza <主题> <操作>` | 完整控制 API 参数 |
| **原始 API** | `shoplazza api rest <方法> <路径>` | 上述未覆盖的任意端点 |

详见 [三层命令体系](../guides/command-layers)。

## 命令分组

### 认证与配置

| 命令 | 说明 |
|------|------|
| [auth login](./auth#login) | 通过 OAuth 2.0 登录 |
| [auth logout](./auth#logout) | 移除存储的凭证 |
| [auth status](./auth#status) | 显示当前认证状态 |
| [auth scopes](./auth#scopes) | 列出可用的 OAuth 作用域 |
| [auth store use](./auth#store-use) | 切换到其他店铺 |

### 应用开发

| 命令 | 说明 |
|------|------|
| [app init](./app#init) | 初始化或链接应用项目 |
| [app list](./app#list) | 列出账户下的应用 |
| [app info](./app#info) | 显示应用元数据 |
| [app dev](./app#dev) | 启动本地开发服务器 |
| [app deploy](./app#deploy) | 部署应用到生产环境 |
| [app config link](./app#config-link) | 链接应用配置 |
| [app config use](./app#config-use) | 切换应用配置 |
| [app extension create](./app#extension-create) | 创建扩展脚手架 |
| [app versions](./app#versions) | 列出已部署版本 |
| [app function compile](./app#function-compile) | 编译 Function 扩展为 WASM |
| [app function release](./app#function-release) | 编译并发布 Function 扩展 |
| [app function list](./app#function-list) | 列出 Function 扩展 |

### 主题开发

| 命令 | 说明 |
|------|------|
| [themes init](./theme#init) | 创建新主题脚手架 |
| [themes serve](./theme#serve) | 实时预览主题 |
| [themes pull](./theme#pull) | 从店铺下载主题 |
| [themes push](./theme#push) | 上传主题到店铺 |
| [themes package](./theme#package) | 打包主题为 ZIP |
| [themes share](./theme#share) | 分享主题预览链接 |

### 扩展开发

| 命令 | 说明 |
|------|------|
| [checkout-extension init](./checkout-extension#init) | 创建 Checkout 扩展项目脚手架 |
| [checkout-extension create](./checkout-extension#create) | 在已有项目中添加扩展 |
| [checkout-extension dev](./checkout-extension#dev) | 本地开发服务器 :8888 |
| [checkout-extension build](./checkout-extension#build) | 使用 Vite 构建扩展 |
| [checkout-extension push](./checkout-extension#push) | 上传新版本 |
| [checkout-extension deploy](./checkout-extension#deploy) | 激活版本 |
| [checkout-extension undeploy](./checkout-extension#undeploy) | 取消部署扩展 |
| [theme-extension create](./theme-extension#create) | 创建 Theme 扩展脚手架 |
| [theme-extension serve](./theme-extension#serve) | 增量同步开发服务器 |
| [theme-extension build](./theme-extension#build) | 构建新版本 |
| [theme-extension deploy](./theme-extension#deploy) | 在店铺启用版本 |
| [theme-extension connect](./theme-extension#connect) | 将扩展链接到应用 |
| [theme-extension release](./theme-extension#release) | 在绑定应用中发布版本 |

### 店铺数据（快捷命令 + API 命令）

| 主题 | 快捷命令 | API 命令数 | 参考 |
|------|----------|-----------|------|
| 商品 | `+search`, `+create`, `+set-price`, `+stock`, `+publish`, `+unpublish`, `+count`, `collections +create` | 78 | [products](./products) |
| 订单 | `+search`, `+count`, `+ship`, `+refund`, `+update-tracking` | 36 | [orders](./orders) |
| 折扣 | `+search`, `+rebate`, `+flashsale`, `+mn-discount`, `+percent-code`, `+amount-code`, `+bxgy-code`, `+free-shipping-code` | 15 | [discounts](./discounts) |
| 客户 | `+search`, `+create` | 11 | [customers](./customers) |
| 店铺 | `+upload-file` | 64 | [shop](./shop) |
| 主题 (API) | — | 15 | [themes-api](./themes-api) |

### 平台功能

| 命令 | 说明 |
|------|------|
| [billing one-time](./billing#one-time) | 一次性收费管理 |
| [billing recurring](./billing#recurring) | 周期性订阅管理 |
| [billing usage](./billing#usage) | 用量计费 |
| [billing transactions](./billing#transactions) | 交易查询 |
| [webhook create](./webhook#create) | 注册事件 Webhook |
| [webhook list](./webhook#list) | 列出已注册的 Webhook |

### 工具命令

| 命令 | 说明 |
|------|------|
| [api rest](./api#rest) | 发送原始 HTTP 请求到任意端点 |
| [schema](./schema) | 查看可用的 API 及参数 |
| [update](./update) | 更新 CLI 到最新版本 |
| [completion](./completion) | 生成 Shell 自动补全脚本 |
| [doctor](./doctor) | 运行诊断检查 |
| `--version` / `-v` | 显示 CLI 版本 |
| `--help` / `-h` | 显示命令帮助 |

## 全局参数

| 参数 | 说明 |
|------|------|
| `--format <json\|pretty\|table>` | 输出格式（默认：`json`） |
| `--jq <表达式>` / `-q` | 使用 jq 表达式过滤 JSON 输出 |
| `--dry-run` | 预览请求，不实际执行 |
| `--debug` | 启用调试输出 |
| `--version` / `-v` | 显示 CLI 版本 |
| `--help` / `-h` | 显示命令帮助 |

详见 [全局参数](../reference/global-flags)。