> ## 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.

# ワークスペース管理

> ワークスペースの作成、名前変更、削除、およびクローン

リポジトリの各コラボレーターは、自分専用のワークスペースを持ちます — 他の人に影響を与えずに変更を加えることができるプライベートな場所です。ワークスペースは未コミットの作業を分離した状態で保持し、クラウドに自動的に同期します。

この概念に馴染みがない場合は、まず [リポジトリ、ブランチ、ワークスペース](/ja/concepts/repo-branch-workspace) のページをご覧ください。

<Warning>マシンごとに別々のワークスペースを使用することをお勧めします。同じワークスペースを複数のマシンにクローンすると、同期の問題やデータ損失が発生する可能性があります。</Warning>

## クローン済み vs 非クローン ワークスペース

ワークスペースは **クローン済み**(ローカル)または **非クローン**(クラウドのみ)のいずれかです。違いを理解することで、ワークフローの設定方法を判断しやすくなります。

|                           | クローン済み(ローカル)                                          | 非クローン(クラウドのみ)                 |
| ------------------------- | ----------------------------------------------------- | ----------------------------- |
| **ファイルの保存場所**             | マシン上、クラウドと同期                                          | Diversion クラウドのみ              |
| **ファイルの編集方法**             | 任意のローカルエディタ、IDE、またはゲームエンジンを使用                         | Web またはデスクトップアプリからファイルをアップロード |
| **自動同期**                  | 変更は双方向に同期 — ローカル編集は自動的にアップロードされ、リモート変更は自動的にダウンロードされます | ローカル同期は不要 — すべてがすでにクラウドにあります  |
| **Explorer / Finder で表示** | 利用可能 — ディスク上のファイル位置を開きます                              | 利用不可                          |
| **デフォルトアプリで開く**           | 利用可能 — OS の関連アプリケーションでファイルを開きます                       | 利用不可                          |
| **ディスク使用量**               | 完全な作業コピーのためにローカルディスク領域を使用                             | ローカルディスク領域は使用しません             |

**クローン済みワークスペースを使うタイミング:** ほとんどの場合。コードを書いたり、ゲームエンジンでアセットを編集したり、ローカルツールを使ったりして積極的に開発している場合は、それらのツールがディスク上のファイルにアクセスできるように、クローン済みワークスペースが必要です。

**非クローンワークスペースを使うタイミング:** ローカルで編集せずに、ファイルの閲覧、変更のレビュー、ブランチの管理だけをしたいとき。プロジェクト全体をダウンロードしたくないマシンからの軽量なアクセスや、大規模なリポジトリをディスク上に複製せずに複数のワークスペースを管理するのに便利です。

