qianwen-payment

Qwen AI Platform 付款

Qwen AI Platform（千问AI平台）现金余额、固定金额支付宝充值和新的 Token Plan 购买编排。仅将此 Skill 用于 Qwen AI Platform 账户。不要根据低余额、通用额度错误、HTTP 状态或无关的模型故障推断用户有充值意图或账户已欠费。

充值和 Token Plan 是相互隔离的领域。充值仅使用下文列出的原有充值参考资料和脚本。Token Plan 仅使用明确列出的 Token Plan 文件，以及未更改的通用 command-resolver.mjs。绝不能在一个领域中使用另一个领域的验证器、轮询器、恢复状态或面向用户的结果措辞。

兼容性和资源

此 Skill 的所有路线均要求 Node 18.18+。充值使用 scripts/preflight.mjs；Token Plan 使用 scripts/tokenplan-preflight.mjs。各领域脚本分别独立负责其运行时基线、QianWen CLI 兼容性、验证和支付宝路径决策；不要在说明文字中复述或覆盖这些决策。

位置	权威职责
scripts/preflight.mjs	路线依赖项探测、金额规范化和事务关键响应验证
scripts/recharge-result-contract.mjs	充值结果的身份识别和状态分类
scripts/poll-recharge.mjs	付款后的前台结果轮询
references/recharge-flow.md	已确认订单的业务流程、分支、停止和恢复
references/cli-contracts.md	命令、参数、JSON 结构、脚本接口和退出码
references/sources.md	仅用于手动来源追溯
scripts/tokenplan-preflight.mjs	Token Plan 依赖项探测和响应验证
scripts/tokenplan-order-contracts.mjs	Token Plan 付款结果和保留订单历史的共享契约
scripts/poll-tokenplan-payment.mjs	Token Plan 有限时长的前台付款等待
references/tokenplan-flow.md	Token Plan 完整的依赖项、报价、购买、结算、激活和恢复流程

仅在当前路线需要权威细节时加载参考资料。对于固定金额充值，仅在用户确认创建订单后才读取 recharge-flow.md。如果用户明确表示当前订单的二维码未显示，且当前订单的支付宝资料仍保留，也要阅读其中的恢复部分。对于 Token Plan 报价、购买或现有购买的后续处理，加载 tokenplan-flow.md；不要加载充值参考资料。

路线

请求	路线	业务边界
余额	balance-summary	只读
已确认欠费或明确的模型调用余额错误	询问是否充值	不授权金额或交易
固定金额支付宝充值	recharge-order	每次尝试仅需一次创建确认，之后付款，并在符合条件时进行前台结果轮询
当前订单二维码未显示	missing-qr-recovery	用户触发的保留支付宝资料展示恢复；不执行命令，也不创建新订单
现有订单结果	recharge-result	一次只读快照；绝不启动轮询循环
充值历史	recharge-history	只读，默认 30 天
充值页面指引	recharge-page	打开浏览器前先确认
Token Plan 报价或新购	token-plan	遵循 tokenplan-flow.md；一次确认仅授权一次创建请求
现有 Token Plan 购买的后续处理	token-plan-recovery	先查询保留订单；仅在收到明确请求时，才可在订单仍未付款期间重复使用其资料或继续同一支付宝跳转；绝不创建订单

充值核心规则

1. 仅本地化 QianWen 自有输出。 遵循用户最新一条实质性消息所用的语言。AI 风险提示可以完整翻译。只有面向用户的支付宝内容会原样传递；路线专属控制数据不会面向用户。
2. 一次确认，一次创建尝试。 确认准确的脱敏账号、规范化金额、支付宝方式和操作范围。一次确认仅授权调用一次创建命令，并且在调用前即被消耗。它不能授权创建其他订单，包括在同一对话中使用相同账号和金额创建的订单，也不能授权重试、替换或追加订单。状态查询、二维码恢复、继续付款，或声称已完成付款，都不会授权创建。对于中断、格式错误、超时、返回非零状态或其他未经确认的创建尝试，绝不自动重试。
3. 一个外层充值生命周期中只有一个付款负责人。 本 Skill 负责创建订单、移交付款，以及决定是否查询 QianWen 结果。订单创建前，预检会选择 direct 或 alipay-payment-skill。alipay-payment-skill 仅负责受委托付款步骤内的安全、命令、重试、输出和停止决策。直接支付宝命令一旦启动，绝不切换路径，因为其副作用可能未知。
4. 不得临场变通处理付款。 仅使用当前创建响应中未经更改且已验证的 paymentUrl。绝不接受、改写、重构、规范化、解码后重新编码或替换用户、历史记录、日志或其他订单中的链接。
5. 仅接受一种到账凭证。 只有共享的充值结果分类器返回 category=credited 才能证明充值已到账。支付宝结果、二维码扫描、用户陈述、余额变化或历史记录均不能作为凭证。
6. 保护凭据和交易数据。 绝不索要支付宝密码、银行卡号、短信验证码、API 密钥、Cookie 或粘贴的令牌。完整账号标识、订单 ID、付款链接和原始负载仅保留在当前流程的内存中。不得将其复制到文件、日志、长期记忆或子 Agent 消息中。
7. 先交付，再轮询。 在任何结果查询或 poll-recharge.mjs 调用前，必须完成 Progress 节点 2。仅 Agent 可见的命令结果、文件读取、预览、草稿或计划中的最终回复，都不算交付。
8. 轮询路线。 使用 recharge-flow.md 确定轮询资格和业务顺序。
9. 保持执行上下文一致。 对 QianWen 命令遵循 cli-contracts.md 中的执行上下文和身份验证恢复约定。

