> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 既存のプロジェクトを取得する

> リポジトリをクローンし、ワークスペースでファイルを管理する

チームメンバーがプロジェクトの [Diversion をセットアップ](/ja/basic/start-using-diversion) して [あなたを招待](/ja/basic/manage-project-access) している、あるいは別のコンピューターで作成した自分のプロジェクトを取得したいところかもしれません。セットアップしましょう:

<Steps>
  <Step title="アプリの「Remote Repositories」タブにリポジトリが表示されているはずです">
    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/join-project-all-repos.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=6683bfe1c6ec72547fb52572730c0578" alt="Remote repositories タブ" width="2880" height="1800" data-path="images/join-project-all-repos.png" />

    リポジトリの `...` メニューを開き、`Clone repo` を選択します。
  </Step>

  <Step title="フォルダーを選択">
    リポジトリ名の新しいフォルダーがそこに作成されます (ここでは `DiversionExample`)。

    <img src="https://mintcdn.com/diversion-2/tNxAwm8NrThaCp35/images/join-project-clone-repo.png?fit=max&auto=format&n=tNxAwm8NrThaCp35&q=85&s=63d3aa8dd246230c5f4e1a6b4441af37" alt="リポジトリをクローン" width="828" height="351" data-path="images/join-project-clone-repo.png" />

    `Clone` をクリックします。
  </Step>
</Steps>

プロジェクトはすぐにダウンロードが開始されます。完了したら、開いて作業を始められます!

## ファイル操作

Diversion では、Files ビューから直接、一般的なファイル操作にすばやくアクセスできます。任意のファイルを右クリックして使用可能なアクションを表示するか、ファイルを表示する際にファイルタイトルバーを使用します。

<img src="https://mintcdn.com/diversion-2/byT8FECKa2zLvaOH/images/file-ops-context-menu.png?fit=max&auto=format&n=byT8FECKa2zLvaOH&q=85&s=b08fd56586965fcd43719cba2132f410" alt="ファイル操作を表示する右クリックコンテキストメニュー" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="460" height="508" data-path="images/file-ops-context-menu.png" />

### ファイルの削除

<Steps>
  <Step title="ファイルを右クリック">
    Files ビューで、削除したいファイルを右クリックし、**Delete** を選択します。
  </Step>

  <Step title="削除を確認">
    「Are you sure you want to delete the file '\[file-path]'?」という確認ダイアログが表示されます。赤い **Delete** ボタンをクリックして確認するか、気が変わった場合はキャンセルします。
  </Step>
</Steps>

削除されたファイルは、**赤色** と **x** アイコンで保留中の変更に表示され、削除されたことを示します。

<img src="https://mintcdn.com/diversion-2/Ro_2EfA8JfapE5By/images/file-ops-delete-status.png?fit=max&auto=format&n=Ro_2EfA8JfapE5By&q=85&s=e4ed53a99bb6fcf3ab4fe5661ad33122" alt="赤色に x アイコンで表示された削除されたファイル" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="386" height="198" data-path="images/file-ops-delete-status.png" />

CLI での使用方法については、[rm コマンド](/ja/cmd-ref/rm) を参照してください。

### ファイル名の変更

<Steps>
  <Step title="ファイルを右クリック">
    Files ビューで、名前を変更したいファイルを右クリックし、**Rename** を選択します。
  </Step>

  <Step title="新しい名前を入力">
    現在のファイル名が入力済みのダイアログが表示されます。ファイルの新しい名前を入力します。
  </Step>

  <Step title="名前変更を確認">
    **Rename** をクリックして新しい名前を適用します。
  </Step>
</Steps>

<Warning>新しい名前にファイル拡張子 (例: `.txt`、`.cpp`、`.uasset`) を含めるのを忘れないでください。省略すると、OS やゲームエンジンがファイルを認識できなくなる可能性があります。</Warning>

<Note>ファイル名にこれらの文字を含めることはできません: `< > : " / \ | ? *`</Note>

名前が変更されたファイルは、**緑色** と **二重矢印 (>>)** アイコンで保留中の変更に表示され、移動/名前変更操作を示します。

<img src="https://mintcdn.com/diversion-2/cRpeD_gsb0j32D_2/images/file-ops-rename-status.png?fit=max&auto=format&n=cRpeD_gsb0j32D_2&q=85&s=f7158a7dee2050450d1bd256b41b3408" alt="緑色に二重矢印アイコンで表示された名前が変更されたファイル" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="386" height="198" data-path="images/file-ops-rename-status.png" />

