# ワークスペース — AI Game DevアプリとCLI · AI Game Developer Wiki

AI Game Devのデスクトップワークスペース。プロジェクトウィンドウ、ペイン内のセッション、テクスチャ・3Dモデル・音声のファイルプレビュー、Explorer、Search、Source Controlを説明します。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/app/workspace)。

デスクトップアプリは、AIエージェントと一日中繰り返すループ、つまり依頼を送り、結果を見て、変更を確認するという流れを中心に作られたゲーム開発ワークスペースです。このページでは、プロジェクトウィンドウ、セッションとペイン、ファイルプレビュー、Explorer・Search・Source Controlを備えた右パネル、そしてワークスペースを自分好みにする方法について説明します。

## 1プロジェクトにつき1ウィンドウ

各プロジェクトはVS Codeと同じように、それぞれ専用のウィンドウで開きます。アプリを再起動すると、開いていたすべてのプロジェクトウィンドウが、それぞれのサイズ、位置、サイドパネル、ペインレイアウトとともに復元されます。

空のウィンドウは、最近のプロジェクト、**Open folder…**、**Create new project** を備えたランチャーです。Ctrlクリック（Windows、Linux）またはCmdクリック（macOS）で、現在のウィンドウを置き換えるのではなく、新しいウィンドウでプロジェクトを開けます。プロジェクトの開き方と作成方法については[Projects and engines](https://ai-game.dev/ja/docs/wiki/app/projects-and-engines)を参照してください。

## ペイン内のセッション

ウィンドウの中央はペインのレイアウトです。次のことができます:

- 複数のセッションをタブとして開いたままにする、または垂直・水平に並べて分割する。
- 1つのペインを最大化する、またはレイアウトの上にフローティング表示する。
- セッションリストからセッションをレイアウトへ直接ドラッグする。

バックグラウンドのセッションはストリーミングを続け、レイアウトはプロジェクトごとに保存されます。各ペインは独自のモデル、推論の強度、エージェントを保持するため、1つのペインで大型モデルを使って機能を計画しながら、別のペインで高速なモデルを使って簡単な質問に答えられます。[Agents and models](https://ai-game.dev/ja/docs/wiki/app/agents-and-models)を参照してください。

### セッショングループ

サイドバーはセッションをグループに整理し、グループは作成、名前変更、色付け、並べ替えができます。グループ分けはプロジェクトとともにコミットされるため、リポジトリをクローンしたチームメンバーも同じレイアウトを見られます。各行にはAIが何をしているかと、どれくらいの時間作業しているかが表示され、検索フィールドで名前またはグループによってセッションを絞り込めます。完了としてマークしたセッションは復元または完全に削除できます。

長い会話では、プロンプトナビゲーターを使って以前のメッセージにジャンプでき、ホバーでプレビューが表示されます。

## チャットの横でファイルをプレビュー

エージェントがファイルを作成または変更したら、セッションの横のプレビューペインで開けます。チャットメッセージ内のファイルパスはクリック可能で、クリックするとファイルが開き、メッセージに行番号があればその行にジャンプします。

| ファイルの種類 | プレビューの内容 |
| --- | --- |
| コードとMarkdown | シンタックスハイライト、レンダリングされたMarkdown |
| 画像とテクスチャ | PNG、JPEGなどに加え、TGA、TIFF、PSD、HDR、EXR、DDS、KTX、SVG |
| 3Dモデル | テクスチャ付きのモデル、切り替え可能なライティングとシャドウ、向きを示すギズモ |
| 音声 | 波形、実際のサンプルレート、コーデック、ビット深度、チャンネル、ループの切り替え |
| 動画、フォント、CSV | 再生、グリフ、表 |
| その他 | 16進表示 |

シングルクリックで一時的なプレビューが開き、ダブルクリックで開いたままになります。プレビューはディスク上のファイルが変更されると再読み込みされるため、より暗いテクスチャを依頼した場合、エージェントがファイルを書き込むとすぐに開いているプレビューが更新されます。パッケージは他のファイル形式向けに独自のプレビューやエディターを追加できます。

## 右パネル: Explorer、Search、Source Control

右パネルには3つのタブがあります:

- **Explorer**: Gitの装飾付きのライブツリーとしてプロジェクトのファイルを表示し、インラインでの名前変更と作成、ファイルのチャットコンポーザーへのドラッグ＆ドロップが可能です。
- **Search**: include/exclude globを使ったコンテンツ検索と、すべての一致の置換。
- **Source Control**: ブランチ、ahead/behindの件数、diffstat。ここからコミットとプルができます。

Source Controlで変更されたファイルをクリックすると、差分として開きます。画像の場合、差分は並べて比較する表示なので、コミット前にテクスチャがどう変わったかを正確に確認できます。

パッケージはサイドパネルに独自のタブを追加できます。たとえばKnowledge BaseパッケージはKnowledge Baseビューを追加します。

CLIにも同じ操作がコマンドとして用意されています: status、stage、commit、discard、pull、pushには`/git`、プロジェクト検索には`/search`と`/replace`、ファイル変更には`/file`、チャットで言及されたファイルには`/files`。[CLI reference](https://ai-game.dev/ja/docs/wiki/app/cli#slash-commands)を参照してください。

## ループ: 依頼、プレビュー、レビュー

1. 依頼を送ります。たとえば:「Meadow Isleを夜用の草テクスチャに切り替えて、グライドの落下をもう少し遅くして。」
2. チャットの横で結果を確認します。テクスチャは画像プレビュー、キャラクターは3Dプレビュー、音楽は音声プレビューで。
3. Source Controlを開き、古いテクスチャと新しいテクスチャを比較し、コードの差分を確認します。
4. 満足したらコミットするか、別の変更を依頼します。

**ヒント**

頻繁にコミットしましょう。小さなコミットは実験がうまくいかなかったときに戻りやすくし、履歴にはどのセッションがどの変更を行ったかが残ります。

## ツール、ステータスバー、コマンドパレット

- コンポーザーの上にある**Tools row**では、セッションのツールをオン/オフできます: Blender、Music、Knowledge Base、Image Gen、Video、Tripo、Cloud generation、およびインストールした他のパッケージのツール。
- 下部の**status bar**には、Knowledge Baseのノート数などのパッケージ項目と、Packagesウィンドウを開くパッケージアイコンが表示されます。
- **command palette**にはアプリとパッケージのコマンドが一覧表示されます。
- パッケージはコンポーザーのツールバーにボタン、右クリックメニューに項目を追加できます。

## 自分好みにカスタマイズ

ワークスペースには6つのテーマ（ニュートラルな黒のDarkから、チャコールのCarbon、ライトテーマまで）が用意されています。**Settings**の**Appearance**で選択してください。ウィンドウが狭くなると、コンポーザーは決まった順序でコントロールを隠していくので、小さな分割でも使いやすさが保たれます。初めて役立つときに機能を紹介する短いアプリ内ヒントが表示されます。ヒントは**Settings**の**General**でリセットできます。

## さらに詳しく

- ブログ記事[one workspace for panes, previews and Git](https://ai-game.dev/ja/blog/ai-game-dev-workspace-panes-previews-git)では、デモゲームで一連の流れを紹介しています。
- [Packages](https://ai-game.dev/ja/docs/wiki/app/packages)では、パネル、プレビュー、ツールの追加方法を説明しています。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/app/workspace

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/app/workspace