> ## 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>