CLI での使用方法については、[mv コマンド](/ja/cmd-ref/mv) を参照してください。

### ファイルの移動

<Steps>
  <Step title="ファイルを右クリック">
    Files ビューで、移動したいファイルを右クリックし、**Move** を選択します。
  </Step>

  <Step title="移動先フォルダーを選択">
    ディレクトリピッカーダイアログが開きます。ファイルを移動したいフォルダーを参照します。
  </Step>

  <Step title="移動を確認">
    **Move** をクリックして、選択したフォルダーにファイルを移動します。ファイルは元の名前を保持します。
  </Step>
</Steps>

移動されたファイルは、**緑色** と **二重矢印 (>>)** アイコンで保留中の変更に表示され、移動/名前変更操作を示します。

<img src="https://mintcdn.com/diversion-2/cRpeD_gsb0j32D_2/images/file-ops-move-status.png?fit=max&auto=format&n=cRpeD_gsb0j32D_2&q=85&s=75f61e902b26ad36ebdceaf3a24c9682" alt="緑色に二重矢印アイコンで表示された移動されたファイル" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="386" height="228" data-path="images/file-ops-move-status.png" />

CLI での使用方法については、[mv コマンド](/ja/cmd-ref/mv) を参照してください。

### ファイル履歴の表示

<Steps>
  <Step title="ファイルを右クリック">
    Files ビューで、ファイルを右クリックし、**History** を選択します。
  </Step>

  <Step title="履歴を閲覧">
    ファイル履歴ページには、このファイルを変更したすべてのコミットが表示され、各変更について操作タイプ (追加、変更、移動)、コミットメッセージ、作者、日付が含まれます。任意のコミットをクリックすると、そのバージョンの差分が表示されます。

    デフォルトでは、マージ経由で到達した変更はマージコミットのみが表示されます。**Show squashed commits** をチェックすると、マージされたブランチからの元のコミットも、独自の作者、メッセージ、差分とともに表示されます。これは連鎖したマージにわたって機能します: あるブランチから別のブランチにマージされ、そこからあなたのブランチにマージされたコミットも表示されます。

    <img src="https://mintcdn.com/diversion-2/ifvI6j1fNMaTg1AY/images/file-ops-history-view.png?fit=max&auto=format&n=ifvI6j1fNMaTg1AY&q=85&s=d1ba252ccca48a3bbecebaf1ca2d7902" alt="コミットを表示するファイル履歴ページ" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1782" height="1127" data-path="images/file-ops-history-view.png" />
  </Step>
</Steps>

### 以前のバージョンを復元

特定のコミットでファイルを表示している場合、そのバージョンをワークスペースに送信できます。これにより、現在のファイル内容が選択したバージョンに置き換えられ、変更が保留中の変更に表示されます。

<Steps>
  <Step title="特定のコミットでファイルに移動">
    2 つの方法で到達できます:

    * **ファイル履歴から**: ファイルを右クリックし、**History** を選択し、目的のコミットをクリックします。
    * **ブランチ履歴から**: コミットを開き、復元したいファイルをクリックします。
  </Step>

  <Step title="ワークスペースに送信">
    ファイルタイトルバーで、**Send this version to workspace** ボタン (矢印アイコン) をクリックします。

    <img src="https://mintcdn.com/diversion-2/ifvI6j1fNMaTg1AY/images/file-ops-restore-version.png?fit=max&auto=format&n=ifvI6j1fNMaTg1AY&q=85&s=bc08169e099599dc93e57123e2b3f326" alt="ファイルタイトルバーの Send this version to workspace ボタン" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1782" height="1127" data-path="images/file-ops-restore-version.png" />
  </Step>
</Steps>

復元されたファイルは、変更として保留中の変更に表示されます。変更を確認し、準備ができたらコミットできます。

CLI での使用方法については、[restore コマンド](/ja/cmd-ref/restore) を参照してください。

### アノテート (blame)

**Annotate** ビューは、ファイルの各行を最後に変更した人と、コミットメッセージおよび日付を表示します。これは、ファイルがどのように進化したか、および特定の変更に責任があるのが誰かを理解するのに役立ちます。

<Note>Annotate はテキストファイルでのみ利用可能です。バイナリファイルはサポートされていません。</Note>

