Code & files

コードとファイル

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

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

開始する前に

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

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

Editor を開く

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

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

ファイルを検索してプレビューする

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

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

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

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

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

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

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

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

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

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

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

Editor が読み取り専用の場合

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

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

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

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

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

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

変更を比較する

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

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

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

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

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

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