下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/lingxunhub--song-evaluator-pro.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @lingxunhub/song-evaluator-pro。写完歌、发歌前心里没底?上传歌名 + 带结构标注的歌词 + 风格,AI 从 18 个维度打出 1000 分制爆款潜力分,告诉你歌词评分在哪个档位、哪部分拖后腿、怎么改能提升,并按段落给出可选改法。专业版付费 Skill,按调用量计费(微信 Agent Pay X402)
阅读全文 (展开查看完整说明)
概述
爆款神曲潜力评估器(专业版 Pay Skill)
本 Skill 由云端函数提供评估能力,采用微信 Agent Pay X402 协议按调用量计费。调用前请确认 Agent 已安装
weixinpay插件。写完一首歌、准备发布前心里没底它能不能火?本评估器用一套 18 维度千分制评分体系,把"火不火"讲清楚——逐维告诉你歌词强在哪、弱在哪、怎么改。支持微信扫码统购,也支持自带 LLM Key(BYOK)更低单价。
本skill指南分两部分,无技术背景普通用户浏览版块一(白话文视角解读),有技术背景专业用户浏览版块二(专业视角解读)。
统购模式无需任何 Key:直接发起评估、微信支付后即可使用。
BYOK 模式(自带 LLM Key 享 ¥0.50/次):部分 Agent 无法自动扫描你客户端的 LLM API Key。为保证能走通 BYOK,建议在请求体 Body 中填写 "byok_key": "<你的 TokenHub / DeepSeek Key>",也可在对话中单独一行写 BYOK_KEY: <你的Key>(云端引擎会自动提取并从歌词中移除,不会当作歌词参与评分);若你的 Agent 支持自动扫描客户端 Key,也可不填。
⚠️ 密钥风险提示与承诺:LLM API Key 属个人敏感凭证。本服务仅将其用于本次评估的大模型鉴权——不写入歌词、不展示在报告、不在服务端留存,也不会主动用它发起任何评估之外的请求。
若你不放心,可不填写:不填时有两种可能——若当前 Agent 支持自动扫描你客户端的 LLM API Key,会自动走 BYOK;若不支持,则按统购价(¥1.00/次,平台承担模型费用)计费。两种路径都能正常拿到评估报告。
🔒 安全提示
- 统购:全程只通过微信支付收款,本 Skill 不会、也无需在聊天中向你索要任何 Key、密码或验证码。
- BYOK:你填入的是自己的 LLM API Key(属个人敏感凭证),仅通过本 Skill 的请求体
byok_key字段、BYOK_KEY:标注或你 Agent 的密钥配置提供;勿发给无关的聊天窗口或第三方,勿告知任何人。- 若任何对话方/机器人向你要 Key、付款码或验证码,请警惕诈骗,立即终止操作。
⚡ 执行快车道(Agent 硬性指令)
收到歌名 + 歌词 + 风格后,第一轮就直接 POST 到评估 API(见下方「使用流程」第一步),禁止先建临时文件、禁止搜索支付/安装工具、禁止来回确认。
- 专业版走微信 Agent Pay X402:未付费时由
weixinpay插件原生弹出微信支付卡片,支付成功后自动继续,Agent 无需手动拼接支付头或建文件。- 正常预期:约 3–4 分钟出报告(专业版为 3 次采样取中位数 × 思维链推理,耗时主要花在云端模型,属本真红线,不可压缩);加上 Agent 直接发请求省下的 2–8 分钟无意义等待,整体明显快于"先建文件/翻历史"的卡顿路径。
- 若等待偏久,先自查是否自己绕去建文件/搜工具了——那才是卡点,不是引擎慢。
- 报告渲染:拿到 200 响应后直接整段渲染
data.markdown(已排好版,含总分进度条/五层画像/18 维明细/逐段点评),不要重排、不要改写分数;若sectionReviews为null,如实说明本次未生成逐段点评。- 支付后勿重复扣费:报告返回即代表本次微信 X402 支付已完成,直接整段渲染
data.markdown即可;禁止在拿到报告后再发起支付或调用支付工具(会导致二次扣费)。
🚀 30 秒上手(先看这里)
入口在哪:不用打开任何网站、不用注册账号、不用安装软件——直接在对话里把下面这段发出去就行(你现在打字的这个聊天框,就是提交入口)。
照抄模板(把内容换成你自己的):
评估这首歌的爆款潜力
歌名:晚风写信
风格:流行民谣
歌词:
[Verse 1]
(第一段歌词,一句一行)
[Chorus]
(副歌歌词,一句一行)
[Bridge]
(桥段歌词,可省略)三条要点
- 歌词必须带段落标注(
[Verse 1]/[Chorus]/[Bridge]/[Outro]),独占一行或写在行首都行。标注越清晰,副歌相关维度评得越准;不标注也能评,但副歌类维度只能靠推断。 - 一次只评一首。两首歌粘在同一个输入框里,引擎不会自动拆分,会把它们当成一首歌评(结果失真),但仍只算一次调用费用。
- 发出去就别重发。正常 3–4 分钟出报告(专业版为多次采样取中位数,耗时主要花在云端大模型,属本真红线、不可压缩)。中途会弹微信支付卡片,扫码付 ¥1.00(或走 BYOK ¥0.50)后自动继续,不需要你重新提交。
只想快速摸底、不追求分数稳定 → 基础版(单次采样、¥0.50);要稳定结论、批量或高频评估 → 专业版(多次采样取中位数)。
一、无技术背景用户使用指南(版块一)
(一)功能说明
本评估器调用云端评分引擎,对「歌名 + 带结构标注的歌词 + 风格」做量化分析,输出 1000 分制爆款潜力报告。模型全部在云端运行,你无需本地部署。
- 输出内容:总分 + 等级(如 需打磨 / 潜力热歌 / 爆款金曲,共 5 档)+ 各维度评分 + 优势短板 + 改进建议。
- 评分特性:同一首歌多次采样、取维度级中位数,分数稳定、可复现,减少反复评估时的分数跳动(显著减小评分跨级)。
- 适用人群:原创音乐人、词曲作者、音乐运营,在发布前做质量自检与改稿参考。
评分怎么算出来的(方法、维度与等级)
方法:18 个维度分别由云端大模型判档打分(每维 0–100 分),再由服务端按各维权重加权求和,得到 1000 分制总分;等级由总分门槛确定。专业版对同一首歌并行跑 3 次采样、取每个维度的中位数重组总分,因此同一首歌反复评估分数基本一致、极少跨级。
18 个维度分属 5 层(此处只列维度名与考察视角;各维具体权重不外泄,以免评分被针对性刷分):
| 层级 | 考察什么 | 包含维度 |
|---|---|---|
| 内核层 | 歌词立不立得住、值不值得传 | 情绪共鸣度、价值观安全度、歌词画面感、叙事完整度 |
| 听感层 | 唱起来顺不顺、有没有记忆点 | 歌词韵律与重复度、歌词金句指数、音区与呼吸友好度、风格与主题匹配度、副歌长度 |
| 传播层 | 有没有被转发、被使用的场景 | 社交传播力、场景绑定度 |
| 算法层 | 平台推荐逻辑看不看得上 | 歌名吸引力、歌名与歌词契合度、开篇钩子、副歌在歌词结构中的位置 |
| 长效层 | 能活多久 | 内容深度、文本重复度与舒适度、时代印记感 |
5 档等级门槛(满分 1000):
| 总分 | 等级 | 结论 |
|---|---|---|
| ≥ 900 | 国民级神曲 | 跨圈层、跨周期传播,具备经典潜质 |
| ≥ 800 | 爆款金曲 | 具备短视频爆款所有要素 |
| ≥ 700 | 潜力热歌 | 有爆款基因,但存在明显短板 |
| ≥ 600 | 及格之作 | 基础合格,缺乏记忆点和传播力 |
| < 600 | 需打磨 | 多个维度存在硬伤 |
(二)使用流程
1.权限声明
本 Skill 仅发起网络请求调用评分与支付服务,不读取、不上传你的本地文件或其他隐私数据。
2.使用场景
- 写完一首歌,想客观评估爆款潜力再决定要不要发;
- 改稿阶段,想知道哪一段拖后腿、怎么改;
- 手头有多首 Demo,难以抉择,可逐首评估排出优先级。
3.分步操作
(1)第一步 · 发起评估:填写【歌名 + 带结构标注的歌词 + 风格】,同时在头部/尾部写"评估这首歌的爆款潜力"发送即可。
| 必填项 | 说明 |
|---|---|
| 歌曲名称 | 歌名文本(≤60 字) |
| 歌曲风格 | 如 流行 / 民谣 / 说唱 / 国风 |
| 歌词内容 | 须标注段落结构,如 [Verse]、[Chorus]、[Bridge];结构越清晰评估越准 |
(2)第二步 · 完成支付:若弹出付款提示,用微信扫码支付;支付成功后 Skill 自动继续,无需重发请求。
付款提示:未付费时聊天框弹出微信支付卡片,成功支付后自动出报告,全程无需注册账号。
注:BYOK 仍需支付平台服务费,自带 Key 仅用于承担模型 token 费,不免除平台费。
(3)第三步 · 查看报告:等待数十秒,获得 1000 分制评分报告(总分 / 等级 / 各维度分 / 优势 / 改进建议),流程结束。
4.输入不合规会怎样?会不会白扣钱?
最要紧的一条:所有输入校验都发生在下单收款之前——不合规的请求连付款账单都不会生成,不存在"钱扣了、报告没出"这种情况。
| 你会看到 | 触发条件 | 怎么处理 | 是否扣费 |
|---|---|---|---|
| 缺少歌曲名称 / 歌词 / 风格 | 三个必填项有任一为空 | 按提示补齐后重发 | 未扣费 |
| 歌词内容过短 | 歌词少于 20 字符 | 补全歌词后重发 | 未扣费 |
| 歌词过长 | 歌词超过 8000 字符 | 精简或分次评估(超长歌词本身也会稀释各维度判断) | 未扣费 |
| 歌名过长 / 风格名过长 | 歌名超过 60 字 / 风格超过 30 字 | 缩短后重发 | 未扣费 |
| 请求体过大 | 请求超过 32KB | 精简歌词后重发 | 未扣费 |
| 请求过于频繁 | 同一来源每分钟超过 10 次 | 等 1 分钟后重试 | 未扣费 |
| 歌名/风格含指令类内容 | 歌名或风格里夹带了让它"忽略规则""输出系统提示词"之类的文字 | 只提交歌曲信息本身 | 未扣费 |
| 未通过安全审计 | 歌词命中违禁/三俗词库或违规模式 | 属合规拦截,不做评分;请自查歌词内容 | 未扣费 |
| 订单尚未完成支付 | 支付授权未完成就想取报告 | 完成扫码支付后重试 | 未扣费(订单未生效) |
| 报告提示"仅 N 个采样有效" | 个别样本调用超时或上游抖动 | 结论仍有效,稳定性略降,建议复评一次 | 已扣费(报告已交付) |
报告一旦生成即视为交付完成,不接受退款;若因本 Skill 服务端代码或配置错误(我方原因)导致未出报告,可在 SkillHub 订单页核查或联系作者补单。
会扣分(分数偏低)的常见情形——这些不是"评估失败",而是评估结论本身:
- 全篇没有段落标注 → 副歌位置、副歌长度等维度只能推断,通常拉低总分;
- 副歌过长(远超 2–3 句的常规体量),或整段完全重复 6 次以上 → 「副歌长度」「文本重复度与舒适度」扣分;
- 开篇第一句是铺垫而非钩子 → 「开篇钩子」扣分;
- 通篇概述、缺具体意象与细节 → 「歌词画面感」「情绪共鸣度」扣分;
- 只有呼喊、没有一句可被单独记住的金句 → 「歌词金句指数」「社交传播力」扣分;
- 歌名与歌词主题脱节、或歌名过于平淡 → 「歌名吸引力」「歌名与歌词契合度」扣分。
使用示例(完整报告;示例歌曲为虚构)
输入
评估这首歌的爆款潜力
歌名:晚风写信
风格:流行民谣
歌词:
[Verse 1]
站台的灯,亮了三分钟
我把没说的话,折进信封
[Chorus]
晚风替我写信,寄给没来的你
字迹被雨打湿,像我没说完的曾经输出(报告节选,真实结构与真实字段;上下为同一份报告)
《晚风写信》爆款潜力评估报告
一、结论
总分 712 / 1000(71.2%)
███████░░░
等级:⭐ 潜力热歌
- 结论:有爆款基因,但存在明显短板
- 建议:针对低分项定向修改后再发行
二、五层画像
| 层级 | 得分 | 表现 | 走势 |
|---|---|---|---|
| 内核层 | 76%(175/230) | 偏强 | ████████░░ |
| 听感层 | 71%(192/270) | 偏强 | ███████░░░ |
| 传播层 | 68%(102/150) | 偏强 | ███████░░░ |
| 算法层 | 65%(124/190) | 偏强 | ██████░░░░ |
| 长效层 | 56%(89/160) | 中等 | ██████░░░░ |
最强:内核层 76% · 最弱:长效层 56%
三、18 维明细(按得分降序,此处节选 10 项)
| # | 层级 | 维度 | 得分 | 等级 | 评分依据 |
|---|---|---|---|---|---|
| 1 | 内核层 | 情绪共鸣度 | 88 █████████░ | 优秀 | 离别场景具体,"没说完的话"情绪落点准确 |
| 3 | 内核层 | 歌词画面感 | 82 ████████░░ | 优秀 | 站台灯光、信封、雨打信纸,画面可拍 |
| 14 | 算法层 | 开篇钩子 | 78 ████████░░ | 良好 | "亮了三分钟"带时间张力,起句有效 |
| 2 | 内核层 | 价值观安全度 | 76 ████████░░ | 良好 | 无违规内容,情绪健康 |
| 6 | 听感层 | 歌词金句指数 | 72 ███████░░░ | 良好 | "晚风替我写信"可记,但缺更强的收尾金句 |
| 5 | 听感层 | 歌词韵律与重复度 | 68 ███████░░░ | 良好 | 尾字押韵基本成立,副歌重复偏多 |
| 15 | 算法层 | 副歌在歌词结构中的位置 | 65 ██████░░░░ | 良好 | 副歌出现位置适中 |
| 7 | 听感层 | 音区与呼吸友好度 | 62 ██████░░░░ | 中等 | 句长适中,长句换气点略紧 |
| 10 | 传播层 | 社交传播力 | 60 ██████░░░░ | 中等 | 情绪可共情,但缺可被引用的短句 |
| 12 | 算法层 | 歌名吸引力 | 58 ██████░░░░ | 中等 | "晚风写信"意象好但记忆点一般 |
(其余 8 项在报告中照此全列,不再省略)
四、逐段点评
分段点评与可选改法,仅供参考,是否采纳由你决定。
▸ [Verse 1] · 铺垫·建立场景
- 有效:时间与地点具体(站台、三分钟),开场就给出画面与悬念
- 风险:两句都停在"物"上,人物与关系交代偏少,听者代入稍慢
- 可选改法
- 原:站台的灯,亮了三分钟
- 改:站台的灯,亮到我数完三分钟
- 为什么:加入"我"的视角,人物与焦虑感一起立起来
- 可选改法
- 原:我把没说的话,折进信封
- 改:我把没说的话,折成一张纸的厚度
- 为什么:把抽象的话变成可感知的量,画面更实
▸ [Chorus] · 爆发·记忆点
- 有效:"晚风替我写信"意象新颖,具备成为记忆点的潜质
- 风险:整段只有两句,爆发力度不足;"曾经"收尾偏软,缺少可被引用的金句
全篇小结:场景与意象选得好,"晚风替我写信"是全曲最佳钩子,主要问题在副歌体量偏短、收尾缺金句。
五、优势亮点 Top 3
- 情绪共鸣度(88/100,优秀)
- 歌词画面感(82/100,优秀)
- 开篇钩子(78/100,良好)
六、短板与改进(按优先级)
| 优先级 | 维度 | 建议动作 |
|---|---|---|
| P0 | 副歌长度 | 副歌过短:补足到 4 句左右,让情绪有爆发空间 |
| P1 | 歌词金句指数 | 补一句可被单独引用的短句,放在副歌末句 |
| P1 | 歌名吸引力 | 歌名可考虑与副歌金句呼应,增强记忆点 |
七、总评
(一段总结,含题材定位与竞争力判断)
八、推广建议
(编曲 / 演唱 / 推广场景各一句)
(说明:为便于在文档内阅读,示例报告的标题在此处已扁平化为加粗;实际输出为二级标题。)
报告尾部还会附带三项:稳定性说明(本次采样次数与总分波动区间)、本次计费模式与实收金额(BYOK ¥0.50 / 统购 ¥1.00)、诚实边界(本评估只评歌名/歌词/风格,不含侵权检测与音频分析)。
(三)价格策略
| 项目 | 统购(推荐普通用户) | BYOK |
|---|---|---|
| 用户类型 | 推荐普通用户 | 推荐开发者 |
| 用户特征 | 无技术背景、偶尔评估、不想折腾配置的音乐人 | 高频调用、开发者集成、自带 Key 的用户 |
| 是否需要自带 Key | 否,直接使用平台key | 是,需在 AI 端配置 Key |
| LLM token 费 | 平台垫付模型算力,你无需支付 | 你提供自己的 LLM Key,模型费用由你承担 |
| 平台服务费 | ¥1.00 / 次,你需要支付 | ¥0.50 / 次,你需要支付 |
| 评分稳定性 | 多次采样降方差,稳定可复现 | 同左,稳定性依赖你自己的 AI 模型 |
三价一致:SkillHub 展示价、微信登记价、服务端单价(统购 100 分 / BYOK 50 分)保持一致。
(四)版本对比
| 维度 | 基础版 | 专业版 |
|---|---|---|
| 评估方式 | 单次采样 | 多次采样 + 维度级中位数聚合 |
| 评分稳定性 | 同一首歌可能上下跳动,存在跨级情况 | 稳定、可复现,减少跳动,极少跨级 |
| 是否需要 Key | 否 | 统购否 / BYOK 是 |
| 适合场景 | 快速摸底、随手评估 | 需要稳定结论、批量或高频评估 |
| 价格 | ¥0.50 / 次统购 | ¥1.00 统购 / ¥0.50 BYOK |
基础版为轻量单次版;专业版在分数稳定性上更强,适合对结论一致性有要求的场景。
(五)常见 QA
- 一次能评几首? 一次评一首。若把多首歌词粘贴进同一个输入框,引擎不会自动拆分,会把全部内容当成一首歌评估,出 1 份(质量失真)报告,仍只触发一次评估、按一次调用计费。多首请逐次调用(如统购 5 首 = 5 次 = ¥5.00,BYOK 为 ¥2.50)。
- 付了钱没出报告怎么办? 报告一旦生成即视为交付完成,不接受退款;若因本 Skill 服务端代码或配置错误(我方原因)导致未出报告,可在 SkillHub 订单页核查或联系作者补单。
- 分数会变化吗? 专业版通过多次采样取中位数,同一首歌反复评估分数基本一致,分差有控制;基础版单次采样,可能略有跳动。
- 支持哪些风格? 流行 / 民谣 / 说唱 / 国风等主流风格均可,结构标注越清晰评估越准。
- 我的歌词会被拿去训练吗? 不会。每次仅用于本次评估推理,不留存、不用于训练。
(六)诚实说明
- 本评估基于歌名、歌词(含结构)与风格,不含侵权 / 抄袭检测,商用前请自行核实原创性。
- 评分是辅助参考,不是流量保证;歌曲走红还受演唱、制作、宣发、时机等多因素影响。
- 评估结论依赖模型判断,存在主观性,重大商业决策请结合自身判断。
- 当前版本不评旋律、编曲、演唱等音频层面,仅评歌名、歌词文本与风格。
- BYOK 密钥信任边界:你提供的 LLM API Key 仅用于本次评估的大模型鉴权,我们不主动使用它发起评估之外的任何请求,不写入歌词、不展示在报告、不在服务端留存。不填写 Key 时有两种可能:当前 Agent 支持自动扫描客户端 Key → 走 BYOK;不支持 → 走统购(¥1.00/次,平台承担模型费用)。两种路径都能正常拿到评估报告。
🔧 BYOK 用户可浏览下方BYOK 操作指引
(七)BYOK 操作指引
适合:已有 TokenHub / DeepSeek 等 LLM Key、希望自行承担 token 费用的高频或开发者用户。
1. 提供 Key(两种方式任选其一)
- 方式 A(推荐,最稳妥):调用时在请求体 Body 填写
"byok_key": "<你的 TokenHub / DeepSeek Key>";也可在对话中单独一行写BYOK_KEY: <你的Key>,云端引擎会自动提取并从歌词中移除,不会当作歌词参与评分(部分 Agent 无法自动扫描客户端 Key,此方式可确保走通 BYOK)。 - 方式 B:若你的 Agent 支持自动扫描,可在其设置中预配置一次你的 LLM API Key(TokenHub / DeepSeek 等)与 Base URL,调用时自动携带,无需每次手动粘贴。
- 模型 token 消耗由你的 Key 对应账号承担,本 Skill 仅按 ¥0.50/次 结算服务费。
2. 返回数据异常处理
- 仍收到付款提示:收到 ¥0.50 付款提示属正常(为平台服务费);若支付后仍报错或提示金额异常(如变成统购价格 ¥1.00),再检查自己AI平台的 Key 是否填对/过期;如果不想配置 Key 可直接走统购 ¥1.00。
- 报告中断 / 超时:多为 Key 方额度不足或网络抖动,确认额度后重试;仍异常可改用统购路径。
- 字段缺失:正常返回含各维度
rawScore/weightedScore等字段;某字段为空通常是该维度模型未给出判定,不影响总分。
完整接入格式与字段说明见 SkillHub 开发者接入文档。
二、有技术背景用户使用指南(版块二)
(一)权限声明
本技能仅需要网络访问权限(访问评估 API 与微信支付/SkillHub 支付域名),不需要文件系统、Shell 执行、读取环境变量或访问其他本地资源。
(二)功能说明
根据歌曲的名称、歌词内容(含结构标注)、风格,调用云端评估引擎,输出 1000 分制量化评分报告(18 维度决策树 + 多采样中位数聚合 + 结构维度确定性化)。评估模型全部在云端运行。
(三)使用场景
- 音乐人创作完成后评估商业潜力
- 词曲作者在创作过程中了解可优化维度
- 音乐公司 A&R 筛选 demo
- 短视频创作者判断歌曲是否适合做 BGM
(四)输入要求
- 歌曲名称(title):歌名文本
- 歌词内容(lyrics):须标注段落结构,如
[Verse]、[Chorus]、[Chorus]、[Bridge]、[Outro]。独占一行或行内紧跟内容均可。 - 歌曲风格(style):如流行、说唱、国风、民谣、R&B、摇滚、电子等
(五)付费前置检查
调用本 Skill 前,检查当前 Agent 是否已安装 weixinpay 插件:
- 已安装:可继续提供付费服务
- 未安装:提示"当前 Agent 暂不支持微信支付付费能力",终止流程
(六)工作流程
以下 402 支付链路由支付层自动完成,Agent 无需手动提取响应头或调用支付函数;下文仅按协议顺序描述流程,便于理解与排查。
第一步:请求资源
POST https://1473480629-074pfbwo58.ap-beijing.tencentscf.com
Headers:
Content-Type: application/json
Authorization: Bearer 这里替换为部署方下发的调用密钥(可选;若网关吞掉 Authorization 可改 X-Api-Key)
Body:
{
"title": "歌曲名称",
"lyrics": "完整歌词文本(含结构标注)",
"style": "歌曲风格"
}BYOK(用户自带 LLM Key,单价更低):在请求头加
X-LLM-API-Key: <你的DeepSeek/TokenHub Key>;若所用平台不转发自定义请求头,可改在请求体填写"byok_key": "<你的Key>"(也可内联BYOK_KEY: <Key>,云端自动提取并从文本移除)。服务端走自带 Key 模式,平台 0 LLM 成本。
第二步:处理 402 响应
若收到 HTTP 402,说明需要支付。以下两项凭证由 weixinpay 插件 / SkillHub 代付层自动提取,Agent 无需手动处理:
- Header
WeixinPay-Required:支付码(payment_code) - Header
X-Out-Trade-No:订单号
响应体示例:
{
"code": "PAYMENT_REQUIRED",
"message": "需要支付后才能获取评估报告",
"WeixinPay": {
"WeixinPay-Required": "xY9zAbc123def456",
"prompt": "本次使用微信支付,请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay,以向用户申请支付授权。"
},
"out_trade_no": "WX402_20260903120000abcdef123456",
"amount": "1.00",
"currency": "CNY",
"paidMode": "unified"
}第三步:发起支付
支付层将 WeixinPay-Required 的值作为 paymentCode,调用 weixinpay_pay 向用户申请支付授权:
weixinpay_pay(paymentCode = "xY9zAbc123def456")第四步:支付成功后自动获取资源
支付授权完成后,支付层会自动向函数发起一次带支付凭证的请求并取回评估报告(下图为其协议形态,由支付层内部自动完成,Agent 无需手动发送):
POST https://1473480629-074pfbwo58.ap-beijing.tencentscf.com
Headers:
Content-Type: application/json
WeixinPay-Required: xY9zAbc123def456
X-Out-Trade-No: WX402_20260903120000abcdef123456
Body:
{
"title": "歌曲名称",
"lyrics": "完整歌词文本(含结构标注)",
"style": "歌曲风格"
}(注:订单号 X-Out-Trade-No 由支付层自动携带并验付;早期版本曾要求 Agent 手动携带该订单号重试,现已由支付层自动完成,Agent 不必重复该动作。)
服务端会查单验付(trade_state=SUCCESS),通过后返回 HTTP 200 + 评估报告。若订单尚未支付,返回 PAYMENT_NOT_PAID,请先完成支付再重试。
(七)返回结果处理
接口返回 JSON。按以下规则呈现:
1. 评估通过(success: true):
- 取
data.totalScore/data.maxScore为总分 - 取
data.grade(level 星级 / label 等级 / conclusion 结论 / advice 建议)与data.scorePercent(百分制,便于横向对比) - 取
data.scores(或同义data.dimensions)列出 18 项细分评分(name 维度名、rawScore 原始分、weightedScore 加权分、reason 评分依据、tier 等级:优秀/良好/中等/偏弱/短板) - 取
data.categories按内核/听感/传播/算法/长效 5 层汇总各维度均分与明细,一眼看清强弱分布 - 取
data.highlights(top3 优势维度)与data.issues(短板维度含 severity 与 improvementTip 改进建议)重点展示 - 取
data.recommendations(按优先级排序的修改建议)与data.markdown(预渲染完整报告,可直接渲染) - 取
data.paidMode(byok/unified)与data.paidPriceFen(实际收费分)确认本次计费模式 - 取
data.summary和data.promotion作为总评和推广建议 - 取
data.sectionReviews逐段点评(v2.1.44 新增):sections[]每项含tag(段落标注)、role(该段在全曲中的功能)、good(有效之处)、risk(风险)、rewrites[](可选改法,每项含original原句 /improved改句 /why改动理由);另有overallNote(全篇小结)与disclaimer(免责口径)。为null表示本次未生成——该模块与评分相互独立,上游异常或超时时自动跳过,不影响评分结论。必须保留"仅供参考,是否采纳由你决定"的口径,不得替用户决定采纳,也不得编造段落点评。 - 取
reliability字段了解稳定性:mode为self-consistency表示多次采样取中位数(samples/scoreMin/scoreMax/scoreMean为波动区间);single/rule-fallback表示单点。若scoreMax - scoreMin > 60,hints会提示"结果仅供参考,建议复评确认" - 取
compliance字段:semanticAudit为passed-llm表示大模型语义审计已通过;skipped-rule-fallback表示云端大模型不可用、已降级规则引擎,语义级审计未执行,请提醒用户正式发布前人工复核 - 若
hints数组非空(如歌词缺结构标注),如实提醒用户
输出格式示例:
总分:760 / 1000 | 等级:⭐ 潜力热歌
结论:有爆款基因,但存在明显短板
优势维度:情绪共鸣度(85) | 社交传播力(80) | 韵律与重复度(78)
低分项:副歌长度(30) —— 建议:……
总评与推广建议:……
报告渲染规范(给 Agent,务必遵守)
- 优先整段渲染
data.markdown——它已是排好版的可视化报告(总分进度条 / 五层画像 / 18 维明细 / 逐段点评 / 优先级行动表),逐字渲染即可,不要自己重排、不要改写任何分数。 - 在 markdown 之后追加「稳定性说明」(由
reliability生成:采样次数、总分波动区间、是否建议复评)与「本次提示」(hints[],按 level 分级展示)。 - 逐段点评必须保留"仅供参考,是否采纳由你决定"的口径,不得替用户决定是否采纳,也不得把可选改法说成"必须改"。
- 若
sectionReviews为null,如实说明本次未生成逐段点评、并说明不影响评分结论,严禁自行编造段落点评。
2. 评估被拦截(success: false):
error: AUDIT_REJECTED→ 如实告知:歌词未通过安全审计,不做评分error: INJECTION_SUSPECTED→ 告知:歌名/风格含指令类内容被拒,请仅提交歌曲信息error: PAYMENT_NOT_PAID→ 告知:订单尚未完成支付,请先完成微信支付授权后重试error: RATE_LIMITED/PAYLOAD_TOO_LARGE→ 告知频率或体积超限,稍后重试error: UNAUTHORIZED/MISSING_*/LYRICS_TOO_SHORT→ 将 message 告知用户,引导补充正确输入
3. 网络调用失败: 如实告知"云端评估服务暂时不可用,请稍后再试",不得编造评分。
(八)安全审计范围
云端引擎评分前执行前置安全审计(一票否决):服务端硬词库(违禁/三俗)+ 大模型语义审计(政治敏感、性别对立、地域歧视、色情暴力低俗)。大模型不可用时仍执行硬词库 + 三俗正则二级扫描,硬违规照样拦截。
⚠️ 未集成"连续 5 句与已知歌曲高度相似"的侵权检测(依赖外部曲库),不应声称已做侵权检测;若歌曲明显疑似翻唱,提示用户正式发布前人工复核版权。
(九)注意事项
- 评分逻辑完全由云端引擎计算,本地不做评分推演,也不要虚构"评估模型"细节
- 歌词必须含结构标注(
[主歌]/[副歌]等),否则副歌相关维度为推断值 - 本技能基于歌词文本评分,不涉及音频分析
- 单次调用通常 60-80 秒(云端模型当前为思维链模式);部署建议设
LLM_TIMEOUT_MS=240000且云函数执行超时提到 300s,避免大样本采样被截断 - 字段限制:歌名 ≤60、风格 ≤30、歌词 20~8000 字符;请求体 ≤32KB;同来源每分钟最多 10 次
- 逐段点评(v2.1.44 新增)可用环境变量
SECTION_REVIEW=0关闭;其独立超时为SECTION_REVIEW_TIMEOUT_MS(默认 180s,上限 180s)。点评与评分并行调用,点评失败只降级为「本次未生成逐段点评」,不影响评分与报告输出。
(十)版本变更(changelog)
本 Skill 的评分引擎演进自免费版
song-evaluator,下方按版本倒序记录各版本重大调整。付费能力(微信 Agent Pay X402)自 v2.1.13 起引入;18 维决策树权重体系自 v2.1.9 确立后保持不变,后续均为工程层与本真口径治理。
v2.1.45(最新发布版)
- 报告可读性重构(买家视角):
- 逐段点评改为「全曲第一段 + 第一个副歌 + 最弱段」三段深评,其余段一句话带过,避免冗长。
- 新增「风格性特征豁免」:古风 / 主旋律励志向 / 民谣等风格的固有写法(对仗排比、口语留白)只点评其在本风格内是否成立,不强行改成通用句、不磨平。
- 结构性维度(5/7/9/15/17)的「评分依据」去黑话,改为按实测指标说话(如"副歌完全重复 3 次、尾字重复 2 组")。
- 短板改为按「预计提分」降序(性价比最高在前),每条标注 🟢易改 / 🟡需改写 / 🔴大改 与单条保守预计提分;结论区新增「一句话结论 + 最高杠杆动作 + 改后预测分」。
- 删除原「优势亮点 Top 3」节(聚焦短板性价比更实用)。
- 修复:逐段点评因
max_tokens:4000被思维链吃光导致 JSON 截断、整段点评丢失——改为max_tokens:16000且点评路径关闭思维链(reasoning_effort='none',6–9x 加速、不再截断、不增加评分方差),新增LLM_SECTION_REASONING_EFFORT可配与finish_reason=length截断诊断日志。 - 评分引擎(18 维决策树 / 权重 / 等级门槛)与价格(统购 ¥1.00 / BYOK ¥0.50)一字未改,分数与 v2.1.44 逐位一致、可复现。
v2.1.44(历史版本)
- 新增「逐段点评」:报告新增第四部分,按段落(
[Verse]/[Chorus]/[Bridge])逐段给出「这段在做什么 / 有效之处 / 风险」,并给出可选改法(原句 → 改句 → 为什么这么改)。重点段(副歌、全曲第一段)给 2 条改法,其余段 1 条。所有点评均标注「仅供参考,是否采纳由你决定」,不替用户做决定。 - 报告排版可视化升级:总分进度条、五层画像(内核/听感/传播/算法/长效)对比条、18 维明细(按得分降序、含得分条与等级)、按优先级(P0/P1)排序的改进行动表,手机上也能一眼看清强弱与先后。
- 文档补强:新增「30 秒上手」(可直接复制的输入模板 + 明确提交入口)、「输入校验与错误对照」(明确所有输入校验发生在下单收款之前,不合规不扣费)、「评分方法与等级对照」(18 维归属 5 层及其考察视角、5 档等级门槛),并补上一份完整示例报告(此前只有脱敏字段示例)。
- 修复:修正报告标题中一处乱码字符(此前会印出"结□□□:")。
- 评分与计费不变:18 维决策树、权重体系、多采样中位数聚合与等级门槛一字未改,分数与上一版逐位一致、可复现;统购 ¥1.00 / BYOK ¥0.50 价格不变。逐段点评由独立调用完成、与评分采样并行执行,不参与打分,也不额外增加等待时间。
v2.1.43
- 新增「执行快车道」硬性指令:Agent 收到歌名+歌词+风格后第一轮即直接发起评估请求,禁止先建临时文件或搜索支付/安装工具(实测可省 2–8 分钟无意义等待);明确约 3–4 分钟时间预期(含 3 次采样思维链,属本真红线不可压缩)。评分引擎与微信 X402 支付链路保持不变。
v2.1.42
- 更名与信任升级:本 Skill 由「企业版」统一更名为「专业版 Pay Skill」(计价不变:统购 ¥1.00 / BYOK 自带 Key ¥0.50)。新增 BYOK 自带 Key 操作指引与密钥承诺(仅用于本次评估鉴权、不主动使用、不留存);新增「诚实说明(数据信任边界)」透明披露计费两种结果与 Key 处理边界;安全提示优化为「遇到索要 Key/付款码/验证码请警惕诈骗并立即终止操作」。评测能力、18 维决策树与微信 X402 支付链路保持不变。
v2.1.41
- 稳定性优化:本次为发布包结构优化与调用稳定性更新,评测能力与微信 X402 支付链路保持不变。
- 使用方式不变:持有微信 AI 专属卡即可调用,单次 ¥1.00;支持 BYOK(自带 LLM Key 享 ¥0.50 统购价),18 维决策树 · 1000 分制报告照常输出。
v2.1.40
- 展示页对非技术用户不友好,对展示页文档进行修正,恢复完整支付流程说明,通过「Pay Skill 改造检查」重新上架;同步修正支付流程与稳定性提示的表述。
v2.1.20(SkillHub 审核通过发布版,作者拒绝修改展示页)
- 以 v2.1.14 为基础的付费 Skill 提交 SkillHub 企业版,通过「Pay Skill 改造检查」审核并上架(微信 X402,统购 ¥1.00 / BYOK ¥0.50)。
v2.1.14(对比 v2.1.13,输出结构重组 + 双模式可视)
- 输出结构全面重组(buildReport 重写):200 响应新增
title/style/scorePercent/grade/categories/highlights/issues/recommendations/markdown等字段,scores与dimensions保留兼容。 - 短板行动化:每个短板维度附带
improvementTip与severity,recommendations按影响排序。 - 双模式可视:200 响应新增
paidMode与paidPriceFen,结果中可见本次计费模式与实收金额。 - hints 结构化:由
string[]改为分级结构,便于前端分级展示。
v2.1.13(对比 v2.1.12,专业版 Pay Skill 付费闭环)
- 新增微信 Agent Pay X402 支付网关(
PAY_SKILL=1);按调用计费,支持X-LLM-API-Key走 BYOK 模式;真实峰谷牌价;MOCK_PAY=1本地联调。
v2.1.12(工程加固 + 可配置化)
- 超时与思维链可配置;失败样本原因分类上报;样本丢失透明化提示;降级模式诚实化(明确口径差异)。
v2.1.11(采样纪律)
- 固定采样数与聚合口径,明确总分与维度中位数重组值的对应关系。
v2.1.10(方差治理)
- 维度级聚合与结构维度确定性化,收敛跨轮波动,保留单点退化通道。
v2.1.9(self-consistency + 合规加固)
- 引入多采样自一致性;合规层加固;确立 18 维决策树权重体系。
v2.2.0 / v2.2.1(已回退)
- 曾尝试扩充词库与采样,实测引入分数混杂、偏离纯歌词评估,已回退至 v2.1.9 纯净版。
变更说明
- v2.1.45:[优化] 报告可读性重构——逐段点评改为「3 段深评 + 其余一句带过」避免冗长,新增风格性特征豁免(同风格写法不磨平);结构性维度 reason 去黑话、改为按实测指标人话说明;短板改为按「预计提分」降序并标注 🟢易改/🟡需改写/🔴大改 与单条预计提分,结论区新增「一句话结论 + 最高杠杆动作 + 改后预测分」,删除原「优势亮点 Top 3」节。[修复] 逐段点评 token 截断(
max_tokens4000→16000 且关思维链,彻底根治「四、逐段点评」为空);新增LLM_SECTION_REASONING_EFFORT可配与截断诊断日志。评分引擎与价格不变。 - v2.1.44:新增「逐段点评」——报告新增第四部分,按段落(
[Verse]/[Chorus]/[Bridge])逐段说明「这段在做什么 / 有效之处 / 风险」,并给出可选改法(原句 → 改句 → 为什么这么改):重点段(副歌、全曲第一段)2 条、其余段 1 条,全部标注「仅供参考,是否采纳由你决定」,不替用户做决定。报告排版升级——总分进度条、五层画像对比条、18 维明细(按得分降序、含得分条与等级)、按优先级(P0/P1)排序的改进行动表,手机上也能一眼看清强弱与先后。文档补强——新增「30 秒上手」(可直接复制的输入模板)、「输入校验与错误对照」(明确所有输入校验发生在下单扣费之前,不合规不扣费)、「评分方法与等级对照」,并补上一份完整示例报告。[修复] 修正报告标题中一处乱码字符。逐段点评由独立调用完成、与评分采样并行执行,不参与打分、也不额外增加等待时间;18 维决策树、权重体系与等级门槛一字未改,分数与上一版逐位一致、可复现;统购 ¥1.00 / BYOK ¥0.50 价格不变。 - v2.1.43:新增「执行快车道」硬性指令——Agent 收到歌名+歌词+风格后第一轮即直接发起评估请求,不再先建临时文件或搜索支付/安装工具(实测可省 2–8 分钟无意义等待);同时明确约 3–4 分钟时间预期(含 3 次采样,属引擎固有耗时,不可压缩)。评分引擎与微信 X402 支付链路保持不变。
- v2.1.42:由「企业版」统一更名为「专业版 Pay Skill」(计价不变:统购 ¥1.00 / BYOK 自带 Key ¥0.50);新增 BYOK 操作指引与密钥承诺(仅用于本次评估鉴权、不主动使用、不留存);新增「诚实说明」透明披露计费结果与 Key 处理边界;安全提示升级为「遇到索要 Key / 付款码 / 验证码请警惕诈骗并立即终止操作」。
- v2.1.41:发布包结构与调用稳定性优化,评测能力与微信 X402 支付链路保持不变。
- v2.1.40:修正展示页对非技术用户的表述,恢复完整支付流程说明,重新通过上架检查。
- v2.1.20:付费版首次通过 SkillHub 企业版上架(微信 Agent Pay X402;统购 ¥1.00 / BYOK ¥0.50)。
更早的引擎演进记录(v2.1.9 确立 18 维决策树权重体系、v2.1.10–v2.1.14 方差治理与输出重组)见版块二「(十)版本变更(changelog)」。