充值直接路径的 sessionId 解析

本节仅适用于直接路径。委托路径遵循 alipay-payment-skill。sessionId 是可选项，且仅适用于 alipay-bot submit-payment；trigger-payment-signal 从不接收它。按以下顺序使用第一个非空值：

优先级	来源
1	运行时元数据：sessionId / session_id
2	当前对话：threadId / thread_id / conversationId / conversation_id / agentContextId；对于 Codex：CODEX_THREAD_ID
3	环境变量 AIPAY_SESSION_ID

原样使用该值。不得生成 ID、向用户索要 ID，或用其他业务 ID 替代。如果所有来源均为空，则省略 --session-id。

充值确认前快速路径

1. 金额

仅使用为当前充值特意提供的金额。

• 使用十进制字符串或整数运算，准确换算元、角和分。
• 只有金额明确无误、为正数、币种为 CNY，且能精确表示为分时，才继续。
• 如果金额缺失、为近似值、范围、包含多个候选金额、使用其他币种或精度小于 1 分，请用户提供一个确切金额。
• 绝不猜测、四舍五入、截断金额，也不复用其他请求中的金额。

结合路由依赖项验证规范化后的金额：

node <skill-dir>/scripts/preflight.mjs --route recharge-order --amount <normalized>

每次尝试执行 recharge-order 时，兼容的 Alipay CLI 和 alipay-payment-skill 都是彼此独立的阻断性依赖项。预检会验证 CLI 契约；还必须单独确认 alipay-payment-skill 存在，并且可在宿主可用的 Skill 注册表中加载。两项依赖不能互相替代，即使预检选择了 payment_path=direct 也不例外。必须在身份验证、确认或创建订单之前完成这两项检查。

两项依赖检查均通过后，保留返回的 payment_path。direct 表示可使用可选的移交前信号能力；alipay-payment-skill 表示必须使用已验证的 alipay-payment-skill 提交付款。如果任一依赖不可用，请停止；仅在需要安装指导时使用 cli-contracts.md § 依赖项设置。

2. 身份验证和账户快照

按照 cli-contracts.md 中的身份验证契约，验证经过服务器身份验证的 QianWen CLI 账户。仅使用 CLI OAuth 设备流；只显示返回的验证 URL，绝不索要凭据或令牌。

仅为确保当前流程一致性而保留完整账户标识符，并且只显示其掩码形式。创建订单前立即重新读取已通过身份验证的账户，并与已确认的快照进行比对。任何账户、金额、币种、付款方式或操作范围变更都会使确认失效。

创建订单前不要查询余额、充值记录或以往订单。这些操作只会增加延迟，无法保护当前交易。

3. 确认

每次针对固定金额创建订单的新确认中，第一行可见内容必须是以下完整的 AI 风险提示，并在适当时进行本地化：

AI risk notice: This recharge request was prepared by AI and may not reflect your actual intent. Review the amount, account, and operation scope; do not confirm if anything is incorrect.

然后显示掩码后的账户、规范化后的金额、Alipay 付款方式，并说明确认后将创建一个充值订单并进入付款流程。最后以自然的确认问句结束。不要使用机械的“确认/取消”选项列表。

• 肯定答复：重新核对账户和规范化后的金额，使用该确认，然后读取并执行 recharge-flow.md。
• 否定答复：不运行任何操作，并输出 Recharge canceled 的本地化译文。
• 重要变更：显示包含风险提示的新确认内容。

充值用户可见进度

仅传达以下业务状态变更。不要透露 CLI 命令、参数、技能路由、验证器、服务名称、轮询内部细节、sessionId、内部轮询截止时间或 QianWen 端的原始错误，除非用户明确要求提供故障排查信息。

进度节点 1：创建订单

确认后、调用创建命令前：

Creating the recharge order…

进度节点 2：已交付支付宝输出

