接続
すべてのプロバイダーは2つのものを表示します。数値の出所を示すチップと、その下に、プロダクト全体が共有する1つの語彙から取られた状態です。このページでは、その中のすべての状態に名前をつけ、Import onlyが何を意味するかをはっきり述べ、実際の接続が存在するようになると何が変わるかを説明します。
今日、プロバイダーについているチップ
パーサーが存在することは、接続があることを意味しません。そのため、どのカードも、パーサーの存在だけを根拠に接続済みと表示されることはありません。代わりに、すべてのプロバイダーには、その数値が実際どのようにこのデバイスに届いたかを示すチップがついています。実際の接続が存在するまでは以下の3種類のいずれかで、そのプロバイダーをデスクトップアプリケーションからリンクすると接続済みになります。
| チップ | プロバイダー | 意味 |
|---|---|---|
Local CLI | Claude, Codex, Gemini CLI, Antigravity, Grok, Kimi, OpenRouter | A tool already on this machine holds the login, and OpenLimiter reads its own quota from that, or from what that tool already wrote. |
Import only | OpenCode | ペイロードの構造がパースされます。ここではサインインも取得も行われないため、ドキュメントはあなたが用意します。 |
Manual | 手動入力 | 自分で保持する数値です。アカウントから読み取られるものは何もありません。 |
接続の語彙の全体
3つのチップの下には、より大きな語彙があります。13の名前つき状態で、プロダクト全体が作られているcoreパッケージの中の1つのモジュールにあり、それぞれログの1行ではなく、平易な1文で説明されています。これが存在するのは、接続の状態がどの画面でも同じように読み取られる1つの値であり続け、各画面が勝手に文章を作り出さないようにするためです。
| 状態 | 意味 |
|---|---|
NOT_CONFIGURED | 未接続。 |
DETECTED | このマシン上で見つかっているが、まだ収集していない。 |
NEEDS_AUTH | 認証情報を待っている。 |
READY_TO_ENABLE | 収集を始める準備ができている。 |
CONNECTING | 接続中。 |
CONNECTED | 接続済みで、収集中。 |
DEGRADED | プロバイダーが今のところ読み取りを拒否している。 |
STALE | 最後の値が、あるべき鮮度より古い。 |
AUTH_EXPIRED | 保存されていた認証情報が機能しなくなった。 |
IMPORT_ONLY | インポートしたものだけを読み取る。自動で収集されるものはない。 |
MANUAL | 自分で入力したプランを表示する。 |
UNSUPPORTED | この製品にはまだ安全な自動ソースが存在しない。 |
ERROR | この接続は失敗しており、確認が必要。 |
IMPORT_ONLY、MANUAL、UNSUPPORTEDは、試みた結果としてではなく、設計として宣言されるものです。プロダクトはこれらをはっきりと明言し、その後に起きること、レスポンスであれ、失敗であれ、タイムアウトであれ、それらが静かにCONNECTEDへ格上げされることは許されません。ある接続をそこから動かせるのは、OpenLimiter自身が別のことを宣言したときだけです。- 残りは、実際のリーダーが接続を通過させるライフサイクルに名前をつけたものです。見つかったがまだ収集していない、認証情報を待っている、接続中、接続済み、そして何かがうまくいかなかったときの、劣化、鮮度切れ、期限切れ、確認が必要、です。
このページが主張していないこと
13の状態すべてが各画面に表示されるわけではありません。ライブリーダーがない場合、Webアプリとコマンドラインツールは3つのチップによる簡単な語彙を表示します。設定済みのリーダーがあれば、コマンドラインからライブ更新を要求できます。13の状態はコアパッケージで実際にテストされており、デスクトップアプリのConnections画面では接続のライフサイクルに応じて表示されます。
実際の接続が変えること
このページの内容は日付でも約束でもありません。ライブリーダーがない場合、Webアプリとコマンドラインツールは上記の3つのチップを使い、設定済みのコマンドラインリーダーはプロバイダーを更新できます。プロバイダーに実際のリーダーがある場合、その時点で適切な13の状態のいずれかを正直に表示します。検出済み、認証情報待ち、接続中、接続済み、または問題発生時の劣化、古さ、確認待ちです。
すべてのプロバイダーが今日その読み取り機能を持っているわけではありません。実際のものが最初に現れるのは、デスクトップアプリケーション自身の接続画面です。何が計画されていて何がそうでないかはロードマップを、各connectorが今実際に何をできるかは対応プロバイダーを参照してください。