qianwen-payment

Qwen AI Platform の支払い

Qwen AI Platform（千问AI平台）の現金残高、金額指定の Alipay チャージ、新しい 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 の互換性、検証、Alipay の処理経路の判断を単独で担います。これらの判断を文章で再現したり、上書きしたりしてはいけません。

場所	権威ある役割
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 を読み込んでください。また、ユーザーが現在の注文の QR コードが表示されず、現在の注文の Alipay 用情報が引き続き保持されていると明示した場合は、そのリカバリーのセクションも読み込んでください。Token Plan の見積もり、購入、または既存購入のフォローアップでは、tokenplan-flow.md を読み込んでください。チャージ用のリファレンスは読み込まないでください。

ルート

リクエスト	ルート	業務上の境界
残高	balance-summary	読み取り専用
確認済みの未払い、またはモデル呼び出し時に明示された残高エラー	チャージするか確認する	金額や取引を承認するものではありません
金額指定の Alipay チャージ	recharge-order	試行ごとに作成確認は1回のみ。その後、支払いを行い、条件を満たす場合にフォアグラウンドで結果をポーリングします
現在の注文の QR コードが表示されない	missing-qr-recovery	保持されている Alipay 用情報をユーザーの要求に応じて再表示します。コマンドや新規注文は作成しません
既存注文の結果	recharge-result	読み取り専用のスナップショットを1回取得します。ポーリングループは開始しません
チャージ履歴	recharge-history	読み取り専用。デフォルトは30日間
チャージページの案内	recharge-page	ブラウザーを開く前に確認します
Token Plan の見積もりまたは新規購入	token-plan	tokenplan-flow.md に従います。1回の確認で1回の作成リクエストを承認します
既存の Token Plan 購入のフォローアップ	token-plan-recovery	まず保持された注文を照会します。明示的な要求がある場合に限り、その注文が未払いの間、保持された情報を再利用するか、同じ Alipay の引き渡しを再開できます。注文は作成しません

チャージの基本ルール

1. QianWen が生成した出力のみをローカライズします。 ユーザーの直近の実質的なメッセージの言語に従います。AI リスク通知は全文を翻訳してかまいません。ユーザー向けの Alipay コンテンツのみをそのまま渡し、ルート固有の制御データをユーザー向けに表示してはいけません。
2. 確認は 1 回、作成の試行も 1 回です。 マスクされた正確なアカウント、正規化された金額、Alipay の方法、操作範囲を確認します。確認によって許可されるのは、作成コマンドの呼び出し 1 回のみであり、その呼び出しの前に確認は消費されます。同じ会話内で同じアカウントと金額を指定する場合も、再試行、置き換え、追加注文の場合も、別の注文を許可することはできません。ステータス照会、QR コードの復旧、支払いの続行、または支払い完了の申告によって、作成が許可されることはありません。中断、形式不正、タイムアウト、ゼロ以外の終了コード、またはその他の未確認状態になった作成の試行を自動で再試行してはいけません。
3. 1 つのチャージライフサイクル内で、支払いを担当する主体は 1 つです。 この Skill は、注文の作成、支払いへの引き継ぎ、および QianWen の結果を照会するかどうかの判断を担当します。作成前の事前確認で、direct または alipay-payment-skill を選択します。alipay-payment-skill が担当するのは、委任された支払い側のステップ内での安全性、コマンド、再試行、出力、停止判断のみです。副作用が不明な可能性があるため、直接 Alipay コマンドを開始した後に経路を切り替えてはいけません。
4. 支払い方法を独自に変更してはいけません。 現在の作成レスポンスに含まれる、変更されていない検証済みの paymentUrl のみを使用します。ユーザー、履歴、ログ、または別の注文から取得したリンクを受け入れたり、書き換えたり、再構築したり、正規化したり、デコード／再エンコードしたり、代わりに使用したりしてはいけません。
5. チャージを証明する方法は 1 つだけです。 共有のチャージ結果分類器が category=credited を返した場合のみ、チャージが反映された証明となります。Alipay の結果、QR コードのスキャン、ユーザーの申告、残高の変化、履歴の記録は、その証明にはなりません。
6. 認証情報と取引データを保護します。 Alipay のパスワード、銀行カード番号、SMS コード、API キー、Cookie、貼り付けられたトークンを要求してはいけません。完全なアカウント識別子、注文 ID、支払いリンク、生のペイロードは、現在のフロー内のメモリにのみ保持します。ファイル、ログ、長期メモリ、サブエージェントへのメッセージにコピーしてはいけません。
7. ポーリングの前に結果を届けます。 結果を照会したり poll-recharge.mjs を実行したりする前に、Progress ノード 2 を完了します。エージェントにしか見えないコマンド結果、ファイルの読み取り、プレビュー、下書き、または送信予定の最終返信は、結果を届けたことにはなりません。
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 に置き換えたりしてはいけません。すべての値が空の場合は、--session-id を省略します。