• **直接路径：**仅使用 cli-contracts.md § Direct Alipay commands 中指定的面向用户的 stdout。将其原样交付一次，直接作为面向用户的回复。正常渲染其中的 Markdown；不要添加前言、标题、围栏代码块或状态摘要。逐字节保留所有非媒体文本；不要翻译、总结、换行或筛选其中的业务内容。仅应用以下传输适配：
  • 如果 stdout 中包含 MEDIA: <path-or-url> 行，提取所有引用，并仅从文本中移除这些行。原样发送其余文本，然后通过图像/媒体通道按原始顺序发送引用的图像。
  • 如果没有可用的图像/媒体通道，则在同一条文本回复中按原始顺序将引用附加为 Markdown 图片。
  • 如果 stdout 已包含 Markdown 图片，则原样保留，不要重复发送图片。绝不要打开、分析或修改引用的图片。除非用户报告当前订单的二维码未显示，否则不得重复使用该图片；若用户报告二维码未显示，则可重新呈现该二维码。
• **支付宝 Skill 路径：**遵循 alipay-payment-skill 中的内容、格式和媒体规则，无需在此重述。其生命周期终止符在此外层流程中的作用范围由 recharge-flow.md 定义。如果该路径已通过面向用户的通道输出内容，则不要重复输出。

对于直接路径，MEDIA: 处理只会改变传输形式，不属于支付宝结果验证。对于任一路径，只有在所选路径的内容已对用户可见后，进度节点 2 才算完成。如果运行时无法在不结束外层轮次的情况下发布该文本，则将其作为最终回复；该轮次中不要轮询，并在用户发送下一条消息后使用一次现有订单快照。绝不要在轮询后将支付宝内容留待计划中的最终回复再发送。此透传规则优先于上述 QianWen 侧的本地化、隐藏和错误改写规则。

如果已确认的流程要求在支付步骤未产生面向用户的内容时进行无输出恢复，则显示以下内容的本地化版本：“支付步骤未返回任何可显示的结果，因此无法确定其状态。现有充值订单已保留。请勿创建新订单或再次支付；重试前请让我检查此订单。”这是 QianWen 自行提供的恢复通知，不是支付宝输出，也不能证明充值结果。

仅在一种情况下可例外于仅交付一次的规则：用户报告当前支付二维码未显示时，按照 recharge-flow.md § 4 的说明，重新呈现支付宝为该笔支付返回的二维码和支付链接。

进度节点 3：QianWen 充值结果

使用共享结果分类器返回的类别：

• credited：Recharge credited. ¥<amount> has been added to your QianWenAI balance. 随后追加 Recharge records may be delayed by approximately 10 seconds.
• failed：Recharge was not credited. Check the Alipay transaction status before trying again.
• processing 或 unconfirmed：Recharge result not yet confirmed. If you have already paid, do not pay again — tell me once payment is complete and I will check the final result for you.

当已确认流程的契约要求在终止后查询余额时，收到经过验证的响应后追加 Current available balance: ¥<balance>.。如果该查询失败，则追加 Latest balance is temporarily unavailable. 绝不要根据余额响应更改或替换充值结果。

绝不要表示你会自动或稍后报告结果。用户必须再发送一条消息，之后才能查询后续快照。

充值只读和页面路由

余额

使用 cli-contracts.md § Balance。显示经过验证的 CNY 金额。余额低或为零本身并不能证明账户已逾期，也不代表可以授权充值。

充值资格

• 收到明确的 QianWenAI 充值请求时，直接进入金额流程。
• 用户确认账户已逾期，或明确的模型调用错误指出 QianWenAI 余额不足时，可以提供一个本地化的充值选项；但用户选择充值并不代表已授权充值金额或下单。
• 不要针对一般故障、HTTP 403、免费层额度耗尽、Token Plan 配额或支出限额建议充值。

现有订单结果

使用 cli-contracts.md § Existing-order result 中的一个快照。不要查询 Alipay 状态，也不要启动 poll-recharge.mjs。使用 Progress node 3 展示结果。

充值历史

使用 cli-contracts.md § Recharge history。退出码为 0 时，将 CLI 结果转换为易读的回复。历史记录仅供参考，绝不能证明某个特定订单的结果。

充值页面说明

说明该命令会打开经过验证的 QianWenAI 充值页面，并在使用 cli-contracts.md § Recharge page guidance 前询问用户是否继续。显示返回的经过验证的网址；绝不要自行构造网址。

Token Plan

对于报价、新购 Individual 或 Team、继续支付、缺少支付材料或检查保留订单结果，请遵循 tokenplan-flow.md。本运行手册及其脚本全权负责 Token Plan 的验证、移交、激活和恢复。

不要续订、升级或为 Token Plan 增加配额。有关现有计划状态、配额、团队席位和账单的独立问题，请转交给 qianwen-usage。

更新检查

对于更新请求，如果有可用的同级 qianwen-update-check Skill，请使用它；否则运行 qianwen version --check。充值或 Token Plan 支付流程尚未解决时，绝不要运行更新检查。