開源 · MIT 授權

在終端機管理
App Store Connect。

用於管理 iOS 和 macOS 應用程式的 Swift 命令列工具。提交版本、管理截圖、追蹤建構——同時內建完整的 CAEOAS 可供 AI 智能體調用。

$ brew install tddworks/tap/asccli
在 GitHub 上查看
130+
命令
CAEOAS
AI 智能體就緒
MIT
開源授權
100+
API 端點
zsh — 80×24

功能特性

所需功能，一應俱全

基於官方 App Store Connect API，採用清晰的三層架構，並提供完整的 Affordance 輸出，專為 AI 智能體工作流設計。

AI 智能體就緒（CAEOAS）

每條回應都內嵌可直接執行的下一步命令，存儲在 affordances 欄位中。智能體無需了解完整命令樹，只需跟隨連結即可。

App
├─ AppStoreVersion
│  └─ Localization
│     └─ ScreenshotSet
├─ AppInfo
│  └─ AppInfoLocalization
├─ Build
└─ TestFlight

完整資源層級

管理完整的 App Store Connect 資源樹：應用程式 → 版本 → 本地化 → 截圖集 → 截圖。同時支援建構和 TestFlight。

$ asc versions submit \
  --version-id a9657737
// 4 API calls, 1 command:
1. GET /appStoreVersions/{id}
2. POST /reviewSubmissions
3. POST /reviewSubmissionItems
4. PATCH /reviewSubmissions/{id}
✓ state: WAITING_FOR_REVIEW

一鍵提交審核

一條命令即可將任意 iOS 或 macOS 版本提交審核。CLI 自動處理完整的多步驟審核提交流程。

提交前檢查

一個命令在提交前執行所有檢查。可檢測缺失的構建版本、未設定定價以及不完整的本地化——按「必須修復」與「建議修復」嚴重程度分類。只有當所有檢查通過時，提交操作才會出現。

$ asc iris status
source: browser · cookies: 5
$ asc iris apps create \
  --name "My App" \
  --bundle-id com.example.app \
  --sku MYSKU
✓ id: 1234567890

Iris（私有 API）

存取驅動 App Store Connect 網頁端的私有 API。建立新應用程式、列出所有應用程式 — 這些功能公開 REST API 無法實現。基於瀏覽器 Cookie 認證，無需額外設定。

# 一次性儲存金鑰
$ asc app-shots config \
  --gemini-api-key KEY
# 將 PNG 放入 .asc/app-shots/ → 執行
$ asc app-shots generate
# 一條指令完成本地化
$ asc app-shots translate \
  --to zh --to ja
✓ screen-0.png · 1320×2868
✓ zh/ ja/ ← localized

AI 截圖產生器

使用 Gemini AI 生成 1320×2868（iPhone 6.9"）App Store 截圖。一條指令完成本地化 — asc app-shots translate --to zh --to ja。輸出尺寸精確。

$ asc version-localizations list \
  --version-id v1
$ asc version-localizations update \
  --localization-id id \
  --whats-new "Bug fixes"
✓ en-US · zh-Hans · ja · ko

版本本地化

更新每個語言版的「新功能」文字、描述、關鍵字和促銷 URL。支援列出、建立和更新所有支援語言的完整 CRUD 操作。

$ asc screenshot-sets create \
  --localization-id id \
  --display-type APP_IPHONE_67
$ asc screenshots upload \
  --set-id id --file screen.png
✓ 3-step ASC upload flow

截圖管理

為任意尺寸建立截圖集，並透過三步 ASC 上傳流程上傳 PNG 圖片。支援所有 iPhone、iPad、Mac 和 Apple TV 顯示類型。

$ asc app-preview-sets create \
  --localization-id id \
  --preview-type IPHONE_67
$ asc app-previews upload \
  --set-id id --file preview.mp4 \
  --preview-frame-time-code 00:00:05

App 預覽影片

上傳影片預覽（.mp4、.mov、.m4v），可選擇縮圖時間碼。CLI 自動處理完整的三步上傳流程：預留、分塊上傳和 MD5 確認。

$ asc app-info-localizations list \
  --app-info-id id
$ asc app-info-localizations update \
  --localization-id id \
  --name "My App" \
  --subtitle "Do things faster"

應用程式資訊本地化

讀寫每個語言版的應用程式中繼資料：名稱、副標題和隱私政策 URL。應用程式層級的中繼資料適用於所有版本，與版本本地化分開管理。

# 一次設定，永久使用
$ asc auth login \
  --key-id KEY \
  --private-key-path ~/.asc/Key.p8
✓ 已儲存至 ~/.asc/credentials.json
# 無需環境變數，直接使用
$ asc apps list

持久化登入認證

使用 asc auth login 一次性儲存 API 金鑰，憑證存儲於 ~/.asc/credentials.json，每條命令自動讀取，無需每次配置環境變數。

