用途：当需要了解 Apple Ads 投放表现（花费、CPI、点击、安装、哪些关键词或搜索词带来量）、修改账户（出价、预算、关键词、上线新活动），或对关键词做保留/淘汰/放量判断时使用。它是某真实账户生产系统的通用版本，账户相关数值需自行填写并保持更新。
主要能力：scripts/ 下只有四个脚本——api-client.ts、fetch-ads.ts（读取投放与洞察）、inspect-account.ts（读取配置）、apply-change.ts（唯一写入路径），不要新增第五个脚本。fetch-ads.ts 支持 campaigns、keywords、searchterms、impressionshare、popularity、suggestions、changehistory 等报告，可输出 json 或 markdown。apply-change.ts 默认 dry run，--apply 必须带 --reason，并把 API 回读值写入 ledger.md。
使用方式：首次运行需在本目录执行 bun install（依赖 jose 与 dotenv），凭据来自 .env 中的 APPLE_ADS_* 环境变量。读取示例：bun run scripts/fetch-ads.ts --report=campaigns --days=30 --output=json。修改示例：先 dry run，再 bun run scripts/apply-change.ts keyword-bid --id=<keywordId> --to=1.75 --apply --reason="…"。上线活动顺序为 campaign-create → negative-add → adgroup-create → keyword-add → campaign-status --to=ENABLED，且 campaign-create 始终生成 PAUSED 活动。
适用场景与限制：适合按查询隔离活动、维护否定词墙、用两个常设测试位持续测试，并以成熟队列 ROAS 而非 Apple 自身数据做决策。--days=N 指截至昨天的 N 个完整天，当前未完成日需显式 --include-today。Apple 数据不含收入，需 RevenueCat、MMP 或自有后端归因。搜索词报告可能因隐私阈值隐藏查询文本但仍有真实花费。具体门槛值、预算与账户配置需自行填写，资料未提供。