Recharge / Renew of Skills | 技能账户充值/续费

🎯 平台自动检测（零用户配置）

本技能内置多维度平台自动检测功能，无需用户任何配置，开箱即用。

检测维度

智能适配效果

开发者调用

from scripts.platform_detection import get_current_platform, render_qrcode_markdown

# 获取当前平台信息
platform = get_current_platform()
# {"platform": "arkclaw", "confidence": 1.0, "method": "BUSINESS_CARRIER", ...}

# 智能渲染二维码
print(render_qrcode_markdown("https://qr.alipay.com/xxx"))

---

支付流程要求

支付二维码生成后，不再要求用户回复支付确认词，也不自动触发订单状态或余额查询。只提示用户：如支付成功后，可输入「查询余额」了解账户详情。用户可见输出必须只展示付款二维码，禁止显示备用支付链接、支付 URL、打开付款页面链接或任何备用方式说明。

标准流程

【1】显示充值套餐（🔴 必须包含所有套餐，包括专属定制套餐 4）
   ↓
   ⚠️ 【STOP】必须等待用户明确选择套餐！禁止自动继续或自动选择套餐！
   ↓
【2】用户选择套餐（用户明确回复「选 1」、「体验套餐」等）
   ↓
【3】系统自动完成内部身份关联（优先复用本地存根；缺失时自动复用/创建本地默认充值账号）
   ↓
【4】创建云端订单，必须获取云端 orderNo
   ↓
【5】使用云端 orderNo 生成支付宝付款二维码图片（底层支付参数仅用于生成二维码，不得在用户可见内容中展示）
   ↓
【6】展示支付卡片给用户
   ↓
【7】提示用户：如支付成功后，可输入「查询余额」了解账户详情
   ↓
【8】流程结束，等待用户后续手动触发余额查询

🔴🔴🔴 【最高优先级红线 - 禁止擅自代用户选择套餐】

绝对禁止在展示套餐列表后、用户未明确回复前自动调用下单脚本！

记忆强化口诀：

套餐列表展完后，必须等待用户选；
用户没说选哪个，绝对不能下单；
擅自代客做决定，严重违规要追责！

强制要求

---

充值套餐

🔴 【强制性展示要求 - 必须执行】

必须同时展示所有套餐，包括专属定制套餐！ 禁止隐藏或省略定制套餐入口。每次展示套餐列表时，必须完整显示以下所有 5 个套餐。

📌 强制显示规则

🧠 防错记忆强化（必须背诵）

套餐展示口诀：

充值第一步，只显一到四；
用户不说零，绝对不能提；
先展套餐表，用户选完后；
才设环境量，顺序不能扭；
提前显测试，就是大错误！

禁止擅自下单口诀：

套餐列表展完后，必须等待用户选；
用户没说选哪个，绝对不能下单；
自动继续或自选，都是严重违规；
擅自代客做决定，严重违规要追责！

完整流程口诀：

一展套餐（1-4），二等用户选；
用户说选几，就下几的单；
自动继续或自选，绝对不允许；
这是红线区，违反必追责！

⚠️ 典型错误案例警示

🧠 记忆强化口诀

套餐要展示，定制不能少；
少了定制项，就是没做好；
四条全显示，用户才知道！

---

推荐入口

测试套餐：

SMYX_PAYMENT_SHOW_TEST_PACKAGE=1 python3 -u -m skills.smyx_payment.scripts.start_recharge 0

正式套餐：

python3 -u -m skills.smyx_payment.scripts.start_recharge 1
python3 -u -m skills.smyx_payment.scripts.start_recharge 2
python3 -u -m skills.smyx_payment.scripts.start_recharge 3

脚本会：

1. 创建云端订单；
2. 生成支付宝支付卡片；
3. 提示用户完成支付；
4. 提示用户如支付成功后，可输入「查询余额」了解账户详情；
5. 结束当前支付生成流程，不自动查询订单状态或余额。

支付方式说明

由于支付宝「当面付」接口需要商户单独开通权限（报 ACQ.ACCESS_FORBIDDEN 错误），当前采用支付宝网页支付模式：

「当面付」开通说明（可选升级）

如果需要使用支付宝原生支付码（格式：https://qr.alipay.com/xxx），需要：

1. 登录支付宝商户平台
2. 进入「产品中心」→ 找到「当面付」产品
3. 签约并开通当面付权限
4. 审核通过后即可使用 alipay.trade.precreate 接口生成原生支付码

当前网页支付二维码方案已能满足绝大多数场景，用户体验与原生支付码一致。

支付卡片输出规范

---

⚠️ 🔴 【强制性前置检查 - 必须执行，违者追责】🔴 ⚠️

🚨 生成支付卡片前，必须先执行平台检测，这是最高优先级的强制要求！

🧠 记忆强化口诀

生成支付卡，先把平台查；
ArkClaw 用 img，OpenClaw 用 MEDIA；
忘记这一步，就是大傻瓜！

🔍 检查清单（生成前必须逐项核对）

