本ページの調整値は .env ではなく、アプリ内の App Settings 画面（サイドバー下部の
スライダーアイコン）で設定し、app_settings.jsonc に保存されます。.env に残った値は
無視され、起動ログにキー名が 1 度だけ列挙されます。既存の設定を引き継ぐには
chatwalaau settings migrate --write を実行してください。機能の有効化ゲートと
シークレットは .env のままです。
詳細は 設定 -> アプリケーション設定。
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、グラフ、エクスポートなど）を作ると、ワークスペースに
保存して回答内でリンクします。そのリンクは普通のリンクではなく、小さな ファイル操作要素 として
表示されます:
- ダウンロード -- ファイルを手元のコンピュータに保存します。ツリーの Download と同じ エンドポイント・同じ上限を使います。
- 開く（PDF と画像、全画面の
/chatページのみ） -- File Explorer でそのファイルのビューア タブを開きます。タブを追加またはフォーカスするだけなので、未保存の編集が失われることは ありません。 - この形でリンクされた 画像 は、回答内にそのまま表示されます。
内部的には、アシスタントは [hello_world.pdf](workspace:output/pdf/hello_world.pdf) のように
書きます。workspace: の後ろにワークスペース内のパスが続く形式です。OpenAI がホストする
サンドボックス向けに書かれたスキルは、回答の最後に sandbox:/... のリンクを出します。これも
解釈されるので、そうしたスキルも編集なしで動作します。さらに、素の相対パスのリンク
([hello_world.pdf](output/pdf/hello_world.pdf))も同じように扱われます。そのため、書き出した
パスをそのまま示しただけの回答でも、操作要素が表示されます。
ワークスペースのファイルとして扱わないリンク: Web リンク、file: リンク、Windows の絶対パス
(ブラウザからは開けません)、および / で始まるもの。最後の1つは生成画像の配信に使われている
ため、画像として従来どおり表示されます。また、本文中に書かれただけのパスがリンクになることは
ありません。
チャットのリンクからのダウンロードには、File Explorer が有効である必要があります。
FILE_EXPLORER_ENABLED=false のときは、理由付きのグレー表示になり、ワークスペースのファイルは
ブラウザから到達できないままです（別の入口はあ りません）。回答後にファイルが移動・削除された
場合は、ワークスペースにファイルが見つかりません と表示されます。
Microsoft Teams では、Teams から開けないリンクはファイル名とパスに置き換えられます
（例: hello_world.pdf (workspace file: output/pdf/hello_world.pdf)）。ファイル自体は Teams に
送信されません。
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_ENABLED | false | 機能全体のマスタスイッチ。 |
FILE_EXPLORER_MAX_FILE_BYTES | 5242880 | エディタで開く/保存できる最大サイズ（バイト）。 |
FILE_EXPLORER_MAX_TREE_ENTRIES | 1000 | 1 ディレクトリ階層で返す最大エントリ数。 |
FILE_EXPLORER_MAX_DOWNLOAD_BYTES | 104857600 | 単一ファイルのダウンロードとフォルダ ZIP（合計非圧縮）の最大サイズ（バイト）。 |
FILE_EXPLORER_MAX_DOWNLOAD_ENTRIES | 5000 | フォルダ ZIP に含める最大ファイル数。 |
FILE_EXPLORER_MAX_UPLOAD_BYTES | 104857600 | 1 回のアップロードの全ファイル合計最大サイズ（バイト）。 |
FILE_EXPLORER_MAX_UPLOAD_FILES | 500 | 1 回のアップロードの最大ファイル数（フォルダは1ファイル=1件）。 |
File Explorer も CODING_ENABLED と CODING_WORKSPACE_DIR を必要とします（設定
を参照）。