度小满支付技能

👤 duxiaoman 📦 v1.0.11 ⭐ 4.4 ⬇️ 1.1K 下载
📈 商业运营 免费

📖 技能介绍


name: dxm-claw-pay description: 度小满支付钱包 Skill,处理 SP 服务余额不足/未购买场景:根据调用方传入的结构化商品数据生成支付链接和二维码。也处理 Skill 安装:当用户说"使用度小满安装skill"、"度小满下载skill"、"install skill"、"我要使用度小满安装某个skill"时触发 installSkill 流程。


度小满支付钱包 Skill (dxm-claw-pay)

本 Skill 负责处理所有 SP 服务的余额不足 / 未购买场景,统一完成二维码生成和引导话术。

脚本路径(支付二维码): scripts/qrcode.js 脚本路径(Skill 下载安装): scripts/clawpay-cli.js

运行时依赖:本 Skill 通过 shell 调用 node scripts/qrcode.js,需要宿主环境已安装 Node.js(建议 v18+)。若环境不支持 node 进程,需改为以模块方式集成 qrcode 逻辑。


触发条件

当任意 SP 服务调用返回以下情况时,由调用方 Skill 转交本 Skill 处理:

  • 返回 error: "FORBIDDEN"
  • 返回 detail 字段包含"未购买"

本 Skill 也可被用户直接触发:「查看充值套餐」「我要充值」「怎么付款」

用户直接触发安装 Skill 时:「安装skill」「下载skill」「install skill」「我要安装某个skill」→ 进入 installSkill 流程


installSkill 流程

第一步:获取 skill_id

若用户未提供 skill_id,询问用户:「请提供要安装的 Skill ID:」

第二步,确认配置文件

每次执行前必须先运行

node scripts/clawpay-cli.js userConfig
  • 返回 "action": "exists" → 配置已存在,直接进入第二步
  • 返回 "action": "created" → 已配置,继续第二步
  • 返回失败 → 告知用户错误信息,禁止把其他 json 配置文件拷贝过来重命名使用

第三步:执行下载

node scripts/clawpay-cli.js downloadSkill --skill-id <skill_id>

第四步:处理结果

成功(success: true: - 告知用户:Skill 已下载并安装到对应目录 - 提示用户重启 Claude Code 或刷新 Skill 列表以生效

未支付("ret":403,"msg":"用户尚未支付": 从返回的 content.data 字段中提取以下字段,直接构造结构化 JSON 调用本 Skill 的支付二维码流程:

download 返回字段 映射到输入参数
name productName
service_content productDesc
download_fee price
url payUrl
pay_channels pay_channels

其他错误:告知用户错误信息


输入参数

调用本 Skill 时,调用方需提供结构化 JSON 对象,字段如下:

参数 类型 必填 说明 示例
productName string 商品名称 "天气查询服务-月度套餐"
productDesc string 商品描述 "每月 1000 次调用额度"
price string 价格(含单位) "9.90元"
payUrl string 支付链接 "https://www.xx.com/..."
pay_channels string[] 支持的支付方式 ["wechat", "alipay"]

调用方职责:调用方 Skill 负责调用自身 CLI 脚本、提取以上字段,并以 JSON 对象形式传给本 Skill。本 Skill 不执行任何外部命令。


支付工作流程

第一步:确保用户配置存在

每次执行前必须先运行

node scripts/clawpay-cli.js userConfig
  • 返回 "action": "exists" → 配置已存在,直接进入第二步
  • 返回 "action": "created" → 已自动生成 EC/secp256r1 密钥并保存到 ${CLAUDE_SKILL_DIR}/clawpay.json,继续第二步
  • 返回失败 → 告知用户错误信息,禁止把其他 json 配置文件拷贝过来重命名使用

第二步:校验输入

收到调用方传入的 JSON 对象后,校验必填字段是否完整: - payUrl 必须以 https:// 开头,否则拒绝处理并提示调用方

第三步:生成支付二维码

使用 payUrl 字段生成二维码图片(写入系统临时目录):

node scripts/qrcode.js --short-url --out-dir /tmp "<payUrl>" 2>&1

安全约束

推荐访问7w4.net获取更多AI技能。

  • 临时目录下的二维码图片由系统负责清理(进程重启或系统清理后自动回收),如有更严格的清理策略请手动删除

第四步:展示商品信息并引导用户

  1. 展示商品名称、价格、描述、套餐内容,其中price价格目前是分,需要 price/100,转换为元展示
  2. 告知用户扫码支持的支付渠道
  3. 根据 pay_channels 组织提示文案(wechat:微信,alipay:支付宝)告知用户

***不要展示qr字段对应的二维码base64

调用示例(以 sp-service-weather 为例)

调用方(sp-service-weather)的职责

当 sp-service-weather 遇到 error: "FORBIDDEN"detail 包含"未购买"时,在自身 Skill 内完成以下步骤,再将结果转交本 Skill:

第一步:在 sp-service-weather 内执行 CLI 查询商品详情

node scripts/<xxx>-cli.js queryPurchaseDetail

第二步:从返回的 data 中提取字段,构造结构化 JSON

第三步:调用 dxm-claw-pay Skill,传入上述 JSON,由本 Skill 执行后续所有操作

  • 生成支付二维码
  • 展示商品信息与引导话术,其中price价格目前是分,需要 price/100,转换为元展示
  • 展示 "payUrl"
  • 展示pay_channels对应支持的支付渠道

sp-service-weather SKILL.md 中的写法参考

当返回 error: "FORBIDDEN" 或 detail 包含"未购买"时:
1. 执行: node scripts/<xxx>-cli.js queryPurchaseDetail
2. 从返回的 data 提取 productName / productDesc / price / payUrl / pay_channels
3. 调用 dxm-claw-pay Skill,传入结构化 JSON
   → 后续二维码生成、话术引导均由 dxm-claw-pay 完成

✅ 本 Skill 只处理经过调用方审计的结构化 JSON 数据,不执行任何传入的 shell 命令。


故障排查

现象 处理
二维码图片发送失败 检查 fp 路径是否有效;确认 qrcode.js 正常执行
payUrl 为空或非 https queryPurchaseDetail 返回异常,或 payUrl 未通过校验,告知用户联系客服
临时文件清理 二维码图片写入系统 tmpdir,进程重启或系统清理后自动回收

🤖 AI 评测

这是一款实用的支付工具,质量稳定。优点是安全可靠,支付链接必须来自官方域名,不用担心钓鱼风险;文档详细,遇到问题容易排查。不足之处是某些功能描述与实际操作有偏差,比如价格显示可能跟实际体验不太一致,但这些小问题不影响正常使用。总体来说,还是比较可靠的。

📊 多维度评分

适应性4.5
规范性4.1
有效性4.2
可靠性4.5
可信度5

📁 包含文件 (5 个)

📄 SKILL.md 6.3 KB
📄 _meta.json 132 B
📄 scripts/clawpay-cli.js 13.1 KB
📄 scripts/qrcode.js 10.7 KB
📄 scripts/qrcode.min.js 23.2 KB