• 是否已调用 get_current_platform() 获取平台信息？
• 是否已将平台信息存储在变量中？
• 是否已根据 platform 字段判断渲染方式？
• ArkClaw → ``
• OpenClaw → MEDIA:...
• 确认二维码 URL 格式正确（300x300px）
• 确认没有在代码中硬编码渲染方式

---

🔴【兜底策略 - 确保二维码 100% 显示】（最高优先级）

问题背景

当平台检测失败（返回 unknown）或渲染指令（MEDIA: / HTML ``）未被系统解析时，用户可能看不到二维码图片。

兜底方案

必须执行以下兜底流程，确保二维码始终以图片形式送达用户：

兜底触发条件

兜底代码示例

import subprocess
import tempfile
import os

def send_qr_fallback(qr_url: str, caption: str):
    """兜底：下载二维码并用 message 工具发送"""
    # 1. 下载到临时文件
    tmp_path = tempfile.mktemp(suffix=".png")
    subprocess.run(["curl", "-s", qr_url, "-o", tmp_path], check=True)
    
    # 2. 用 message 工具发送
    from openclaw_tools import message
    result = message(action="send", filePath=tmp_path, caption=caption)
    
    # 3. 清理临时文件
    if os.path.exists(tmp_path):
        os.remove(tmp_path)
    
    return result

记忆强化口诀

平台检测若失败，兜底策略马上来；
下载图片发文件，用户肯定看得见！

---

支付卡片必须包含以下内容，且二维码必须直接以图片形式显示在界面上。必须根据平台检测结果选择渲染方式，确保在当前环境下正常显示：

================================================================================
# 🦞 小龙虾主厨 · 套餐充值
================================================================================

## 📦 充值信息

| 项目 | 内容 |
|------|------|
| **套餐** | {套餐名称} |
| **金额** | ¥{金额} 元 |
| **次数** | {次数} 次 |
| **订单号** | {订单号} |
| **账户** | {账户} |
| **支付方式** | 支付宝当面付（直接扫码） |

## 📱 支付宝支付信息

### 🖼️ 支付二维码

🔴 【根据平台检测结果自动选择以下方式之一，禁止同时显示两种】

**✅ ArkClaw 平台（检测到 platform='arkclaw'）：**
``

**✅ OpenClaw 平台（检测到 platform='openclaw'）：**
`MEDIA:https://api.qrserver.com/v1/create-qr-code/?size=300x300&data={支付链接}`

💡 请使用支付宝“扫一扫”扫描上方二维码完成支付。

--------------------------------------------------------------------------------
✅ 支付信息已生成。
💬 请使用支付宝完成支付。
🔎 如支付成功后，可输入「查询余额」了解账户详情。
--------------------------------------------------------------------------------

优化说明

二维码图片显示优化（🔴 强制性执行标准）：

🧠 记忆锚点：

• 平台检测不是「可选项」，而是「前置条件」
• 不检测平台 → 不生成支付卡片
• 检测平台后选错渲染方式 → 属于「严重错误」
• 每次生成都要默念：先检测，后渲染！

适配场景：

• 聊天应用（如微信、钉钉、企业微信）
• 网页端聊天界面
• 各种支持图片显示的平台
• 保持支付流程的完整性和安全性

二维码生成说明

• 生成方式：使用公共二维码生成服务 api.qrserver.com
• 尺寸：300x300px，确保扫码清晰
• 数据：底层支付参数仅用于生成二维码，不得在用户可见文本中展示
• 显示：仅以二维码图片形式展示；禁止额外输出备用链接、支付 URL、打开付款页面链接或复制链接说明

支付卡片后的用户提示语

支付页已生成。请完成扫码支付。
如支付成功后，可输入「查询余额」了解账户详情。

用户手动查询余额后的成功提示语

🎉🎉🎉
✅ 账户详情查询完成！
🎉🎉🎉

→ 展示完整余额信息表格：账户、总可用次数、已使用次数、剩余次数、是否余额不足。

支付页生成后禁止行为

不要提示用户回复「已支付」或「支付成功」。
不要因用户支付确认词自动查询订单状态或余额。
仅提示：如支付成功后，可输入「查询余额」了解账户详情。

---

安全规则

1. 云端 API 失败或未返回 orderNo 时必须终止，禁止降级。

2. 禁止本地生成订单号，禁止猜测订单号。

3. privateKey 只能来自云端创单响应，并仅在当前进程内存中传递给支付宝签名/查询函数。

4. 禁止把 privateKey 写入文件、环境变量、命令行参数或用户可见输出。

5. 若云端创单返回敏感存根，系统仅可在内部完成本地保存与比对，任何情况下都不得向用户透露、暗示或展示该存根的存放路径。

6. 仅当敏感存根为首次返回或相较本地已有值发生变化时，必须在创单成功后用纯 Markdown 强调格式提示用户复制存根以防遗失；提示内容只能包含必要的存根说明和值本身，不得包含任何存放路径。提示模板如下：

   ⚠️ 重要：您的 ApiKey 为：{敏感存根}

   请务必复制存根，以免遗失。

7. 除第 6 条规定的首次或变化场景外，绝对禁止在用户可见内容中提及、展示、解释或暗示该敏感存根及其相关字段；也不得说明其保存位置、文件名、目录或任何路径信息。