用途：这是 StackAdapt 的智能体原生 CLI（stackadapt-pp-cli），用于分析你已经在跑的 StackAdapt 广告系列，属于只读报表与分析工具，适合智能体和脚本调用并获取 JSON 输出。
主要能力：pacing 查看各广告系列相对预算的投放节奏（欠投或超投）；delivery-drift 按周追踪 CTR、CPM、spend 漂移并标记表现退化；bottleneck 按最差 ROAS/CPA 对高花费广告系列排名并给出原因列；stale-campaigns 查找最近 N 天零投放的活跃系列；report 拉取投放报表，可用 --select 配合点号路径只取需要的字段；graphql 提供原始 GraphQL 透传；sync、search、sql 支持把对象镜像到本地 SQLite 后离线检索与只读 SQL 查询；which 用自然语言把能力查询解析到最匹配命令。
安装与验证：npx -y @mvanhorn/printing-press-library install stackadapt --cli-only；验证 stackadapt-pp-cli --version。若 npx 失败可改用 go install github.com/mvanhorn/printing-press-library/library/marketing/stackadapt/cmd/stackadapt-pp-cli@latest（需 Go 1.26.6+）。
鉴权：使用 StackAdapt GraphQL API 令牌，需向账户经理申请；export STACKADAPT_API_TOKEN=your-token 后运行 stackadapt-pp-cli doctor 确认连接，令牌以 Authorization: Bearer <token> 发送。
使用方式：任意命令加 --agent（等价于 --json --compact --no-input --no-color --yes）；--dry-run 预览请求；--deliver 支持 stdout、file:<path>、webhook:<url>；profile save/list/show/delete 可保存复用参数。退出码 0 成功、2 用法错误、3 资源未找到、4 需鉴权、5 API 错误、7 限流、10 配置错误。
限制：该 CLI 只读，不可创建、编辑、暂停或删除广告系列、广告与受众，也不用于上传受众或素材、实时竞价或像素触发；这些操作需使用 StackAdapt UI 或官方 SDK。legacy REST key 无法使用。