チャージの確認前の高速経路

1. 金額

現在のチャージに対して明示的に指定された金額のみを使用してください。

• 元、角／毛、分は、10 進文字列または整数の演算で正確に換算してください。
• 金額が明確で、正の値であり、CNY 建てで、分単位で正確に表現できる場合にのみ続行してください。
• 金額が未指定、概算、範囲指定、複数の候補を含む、別の通貨建て、または 1 分未満の精度の場合は、正確な金額を 1 つ尋ねてください。
• 金額を推測、丸め、切り捨てたり、別のリクエストの金額を再利用したりしないでください。

正規化した金額を、ルートの依存関係と併せて検証してください。

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

recharge-order を試みるたびに、互換性のある Alipay CLI と alipay-payment-skill は、それぞれ独立した必須依存関係です。事前確認では CLI の契約を検証し、ホストで利用可能な Skill レジストリに alipay-payment-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 の方法、確認するとチャージ注文が 1 件作成され、支払いフローに進むことを表示してください。自然な確認の質問で締めくくってください。機械的な「確認／キャンセル」の選択肢一覧は使用しないでください。

• 肯定の場合：アカウントと正規化した金額を再確認し、確認を消費してから、recharge-flow.md を読み、実行してください。
• 否定の場合：何も実行せず、Recharge canceled に相当する文言をローカライズして出力してください。
• 重要な変更があった場合：リスク通知を含む新しい確認ブロックを表示してください。

チャージ時にユーザーに表示する進行状況

次の業務上の遷移のみを伝えてください。ユーザーがトラブルシューティング情報を明示的に求めない限り、CLI コマンド、引数、Skill のルーティング、バリデーター、サービス名、ポーリングの内部処理、sessionId、内部ポーリング期限、または QianWen 側のエラーの生データを公開しないでください。

進行状況ノード 1：注文の作成

確認後、作成コマンドを呼び出す前に：

Creating the recharge order…

進捗ノード 2：Alipay の出力を配信

• 直接経路： cli-contracts.md § Direct Alipay commands で指定されている、ユーザー向けの stdout のみを使用します。前置き、見出し、フェンス付きコードブロック、ステータスの要約を追加せず、そのままユーザー向けの応答として一度だけ配信します。Markdown は通常どおり表示します。メディア以外のテキストはバイト単位でそのまま保持し、ビジネス上の内容を翻訳、要約、折り返し、フィルタリングしないでください。適用するのは、次の配信上の調整のみです。
  • stdout に MEDIA: <path-or-url> の行が含まれている場合は、すべての参照を取り出し、それらの行だけをテキストから削除します。残りのテキストを変更せずに送信し、その後、参照されている画像を元の順序で画像／メディアチャネル経由で送信します。
  • 画像／メディアチャネルを利用できない場合は、参照を元の順序で Markdown 画像として単一のテキスト応答に追加します。
  • stdout にすでに Markdown 画像が含まれている場合は、変更せずに保持し、画像を重複して送信しないでください。参照された画像を開いたり、分析したり、変更したりしないでください。ユーザーが表示されなかったと報告した場合に、現在の注文で保持されている QR を再提示する場合を除き、再利用しないでください。
• Alipay Skill 経路： alipay-payment-skill の内容、書式、メディアに関するルールに従ってください。これらをここで再掲しないでください。この外側のフローにおけるライフサイクル終了条件の適用範囲は、recharge-flow.md で定義されています。ユーザーに見えるチャネルを通じてすでに内容を出力している場合は、繰り返さないでください。