$ asc builds upload \
  --app-id id --file MyApp.ipa \
  --version 1.2.0 --build-number 55
// 5-step flow:
1. Reserve slot
2. Upload chunks
3. Confirm MD5
✓ state: processing

建置包上傳

透過五步 ASC 上傳流程上傳 IPA/PKG：預留位置、分塊上傳、確認 MD5，再輪詢處理狀態。支援列出、取得和刪除上傳記錄。

$ asc testflight groups list \
  --app-id id
$ asc testflight testers add \
  --beta-group-id id \
  --email [email protected]
$ asc testflight testers import \
  --beta-group-id id --file testers.csv

TestFlight

管理 Beta 測試群組和測試人員：按電子郵件新增或移除，透過 CSV 批次匯入/匯出，向測試群組發布建置，並按語言更新「新功能」說明。

多種輸出格式

專為人類和機器設計。支援 JSON（預設）、表格或 Markdown 格式輸出，輕鬆接入 jq、腳本或 AI 智能體。

$ asc iap create --app-id id \
  --type consumable \
  --reference-name "Coins 100"
$ asc iap prices set \
  --iap-id id --base-territory USA \
  --price-point-id id
$ asc iap submit --iap-id id

應用程式內購買

建立消耗型、非消耗型和非續訂訂閱 IAP。從 App Store 價格點設定按地區定價，管理每個語言版的名稱和描述，並提交審核。

$ asc subscription-groups create \
  --app-id id --reference-name "Pro"
$ asc subscriptions create \
  --group-id id --period ONE_MONTH
$ asc subscription-offers create \
  --subscription-id id \
  --mode FREE_TRIAL --periods 7

自動續訂訂閱

建立訂閱群組和訂閱等級（按週到按年）。管理推介優惠（免費試用、按使用付費、預付款），以及每個語言版的中繼資料，並提交審核。

$ asc bundle-ids create \
  --name "My App" \
  --identifier com.example.app \
  --platform ios
$ asc profiles create \
  --type IOS_APP_STORE \
  --bundle-id-id id --certificate-ids id

程式碼簽署

管理完整的簽署鏈：註冊 Bundle ID、從 CSR 建立憑證、按 UDID 註冊裝置，以及建立或刪除配置描述檔——全部在終端機完成。

$ asc tui
┌─ Apps ─────────────────────────┐
│ ▶ AppNexus │
│  My Other App │
└────────────────────────────────┘
↑↓ navigate · Enter · Esc back

互動式 TUI 模式

執行 asc tui 開啟完整的終端機 UI 瀏覽器，用方向鍵瀏覽應用程式、版本、建置和 TestFlight——無需記憶命令，非常適合探索和發現。

快速開始

數分鐘內快速上手

1
$ brew install tddworks/tap/asccli
🍺 Pouring asc...
✓ asc installed
$ asc --version
asc 1.0.0

透過 Homebrew 安裝

一條命令即可安裝最新版本，無需 Xcode 或 Swift 工具鏈。

2
$ asc auth login \
  --key-id YOUR_KEY_ID \
  --issuer-id YOUR_ISSUER \
  --private-key-path ~/.asc/Key.p8
$ asc auth check
✓ source: "file" · key: YOUR_KEY_ID
# 憑證已儲存至 ~/.asc/credentials.json

一次登入，永久使用

使用 asc auth login 儲存 API 金鑰，憑證存儲於 ~/.asc/credentials.json，之後無需每次配置環境變數。

3
$ asc apps list
$ asc versions list --app-id <id>
$ asc screenshots upload \
  --set-id <id> --file shot.png
$ asc versions submit \
  --version-id <id>
✓ Submitted for review

開始管理您的應用程式

列出應用程式、查看版本、上傳截圖、提交審核——一切盡在終端機，也可由 AI 智能體自動完成。

智能體技能

為你的 AI 智能體加速

安裝 26+ 個預建技能，教你的 AI 編程智能體如何使用每一個 asc 命令——從上傳到提交。

$ asc skills install --all

asc-builds-upload

上傳 IPA/PKG 建置包並管理 TestFlight 發布

asc-app-shots

使用 AI 生成和翻譯 App Store 截圖

asc-check-readiness

提交審核前的預先檢查

asc-auth

設定和管理 App Store Connect API 憑證

asc-testflight

管理 TestFlight 的測試群組和測試人員

asc-release-workflow

端到端發布流程：版本號、封存、上傳、提交

26+ 個技能可用——相容 Claude Code、Cursor、Windsurf 等

準備好試用 asc 了嗎？

自動化您的 App Store Connect 工作流

$ brew install tddworks/tap/asccli
在 GitHub 上查看原始碼

社群

應用展示

開發者使用 asc CLI 發布到 App Store 的真實應用程式。

$ asc app-wall submit --app-id <your-app-id>

一條命令提交應用程式並開啟 Pull Request →

Built for real apps

Sponsors