<Steps>
  <Step title="ファイル履歴を開く">
    Files ビューでファイルを右クリックし、**History** を選択します。
  </Step>

  <Step title="Annotate タブに切り替え">
    ファイル履歴ビューの上部にある **Annotate** タブをクリックします。

    <img src="https://mintcdn.com/diversion-2/hNFKL35i0RPRSCiK/images/file-ops-annotate-view.png?fit=max&auto=format&n=hNFKL35i0RPRSCiK&q=85&s=3ba68e411a4e977572af8bae253d46db" alt="行ごとのコミット属性を表示する Annotate ビュー" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="2432" height="1640" data-path="images/file-ops-annotate-view.png" />
  </Step>

  <Step title="行ごとの帰属を閲覧">
    左パネルには、色分けされたドット、変更されてからの経過時間、作者名、および各行範囲のコミットメッセージが表示されます。右パネルには、行番号付きのファイル内容が表示されます。
  </Step>

  <Step title="コミット詳細を表示">
    左パネルの任意のエントリにホバーすると、完全なコミット詳細 (作者のアバターと名前、日付、完全なコミットメッセージ、コミット ID) が表示されます。**View commit** をクリックすると、そのコミットに移動します。

    <img src="https://mintcdn.com/diversion-2/I1zVc2xApEwN8Z0T/images/file-ops-annotate-tooltip.png?fit=max&auto=format&n=I1zVc2xApEwN8Z0T&q=85&s=e6d950f2bcde315e73d973b6bbc268f3" alt="ホバー時にコミット詳細を表示する Annotate ツールチップ" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1330" height="926" data-path="images/file-ops-annotate-tooltip.png" />
  </Step>
</Steps>

CLI での使用方法については、[annotate コマンド](/ja/cmd-ref/annotate) を参照してください。

### ファイルのダウンロード

ワークスペースまたはコミットビューでファイルをクリックすると、ファイルタイトルバーにダウンロードアイコンボタンが表示されます。クリックすると、コンピューターにファイルがダウンロードされます。

<img src="https://mintcdn.com/diversion-2/hNFKL35i0RPRSCiK/images/file-ops-download-button.png?fit=max&auto=format&n=hNFKL35i0RPRSCiK&q=85&s=8baf7d8ae1da54260d72e56fcceb6351" alt="ファイルタイトルバーのダウンロードボタン" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1116" height="516" data-path="images/file-ops-download-button.png" />

### Explorer で開く (デスクトップのみ)

Files ビューでファイルを右クリックし、**Show in Explorer** (Windows) または **Reveal in Finder** (macOS) を選択して、システムのファイルエクスプローラーで含まれるフォルダーを開きます。

<img src="https://mintcdn.com/diversion-2/cRpeD_gsb0j32D_2/images/file-ops-open-in-explorer.png?fit=max&auto=format&n=cRpeD_gsb0j32D_2&q=85&s=8008959ad6bab64f0726e5dc76517dd8" alt="コンテキストメニューの Show in Explorer オプション" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="240" height="233" data-path="images/file-ops-open-in-explorer.png" />

<Note>このオプションはローカルにクローンされたワークスペースでのみ利用できます。Diversion エージェントが実行されていることを確認してください。</Note>

これは、プロジェクトファイルを直接開くのにも役立ちます。たとえば、**Show in Explorer** を使って Unreal Engine の `.uproject` ファイルに移動し、そこから開くことができます。

### デフォルトアプリで開く (デスクトップのみ)

ファイルを表示中、ファイルタイトルバーの **Open with default app** アイコンをクリックして、OS がそのファイルタイプに関連付けたアプリケーションでファイルを開きます。

<img src="https://mintcdn.com/diversion-2/cRpeD_gsb0j32D_2/images/file-ops-open-with-default-app.png?fit=max&auto=format&n=cRpeD_gsb0j32D_2&q=85&s=514ee1be86069c0b4131ca60cad9298d" alt="ファイルタイトルバーの Open with default app ボタン" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="608" height="74" data-path="images/file-ops-open-with-default-app.png" />

<Note>このオプションはローカルにクローンされたワークスペースでのみ利用できます。Diversion エージェントが実行されていることを確認してください。</Note>

これを使ってプロジェクトファイルを直接開くこともできます — たとえば、`.uproject` ファイルを開くと Unreal Engine で起動します。想定どおりに動作させるには、そのプロジェクトを正しいエンジンバージョンで以前に開いておく必要がある場合があります。