直接経路では、MEDIA: の処理は配信形式のみを変更するものであり、Alipay の結果検証には影響しません。どちらの経路でも、選択した経路の内容がユーザーに表示された時点でのみ、進捗ノード 2 は完了となります。ランタイムが外側のターンを終了せずにそのテキストを公開できない場合は、それを最終応答として使用し、そのターンではポーリングを行わず、ユーザーの次のメッセージの後に既存注文のスナップショットを 1 回取得してください。ポーリング後に予定している最終応答へ Alipay の内容を先送りしないでください。このパススルールールは、前述の QianWen 側のローカライズ、非表示化、エラーの書き換えに関するルールより優先されます。

確認済みフローで、支払いステップがユーザー向けの内容を何も出力しなかったため、出力なしの復旧が求められている場合は、次の内容をローカライズして表示してください。支払いステップから表示可能な結果が返されなかったため、結果は不明です。既存のチャージ注文は保持されています。新たな注文を作成したり、もう一度支払ったりしないでください。再試行する前に、この注文を確認するよう依頼してください。 これは QianWen が提供する復旧通知であり、Alipay の出力でも、チャージ結果の証明でもありません。

一度だけ送信するルールには例外が 1 つあります。ユーザーが現在の支払い QR が表示されなかったと報告した場合は、recharge-flow.md § 4 に従い、その支払いについて Alipay から返されたデータを使って QR と支払いリンクを再提示してください。

進捗ノード 3：QianWen のチャージ結果

共有結果分類器から返されたカテゴリを使用します。

• credited：チャージが反映されました。¥<amount> が QianWenAI の残高に追加されました。 続けて チャージ記録の反映には約 10 秒かかる場合があります。 を追加します。
• failed：チャージは反映されていません。再試行する前に、Alipay の取引状況を確認してください。
• processing または unconfirmed：チャージ結果はまだ確認できていません。すでに支払い済みの場合は、もう一度支払わないでください。支払いが完了したら知らせてください。最終結果を確認します。

確認済みフローの契約で終了後の残高照会が求められている場合は、応答の検証後に 現在利用可能な残高：¥<balance>。 を追加します。その照会に失敗した場合は、最新の残高は一時的に利用できません。 を追加します。残高応答を根拠として、チャージ結果を変更したり置き換えたりしないでください。

結果を自動的に、または後で報告すると決して言わないでください。後でスナップショットを照会するには、ユーザーが別のメッセージを送る必要があります。

チャージの読み取り専用ルートとページルート

残高

cli-contracts.md § Balance を使用します。検証済みの CNY 金額を表示します。残高が少ない、またはゼロであることだけでは、延滞状態の証明にもチャージの許可にもなりません。

チャージの対象となる場合

• 明示的な QianWenAI のチャージ依頼があった場合は、直接金額のフローに進みます。
• ユーザーが延滞アカウントであることを確認した場合、または QianWenAI の残高不足を示す明示的なモデル呼び出しエラーが発生した場合は、ローカライズされたチャージの選択肢を 1 つ提示できます。オプトインしても、金額や注文が許可されたことにはなりません。
• 一般的なエラー、HTTP 403、無料枠の上限到達、Token Plan のクォータ、または利用上限を理由にチャージを提案してはいけません。

既存注文の結果

cli-contracts.md § Existing-order result のスナップショットを 1 つ使用します。Alipay のステータスを照会したり、poll-recharge.mjs を起動したりしないでください。Progress ノード 3 とともに結果を提示します。

チャージ履歴

cli-contracts.md § Recharge history を使用します。終了コード 0 の場合、CLI の結果を人が読みやすい応答に変換します。履歴は参考情報であり、特定の注文結果を証明するものではありません。

チャージページの案内

コマンドが検証済みの QianWenAI チャージページを開くことを説明し、cli-contracts.md § Recharge page guidance を使用する前に、進めてよいか確認します。返された検証済み URL を表示し、URL を作成してはいけません。

Token Plan

見積もり、新規の Individual または Team の購入、支払いの続行、決済情報の不足、または保持された注文結果の確認については、tokenplan-flow.md に従います。このランブックとそのスクリプトが、Token Plan の検証、引き継ぎ、有効化、および復旧をすべて担当します。

Token Plan の更新、アップグレード、またはクォータの追加は行わないでください。既存プランの単独のステータス、クォータ、チームシート、および請求に関する質問は、qianwen-usage に案内してください。

更新チェック

更新依頼には、利用可能な場合は同階層の qianwen-update-check Skill を使用します。それ以外の場合は qianwen version --check を実行します。解決していないチャージまたは Token Plan の支払いフローがある間は、更新チェックを実行してはいけません。