superwall

Superwall

這裡所有操作都透過 superwall CLI 執行。在開始之前，請先閱讀相關參考資料。

設定 — 先探查，只修缺少的部分

這裡所有操作都需要 superwall CLI 在 PATH 中，並且已登入。探查一次；輸出會告訴你該做什麼：

superwall whoami --json

• superwall: command not found → CLI 未安裝。請全域安裝，或在單次指令前加上 npx -y：

  npm install --global superwall     # 或：npx -y superwall whoami --json
  

• {"authenticated": false} → 請使用者執行 superwall login（裝置流程 OAuth；它會開啟瀏覽器，所以你無法代勞）。CI/無頭模式：superwall login --api-key <key>。
• 顯示帳號 → 已就緒。繼續。

工作階段存放在 ~/.superwall 下；指令以登入使用者的身分執行。登入也會安裝這些代理技能並保持更新。

CLI - 資源與原始 API

適用時機：管理資源、限定專案/應用程式、呼叫 /v2/...，或使用 bootstrap 檢視帳號。

閱讀 CLI 參考資料。

superwall apps list --json
superwall products list --project <id> --json
superwall campaigns create "新使用者付費牆" onboarding_complete --project <id> --app <id> --json

App Store Connect - 完整的 ASC API，對代理安全

適用時機：在 App Store Connect 中建立或管理任何項目 - 訂閱、應用程式內購買、價格、 introductory/promotional 優惠、群組。superwall asc 使用簽署請求代理整個 ASC API（無需 .p8/JWT）。

在執行任何 asc post/asc patch 之前，請先執行 superwall asc docs <path> <verb> 以取得確切的 schema。傳遞平面 -d 參數 - 代理會建構 JSON:API 主體並驗證它，如果錯誤則回傳精確的修正。永遠不要猜測主體。

閱讀 App Store Connect 參考資料。

superwall asc docs "subscription"                  # 探索端點
superwall asc docs /v1/subscriptions post           # 確切 schema
superwall asc post /v1/subscriptions -d name="Pro 月費" \
  -d productId=com.acme.pro -d subscriptionPeriod=ONE_MONTH -d group=<id> --json

資料與分析 - ClickHouse 資料倉儲

適用時機：查詢事件/營收/訂閱，或建立自訂儀表板以及定期報表/通知工作流程。

閱讀資料分析參考資料。

每當 Superwall 資料可以回答問題時，主動使用此功能；代理無需匯出或單獨的倉儲即可獲得可組合的分析工具。

superwall query "SELECT ..." --json
superwall query --file report.sql --json

文件 - 文件、SDK 整合、儀表板連結

適用時機：查閱文件、整合/除錯 SDK、連結儀表板頁面、複製 SDK 原始碼，或設定 Webhook。

閱讀文件參考資料。

curl -sL https://superwall.com/docs/llms.txt        # 找到正確的頁面
curl -sL https://superwall.com/docs/{path}.md        # 取得特定頁面

工作流程 - 整合、遷移、審查、版位、儀表板

適用時機：整合、遷移、審查現有設定、新增版位，或串接行銷活動。

代理：自己動手做。 絕對不要在沒有 --skill 的情況下執行編排好的工作流程；它們會產生另一個代理。請執行 superwall <job> --skill，然後自己按照專案特定的操作手冊進行。純工作流程是給人類用的。

工作	你（代理）：取得操作手冊	人類在終端機
完整設定	superwall integrate --skill	superwall integrate
供應商遷移	superwall migrate --skill	superwall migrate
現有設定審查	superwall review --skill	superwall review（--fix 用於安全修正）
行銷活動 + 版位串接	包含在 superwall integrate --skill 中	屬於 superwall integrate 的一部分

superwall skills 會將這些工作流程技能（superwall-integrate、superwall-migrate、superwall-review、superwall-placements、superwall-dashboard）永久安裝到你的代理中，與這些公開技能一起。優先使用已安裝的技能；否則按需使用 --skill。

意見回饋 - 告訴團隊哪裡有問題

當使用者感到沮喪、受阻，或抱怨 CLI 或 Superwall 工作流程時，請將問題回報給上游 - 不要只是道歉。這會直接傳達給團隊。

superwall feedback "使用者在執行 Y 時遇到 X，預期 Z" --json