爆款神曲潜力评估器（基础版）

写完一首歌，不知道副歌够不够抓耳、歌词有没有爆款相？把歌名、歌词、风格发来，我用一套 18 维决策树（千分制）给你打出评分报告，告诉你现在卡在哪个档位、哪几维拖了后腿、具体怎么改能往上提。

⚡ 执行快车道（Agent 必读·硬性指令）

为避免不必要的等待，Agent 处理评估请求时必须遵循以下最短路径，不得绕行：
1. 第一轮工具调用就直接发起评估请求：按文末「调用示例」直接 POST 云端接口（title/lyrics/style 三字段）。禁止先创建临时文件整理参数、禁止搜索或加载其他支付工具/连接器/插件——支付完全由服务端 402 协议驱动，收到 402 再按第二步处理即可。
2. 收到 402 不等于出错：这是支付流程的第一步。立刻把响应体 payment_needed 字段的值存成文件、交给支付宝 CLI 弹码，精确做法如下（官方口径，不要自创参数、不要搜索其他支付工具）：
- ① 取 payment_needed 的值（一串 Base64URL 文本），不解码、不加引号、不做 JSON 包裹，原样写入 402_needed_<时间戳>.txt；
- ② 执行 alipay-bot -- 402-buyer-pay -f '<该文件路径>'——只加 -f 一个参数，不要自创 -r / -m / -d / -i / --json 等参数；
- ③ CLI 输出逐字符原样展示给用户（含二维码行/支付链接，不得用代码块包裹、不得截断或改写链接、不得重复输出）；
- ④ 若客户端未装 @alipay/agent-payment（没有 402-buyer-pay 命令），按第二步的安装命令执行一次（仅首次）；
- ⑤ 若 CLI 报 402 response missing protocol structure：说明存进文件的不是纯 Base64URL 文本（多半把整份 402 JSON body 存成文件了）。只把 payment_needed 的值写进文件即可，不要放整个 body。
3. 时间预期：从发起请求到出报告通常 1.5–3 分钟（大模型评分约 60–80 秒）；账单有效期 15 分钟（自账单生成起算）；弹码后的支付链接/二维码约 5 分钟有效，请提示用户尽快扫码。请勿向用户转述其他时限，也勿在等待中反复轮询——单次请求阻塞等待即可。
4. 支付只走官方三步，禁止任何钱包状态预检/轮询：收到 402 后直接走支付宝官方买家流程——① probe：请求已自动取得 402 账单；② pay：调用 @alipay/agent-payment 的 402-buyer-pay 弹出支付宝支付卡片，等待用户扫码授权，钱包若未开通此步会自动引导开通（无需提前检查）；③ complete：用户付款后执行 alipay-bot 402-query-payment-status -t '<交易号>' -r '<接口URL>' -m POST -d '<原请求体>' 取回 18 维报告；如需履约回执再执行 alipay-bot -- 402-buyer-fulfillment-ack -t '<交易号>'。严禁在支付前调用 check-wallet 等钱包状态预检，严禁 sleep 轮询等待状态翻转——钱包状态查询在服务端繁忙时会返回 code=500，官方规则是立即停止流程（不是重试），此前 15+ 分钟空转死循环即由此而来。状态不明时先查原订单，绝不重复付款。若 402 流程反复失败或遇未知错误，用官方报障通道 alipay-bot problem-feedback --reason '<问题描述>' 上报。

一、功能说明

• 18 维决策树评分（开篇钩子、副歌记忆点、金句指数、画面感、社交传播力等），输出 0–1000 分与等级（国民级神曲 / 爆款金曲 / 潜力热歌 / 及格之作 / 需打磨）。
• 单首歌词一次性评分，标准长期冻结，结果确定、可复现（同一模型版本下，同一首歌每次评分一致）。
• 平台统一承担大模型调用（你无需任何 API Key），按次统购计费。

二、分步操作

第一步：发起评估

提交入口（两种方式任选其一）：
- 对话式（推荐）：在 AI 客户端对话框直接说"帮我评估这首歌"，附上歌名、歌词、风格三项，Agent 会按本说明自动发起调用与支付，你无需手动构造请求；
- 技术直连：开发者可按文末「调用示例」直接 POST 云端接口，字段一致。

