通用创作质量评级 · 按量付费客户端
> 本 skill 是线上评级服务的按量付费客户端：付费与评级都发生在服务端，
> 壳负责「收内容 → 由平台内官方支付流程完成付款 → 取回评级报告」。
> 计费：按次计费，具体价格以技能详情页为准。
> 不含、不打包评级方法论教程原文；评级方法论（七维度标准+锚点参照）的免费版另行提供。
⚠️ 使用边界与责任声明
- 本 skill 调用部署在公网 HTTPS 域名上的评级服务；服务地址与 serviceId 已在打包时注入
references/service-config.json（公网 HTTPS 域名+平台服务ID）；密钥不入包（包内不含任何密钥、裸 IP、外部支付链接或收款方式）。 - 付款方与收款方不能同一人（买家支付宝账号须与卖家不同）。
- 支付走支付宝 AI 按量付费官方链路（未付款返回 402 账单 → 由官方支付能力生成支付入口 → 买家携
Payment-Proof凭证重试 → 服务端验付 → 履约回执确认）；本壳不自行实现付款或签名，不引导用户离开 SkillHub 完成支付。 - 输出的评级报告为服务端模型生成内容，供创作改进参考；不构成对作品市场表现的预测。
1. 用法（对话层）
用户提交创作内容后，按 §3 流程执行。典型触发语：
- 「帮我评级这篇文章」/「给这段代码评个级」→ 追问或直接接收待评级内容（content）
- 「用质量评级技能评一下这个技能设计」→ content 已含，可选补 content-type
- 「继续/付款成功了」→ 查询支付状态并取回评级报告
必收参数：
| 参数 | 必填 | 说明 |
|---|---|---|
content |
✅ | 待评级的创作物文本（文章全文/代码/技能文档等） |
content_type |
可选 | 类型提示：article（文章）/ code（代码）/ skill（技能）/ video（影视脚本），默认 article |
2. 服务契约
| 项 | 值 |
|---|---|
| 服务地址 | references/service-config.json（公网 HTTPS 域名，打包时注入） |
| 计费 | 按次计费，具体价格以技能详情页为准 |
| 评级耗时 | 30–90 秒（客户端等待须容忍首次超时，见 §3 步骤 4） |
| 返回 | content：完整评级报告（等级 + 七维度判定 + 改进方向，Markdown） |
| 凭证重试 | 支付后携 Payment-Proof 重试原请求；验付通过交付资源，无效/过期不交付 |
3. 执行流程（官方 402 链路 · 脚本编排）
> 支付相关调用一律使用官方支付能力/SDK（不自行实现、不硬编码密钥）。
> 本 skill 的支付编排由 scripts/rater-paid.mjs 完成：probe 触发 402 账单、pay 调官方 alipay-bot、complete 复用原订单取回评级结果。
> 业务资源端点声明于 references/service-config.json（公网 HTTPS 付费端点）。
依赖（官方）：买家侧 @alipay/agent-payment（提供 alipay-bot CLI）。
- 确认付费：向用户说明「按次计费，具体价格以技能详情页为准」，用户确认后继续。
- 触发 402（probe）：
node scripts/rater-paid.mjs probe --service rater --content "<待评级内容>" --content-type "<article|code|skill|video>" --state-dir ".state/<本次会话>"
→ 期望取得 HTTP 402 账单，Payment-Needed落盘到 state 目录。 - 发起支付（pay）：
node scripts/rater-paid.mjs pay --service rater --session-id "<本次会话ID>" --state-dir ".state/<本次会话>"
→ 官方alipay-bot 402-buyer-pay生成支付入口，用户在同一 AI 对话内扫码授权付款。 - 用户付款并取结果（complete）：用户付款后运行
node scripts/rater-paid.mjs complete --service rater --out-shake-no "<订单号>" --state-dir ".state/<本次会话>"
→ 官方alipay-bot 402-query-payment-status复用原订单取回评级报告。
- 若报资源请求超时/失败：服务端仍在后台评级（30–90s），等待后用同一订单号重查（脚本复用已落盘的 resource-url 与 out_trade_no），命中服务端幂等缓存即秒回（绝不重新下单、绝不重复付款）。
- 返回未支付 → 请用户确认付款状态后重查。
4. 排错要点
- 钱包未绑定 → 按官方流程开通；买家=卖家会被拒，须换非商户账号作买方。
- 状态不明 → 先查原订单，不重复付款、不追加独立回执。
- 只付一次 → 超时重查用同一订单号，绝不重新生成第二笔订单。
5. 参考与来源
- 官方接入：支付宝 AI 按量付费（A2M/X402）与 SkillHub Pay Skill 教程；生产配置（域名、serviceId、密钥）由部署侧注入，不入包。
- 评级方法论免费版：见发布者主页的免费技能（评级七维度标准+锚点参照）。
- 本包不含第三方受版权保护文本；服务端评级报告内容版权按服务条款。
