SuperAPI AI 工具集

asc-cli-usage

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:本技能用于在需要运行或设计面向 App Store Connect 的 asc 命令时提供指导。

命令发现:始终用 --help 发现命令与标志,如 asc --help、asc builds --help、asc builds list --help。已知工作流但不确定命令路径时,用 asc search 做本地确定性发现,如 asc search "submit app for review"、asc search --output table "upload build"。设计面向 API 的命令前,用 asc schema 查看内置端点模式与请求/查询字段,如 asc schema --pretty "GET /v1/apps"、asc schema --method POST appStoreVersions。用 asc capabilities 说明 CLI 支持、部分支持、web 会话及公共 API 受限的工作流覆盖,如 asc capabilities --area release --output table。

规范动词:只读命令优先用 view 而非旧 get 别名,如 asc apps view --id "APP_ID"、asc versions view --version-id "VERSION_ID"。仅更新的可用性界面及其他规范编辑流程优先用 edit,如 asc pricing availability edit --app "APP_ID" --territory "USA,GBR" --available true。使用仅更新的 edit 前,先用 asc pricing availability create 初始化应用可用性;若 Apple 拒绝公共 API 引导,可认证 web 会话后用 asc web apps availability create,或在 App Store Connect 中配置。当 --help 仍显示 set 为规范动词时保留 set。

标志约定:使用显式长标志(如 --app、--output);自动化中优先显式标志,部分新命令交互式运行时会提示缺失字段;破坏性操作需 --confirm;需要全部页面时用 --paginate。

输出格式:默认感知 TTY,交互终端用 table,管道或非交互用 json;仅人类可读输出用 --output table 或 --output markdown;--pretty 仅对 JSON 输出有效。

认证与默认值:优先用 asc auth login 的钥匙串认证;回退环境变量 ASC_KEY_ID、ASC_ISSUER_ID、ASC_PRIVATE_KEY_PATH、ASC_PRIVATE_KEY、ASC_PRIVATE_KEY_B64;ASC_APP_ID 可提供默认应用 ID。权限不明时用 asc web auth capabilities 检查密钥角色覆盖。可通过缓存的 Apple 账户 web 会话用 asc web api-keys create 创建团队 API 密钥,需 Account Holder 或 Admin 会话,必要时先 asc web auth login --apple-id "user@example.com";该命令保存一次性 P8 为 AuthKey_<KEY_ID>.p8 且不打印内容,可用 --output-dir 指定目录。

Apple Ads:选择命令前用 asc ads --help。Apple Ads 使用 asc ads auth、--ads-profile 和 ASC_ADS_* 变量,不使用 App Store Connect API 凭据。直接资源命令用 Platform API v1 与 --ad-account 或 ASC_ADS_AD_ACCOUNT_ID;已弃用的 Campaign Management API v5 命令位于 asc ads v5,使用 --org 或 ASC_ADS_ORG_ID,两者 ID 不可互换。用 asc ads auth discover --output json 发现广告账户访问权限。Body 命令用 --file 并遵循叶子帮助中的模式。Apple Ads 资源命令输出 JSON;仅在帮助显示处用 --paginate。删除及涉及支出、账单、投放、定向或访问的敏感变更需 --confirm。

超时:ASC_TIMEOUT / ASC_TIMEOUT_SECONDS 控制请求超时;ASC_UPLOAD_TIMEOUT / ASC_UPLOAD_TIMEOUT_SECONDS 控制上传超时。