非クローンワークスペースはいつでもクローンできます — 下の [ワークスペースをローカルにクローンする](#ワークスペースをローカルにクローンするデスクトップのみ) を参照してください。

## 新しいワークスペースの作成

デスクトップアプリで:

<Steps>
  <Step title="ワークスペースセレクタを開く">
    リポジトリビューの右上にあるワークスペースセレクタを開きます。

    <img src="https://mintcdn.com/diversion-2/UZ43CqMpCXHHcPfk/images/workspace-mgmt-new-workspace-button.png?fit=max&auto=format&n=UZ43CqMpCXHHcPfk&q=85&s=45452efe3fdff1ad060ad9693319ec07" alt="The new workspace button in the workspace selector" width="425" height="135" data-path="images/workspace-mgmt-new-workspace-button.png" />
  </Step>

  <Step title="'+ New workspace' をクリックする">
    これで **Create New Workspace** ダイアログが開きます。

    <img src="https://mintcdn.com/diversion-2/8hwWqMhzYssWzT-3/images/workspace-mgmt-new-workspace-dialog.png?fit=max&auto=format&n=8hwWqMhzYssWzT-3&q=85&s=d5fb923b016c0a777671be39003b48b8" alt="The create new workspace dialog" width="832" height="321" data-path="images/workspace-mgmt-new-workspace-dialog.png" />
  </Step>

  <Step title="ワークスペース名を入力する">
    ワークスペースに分かりやすい名前を付けます。これは必須です。

    デスクトップアプリでは、**Clone this workspace locally** オプションをオンにして、すぐにローカルコピーを作成することもできます。クローンする場合は、フォルダー名とマシン上のディレクトリを選ぶ必要があります。
  </Step>

  <Step title="'Create' または 'Create & clone' をクリックする">
    ワークスペースはリポジトリのデフォルトブランチから作成されます。準備ができると、新しいワークスペースに自動的に遷移します。
  </Step>
</Steps>

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

## 複数のコンピューターから作業する

デスクトップとラップトップなど、複数のマシンから同じプロジェクトで作業できます。1 つのワークスペースを共有するのではなく、各マシンで別々のワークスペースをセットアップしてください。

マシン間はコミットを通じて同期されます。**ローカルの未コミットの変更は、保存されたマシンに留まります** — それらはコミットするまでクラウドにアップロードされたり、他のコンピューターから見えたりすることはありません。コミットすると、そのブランチを追跡するすべてのワークスペースが自動的に受け取ります。コミットせずに *未コミットの* 作業をマシン間で移動するには、[シェルフ](/ja/basic/shelves) を使用してください。クラウドに保存され、同じリポジトリの任意のワークスペースから利用できます。

<Warning>
  クラウド同期フォルダー(Dropbox、OneDrive、iCloud、Google Drive)、ネットワークドライブ、または `.diversion` ディレクトリのコピーを介して、複数のマシンで単一のワークスペースを共有しないでください。各マシンのエージェントがワークスペースの状態を巡って競合し、ファイルの削除、同期ループ、`dv reset` による繰り返しの復旧が発生する可能性があります。
</Warning>

### 2 台目のマシンをセットアップする

<Steps>
  <Step title="2 台目のマシンに Diversion をインストールする">
    プライマリマシンで使用しているのと同じアカウントでサインインします。
  </Step>

  <Step title="そのマシンで新しいワークスペースを作成する">
    [新しいワークスペースの作成](#新しいワークスペースの作成) の手順に従い、ローカルにクローンします。ワークスペースを区別できるように、マシンを識別できる名前(例:`main-laptop`)を付けます。
  </Step>

  <Step title="作業を開始する">
    新しいワークスペースは自動的に同期されます。あるマシンから別のマシンへの変更の伝わり方については、下の [マシン間で作業を移動する](#マシン間で作業を移動する) を参照してください。
  </Step>
</Steps>

### マシン間で作業を移動する

作業はコミットを通じてマシン間を移動します:

* **作業中のマシンでコミットする。** クラウドにアップロードされるのはコミットされた変更だけであり、同期がアクティブなときだけです — なので作業をコミット(`dv commit -a -m "message"` またはデスクトップアプリで)し、同期が一時停止していないことを確認してください。
* **コミット先のブランチで変更を見つける。** 各コミットはブランチに配置され、ワークスペースは現在いるブランチのコミットのみを表示します。別のマシンで行った変更を見るには、デスクトップアプリで **ブランチセレクタ** を開くか(または `dv checkout <branch>` を実行して)、コミット先のブランチに切り替えます。
* **ワークスペースを更新させる。** [自動更新](/ja/concepts/syncing#ワークスペースの自動更新) がオンの場合、ワークスペースは新しいコミットを自動的に取り込みます — チームメイトのワークスペースと同じです。オフの場合、同期ステータスに **Updates available** が表示されます — それをクリックするか、`dv update` を実行します。
* **選択同期(Selective Sync)がディスクに何を配置するかを決定します。** **Settings -> Selective Sync** でチェックが外れているフォルダーは、コミットされていてもローカルにダウンロードされません。参照: [選択同期](/ja/advanced/selective-sync)。

## 外部ストレージ上のワークスペース

USB ドライブ、外付け SSD、または通常のローカルディスクとしてマウントされる他の取り外し可能なドライブに、クローン済みワークスペースを保管できます。これにより、各マシンに Diversion がインストールされ、同じアカウントでサインインしていれば、再クローンなしでマシン間でワークスペースを持ち運べます。

<Steps>
  <Step title="外部ドライブにワークスペースをクローンする">
    クローン時、ローカルの場所として外部ドライブ上のフォルダーを選択します。
  </Step>

  <Step title="他のワークスペースと同様に使用する">
    ドライブが接続され、Diversion エージェントが実行されていれば、ワークスペースは通常どおり同期します。
  </Step>

  <Step title="ドライブを再接続した後に再アタッチする">
    ドライブを再接続してもワークスペースが表示されない場合 — または別のマシンに接続した後 — [ワークスペースのアタッチ](#ワークスペースのアタッチデスクトップのみ) を使って、ドライブ上のワークスペースフォルダーを Diversion に指し示してください。
  </Step>
</Steps>

## ワークスペースの名前変更

<Steps>
  <Step title="Workspaces ページを開く">
    アバターをクリックして **Your organizations** を選択し、左サイドバーの **Repositories** をクリックし、リポジトリ列の **Workspaces** をクリックします。列の上部のピッカーで正しいリポジトリが選択されていることを確認してください。ワークスペースを見つけ、行末のアクションメニューをクリックし、**Rename** を選択します。

    <img src="https://mintcdn.com/diversion-2/UZ43CqMpCXHHcPfk/images/workspace-mgmt-rename-menu.png?fit=max&auto=format&n=UZ43CqMpCXHHcPfk&q=85&s=6ff6aa59d0d1adf75597a5a16bcb0d4a" alt="Workspace row actions menu with Rename option" width="1029" height="245" data-path="images/workspace-mgmt-rename-menu.png" />
  </Step>

  <Step title="新しい名前を入力する">
    **Rename Workspace** ダイアログには現在の名前が入力済みで表示されます。希望の新しい名前を入力します。

    <img src="https://mintcdn.com/diversion-2/8hwWqMhzYssWzT-3/images/workspace-mgmt-rename-dialog.png?fit=max&auto=format&n=8hwWqMhzYssWzT-3&q=85&s=af66c58fe26ae6bafaaa0635b8c01a30" alt="The rename workspace dialog" width="637" height="335" data-path="images/workspace-mgmt-rename-dialog.png" />
  </Step>

  <Step title="'Rename' をクリックする">
    名前が空または変更されていない場合、ボタンは無効になっているので、必ず異なる名前を入力してください。
  </Step>
</Steps>

<Tip>
  リポジトリビューのワークスペースセレクタからもワークスペースの名前を変更できます:セレクタを開き、ワークスペースの隣の **...**(その他のオプション)メニューをクリックし、**Rename** を選択します。
</Tip>

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

## ワークスペースの削除

<Steps>
  <Step title="Workspaces ページを開く">
    アバターをクリックして **Your organizations** を選択し、左サイドバーの **Repositories** をクリックし、リポジトリ列の **Workspaces** をクリックします。列の上部のピッカーで正しいリポジトリが選択されていることを確認してください。ワークスペースを見つけ、行末のアクションメニューをクリックし、**Delete** を選択します。

    <img src="https://mintcdn.com/diversion-2/UZ43CqMpCXHHcPfk/images/workspace-mgmt-delete-menu.png?fit=max&auto=format&n=UZ43CqMpCXHHcPfk&q=85&s=02960c706fe73b547e187a58e2414e28" alt="Workspace row actions menu with Delete option" width="1029" height="245" data-path="images/workspace-mgmt-delete-menu.png" />
  </Step>

  <Step title="削除を確認する">
    **Delete Workspace** ダイアログで確認を求められます。ワークスペース内の未コミットの変更はすべて失われることを覚えておいてください。
    ワークスペースがローカルにクローンされている場合、ローカルファイルはディスクに残るが Diversion とは同期されなくなるという追加の警告が表示されます。続行する前に確認チェックボックスをオンにする必要があります。

    <img src="https://mintcdn.com/diversion-2/8hwWqMhzYssWzT-3/images/workspace-mgmt-delete-dialog.png?fit=max&auto=format&n=8hwWqMhzYssWzT-3&q=85&s=8b23f03da7d974c160da2e3ca9d4a529" alt="The delete workspace confirmation dialog" width="650" height="436" data-path="images/workspace-mgmt-delete-dialog.png" />
  </Step>

  <Step title="'Delete' をクリックする">
    このアクションは永続的です — ワークスペースと未コミットの変更は永久に失われます。
  </Step>
</Steps>

<Tip>
  リポジトリビューのワークスペースセレクタからもワークスペースを削除できます:セレクタを開き、ワークスペースの隣の **...**(その他のオプション)メニューをクリックし、**Delete** を選択します。
</Tip>

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

## ワークスペースをローカルにクローンする(デスクトップのみ)

まだマシンにクローンされていないワークスペースがある場合、いつでもローカルの同期コピーをセットアップできます。

<Steps>
  <Step title="ワークスペースセレクタを開く">
    リポジトリビューの右上のワークスペースセレクタを開きます。このマシンにクローンされていないワークスペースは **Remote** の下に表示されます。ローカルにクローンしたいものを選択します。

    <img src="https://mintcdn.com/diversion-2/byT8FECKa2zLvaOH/images/workspace-mgmt-clone-menu.png?fit=max&auto=format&n=byT8FECKa2zLvaOH&q=85&s=0807540ada5368c5f024e604b8bc98d7" alt="Workspace selector with local and remote workspaces" width="930" height="648" data-path="images/workspace-mgmt-clone-menu.png" />
  </Step>

  <Step title="ディレクトリを選ぶ">
    ディレクトリピッカーが開きます — マシン上でローカルコピーを配置したい場所を選択します。
  </Step>

  <Step title="同期を待つ">
    Diversion がローカルコピーを作成し、自動的に同期を保ちます。ローカルで加えた変更はクラウドワークスペースに反映され、その逆も同様です。
  </Step>
</Steps>

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

## ワークスペースのアタッチ(デスクトップのみ)

マシン上でリポジトリを別のパスに移動した場合、またはポータブルドライブを取り外した後にワークスペースが表示されない場合、Diversion に再アタッチできます。

<Steps>
  <Step title="'Attach workspace' ボタンをクリックする">
    ダッシュボードで、ツールバーの **Attach workspace** ボタンをクリックします。

    <img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/workspace-mgmt-attach-workspace-button.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=4424ce41d40bb3d047ecb8b629caf181" alt="Attach workspace button on the dashboard" width="1656" height="122" data-path="images/workspace-mgmt-attach-workspace-button.png" />
  </Step>

  <Step title="ワークスペースフォルダーを参照する">
    ディレクトリピッカーが開きます。ワークスペースを含むフォルダー(内部に `.diversion` ディレクトリがあるフォルダー)に移動します。
  </Step>

  <Step title="'Connect' をクリックする">
    Diversion がサーバー上でワークスペースを検索し、再接続します。ワークスペースの再アタッチが成功すると、確認メッセージが表示されます。
  </Step>
</Steps>

<Note>ワークスペースフォルダーには、Diversion がワークスペースの状態を追跡するために使用する隠しの `.diversion` ディレクトリが含まれています。このフォルダーはそのままにしておく必要があり、変更したり削除したりしないでください。存在を確認するには、ファイルエクスプローラで隠しファイルを表示してください(Windows:View > Show > Hidden items、macOS:Cmd+Shift+. を押す)。存在しない場合、またはワークスペースがサーバーから削除されているか、アクセス権がない場合は、エラーメッセージが表示されます。</Note>

## 再クローンなしでフォルダー名を変更する

以下の手順で、再クローンなしでフォルダー名を変更できます:

例で使用するワークスペースはこちらです:

<img alt="Diversion Dashboard" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/diversion-dashboard.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=3b12b177054c17dab743d70b9e25aa8c" width="2880" height="1800" data-path="images/diversion-dashboard.png" />

<Steps>
  <Step title="エージェントを停止する:">
    システムトレイの Diversion アイコンを右クリックして *Quit* を選択するか、タスクマネージャーで dv.exe タスクを終了します。

    オプション a:

    <img alt="System Tray Quit" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/vVYvJimUmJw6ddmq/images/diversion-system-tray.png?fit=max&auto=format&n=vVYvJimUmJw6ddmq&q=85&s=20d532480921b740deeb0dc86f185a69" width="341" height="282" data-path="images/diversion-system-tray.png" />

    オプション b:

    <img alt="Diversion End Task" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/vVYvJimUmJw6ddmq/images/dv-end-task.png?fit=max&auto=format&n=vVYvJimUmJw6ddmq&q=85&s=a659a4014345603e4e008493b67d0a26" width="1137" height="862" data-path="images/dv-end-task.png" />
  </Step>

  <Step title="フォルダーの名前を変更する:">
    ファイルエクスプローラで直接フォルダー名を変更します。

    <img alt="Rename Local Folder" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/Uj3Y1xvBAWWLWIvr/images/rename-folder.png?fit=max&auto=format&n=Uj3Y1xvBAWWLWIvr&q=85&s=e4e51c3524fc0c94cf27ebbd3ba1f852" width="383" height="61" data-path="images/rename-folder.png" />
  </Step>

  <Step title="エージェントを再起動する:">
    コマンドラインで dv コマンドを実行し、正常に起動することを確認します。または、デスクトップアプリを開き、プロンプトが表示されたら「start agent」をクリックします。

    オプション a:

    <img alt="DV Command Prompt" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/vVYvJimUmJw6ddmq/images/dv-command-prompt.png?fit=max&auto=format&n=vVYvJimUmJw6ddmq&q=85&s=8b4b7369ee09c1532e35b22c108f44ff" width="1092" height="641" data-path="images/dv-command-prompt.png" />

    確認:

    <img alt="DV CLI" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/vVYvJimUmJw6ddmq/images/dv-cli.png?fit=max&auto=format&n=vVYvJimUmJw6ddmq&q=85&s=8ca76bc38b6fc78a8efa9e36177a4ffd" width="1092" height="635" data-path="images/dv-cli.png" />

    オプション b:

    <img alt="Start Agent Noti" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/8hwWqMhzYssWzT-3/images/start-agent-notification.png?fit=max&auto=format&n=8hwWqMhzYssWzT-3&q=85&s=59140699b88a4105a5f10b22d2c6f1cb" width="1268" height="123" data-path="images/start-agent-notification.png" />
  </Step>

  <Step title="ワークスペースを再アタッチする:">
    フォルダー名が変更されているため、ワークスペースは表示されません。*Attach workspace* をクリックします。

    <img alt="Attach workspace" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/attach-workspace.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=4eb91bad281d7b4355520fe188e06a3c" width="1656" height="122" data-path="images/attach-workspace.png" />
  </Step>

  <Step title="新しいパスに接続する:">
    新しいフォルダー名のパスに移動し、*Connect* をクリックします。

    <img alt="Connect Workspace" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/vVYvJimUmJw6ddmq/images/connect-workspace.png?fit=max&auto=format&n=vVYvJimUmJw6ddmq&q=85&s=d45d7904d4a5603d78f7ce0b22efa824" width="887" height="622" data-path="images/connect-workspace.png" />
  </Step>
</Steps>

これでワークスペースが表示されるはずです:

<img alt="Change Folder Finished" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} src="https://mintcdn.com/diversion-2/Ro_2EfA8JfapE5By/images/change-folder-finish.png?fit=max&auto=format&n=Ro_2EfA8JfapE5By&q=85&s=089d76627f33989b318e85a9c953db3b" width="554" height="278" data-path="images/change-folder-finish.png" />