メインコンテンツまでスキップ

File Explorer

File Explorer は、コードワークスペースのファイルを 手作業で編集 するための、VSCode 風の 画面です -- エージェントのコーディングツールの人間版で、同じワークスペース・同じセキュリティ 境界の上で動きます。アシスタントに頼むのではなく、自分で小さく正確に直したいときに使います。

本機能は オプトイン で、既定では無効です。FILE_EXPLORER_ENABLED=true で有効化します。

有効化​

File Explorer はコードワークスペース内のファイルを編集するため、コーディングツールのセキュリティ 境界を再利用します。次の両方が必要です:

FILE_EXPLORER_ENABLED=true
CODING_ENABLED=true
CODING_WORKSPACE_DIR=/path/to/your/workspace

FILE_EXPLORER_ENABLED が無効のとき、起動アイコンは非表示になり、/files も提示されず、API も inert（404）になります -- ランタイムは変化しません。

開き方​

2 つの方法があり、いずれも同じ全画面オーバーレイを開きます:

  • サイドバー下部の ファイルツリーアイコン（Cron アイコンの隣）をクリックする。
  • チャット入力欄で /files と入力する。

レイアウト​

オーバーレイは左右に分かれ、間には ドラッグで調整できる仕切り があります:

  • 左 -- ファイルツリー。 ワークスペースをルートとするツリーで、1 階層ずつ読み込まれます。 シングルクリックは 選択（フォルダのクリックは展開/折りたたみも兼ねます）、ファイルは ダブルクリックでタブに開きます（Enter キーでも開けます）。ノードを 右クリック すると 操作メニューが出ます（フォルダとファイルで項目が変わります）:
    • フォルダ: New File・New Folder・Download as ZIP・Rename・Delete。
    • ファイル: Open・Download・Rename・Delete。 Rename は新しい名前を入力する小さなダイアログを開きます。項目をフォルダへ ドラッグ して移動することもできます。
  • 右 -- エディタ。 タブ式の monaco エディタ （VS Code を支えるエディタ）で、白テーマです。複数ファイルをタブで開け、未保存のタブには ドットが表示されます。エディタ自身の 右クリックメニュー が Copy / Cut / Paste / Find などを提供し、タブの右クリックメニューには Download が加わります。テキストはエディタで 開き、PDF と画像は組み込みビューアで開きます（後述）。エディタをグループに分割 して タブをドラッグで移動することもできます（後述）。

編集・保存・削除​

  • 開く -- ファイルを開くと一瞬インディケータが出て、内容がタブに表示されます。
  • 保存 -- Ctrl/Cmd+S または Save をクリック。完了まで pending インディケータが 表示されます。
  • 削除 -- ファイル/フォルダの削除は 最終確認（「元に戻せません」）を求め、完了まで ブロッキングインディケータを表示します。フォルダ削除はその中身も削除します。
  • タブ -- タブを右クリックで Close・Close Others・Close All を選べます。
  • 未保存の変更 -- 未保存の作業を失う可能性のある操作は 先に確認 が出ます: タブを閉じる、 未保存タブを含む一括クローズ、そして Explorer 全体を閉じる とき。Explorer を閉じる場合、 確認して続行すると編集中の内容を破棄し、次回はファイルを保存済みの状態で開き直します -- 同じ ファイルを他の人が編集している可能性があるため、ローカルの下書きに縛られないようにしています。

ファイル・フォルダのアップロード​

ローカルのファイル（およびフォルダ丸ごと）をブラウザからコーディングワークスペースへ取り込めます:

  • ファイルのアップロード。 ツリーツールバーの Upload files アイコンでワークスペース ルートへアップロード、またはフォルダを右クリックして Upload files here を選びます。 1つ以上のファイルを選択できます。
  • フォルダのアップロード。 Upload folder アイコン（またはフォルダの Upload folder here）でフォルダを選ぶと、その構造が対象ディレクトリ配下に再現されます。

複数ファイルに対応し、全ファイルを通した 全体のアップロード進捗をアニメーションのバーで表示 します。完了するとツリーが更新されます。既存ファイルは上書き（last-write-wins）です。アップロードは FILE_EXPLORER_MAX_UPLOAD_BYTES（既定 1 回あたり合計 100 MiB）と FILE_EXPLORER_MAX_UPLOAD_FILES（既定 1 回あたり 500 ファイル）で制限され、上限超過は明確な エラーで拒否されます。すべての宛先はワークスペース内に限定されます（パストラバーサルは拒否）。

ファイル・フォルダのダウンロード​

  • ファイルのダウンロード。 ツリーのファイル（または開いているエディタタブ）を右クリックして Download を選びます。
  • フォルダのダウンロード。 フォルダを右クリックして Download as ZIP を選ぶと、フォルダが その場で ZIP にまとめられます。ツールバーのダウンロードアイコンはワークスペース全体を ダウンロードします。