提交三项信息：

输入校验与常见错误提示（校验发生在扣费之前，不通过不会产生扣费）

> 补充：请求体整体不超过 32KB；歌词建议带 [Verse]/[Chorus] 等结构标注，副歌位置、副歌长度等结构类维度判定更准——不带标注也可评，服务端会提示补标注，相关维度按可获取信息保守评估。错误返回均为中文明确原因，不会只给一个模糊的"失败"。

第二步：完成支付（支付宝 AI 按量付费 A2M）

> ⚠️ 首次使用前必做：安装支付宝钱包（仅一次）
> 本 Skill 走支付宝 AI 按量付费（A2M），需要你的 WorkBuddy 客户端已装支付宝钱包连接器。请在你的 AI 对话框发送以下命令安装，并按提示开启支付宝支付功能、完成绑定：
> > npx -y @alipay/agent-payment@latest install >
> 安装一次后即可正常付费调用；未安装则 Agent 没有 402-buyer-pay 等支付工具、支付宝收银台无法弹出，表现为卡在付款前。（注：这是买家侧钱包 @alipay/agent-payment，与开发者侧的 A2M 接入包 @alipay/alipay-aipay 不是同一个，切勿混用——若误装 @alipay/alipay-aipay（卖家集成包），买家侧不会有任何支付工具，将一直无法弹出收银台、表现为卡死；必须使用 @alipay/agent-payment。若 Agent 提示找不到 402-buyer-pay / 402-query-payment-status 等支付命令，说明未正确安装 @alipay/agent-payment，请重装此包而非 alipay-aipay。）

首次发起评估时，服务端返回 HTTP 402 + Payment-Needed（Base64URL 账单，含商家 RSA2 签名 seller_signature）；支付宝官方集成（@alipay/agent-payment）据此向用户弹出支付宝支付卡片，用户扫码授权付款。支付成功后，集成自动携带 Payment-Proof 凭证重试同一接口，服务端通过 alipay.aipay.agent.payment.verify 验付（active=true、金额与 resource_id 一致）后返回 18 维报告，并异步调用 alipay.aipay.agent.fulfillment.confirm 完成履约回执。全程无需你手动重发，也无需自带任何 Key——基础版为纯统购模式，平台统一承担大模型调用，你只需支付一次调用费 ¥0.50。

> 买家侧 CLI 精确用法（照抄即可，勿自创参数）
> 1. 从 402 响应体取 payment_needed 的值（Base64URL 文本），原样写入 402_needed_<时间戳>.txt（不解码、不加引号、不包 JSON）；
> 2. 执行 alipay-bot -- 402-buyer-pay -f '<该文件路径>'——只加 -f，不要加 -r/-m/-d/-i/--json；
> 3. CLI 输出逐字符原样展示给用户（含二维码行/支付链接，勿用代码块包裹、勿截断链接），等用户扫码；
> 4. 用户付款后凭交易号查原单取报告：alipay-bot 402-query-payment-status -t '<交易号>' -r '<接口URL>' -m POST -d '<原请求体>'；
> 5. 需要履约回执时：alipay-bot -- 402-buyer-fulfillment-ack -t '<交易号>'；
> 6. 异常处理：报 402 response missing protocol structure = 交给 CLI 的文件里放的不是纯 Base64URL 文本（多半把整份 402 body 存成了文件），只放 payment_needed 的值即可；流程反复失败或遇未知错误，走官方报障 alipay-bot problem-feedback --reason '<问题描述>'。

> 支付宝 A2M 完整四步支付工作流（闭环）：
> 1. 付费前置检查：平台自动确认本 Skill 为付费统购模式（¥0.50/次、支付宝 AI 按量付费 A2M），你无需携带任何 Key；
> 2. 发起请求：你提交歌名/歌词/风格，服务端检测到未支付；
> 3. 处理 HTTP 402：服务端返回 HTTP 402 + Payment-Needed（Base64URL 账单含商家 RSA2 签名），由 @alipay/agent-payment 弹出支付宝支付卡片，完成支付触发；
> 4. 支付并带凭证重试：用户扫码授权付款后，集成携带 Payment-Proof 自动重试同一接口 → 服务端 alipay.aipay.agent.payment.verify 验付（active=true、金额与 resource_id 一致）→ 返回 18 维报告 → 异步 alipay.aipay.agent.fulfillment.confirm 履约回执。
>
> 异常处理：若支付超时、金额不符或凭证未激活，会明确返回原因（PAY_VERIFY_FAILED / PAYMENT_NOT_PAID），检查网络或重新发起即可；前置检查与重试由支付层自动完成。

