快捷命令
快捷命令以 + 为前缀，专为高频操作设计，同时面向人类开发者和 AI Agent。在交互式终端中，漏填的必填参数会被逐一询问；脚本、CI 和智能体则直接得到 required flag(s) not set 错误。
语法
shoplazza <主题> +<操作> [参数]
可用快捷命令
商品（9 个）
| 命令 | 说明 |
|---|---|
products +search | 按标题、供应商、商品合集或上架状态搜索商品 |
products +count | 统计商品数量 |
products +create | 创建单规格商品 |
products +set-price | 按变体 ID、SKU 或商品 ID 设置变体价格 |
products +set-variants | 一次请求编辑商品的规格矩阵（规格值、规格维度、变体价格） |
products +stock | 设置或增减变体库存 |
products +tag | 添加、移除或替换标签，不影响其他标签 |
products +publish | 上架 |
products +unpublish | 下架 |
订单（5 个）
| 命令 | 说明 |
|---|---|
orders +search | 搜索订单 |
orders +count | 统计订单 |
orders +ship | 创建履约 |
orders +refund | 创建退款 |
orders +update-tracking | 更新物流 |
折扣（8 个）
| 命令 | 说明 |
|---|---|
discounts +search | 搜索折扣 |
discounts +rebate | 创建自动满减 |
discounts +flashsale | 创建限时折扣 |
discounts +mn-discount | 创建满件折（按件数分级的第 N 件折扣） |
discounts +percent-code | 百分比折扣码 |
discounts +amount-code | 固定金额折扣码 |
discounts +bxgy-code | 买 X 送 Y 码 |
discounts +free-shipping-code | 免运费码 |
客户（3 个）
| 命令 | 说明 |
|---|---|
customers +search | 搜索客户 |
customers +count | 统计客户数量 |
customers +create | 创建客户 |
店铺（1 个）
| 命令 | 说明 |
|---|---|
shop +upload-file | 提交文件上传任务，把公网 URL 的文件拉取到媒体库（不支持本地文件） |
主题（6 个）
| 命令 | 说明 |
|---|---|
themes +page | 读取模板页面：按渲染顺序列出区块，并给出可直接复制的 target |
themes +edit | 在一个编辑会话内对模板页面批量执行编辑操作 |
themes +card-schema | 读取可添加主题卡片的 settings 与 blocks schema |
themes +preview | 输出主题的店面预览 URL |
themes block +edit | 写入生成的 block 文件并放到模板页面上 |
themes block +get | 读取生成的 block：文件信息、引用次数和放置位置 |
主题开发命令（themes init、serve、pull、push、package、share）是普通命令，不是快捷命令，见 theme。
通用参数
| 参数 | 说明 |
|---|---|
--format <json|pretty|table|ndjson|csv> | 输出格式（全局参数） |
--dry-run | 输出将要发送的请求，不实际执行 |
--jq <表达式> / -q | 过滤 JSON 输出 |
搜索类快捷命令还支持 --page-limit（页大小，1–250）；products +search 支持 --fields <f1,f2> 指定 API 返回的字段。
示例
shell
shoplazza products +search --keyword "dress" --format table
shoplazza products +search --keyword "dress" --fields "id,title,price_min" --format table