プロバイダー
ADHDev はプロバイダーシステムを使い、IDE、CLI ツール、拡張機能、ACP アダプターを 1 つのダッシュボードでサポートします。
プロバイダーインベントリと検証済みのサポートは、意図的に別のものとして扱われます:
- インベントリ: プロバイダーが組み込みカタログに存在し、ADHDev がロードできる
- 検証済みのサポート: プロバイダーが明示的にテストされ、証拠とともに格上げされた
プロバイダーのカテゴリ
| カテゴリ | 説明 | 例 |
|---|---|---|
ide | デスクトップ IDE アプリケーション | Cursor, VS Code, Windsurf |
cli | ターミナルベースの AI エージェント | Gemini CLI, Claude Code |
extension | IDE 拡張機能/プラグイン | Cline, Roo Code |
acp | Agent Client Protocol エージェント | 35 個の組み込みアダプター |
プロバイダーの仕組み
高いレベルで言えば、プロバイダーは ADHDev に次の方法を伝える統合レイヤーです:
- 対象ツールを検出する
- CDP、PTY、または stdio を通じて接続する
- チャットまたはランタイムの状態を読む
- 入力または制御アクションを送る
- ツールがサポートする場合にモデル、モード、承認のコントロールを公開する
それらの挙動が実際に「サポートされている」と呼べるほど信頼できるかどうかは、別の検証の問題です。
ユーザーが気にすべきこと
エンドユーザーとして、主な問題はプロバイダーがどのように実装されているかではありません。次のとおりです:
- プロバイダーは組み込みインベントリに存在するか？
Verified、Partial、Unverifiedのどれとして文書化されているか？- あなたが気にするワークフローにどんな注意事項が適用されるか？
そのためには、次のページを活用してください:
CLI および ACP プロバイダーのマシン有効化
マシンランタイムプロバイダー（cli と acp）の場合、インベントリに存在することは、特定のマシンで起動可能であることと同じではありません。ADHDev は今や、これらのプロバイダーをマシンスコープのオプトインエントリとして扱います:
- マシンの Providers タブを開きます。
- そのマシンでプロバイダーを有効化します。
- Detect を実行し、ADHDev がそのマシンで構成された実行ファイルを検証するようにします。
- 検出が成功したら、ダッシュボードまたは CLI から起動します。
プロバイダーカードは、現在のマシンのステータス（Disabled、Enabled, not checked、Not detected、Detected）に加えて、最新の検出と検証の詳細を表示します。これにより、カタログに存在するだけのプロバイダーが、ローカルの実行ファイルが実際にチェックされるまで、使用可能なランタイムとして表示されるのを防ぎます。
カスタムの実行ファイルパスと引数は、マシンローカルのプロバイダー設定です。ツールがデフォルトの PATH の外にインストールされている場合や、ラッパーコマンドが必要な場合に使ってください。
プロバイダーソース設定
Providers タブの Provider source config セクションは、プロバイダー定義をどこから解決するかを制御します:
normal: 通常のユーザールートと、アップストリーム/バンドルされたプロバイダーをロードします。no-upstream: ダウンロードされたアップストリームソースをスキップし、ローカル/バンドルされた定義のみを使用します。explicit providerDir: ADHDev を、ローカルのadhdev-providersチェックアウトのような特定のプロバイダールートに向けます。
ソースモードまたは providerDir を変更した後は Apply + Reload を使ってください。リロードは、プロバイダーの解決、修正/検証のフロー、新しい起動に影響します。変更されたプロバイダースクリプトを反映するには、実行中のセッションの再起動が必要になることがあります。
プロバイダーが存在しても失敗する場合
プロバイダーがインベントリに存在しても、依然としてギャップがあることがあります。
一般的な理由:
- IDE またはエージェントのアップストリームの UI 変更
- 部分的なワークフローのカバレッジ
- 基盤となるツールの認証の欠如
- 存在するものの、依然として
Unverifiedの状態のプロバイダー - 有効化されていない、またはマシンの検出に合格していない CLI/ACP プロバイダー
- まだ適用/リロードされていないプロバイダーソース設定の変更
その場合は、プロバイダーの問題 から始めてください。