第三步：查看报告

支付完成后自动返回 18 维评分报告：总分与等级、逐维度原始分与加权分、哪几维是短板、以及可落地的修改建议。

三、价格策略

• （统购）¥0.50 / 次：平台承担大模型调用，你无需任何 Key。单次采样、标准冻结，适合快速摸底与日常使用。

四、评分方法与等级

18 个维度，分 5 层，千分制：
- 内核层（4 维）：情绪共鸣度、价值观安全度、歌词画面感、叙事完整度
- 听感层（5 维）：歌词韵律与重复度、歌词金句指数、音区与呼吸友好度、风格与主题匹配度、副歌长度
- 传播层（2 维）：社交传播力、场景绑定度
- 算法层（4 维）：歌名吸引力、歌名与歌词契合度、开篇钩子、副歌在歌词结构中的位置
- 长效层（3 维）：内容深度、文本重复度与舒适度、时代印记感

计分方式：每个维度打 0–100 原始分，按该维权重加权汇总为 0–1000 的总分。各维权重与评分细则为本 Skill 内部资产，恕不公开；基础版为冻结版，同一模型版本下同曲同分，不同时间的评分可直接横向对比。

等级对照：

五、报告长什么样（结构示例）

报告为 Markdown，固定包含以下板块：总分与等级 → 结论与建议 → 类别表现（5 层得分率）→ 亮点维度（最高 3 维）→ 短板维度（含逐维修改建议）→ 总评 → 推广建议；出现异常（如样本降级）时会额外附风险提示。

<details>
<summary>报告结构示例（数值为虚构演示，仅供了解版式）</summary>

# 《示例歌名》爆款潜力评估报告
**总分：782 / 1000（78%）**
**等级：爆款金曲**
**结论：** 具备短视频爆款所有要素
**建议：** 重点运营，配合挑战赛/二创助推

## 类别表现
- **内核层**：81%（324/400，4 维）
- **听感层**：76%（266/350，5 维）
- **传播层**：70%（98/140，2 维）
- **算法层**：80%（120/150，4 维）
- **长效层**：74%（111/150，3 维）

## 亮点维度
- 情绪共鸣度（88/100）：主歌铺陈与副歌爆发形成强情绪落差
- 开篇钩子（85/100）：首句 7 秒内建立记忆点

## 短板维度
- **场景绑定度（55/100）**：歌词未绑定具体听歌场景，建议在副歌前加入"深夜加班/长途车窗"类可代入画面
- **社交传播力（62/100）**：缺少可被观众直接引用的口号式短句，建议提炼一句 ≤10 字的记忆句

## 总评
（一段话总结这首歌的爆款潜力与最需要解决的问题）

## 推广建议
（发行渠道、运营动作、目标人群建议）

</details>

六、常见问答

• 需要自己准备大模型 Key 吗？ 不需要。基础版为纯统购，平台统一调用，你只付调用费。
• 评分标准会经常变吗？ 基础版为冻结版，评分标准长期不更新，保证你不同时间测同一首歌口径一致。
• 和 Pro 版有什么区别？ Pro 版为专业版（多次采样聚合、更低单价 BYOK 选项等），基础版为轻量统购版，单次采样、即付即看。

调用示例（技术参考）

> 本 Skill 由云端函数提供评估能力（支付宝 AI 按量付费 A2M）。调用地址如下，客户端按此 POST 即可触发评估与支付流程：

POST https://1473480629-9612tckokw.ap-beijing.tencentscf.com
Headers:
  Content-Type: application/json
Body:
{
  "title": "歌曲名称",
  "lyrics": "完整歌词文本（含结构标注，如 [Verse]/[Chorus]）",
  "style": "歌曲风格"
}

> WorkBuddy 客户端注意：本 Skill 为纯统购，你无需在请求里带任何 api_key；支付重试凭证 Payment-Proof 由集成走请求体 Body 回传，服务端已适配 Body 优先读取。

