Quota Circuit Breaker(連続失敗・429エラー遮断CLI)
- ダウンロード商品¥ 500

# Quota Circuit Breaker(¥500) プロバイダーとモデルごとの連続失敗を手元の状態ファイルに記録し、止めるべきモデルを外して、次に呼ぶ候補を選びます。 ## こんな方へ 上限のある API を定期ジョブやエージェントから呼び出していて、制限に当たったモデルを叩き続けないようにしたい方へ。 ## ZIP に入っているもの エンジン `src/circuit_breaker.mjs` と CLI `bin/quota-breaker.mjs` を同梱。連続失敗が規定回数(既定 3 回)に達するか、HTTP 429 などの上限系エラーが出た時点でブレーカーが開き、クールダウン中はそのモデルを飛ばします。クールダウン後は試し呼び出しを 1 回だけ許可し、成功すれば閉じ、失敗すれば再び開きます。廃止されたモデルは隔離でき、`pick` が優先順位の高い正常なモデルを返します。状態は JSON 1 ファイルで、更新時は一時ファイルを書き終えてから元のファイルを置き換えます。 テスト、日英の README、商用ライセンスを同梱しています。Node.js 20 以上で、依存パッケージのインストールなしで動作します。 ## クイックスタート 1. ZIP を展開し、ターミナルで展開先の商品フォルダを開きます。 2. `node bin/quota-breaker.mjs --help` でコマンドを確認します。 3. `README.ja.md` の例をもとに、候補のモデルと優先順位を設定します。 4. 呼び出しの成否を `record` で記録し、次の呼び出しの前に `pick` で候補を確認します。 ## ライセンス 商用シングルシートライセンスです。記名の購入者 1 名が利用できます。 出力物は商用利用できます。ソースの再配布、転売、サブライセンスは不可です。利用条件は ZIP 内の `LICENSE-COMMERCIAL.txt` に準拠します。 ## よくある質問 - プロバイダーに接続して使用量や残枠を取得しますか? しません。通信は一切なく、成功・失敗の結果を自分で `record` に渡す仕組みです。API 側の使用量は管理画面で確認してください。 - 日次上限や待ち時間をテストできますか? `--now <iso>` で判定時刻を固定できます。 ## 無料の関連ツール [Jev Harness(無料・MIT)](https://github.com/pikuto1125-pixel/agy-jev-harness)
