ファイルビューアー 0.9.9 で追加

ファイルビューアーは、1 つのファイルを画面全体に表示します。📁 Browse files（ファイルを参照）でファイルをクリックしたとき、エージェントが返信に書いたファイル名をクリックしたとき、または会話内の画像・動画・音声の添付ファイルをクリックしたときに開きます。ファイルを読む、再生する、ズームする、保存することができ、画像には書き込みもできます。

画像、動画、音声は黒い背景に表示されます。テキストは、幅の広い画面でも読みやすい幅の列に表示されます。タイトル、ボタン、ファイルの種類とサイズを示す行は、内容の上に重ねて表示されます。内容をタップまたはクリックすると、これらが隠れ、もう一度で再び表示されます。動画や音声ファイルの再生中は 3 秒後にも薄れて消え、マウスを動かすかボタンに触れると再び表示されます。一時停止中のプレーヤーでは常に表示されます。

種類ごとの表示 #

リレーは、ファイルの拡張子から種類を判断し、テキストについては先頭のバイトも確認します。

内容の上の行は CODE · javascript · 4.2 KB のように表示されます。種類、言語（ある場合）、サイズの順です。

テキスト用のボタン #

ワークスペース、ドライブ、セッションフォルダーにある Markdown、コード、テキストのファイルでは、ツールバーに Preview（プレビュー）と Raw があります。Preview は描画またはハイライトされた表示、Raw はプレーンテキストです。

Markdown ファイルは、レイアウト用の HTML を有効にした状態で開き、⚠ Safe layout HTML enabled; active content is blocked という行が表示されます。Show literal HTML（HTML をそのまま表示）でこれを無効にすると、ファイル内の HTML はテキストとして表示され、Show HTML layout（HTML のレイアウトを表示）で再び有効になります。どちらの場合もスクリプトは実行されません。

描画された Markdown ファイル内の相対リンクは、リンク先のファイルを同じビューアーで開き、ツールバーに前のファイルへ戻るための ← Back（戻る）ボタンが表示されます。Web アドレスへのリンクは新しいタブで開きます。この方法で開いたファイルには、スワイプで移動できる前後のファイルはありません。

大きなファイルとバイナリファイル #

• 大きなテキスト。 ビューアーはテキストファイルの先頭 512 KB を読み込みます。それより長いファイルでは、内容の上の行に truncated to 512 KB が加わります。残りは表示されません。ファイル全体は Download で取得できます。
• バイナリの内容。 拡張子からはテキストに見えても中身のバイトがバイナリのファイル（またはリレーがバイナリの種類として配信するファイル）は、「no inline preview」のカードとして表示されます。
• 画像、動画、音声。 ビューアーではサイズの上限はありません。
• 読み込めないファイル。 ビューアーは Preview failed とエラーを表示します。例：File not found（ファイルが見つかりません）。

ファイル間の移動 #

開いているファイルから別のファイルに移動できるかどうかは、どこから開いたかで決まります。

ファイルが 1 つだけのフォルダーや、画像が 1 枚だけの会話では、ギャラリーなしで開きます。ギャラリーがある場合は、下部に 2 つのボタン（‹ と ›）と位置（例：3 / 12）が表示されます。ギャラリーは端で先頭に戻らず、両端ではボタンが無効になります。前後のファイルは先に取得されるため、移動すると Fetching file preview…（ファイルのプレビューを取得中…）ではなくファイルがすぐに表示されます。

会話内のファイルで画像・動画・音声以外のもの（PDF など）は、メッセージの下の通常のリンクになり、ビューアーではなくブラウザーの新しいタブで開きます。

閉じ方 #

• 画像、プレーヤー、カードの上で下にスワイプします。内容が指に合わせて動き、十分に遠くまで、または速くスワイプすると閉じます。テキストの場合は、代わりに指に合わせてスクロールします。
• 横にスワイプすると、ギャラリー内を移動します。マウスのドラッグではスワイプしないため、テキストを選択できます。ズームした画像では、スワイプの代わりに表示位置が動きます。
• 右上の ×、または Esc。
• スマートフォンでは Back。下記を参照してください。

ズームと移動 #

画像は、最初は画面に合わせたサイズで表示され、それより小さくはなりません。画面に合わせたサイズでは、横へのスワイプで次のファイルに移動し、下へのスワイプでビューアーを閉じます。拡大した状態では、これらのドラッグは代わりに画像の表示位置を動かします。

スマートフォンとインストールしたアプリでの戻る操作 #

ビューアーが開いている間は、システムの戻るジェスチャーや戻るボタンでビューアーが閉じ、それ以外には何も起きません。ブラウザーのアドレスは変わりません。

ブラウザーからインストールしたアプリ（Android、iOS、デスクトップ）では、Back だけでアプリが閉じることはありません。閉じるものが残っていないときは Press back again to close the app と表示され、もう一度押すとアプリが閉じます。ページに一度も触れていない間は、ブラウザーが Back でページを離れることを許可し、ページ側からは変えられません。通常のブラウザーのタブでは、戻るボタンはいつもどおりブラウザーのものです。

アクション #

上部のタイトルをクリックすると、`@file:src/app.js` のようなファイルの参照がコピーされます。これを入力欄に貼り付けると、エージェントがそのファイルを読みます。タイトルのツールチップに正確なテキストが表示されます。ドライブやセッションフォルダーのファイルでは、参照に絶対パスが入ります。

返信内のリンクの行き先 #

• プレーンテキストのファイル名やパス（src/app.js など）で、既知のファイルの種類の拡張子を持つものは、ファイルをビューアーで開くリンクになります。常に会話のワークスペース内のパスとして読み取られます。絶対パスは、ワークスペース内の部分まで切り詰められます。/var/log/app.log のようにワークスペース内にない絶対パスもワークスペースのパスとして扱われ、File not found で失敗します。コードスパンやコードブロック内の名前はリンクになりません。
• 絶対パスでエージェントが埋め込んだ画像は、会話内の他のメディアと一緒にビューアーで開きます。これはワークスペース外のファイルでも動作します。エージェントの返信に含まれるメディアを参照してください。
• ファイルパスへの Markdown リンクは、ビューアーではなく、ブラウザーの新しいタブで生のファイルを開きます。Web アドレスへのリンクも同様です。同じパスをプレーンテキストで書くと、ビューアーで開きます。

ビューアーで開けるもの #

ビューアーはリレーにファイルを要求するため、判断するのはリレーです。

フォルダーを指すパスや、存在しなくなったファイルは拒否されます。HTML と XML のファイルはテキストとして表示され、SVG はスクリプトを実行できないため、エージェントが書いたファイルがリレー上のページとして実行されることはありません。読み取り専用の共有リンクでは、ワークスペースやドライブのファイルを取得できず、埋め込まれた画像をクリックしても何も起きません。

キー #

矢印キーは、ギャラリーがあり、かつテキスト欄に入力中でないときだけ使えます。