服务端在未付费时返回 HTTP 402 + Payment-Needed（支付宝 A2M 账单，含商家 RSA2 签名），由 @alipay/agent-payment 弹出支付宝支付卡片；支付成功后自动带 Payment-Proof（经请求体 Body 的 payment_proof 字段）重试并返回 18 维报告。

> 账单有效期 15 分钟（自账单签发起算，足够覆盖安装 CLI 与用户扫码付款）。请勿向用户转述其他时限；若用户支付时提示订单过期，向服务端重新发起同一请求即可获取新账单，已支付订单不受影响。

七、诚实说明

• 评分基于 18 维歌词决策树，衡量"爆款潜力"的文本特征，不替代市场验证；风格偏好、演唱、编曲不在评估范围。
• 单次采样结果为确定性单点，适合快速判断；如需更稳健的多样本对照，可使用 Pro 版。
• 极少数情况下大模型不可用，服务端会自动降级为规则引擎评分并在报告中明确标注（规则口径与大模型口径不同，同曲分数可能相差 100–200 分，请勿与正常评分直接对比）；此时语义级安全审计同步降级，报告会提示发布前人工复核。
• 输入校验、注入拦截与安全审计均发生在支付之前，校验不通过不会产生扣费。

变更说明

• v1.1.9：[修复] 修复部分客户端下支付宝收款码弹不出来的问题——此前把支付账单交给支付工具的方式不对（存进工具输入文件的不是账单本身，导致工具报"账单结构不完整"而无法生成收款码）。现已按支付宝官方规范写死精确的支付命令用法（账单原样存文件、命令只加 -f、输出逐字展示），并在账单里补齐官方要求的协议结构做双保险。评分引擎与价格（¥0.50/次）不变。
• v1.1.8：对齐支付宝官方 A2M 标准支付流程——支付严格走「probe 拿 402 账单 → pay（调用 402-buyer-pay 弹支付宝支付卡片等用户扫码，钱包未开通此步自动引导开通）→ complete（调用 402-query-payment-status 凭订单号查原单取回报告）」三步；跳过钱包状态预检环节（该环节在服务端繁忙时会被反复重试、曾触发 15+ 分钟轮询死循环，官方规则为该状态码即刻停止，现已整体跳过）；状态不明先查原单、绝不重复付款。评分引擎与价格（¥0.50/次）不变。
• v1.1.7：新增「钱包状态防死循环」硬性指令——钱包状态检查最多 2 次、严禁 sleep 轮询；已绑定用户不再被要求重复扫码开通，直接重新发起评估继续支付（实测状态检查死循环曾导致 15 分钟以上无意义等待）。评分引擎与支付链路（统购 ¥0.50/次）保持不变。
• v1.1.6：新增「执行快车道」硬性指令——Agent 第一轮调用必须直接发起评估请求，禁止先建临时文件或搜索支付工具（实测可省 2–8 分钟无意义等待）；明确 1.5–3 分钟时间预期与账单 15 分钟有效期。评分引擎与支付链路（统购 ¥0.50/次）保持不变。
• v1.1.5：明确账单有效期为 15 分钟（自签发起算），避免误报时限让用户不敢付款；评分引擎与支付链路（统购 ¥0.50/次）保持不变。
• v1.1.4：[修复] 修复支付宝签名校验失败（SIGN_VERIFY_FAILED）导致无法完成支付的问题，对齐官方签名规范，支付链路恢复正常。统购 ¥0.50/次不变。
• v1.1.3：[修复] 账单有效期由 5 分钟延长至 15 分钟，覆盖安装钱包与扫码付款的完整耗时，避免刚拿到账单就过期。
• v1.1.2：[修复] 修复账单时间戳时区错标导致"账单已过期"无法支付的问题。
• v1.1.1：新增评分方法与等级对照、报告结构示例、输入校验与常见错误对照（含"校验发生在扣费之前"边界）；明确两种提交入口。评分引擎与支付链路（统购 ¥0.50/次）保持不变。
• v1.1.0：基础版初版上线：支付宝 AI 按量付费（A2M）、统购 ¥0.50/次、18 维决策树千分制评分。