拡張機能

拡張機能はタスクボードなどの全画面ページを提供できます。セッション一覧の上にある拡張機能のページメニューから開きます。有効で承認済みのページがある場合だけメニューが表示されます。チャット選択、再読み込み、一時停止、削除、サーバー切り替えでページが閉じます。拡張機能が自分で開くことはできません。

拡張機能自身のデータは接続先サーバーに保存され、拡張機能を削除すると消えます。ボードはプロジェクトにファイルを作らず、複数のプロジェクトやワークツリーのセッションを追跡できます。

設定 → 拡張機能 から、他の人が作ったパネルを OpenChamber に追加できます。拡張機能は右側のレールに置かれる小さなページで、組み込みパネルの隣に並びます。別のサービスのデータを表示したり、タスクをチャットに添付したり、あなたが許可すればセッションの開始、プロンプトの送信、ファイルの読み取りもできます。

拡張機能は OpenChamber の web 版とデスクトップ版で動きます。VS Code とモバイルアプリではまだ読み込まれません。OpenCode のプラグインとは別物です。

インストールする

組み込みと表示される拡張機能は、選択中の OpenChamber インスタンスに同梱されています。初期状態で有効になり、宣言された権限は確認ダイアログなしで付与されます。カードの無効化または有効化を使って切り替えます。アプリと別に削除・更新することはできません。無効にしてもデータと接続済みアカウントは保持され、その設定はアプリ更新後も維持されます。

アカウント設定は設定 → 連携 → 標準連携にあります。サービスへのアクセスには、別途 API トークンやログインが必要な場合があります。

設定 → 拡張機能 を開きます。
フォルダ、ZIP、または URL の欄に次のいずれかを貼り付け、追加を選びます:
- このコンピューター上のフォルダの絶対パス
- .zip ファイルのパス
- git リポジトリまたは zip ファイルへの https リンク
- [email protected]:owner/extension.git などの SSH Git アドレス
拡張機能が権限を求める場合、ダイアログにその一覧が出ます。許可して有効化 を選ぶか、削除で取り消します。

.zip を欄にドロップするか、隣のアーカイブボタンで選ぶこともできます。アーカイブは OpenChamber サーバーにアップロードされるので、リモートのインスタンスでも使えます。デスクトップではフォルダボタンでネイティブの選択画面が開き、ドロップしたフォルダはそのパスからインストールされます。

拡張機能のアイコンがレールに表示されます。表示されない場合はトラブルシューティングを見てください。

フォルダからのインストールはそのフォルダから直接動くので、拡張機能を開発している人は編集して再読み込みできます。zip や URL は先に OpenChamber 自身のデータフォルダにコピーされ、元のファイルには触れません。

非公開リポジトリと Git ID

SSH インストールは [email protected]:owner/extension.git と ssh://[email protected]/owner/extension.git に対応し、末尾に #branch-or-tag を指定できます。入力欄横の指紋メニューでグローバル ID または保存済み Git ID を選択します。この選択は更新確認と更新にも使われ、鍵の変更は次の操作に反映されます。

グローバル ID は選択中の OpenChamber サーバーを実行するユーザーの Git/SSH 設定と SSH エージェントを使います。リモートではそのサーバーに鍵が必要です。パスフレーズ付きの鍵は、サーバープロセスの SSH エージェントで先に解除してください。HTTPS は Git の HTTPS 認証情報を使い、SSH に自動切り替えしません。Git ホストは公開アドレスに解決される必要があります。ローカル SSH エイリアスやプライベートネットワークの宛先には対応していません。

拡張機能ができること

パネルを表示することと、どのプロジェクトとセッションが開いているかを読むことに権限は要りません。あなたの代わりに何かをする操作には権限が必要で、その一覧はインストール時に一度だけ表示されます:

セッションにメッセージを送る: モデルにプロンプトを書いて送ります。トークンを消費し、ツールを実行することもあります。
プロジェクトとセッションにアクセス: プロジェクト、ワークツリー、セッション状態を一覧表示し、登録済みプロジェクトでセッションを作成して開きます。会話の内容にはアクセスしません。
プロジェクトのファイルを読み書き: 開いているプロジェクト内のすべてのファイル。
プロジェクト外のファイルを読み書き: ダイアログに挙げられた場所だけ。
Small Model を使う: セッションの外で行う一回限りのテキスト生成で、設定 → セッション → Small Model のモデルを使います。トークンを消費します。
外部サービスに接続: 設定 → 連携で接続したアカウントを使います。
セッションの会話を読み取る: そのセッションで拡張機能のアクションを実行したときだけ。
ローカルサービスを実行: あなたのユーザー権限をすべて持つ別のプログラム。作者を信頼できる場合にだけ許可してください。

新しいバージョンがあなたの許可した範囲より多くを求めると、カードに 承認が必要 と 権限を確認 ボタンが表示されます。新しい一覧を許可するまで、その拡張機能はオフのままです。

どこに現れるか

レールのパネルに加えて、拡張機能はあなたが普段使うメニューに項目を追加できます。チャットメッセージのアクション、セッションのメニュー、チャット欄の横の + メニュー、そして何も開かずに何かを添付する /task ABC-12 のようなスラッシュコマンドです。また、自分のツールに OpenChamber 組み込みツールと同じような、ちゃんとしたアイコン、タイトル、出力レイアウトをチャット上で与えることもできます。どれを提供するかは拡張機能が決めます。拡張機能を許可するまで、すべてオフのままです。

一部の拡張機能は独自のパネルの代わりにライブ画像を表示します。エージェントがサーバー上で作業している対象、たとえばブラウザーやシミュレーターです。画像をクリックするか入力すると操作を引き継げます。ステータス行に あなたが操作中 と表示され、エージェントに戻す を押すまでエージェントのブラウザー操作は拒否されます。コピーと貼り付けは通常どおり使えます。同時に接続している別のデバイスは誰が操作中かを確認でき、操作を奪うことはできません。このような拡張機能は、画像の隣に独自の操作部を追加できます。たとえば上にアドレスバー、横にツール列などです。

アカウントを接続する

サービスとやり取りする拡張機能には、設定 → 連携 の 拡張機能のアカウント にカードが表示されます。サービスによって、カードは API トークン、ユーザー名とトークン、またはサインイン用の client id を求めます。接続を選びます。切断は保存されたトークンを忘れます。拡張機能が宣言した追加の欄は、離れたときに自動で保存されます。

トークンは OpenChamber サーバーに残ります。拡張機能のページがそれを見ることはありません。

更新

git URL からインストールした拡張機能は自分で更新できます。設定 → 拡張機能 を開くと、それぞれを最大 1 時間に 1 回確認します。更新を確認 はすぐに確認します。新しいバージョンがあるカードには 更新あり と更新ボタンが表示されます。更新しても権限、アカウント、設定はそのまま残ります。新しいバージョンがより多くを求める場合は、承認ダイアログが再び表示されます。フォルダや zip からのインストールは更新されません。手動で置き換えてください。

インストール時に git URL へ #v1.2.0 や #stable を付けると、デフォルトブランチの代わりにタグやブランチを追従します。

一時停止または削除

各カードには有効スイッチがあります。オフにすると拡張機能はインストールされたまま、パネルは隠れ、呼び出しはブロックされます。削除は zip や URL からのインストールを OpenChamber のデータフォルダから消します。フォルダからのインストールではパスを忘れるだけで、あなたのフォルダは残ります。

自分で作る

拡張機能にできることのすべてと作り方は拡張機能を作るにあります。