Atoms プロジェクト内のソースファイルを表示および管理するには、Editor を使用します。ファイルの検索、対応形式のプレビュー、変更の比較、コンテキストとして Chat にコードを追加、個別のファイルやフォルダ、またはプロジェクト全体のダウンロードができます。

このガイドでは、project workspace に保存されているファイルのみを扱います。Chat にアップロードされたファイル、生成されたメディア、クラウドデータ、公開済みバージョン、連携サービスのファイルは別途管理されます。

開始前に

• デスクトップのブラウザを使用してください。モバイルデバイスでは Editor の利用体験が制限されます。
• 同じファイルに手動で変更を加える前に、エージェントの処理が完了するまで待ってください。
• 最新のプロジェクトバージョンを開いてください。以前のバージョンを表示している場合は、バージョン管理で Restore を選択し、Restore を確認して、復元が完了してから編集してください。
• プロジェクトの編集またはダウンロードには、対象の有料プランが必要な場合があります。

パスワード、API キー、アクセストークン、その他の秘密情報を、ソースファイルや Chat に直接記載しないでください。

Editor を開く

1. 既存のプロジェクトを開きます。
2. プロジェクトツールバーから Editor を選択します。
3. ファイルツリーとファイルビューアーが読み込まれるまで待ちます。

左側にファイルツリーが表示されます。選択したファイルは右側でコードエディターまたはプレビューとして開きます。ファイルに表示されるツールは、その形式と現在のプロジェクト状態によって異なります。

ファイルの検索とプレビュー

ファイル名またはフォルダ名で検索する

1. ファイルツリーの上にある Search を選択します。
2. ファイル名またはフォルダ名の一部を入力します。
3. 一致する結果を選択して開きます。

検索はファイル名とフォルダ名に一致します。ファイル内のテキストは検索しません。項目が見つからない場合は、検索語を短くするか、検索をクリアして、関連するフォルダを手動で展開してください。

ファイル名またはフォルダ名で Editor のファイルツリーを検索します。

ファイルをプレビューする

ツリー内のファイルを選択します。Atoms では、一般的なコードファイルやテキストファイル、HTML、Markdown、DOCX および XLSX ファイル、画像、対応する音声と動画、PDF、CSV ファイル、Jupyter notebooks をプレビューできます。利用可能なプレビューはファイルの種類によって異なります。

ファイルまたはフォルダをプレビューできない場合は、ダウンロードして対応するアプリケーションで開いてください。

プロジェクトコードを編集する

1. 対応しているコードファイルまたはテキストファイルを開きます。
2. エディターで変更を加えます。
3. 保存インジケーターが完了するまで待ちます。保存により現在の編集セッションは同期されますが、セッション全体はまだ適用されません。
4. プレビューが利用可能な場合は、Preview を選択して結果を確認します。
5. Submit all を選択してセッションを適用するか、Discard all を選択してそのセッション内の編集を元に戻します。

手動編集とエージェントが生成した変更は、同じファイルに影響することがあります。エージェントにプロジェクトの変更を依頼する前に現在の編集を適用または破棄し、大きな変更を行う前にはプロジェクト履歴を使用してください。

Editor の編集セッションをプレビュー、破棄、または送信します。

Editor が読み取り専用の場合

エージェントの処理中、保存の進行中、または以前のプロジェクトバージョンを表示している間は、Editor が一時的に変更を禁止することがあります。また、未対応のプロジェクトや必要なアクセス権のないアカウントでは、読み取り専用になる場合もあります。

現在の操作が完了するまで待ち、最新バージョンを開いてページを更新してください。古いバージョンを表示している場合は、バージョン管理で Restore を選択し、Restore を確認して、復元が完了するまで待ってから最新バージョンを再度開いてください。編集する前に、Read only インジケーターが表示されなくなっていることを確認してください。

Chat でコードを使用し、変更を比較する

ファイル全体を Chat に追加する

ファイルを開き、操作が利用可能な場合は縦向きの ... をクリックして Select file を選択します。Chat で # と入力して、プロジェクトファイルを選ぶこともできます。ファイルは次のリクエストのコンテキストとして追加されます。

現在のファイルの操作を開き、Select file を選択します。

変更を比較する

利用可能な場合は Diff を選択して、変更を適用する前にファイルの元のバージョンと変更後のバージョンを比較します。

ファイルとフォルダを管理する

ファイルツリー内の項目の横にある ... を使用すると、そのファイルまたはフォルダで利用可能な操作を確認できます。項目とプロジェクトの状態に応じて、ファイルやフォルダの作成、アップロード、名前変更、ダウンロード、削除ができます。

1. ツリー内でファイルまたはフォルダを見つけます。
2. ... を選択します。
3. 必要な操作を選択し、画面上の案内に従います。

ファイルまたはフォルダの削除は元に戻せません。 重要なプロジェクトファイルを削除する前に、安全なプロジェクトバージョンを作成するか、コピーをダウンロードしてください。

エージェントがプロジェクトを変更している間、または編集セッションの保存中は、一部のファイル操作を利用できません。現在の操作が完了するまで待ってから、もう一度試してください。

コードとファイルをダウンロードする

現在のファイルをダウンロードする

1. Editor でファイルを開きます。
2. 現在のファイルの操作から Download を選択します。
3. ブラウザのダウンロード先を開き、ファイルを確認します。

フォルダをダウンロードする

1. フォルダの横にある ... を選択します。
2. Download を選択します。Atoms はフォルダを ZIP アーカイブとしてパッケージ化します。
3. アーカイブを開き、内容を確認します。

現在のプロジェクトをダウンロードする

1. Editor で、ファイルツリーの下にある Download Project を選択します。
2. Atoms がアーカイブを準備している間は、ページを開いたままにしてください。
3. ダウンロードした ZIP を開き、必要なファイルを確認します。

サインインしている必要があります。現在のプロジェクトソースのダウンロードには、対象の有料プランが必要な場合があります。共有された読み取り専用のプロジェクト表示では、Editor のダウンロードも利用できない場合があります。

Share からエクスポートする

Share を開いて Export を選択することもできます。これにより、プロジェクトを ZIP としてエクスポートする別の方法が提供されます。引き継ぎやバックアップとして利用する前に、ダウンロードしたアーカイブを確認してください。

Share を開いて Export を選択し、プロジェクトをダウンロードします。