增值账户充值与续费
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-smyx-payment。
技能介绍
要解决什么问题
在 SkillHub 等平台上使用增值技能账户时,常见需求是:查余额与剩余次数、在出现 402 / 余额不足 时续费,以及走完支付宝扫码或跳转支付。若订单号由对话侧本地拼接,支付与云端账本容易对不上,回调也无法可靠对账。
技能如何工作
本技能围绕查询 → 选套餐 → 创单 → 支付 → 验单串联脚本与流程约束:
- 账户查询:通过
scripts/query.py拉取balance、remainingUses、usedCount、isInsufficient等字段,判断是否需续费。 - 固定套餐:仅支持文档中的档位(含 ¥0.01 测试套餐 与 4 档正式套餐),不支持自定义金额;触发词(如「充值」「续费」「402」)会进入套餐选择流程。
- 创单与支付:必须先调用
recharge.py向云端创单,out_trade_no必须等于云端返回的orderNo,再调支付宝模块生成链接/收款码展示。 - 结果确认:用户声称支付完成后,须查询支付宝订单状态,仅在
TRADE_SUCCESS时再提示充值成功;成功/失败分别走callback.py的对应回调回写云端。
边界与注意点
- 充值手机号需为 11 位、1 开头 的国内号码格式,且需用户确认后再创单。
- 安全红线:禁止本地生成或 LLM 推测订单号;云端创单失败必须终止,不得降级绕过。
- 文档中若出现与上述「云端 orderNo」矛盾的旧示例流程,应以 SKILL 中的强制步骤为准。
使用场景
- 调用付费技能返回 402 或提示次数用尽时,先查 `remainingUses` 再选固定套餐完成续费
- 上线前用编号 0 的 ¥0.01 测试套餐走通 `recharge.py` 创单、扫码与 `TRADE_SUCCESS` 验单全流程
- 给团队共用的技能账户充值前,用手机号确认充值对象并核对 `balance` 与套餐档位是否匹配
- 用户说已支付后,必须先查支付宝订单状态,再决定是否调用成功回调更新云端账本
适合人员
- 在 SkillHub 上频繁调用按次计费技能、需要自助查余额与续费的个人或小组使用者
- 负责维护组织增值账户、要按固定套餐为企业手机号充值并留云端订单号的运营或财务对接人
- 为 Agent 接入充值对话流程的工程师,需遵守云端 `orderNo` 与安全红线实现脚本调用
- 需要在预发环境复现充值关键词触发、套餐选择与回调回写的测试或 SRE