ダウンロードは FILE_EXPLORER_MAX_DOWNLOAD_BYTES（既定 100 MiB。単一ファイルとフォルダ ZIP の 合計非圧縮サイズの両方に適用）と FILE_EXPLORER_MAX_DOWNLOAD_ENTRIES（既定 5000。ZIP に含める ファイル数）で上限管理されます。上限を超える対象は明確なエラーで拒否されます。これらの上限は エディタの開く/保存の上限とは別なので、エディタで開けないサイズのファイルもダウンロードできます。

PDF と画像のプレビュー​

PDF を開くと、ズームイン/アウト と ページ送り ができる組み込みの pdf.js ビューアが 表示されます。画像 を開くと、ズームとパン（マウスホイールと画面上のコントロール）が できるビューアが表示されます。これらの種類では従来の「バイナリ -- 読み取り専用」表示の代わりに ビューアが開きます。プレビューは閲覧専用です。PDF ビューアは完全に self-host（外部/CDN への リクエストなし）で、localhost ファースト/オフラインの姿勢を保ちます。

画像または PDF の表示中は、タブバーに チャットに添付 ボタンが現れます。開いている ファイルをチャットのメッセージ入力欄に追加します（File Explorer を閉じ、ドラッグ＆ドロップと 同じ経路で添付）。ダウンロードせずにワークスペースのファイルをそのままアシスタントへ渡せます。 このボタンは、未保存の編集がないときのみ有効です（安全に閉じられる状態）。

エディタの分割​

複数のファイルを並べて作業できます:

  • 分割（Split） -- タブをエディタペインの 左/右/上/下の端 へドラッグすると、その方向に 新しいグループへ分割します。グループのツールバーの 分割アイコン はアクティブタブを右へ 分割します。
  • 移動（Move） -- タブを別グループのタブ列へドラッグすると、そこへ移動します。1 つの ファイルは同時に 1 つのグループにのみ存在します。グループ間の仕切りをドラッグして サイズを変えられます。
  • 空になったグループは自動的に消えます。分割レイアウトは 一時的 で、次に Explorer を 開くと単一グループに戻ります。

制限と挙動​

  • テキストのみ。 バイナリファイルは検出され、読み取り専用 で開きます -- エディタは バイナリ内容を編集しません。
  • サイズ上限。 FILE_EXPLORER_MAX_FILE_BYTES（既定 5 MiB）を超えるファイルはツリーには 表示されますが、開く/保存は拒否されます。各ディレクトリ階層は FILE_EXPLORER_MAX_TREE_ENTRIES（既定 1000）件まで一覧します。
  • 保存は last-write-wins ですが安全策があります: 開いた後にディスク上のファイルが変更されて いた場合、保存は拒否され、外部の編集を黙って上書きしません。本バージョンにはライブのファイル 監視はありません -- ツリーの Refresh で読み直してください。

セキュリティ​

すべては CODING_WORKSPACE_DIR の内側に閉じます: すべてのパスはコーディングツールと同じ ワークスペース jail を通して解決されるため、Explorer はワークスペースの外を読み書きできません。 本機能は既定で無効、CODING_ENABLED が必要で、すべての変更（保存・作成・削除・名前変更/移動）は 認証されます（ローカル開発では loopback は免除）。

ネットワーク経由の貼り付けについて。 エディタの右クリックメニューからの貼り付けはブラウザの クリップボードを使い、localhost 以外ではブラウザがセキュア（HTTPS）オリジンでのみ許可します。 LAN 経由でアクセスする場合は 運用 の HTTPS/TLS を参照してください。 Ctrl/Cmd+V は常に動作します。

設定リファレンス​

変数既定説明
FILE_EXPLORER_ENABLEDfalse機能全体のマスタスイッチ。
FILE_EXPLORER_MAX_FILE_BYTES5242880エディタで開く/保存できる最大サイズ（バイト）。
FILE_EXPLORER_MAX_TREE_ENTRIES10001 ディレクトリ階層で返す最大エントリ数。
FILE_EXPLORER_MAX_DOWNLOAD_BYTES104857600単一ファイルのダウンロードとフォルダ ZIP（合計非圧縮）の最大サイズ（バイト）。
FILE_EXPLORER_MAX_DOWNLOAD_ENTRIES5000フォルダ ZIP に含める最大ファイル数。
FILE_EXPLORER_MAX_UPLOAD_BYTES1048576001 回のアップロードの全ファイル合計最大サイズ（バイト）。
FILE_EXPLORER_MAX_UPLOAD_FILES5001 回のアップロードの最大ファイル数（フォルダは1ファイル=1件）。

File Explorer も CODING_ENABLED と CODING_WORKSPACE_DIR を必要とします（設定 を参照）。