跳到正文
asc-cli 技能手册

asc-analytics-reports

分析报告采集

采集、下载并校验私有的 App Store Connect 分析报告。

帮助查找已存在的分析报告请求,按处理日期或粒度筛选报告实例,并下载每一个报告分段,同时依据 Apple 提供的文件大小与 MD5 元数据逐一校验完整性。

适用场景

  • 需要查找已存在的分析报告请求时
  • 想按处理日期或粒度筛选报告实例时
  • 需要下载并对照 Apple 的大小与 MD5 元数据校验每个报告分段时

命令示例

大写占位符(如 APP_ID、BUILD_ID)请替换为你自己的值;标有「对智能体说」的行是给 AI 智能体的提示词,不会被复制。

zsh
# 先确认命令契约,再交给智能体执行「查找请求 → 选择实例 → 下载分段 → 校验」
$asc analytics view --help
# 查找已有报告请求,并列出某个请求下的报告实例
$asc analytics requests --app "APP_ID" --paginate --output json
$asc analytics view --request-id "REQUEST_ID" --paginate --output json
# 按处理日期与粒度筛选,并下载单个分段(需 asc 3.5.0+)
$asc analytics view --request-id "REQUEST_ID" --processing-date "2026-01-15" --granularity DAILY --paginate --include-segments --output json
$asc analytics download --request-id "REQUEST_ID" --instance-id "INSTANCE_ID" --segment-id "SEGMENT_ID" --output "./segment.txt.gz"
# 让智能体做完整采集与大小 / MD5 校验
对智能体说采集我最新的周度分析报告,私有下载每个分段文件,并在分析前逐一校验完整性

安装此技能

安装 asc 后运行下面的命令即可一次性安装全部技能,其中包含 asc-analytics-reports。

zsh
$asc install-skills