> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 命令行工具

> 了解用于操作线上应用的 superun CLI，以及用于开发和发布项目的苏小强 CLI。

superun 提供两款官方命令行工具。它们工作在应用的不同层面，不能相互替代。

|              | **superun CLI**                   | **苏小强 CLI**               |
| ------------ | --------------------------------- | ------------------------- |
| 终端命令         | `superun`                         | `sxq`                     |
| npm 包        | `superun-cli`                     | `suxiaoqiang-cli`         |
| 操作对象         | 运行中应用的数据和接口                       | 应用项目的源码和发布版本              |
| 典型任务         | 查询或修改业务数据、调用 RPC 和 Edge Functions | 拉取和推送代码、预览编译、正式上线、执行数据库迁移 |
| 适合场景         | 运营操作、业务自动化、让 AI 智能体使用应用           | 本地开发、AI 编程、CI             |
| Node.js 最低版本 | 20                                | 18                        |

<Note>
  最简单的记法：**`superun` 用应用，`sxq` 做应用。**
</Note>

## 如何选择

以下情况使用 **superun CLI**：

* 以当前登录用户身份查看表或读写数据；
* 调用 Postgres RPC 或应用的 Edge Function；
* 让可信的 AI 智能体在应用中完成业务操作；
* 不下载源码，在多个应用后端之间切换并执行命令。

以下情况使用 **苏小强 CLI**：

* 把 superun 项目文件下载到本地目录；
* 使用 IDE 或 AI 编程智能体修改代码，再同步回 superun；
* 触发预览编译或正式上线；
* 执行 `supabase/migrations/` 中新增的 SQL 迁移。

## 容易混淆的任务

| 任务                         | 使用                        | 原因             |
| -------------------------- | ------------------------- | -------------- |
| 修改某个客户的订单状态                | `superun db update` 或应用函数 | 修改的是运行中应用的业务数据 |
| 给 `orders` 表新增 `status` 字段 | `sxq db push`             | 通过迁移修改数据库结构    |
| 为某个订单调用 `send-invoice`     | `superun fn ...`          | 调用应用已经提供的能力    |
| 修改 `send-invoice` 的实现      | `sxq pull` / `sxq push`   | 修改项目源码         |
| 把已完成的版本发布到线上               | `sxq deploy`              | 发布整个项目         |

<Warning>
  `superun db` 的写操作会立即影响应用数据；`sxq deploy` 和 `sxq db push` 会改变线上应用或数据库结构。确认写入、迁移或发布前，请检查目标应用和命令内容。
</Warning>

<CardGroup cols={2}>
  <Card title="使用 superun CLI" icon="terminal" href="/superun/cli/superun-cli">
    以当前用户身份操作应用数据和接口。
  </Card>

  <Card title="使用苏小强 CLI" icon="code" href="/superun/cli/suxiaoqiang-cli">
    在本地开发、同步、预览和发布 superun 项目。
  </Card>
</CardGroup>