爆款笔记生成器（Pay Skill）
每次成功调用 ¥0.05（支付宝 AI 按量付费 / A2M 协议自动收款）。
功能说明
输入主题关键词，返回种草平台风格爆款笔记模板（标题+正文+emoji+互动钩子），已代入主题。服务端为纯本地模板库，不外联第三方、不读取用户本地文件。
服务端为纯本地数据/模板库（爆款笔记生成），不外联第三方、不读取用户本地文件、不访问用户隐私。
付费采用支付宝 AI 按量付费（A2M 协议）：402 报价 → 用户支付 → 服务端验付 → 履约确认 → 返回结果。
适用场景
- 想发种草平台但不会写标题和排版
- 种草产品需要吸睛笔记提升点击
- 批量产出多篇笔记维持更新频率
不适用 / 能力边界
- 本工具不适用：不自动发布、不代运营，只产出文案供复制
- 本工具不适用：emoji 排版为风格示意，平台规则变动需自行核对
- 本工具不适用：只做种草平台调性，不适用于抖音/公众号长文
使用方法（A2M 四步完整流程）
第一步：请求资源（无凭证首调，预期返回 402）
GET https://viral-hook-pro-pay-308980-8-1461759720.sh.run.tcloudbase.com/api/viral-note-studio?q={关键词}
q：关键词，必填；多关键词用空格/逗号分隔。- 也可用打包脚本一键走完整流程：
python scripts/viral-note-studio_client.py --q "示例"
第二步：处理 402 账单
无有效凭证时返回 HTTP 402，响应头 Payment-Needed 为 Base64url 编码的账单（含订单号、金额、卖方 RSA2 签名）。把该头原样保存到仅当前用户可访问的安全文件，不得解码改写账单内容。
第三步：发起支付
读取 alipay-payment-skill，按其 402-buyer-pay 流程将账单交给支付宝收银：
alipay-bot 402-buyer-pay --session-id '<当前会话ID>' --file '<账单安全文件>' \
--resource-url '<第一步的完整URL>' \
--intent-summary '原始请求：爆款笔记生成' --method GET
向用户展示收银二维码/链接，由用户在支付宝 App 内授权付款（首次使用需开通 Agent 支付）。
第四步：付款后取回结果（必须执行）
用户付款后按 alipay-payment-skill 取得 Payment-Proof，带 Payment-Proof 头重放第一步的同一 URL。服务端验付并履约后返回结果，响应头 Payment-Validation 即履约确认凭证（请留存备查）。
触发示例
- 「平价护肤笔记」→ 调用
q=平价护肤笔记 - 「出租屋改造怎么写」→ 调用
q=出租屋改造怎么写 - 「考研经验种草平台」→ 调用
q=考研经验种草平台
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
q |
query | ✅ | q 关键词，必填 |
Payment-Proof |
请求头 | 付款后重放时必带 | 支付宝返回的支付凭证（Base64url），原样携带 |
Payment-Needed（响应） |
响应头 | — | 402 时返回的账单（Base64url），交给 alipay-bot 402-buyer-pay |
Payment-Validation（响应） |
响应头 | — | 履约确认凭证，付款重放成功时返回 |
示例输出
返回 JSON 结构如下：
{
"theme": "平价护肤",
"count": 4,
"items": [
"标题：真的会谢😭平价护肤居然这么好用｜姐妹们冲！\n正文：最近挖到 平价护肤 这个宝藏..."
]
}
履约确认与订单持久化幂等（服务端保证）
- 订单持久化：每次 402 生成全局唯一
out_trade_no（前缀 GK + 毫秒时间戳 + 随机串），订单即时写入服务端 SQLite orders 表（out_trade_no主键 +trade_no唯一索引），含金额、商品名与 30 分钟支付时限。 - 服务端验付：收到 Payment-Proof 后，服务端先调支付宝「AI 按量付费验付接口」核验凭证真伪，并比对订单号、金额、商品一致性，任一不符按未支付处理。
- 履约确认：验付通过后执行支付宝「履约确认」接口，并以响应头
Payment-Validation回传确认结果。 - 幂等：同一订单只履约一次——重放同一 Payment-Proof 直接复用已生成结果，不会重复扣费、不会重复计价；订单状态 UNFULFILLED → PENDING_CONFIRM → FULFILLED 全程留痕可对账。
测试验证
- 2026-09-19 线上实测：GET /api/viral-note-studio?q=示例 → HTTP 402 报价，返回账单与订单号；付费重放后返回结果并携带 Payment-Validation 履约确认头 ✅
异常处理
q缺失 → 422（参数校验），补q重试- 账单过期（30 分钟）或验付失败 → 再次返回 402 新订单，重新走支付流程即可
- 重放时未带
Payment-Proof→ 按 402 处理，不会误判为已支付
版本更新
- v1.0.0（2026-09-19）：首发，按 plc-term-map-pay v1.0.1 模板生成；含 A2M 四步流程、一键付费脚本、TRACE≥90 质量闸通过。
说明
- 结果为常用整理，具体以权威来源为准
- 服务端纯本地数据/模板库，不外联、不读取用户文件
- 内容由 AI 整理生成
与免费版的区别（请如实告知用户）
我们同时提供永久免费的 viral-note-studio。两者分工如下：
免费版 viral-note-studio |
本版 viral-note-studio-pay |
|
|---|---|---|
| 给什么 | 1 条笔记（标题+正文+标签） | 多版本批量（3-5 条）+ 分赛道模板库 + emoji 排版与互动钩子 + 平台规则适配 |
| 技术实现 | 纯提示词推理（本地，通用模板） | 调服务端模板库 API |
| 适合场景 | 偶尔用一次、先试试效果 | 经常用、要批量产出、要稳定风格 |
| 价格 | ¥0 永久免费 | ¥0.05/次 |
建议路径：先用免费版确认风格对不对（不花钱）；确认后若需要批量产出与模板库，再用本版。
