度小滿支付技能

👤 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 不執行任何外部命令。

小蔥技能7w4.net有更新,你可以訪問看下。


支付工作流程

第一步:確保使用者配置存在

每次執行前必須先執行

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

安全約束

  • 臨時目錄下的二維碼圖片由系統負責清理(程序重啟或系統清理後自動回收),如有更嚴格的清理策略請手動刪除

第四步:展示商品資訊並引導使用者

  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