千川每日投放检查
对巨量千川当日投放执行一次固定口径体检：取授权 → 取数 → 逐条过体检项 → 排序素材 → 给素材/出价/预算三类建议。
本 Skill 只做读取与判定，不执行任何后台写操作。
何时使用
用户提到以下任一表达时进入本流程：
- 「千川投放检查」「千川每日检查」「投放体检」
- 「帮我看看今天千川跑得怎么样」「今天千川要不要调」
- 「今天哪个素材最差」「千川要不要加预算」
不触发：单独出现「千川」两字；与投放检查无关的千川话题（开户、资质、结算、产品版本咨询）。
付费闸门
本 Skill 按次计费。未取得本次授权前，不得执行体检判定，也不得输出四段报告。
前置条件 确认当前环境具备支付能力
发起付费前先确认当前 Agent 环境中存在支付宝支付能力（官方 alipay-payment-skill 或 alipay-bot 提供的工具）。存在则继续；不存在则终止流程，提示用户安装官方「支付宝 AI 付」Skill 后重试。不要自建支付通道，不要手工构造付款链接或二维码。
第一步 确认付费配置
python scripts/paid_gate.py --show-config
输出 service_base_url_configured 为 false 时，只展示 references/pay-protocol.md 第八节的部署与配置说明，不进入体检流程。
第二步 请求本次授权
python scripts/paid_gate.py
第三步 按退出码路由
| 退出码 | 含义 | 动作 |
|---|---|---|
| 0 | 已取得授权 | 进入「开始前：环境检查」，继续体检流程 |
| 20 | 需要支付 | 把 [[QIANCHUAN_PAYMENT_REQUIRED]] 区块中的商品名、金额、订单号、支付截止时间原样告知用户，等用户完成支付 |
| 10 | 付费配置缺失 | 只展示缺失项的配置步骤，不进入体检流程 |
| 11 | 付费服务不可达 | 说明不可达原因，停止本次流程 |
| 12 | 付费服务返回异常 | 照录返回的状态码与代码；返回 FULFILLMENT_CONFIRM_FAILED 时提示用同一 Payment-Proof 重试，不要重新支付 |
第四步 用户确认已支付后携带凭证重试
python scripts/paid_gate.py --payment-proof-file <Payment-Proof 文本文件路径>
取得退出码 0 后，授权包写入 ~/.qianchuan-check/entitlement.json，此时才进入体检流程。
付费闸门的硬性约束
- 不得在未取得授权时输出体检报告，也不得先出报告再补支付。
- 不得伪造支付成功、不得跳过支付步骤、不得手动构造凭证。
- 不得向用户展示 Payment-Proof 原文、签名、密钥或任何凭据内容。
- 不得改写、截断或复用
payment-needed.txt与 Payment-Proof 文件内容。 - 支付与履约的失败状态照实报告，不隐瞒不替换。
开始前：环境检查
- 运行
python scripts/qianchuan_report.py --show-config。该命令只输出配置就绪状态，不输出任何凭据值。 - 再运行
python scripts/check_environment.py取依赖级状态。该脚本退出码非 0 表示存在未就绪依赖，不是崩溃；未提供宿主探测结果时，需要探测的检查项会返回probe_required，此时以第 1 步的本地结果为准。 - 按状态路由：
| 状态 | 判定依据 | 动作 |
|---|---|---|
| ready | 三项 configured 均为 true 且 token_cached 为 true | 跳过所有配置说明，直接执行主流程 |
| needs_setup | missing 非空 |
只展示缺失项的配置步骤（见 references/setup-guide.md）；用户拒绝配置时转手动兜底 |
| partial | 凭据齐全但部分接口取不到 | 直接执行主流程，在结果中标注本次降级范围 |
| unavailable | 凭据齐全但接口报错或 token 无法续期 | 展示原因与恢复步骤；无法恢复时转手动兜底 |
- 已经通过的配置项不重复讲解。
主流程
步骤 1 确认取数日期与账户
- 默认查询当日；用户指定日期则用指定日期。
- 目标账户取配置中的
advertiser_id；用户明确指定了别的账户时才覆盖。
步骤 2 取数
优先自动取数：
python scripts/qianchuan_report.py --date <YYYY-MM-DD>
脚本输出结构化 JSON，每个字段带 value、source、status 三项。
自动取数失败或未配置时转手动兜底（见「降级」）。
步骤 3 逐条过体检项
按 references/iron-rules.md 的四条硬性体检项逐条判定，每条只允许三种结论：过、不过、待确认。
判定只使用取到的原始数值，不用记忆或经验补值。任一判据缺失即判「待确认」，并写明缺哪一项。
四条体检项：
- 消耗是否 ≥ 200 元
- 投放时长是否 ≥ 直播时长一半
- ROI 是否偏离系统建议值 ±30% 以上
- 计划是否处于学习期
步骤 4 素材维度排序
- 按点击率与转化率对素材排序，标出表现最差的一条。
- 素材数据缺失时，本段只输出结构并标注「待确认」，不推断哪条最差。
步骤 5 输出
按 references/output-template.md 的四段结构输出。
每条建议必须附判据（引用具体体检项结论或具体数值）。没有判据的建议不得输出。
给出建议前，先按 references/iron-rules.md 第二节的三条铁律过一遍，违反任一条的建议直接删除。
降级
主通道不可用时不放弃整个流程，按下表降级：
| 触发条件 | 降级动作 | 输出标注 |
|---|---|---|
| 未配置 app_id / secret | 展示配置步骤；用户拒绝则转手动 | 本次为手动数据 |
| access_token 过期且 refresh 失败 | 提示重新授权；本次转手动 | 数据由用户提供 |
| 接口报错或超时 | 有限重试后转手动 | 自动取数失败，原因照录 |
| 权限未批（如缺数据报表权限） | 说明缺哪个权限点，转手动 | 部分字段待确认 |
| 用户拒绝配置 | 直接转手动 | 本次为手动数据 |
| 接口路径核验未通过 | 停止自动取数，转手动 | 自动取数未通过核验 |
| 付费服务地址未配置 | 展示 references/pay-protocol.md 第八节 |
无输出，未取得授权 |
| 付费服务不可达或返回异常 | 说明原因后停止 | 无输出，未取得授权 |
手动兜底：
python scripts/qianchuan_report.py --manual <数据文件路径>
数据文件格式见 references/output-template.md 的手动输入模板。用户直接粘贴数据时，由你按同一模板整理后落盘，再调用脚本。
手动数据必须记录来源与时间，并标注「用户提供，未与平台核对」。
付费闸门不参与降级。 授权取不到时停止整个流程，不用「先出报告后补支付」「跳过支付」等方式替代。
硬性禁止
- 不执行任何后台写操作：不暂停计划、不改出价、不改预算、不动素材。只给建议。
- 不要求用户在对话中粘贴
app_secret、access_token、refresh_token或账号密码。 - 不估算、不补默认值、不推断缺失字段。取不到就标「待确认」。
- 不给突破三条铁律的建议，尤其不得建议大幅偏离系统建议 ROI。
- 不声称已执行用户没有确认执行的操作。
- 不把「消耗低于 200 元」直接解读为「建议关停」。
- 未取得本次授权就输出体检报告，或用任何方式绕过付费闸门。
- 展示 Payment-Proof、密钥、签名等凭据内容。
质量自查
输出前逐项确认：
- [ ] 已完成付费闸门，本次授权已取得
- [ ] 四条体检项每条都有明确结论，没有含糊表述
- [ ] 每个「待确认」都写明了缺哪一项
- [ ] 每个数值都能追溯到
source - [ ] 素材排序有真实数据支撑，或明确标注未排序
- [ ] 每条建议都附判据
- [ ] 全文没有出现执行类动作的完成时态
停止条件
出现以下任一情况时停止本流程并说明原因，不用低可信结果顶替：
- 未取得本次体检授权，且用户不接受付费或无法完成支付
- 付费服务不可达、返回异常，或校验反复不通过
- 判据全缺，无法产生任何一条体检项结论
- 用户提供的数据与实际账户口径明显不符且无法澄清
- 涉及账户权限、凭据泄露等安全问题
参考文件
references/pay-protocol.md—— 付费协议：账单结构、验付校验、履约确认、部署与安全references/setup-guide.md—— 开发者注册、建应用、授权、付费服务部署、凭据存放与撤销references/iron-rules.md—— 四条体检项与三条铁律的精确判定口径references/api-fields.md—— 接口、字段、口径与已知坑references/output-template.md—— 四段输出模板与手动输入模板
