用途:为所有在架 App 生成 App Store 销售与下载日报,输出 Markdown。触发方式为运行 python3 scripts/sales_report.py(无参数、无需人工干预),输入 data/apps_full.json 与 data/sales_cache.json,输出到 stdout 与 data/report.md,并需将完整报告粘贴回对话。
前置条件:所有步骤都调用 App Store Connect API,须先运行 python3 scripts/appmate_config.py check;退出码非 0 时停止,提示用户凭据未配置并改用 appmate-setup 技能。
主要能力:拉取约 65 天每日报告,按 5 个固定顺序维度(昨日、近 7 天、近 30 天、本周、本月)聚合,给出总收入、总下载、环比百分比变化与 Top-3(按收入/下载)。脚本自动锚定最近有数据的日期、解码 gzip TSV 并缓存、失败日期记为 _error 下次重试、自动刷新近 3 天空缓存。收入按 Units × Developer Proceeds 经静态 40+ 币种汇率折算美元;IAP 行按 Parent Identifier 合并到父应用;下载按 Product Type Identifier 分类(1*/F1/FI1 计安装,7* 更新不计,IA* 计入收入与 iap_units 不计下载)。
限制:Apple 日报通常延迟 1–2 天;汇率为静态估算,非财务对账口径;本周数据未发布时显示未发布;多币种退款(负 Units)自动扣减但不单独标注。报告模板、emoji 集合与 10 条规则需严格遵循,标题语言与用户对话语言一致。