用途：通过捆绑的 CLI 调用 Mintegral AppGrowth 官方 Open API，查询并安全管理广告数据，不自行构造临时 HTTP 请求。
主要能力：读取账户余额、广告系列/Offer/创意集、效果报表；创建或更新广告系列与 Offer；启停 Offer；替换默认、地区或发布商出价与预算配置；替换发布商允许/屏蔽设置；更新点击与展示追踪 URL；更新目标受众 ID；通过 v3 端点更新 Target-ROAS 或 Target-CPE 目标；创建、更新、删除创意集；上传创意文件与试玩素材并返回 Mintegral MD5。
使用方式：需 Python 3.10 及以上，通过 scripts/mintegral_ads.sh 运行。从环境变量读取 MINTEGRAL_ACCESS_KEY 与 MINTEGRAL_API_KEY，API 主机固定为 ss-api.mintegral.com，上传仅用 ss-storage-api.mintegral.com。凭据在 Mintegral AppGrowth 的 Account > Basic Information 获取，脚本每次请求在内存中派生短期请求令牌。可用 check 检查配置、list-actions 与 describe 查看动作。
安全规则：GET 动作可直接执行；所有变更默认预览，需用户显式授权后加 --execute 重跑。变更前须确认具体广告系列、Offer、创意集、受众或发布商 ID。出价、预算与发布商定向动作需 --acknowledge-full-replacement，并基于实时对象预览、复制 replacement_plan_hash 后执行，载荷变化须重新预览。删除需 --confirm-delete。追踪 URL、受众标识或大载荷使用仅所有者可读的 JSON 文件。变更不自动重试，仅安全读取可在限流或瞬时错误后重试。HTTP 2xx 不足，须响应 code=200；变更后重新读取对象比对字段，verified=false 视为未完成验证。
限制与失败处理：maintain_by=AM 时停止，由客户经理管理；发布商级出价或定向权限不足需向客户经理申请高级功能；报表 code=207 时日期窗口缩至最多八天并排除今天及未来；哈希不匹配须重新预览，不得绕过或复用旧哈希；凭据缺失时说明获取位置并请用户导出环境变量，不得将密钥作为命令行参数。字段或枚举不确定时查阅官方文档，不要猜测。