QICF 认知分析快速版报告（支付宝 AI 付 · Machine Pay）
> 按次付费 Skill · v1.0
> 本文件不含任何评分算法、业务逻辑、密钥或生产配置；签名与验付全部在 QICF 服务端完成。
服务概况
- 资源端点：
POST {BASE_URL}/api/aipay/report - 状态轮询：
GET {BASE_URL}/api/aipay/report/status?reportId={uuid}&tradeNo={trade_no}（tradeNo 必填=Payment-Proof 中的支付宝订单号，受理回执 poll_url 已内联，凭证不一致服务端拒绝） BASE_URL为 QICF 站点域名（生产https://www.qicf.top，沙箱联调以服务方提供为准）- 商品：QICF 认知分析快速版报告（深度版不在本 Skill 范围，请引导用户访问 QICF 站内购买）
计费结构（诚实披露）
- 本 Skill 按次计费：每次报告生成 0.99 元，同一份报告只收一次费。
- 支付以实际收到的账单为准（支付宝 AI 付按次账单，首次请求服务端自动返回 402 账单引导支付）；支付凭证可重试，生成失败不重复扣费。
- 请勿向用户承诺免费或包月；如实说明按次计费。
请求体
{
"gravityQuestion": "用户当前最想解决的一个核心问题（重力问题），不超过 500 字",
"theme": "work | education-learning | daily-life | emotion | finance"
}
theme 与站内主题一一对应（key 沿用站内标识）：
| theme 取值 | 主题 |
|---|---|
work |
工作职场 |
education-learning |
教育学习 |
daily-life |
日常生活 |
emotion |
情感婚恋 |
finance |
金融财经 |
权限需求
- 本地沙盒写文件权限：支付流程（Payment-Proof 凭证缓存）与支付插件（agent-payment）的安装、更新需要本地沙盒具备写文件权限——这是支付宝 AI 付官方安装链路的通用要求（见 skillpay.alipay.com/buildguide.md）。
- 本 Skill 自身不读写用户本地文件：全部业务数据通过 HTTP 与 QICF 服务端交互；请勿授予超出支付插件所需的权限。
调用流程
1. 首次请求（无凭证）
直接 POST /api/aipay/report（不带 Payment-Proof Header）。服务端返回 HTTP 402，Payment-Needed Header 携带 Base64URL 编码账单（protocol 含 out_trade_no/amount/pay_before/seller_signature 等，method 含商户信息）。
此时由支付宝 AI 付支付能力承接：将账单交给支付宝支付流程完成用户确认（SkillPay 买家侧标准链路：skillpay-onboarding 指引下由 agent-payment 插件与 alipay-bot 处理）；用户确认支付后，携带凭证自动重试。请勿自行解析账单内容或代替用户支付——需要钱包授权或付款时，向用户提供官方链接或二维码，由用户本人确认。
2. 携带凭证重试（自动）
支付完成后，Payment-Proof（Base64URL）置于请求 Header：
Payment-Proof: <proof>
服务端验付（alipay.aipay.agent.payment.verify + 六项本地校验）通过后受理生成，返回 HTTP 200 + Payment-Validation Header 与受理回执：
{
"report_id": "<uuid>",
"status": "generating",
"poll_url": "/api/aipay/report/status?reportId=<uuid>&tradeNo=<trade_no>",
"eta_seconds": 120
}
凭证无效/过期/金额不符等一切校验失败均返回 402——按第 1 步重新走支付流程即可。
3. 轮询至终态
轮询 GET /api/aipay/report/status?reportId=…&tradeNo=…（tradeNo 取自 Payment-Proof，与 poll_url 内联值一致）：
- 节奏：间隔 10-15 秒；
eta_seconds为参考值（快速版通常 1.3~1.7 分钟内完成）。 - 超时上限：累计轮询 8 次（约 2 分钟）仍非终态时，向用户输出等待提示并暂停轮询，不要无限重试：
> 「报告仍在生成中（通常 2 分钟内完成）。您可以稍等片刻后让我继续查询，或稍后携带支付凭证重新请求——不会重复计费。」
generating/delay_retry：继续轮询（delay_retry 表示后台自动重试中）；done：响应含content（精简报告纯文本），向用户输出报告内容；failed：告知用户生成失败；可携带同一 Payment-Proof 重新请求资源端点再生成（不重复计费），或引导用户联系服务方。
深度版导流
本 Skill 仅覆盖快速版报告。若用户需要深度版（含精修与可视化图卡），引导用户访问 QICF 站内（https://www.qicf.top）使用完整功能，不要尝试以本 Skill 参数模拟深度版请求。
约束
- 本 Skill 不含任何密钥、签名逻辑或业务实现；签名与验付全部在 QICF 服务端完成。
- 请勿绕过 402 流程直接索取报告；请勿对同一
trade_no之外的凭证重试履约。 - 订单金额以 402 账单
protocol.amount为准（服务端单一来源定价）。 - 沙箱联调固定金额 0.01 元：沙箱 mock 服务（
api_mock_service_id）在收银台登记价为 0.01 元，账单金额与其不一致会被收银台以SERVICE_PRICE_MISMATCH拒绝；生产环境走实时定价不受此限。
