Skip to main content
superun CLI 把運行中應用的後端能力帶到終端。它可以查詢和修改 PostgREST 數據、調用 Postgres RPC，並通過 OpenAPI 清單發現和調用 Edge Functions。 它用於 操作和自動化應用，不負責下載專案源碼或發布專案。如需本地開發和上線，請使用蘇小強 CLI。

​
準備工作

你需要：
  • Node.js 20 或更高版本；
  • 你有權使用的應用後端 URL 和 anon key；
  • 該應用支持的一種登入方式。
對於在 superun 中創建的應用，建議從 研發 → 技能庫 → 連接 AI 應用（標籤為 Agent 友好）開始；也可從 運營 → Agent 友好 進入。系統生成的安裝指引已包含當前應用的配置。詳見 Agent 友好。

​
安裝

確認 superun 命令可用：

​
連接應用並登入

註冊後端，並為它設置一個本地別名：
然後以應用用戶身份登入：
如果已有 access token，也可以直接使用：
執行寫操作前，先確認當前身份：

​
操作應用數據

update 和 delete 預設必須帶過濾條件。只有顯式添加 --all 才能執行全表操作。 所有請求都使用當前用戶的會話，因此應用的行級安全策略（RLS）仍然生效。命令只能訪問當前登入用戶有權訪問的數據。

​
調用 Edge Functions

CLI 會從應用的 OpenAPI 清單發現應用專屬函數。建議從分組逐級查看到單個函數：
應用接口發生變化後，刷新本地緩存的函數清單：

​
管理多個應用

如需只讓一條命令使用另一個已配置應用，可添加 -a，無需切換當前應用：

​
命令速查

使用 superun <command> --help 查看全部參數和輸入要求。

​
安全與排查

  • 敏感寫操作前，先運行 superun app show 和 superun whoami。
  • access token 和 refresh token 都屬於敏感憑據。只把 Agent 友好安裝指引交給可信的 AI 助手或運行環境。
  • 401 通常表示當前會話對這個後端已失效。請使用同一應用籤發的 token 重新登入。
  • 如果 superun fn 為空或內容過期，請運行 superun app refresh。應用必須提供有效的 CLI 清單才能發現函數。
  • 資料庫和函數調用可能立即產生業務影響，執行前請檢查命令和請求數據。

npm 上的 superun CLI

查看已發布的軟體包和當前版本。

源代碼

閱讀完整參考資料或提交問題。