# 工作區 — AI Game Dev 應用程式與 CLI · AI Game Developer Wiki

AI Game Dev 桌面工作區：專案視窗、窗格中的工作階段、貼圖、3D 模型與音訊的檔案預覽，以及 Explorer、Search 與 Git。

本頁面由英文機器翻譯而成。[閱讀英文原文](https://ai-game.dev/docs/wiki/app/workspace)。

桌面應用程式是一個遊戲開發工作區，圍繞著你每天與 AI 代理反覆進行的循環：送出請求、查看結果、檢查變更。本頁說明專案視窗、工作階段與窗格、檔案預覽、右側面板的 Explorer、Search 與 Source Control，以及如何把工作區調整成自己的樣子。

## 每個專案一個視窗

每個專案都有自己的視窗，就像 VS Code 一樣。重新啟動應用程式時，先前開啟的每個專案視窗都會回來，並保留各自的大小、位置、側邊面板與窗格配置。

空白視窗是一個啟動器，列出最近的專案，並提供 **Open folder…** 與 **Create new project**。Ctrl 點擊（Windows、Linux）或 Cmd 點擊（macOS）會在新視窗開啟專案，而不是取代目前的視窗。開啟與建立專案請見 [專案與引擎](https://ai-game.dev/zh-hant/docs/wiki/app/projects-and-engines)。

## 窗格中的工作階段

視窗中央是一組窗格配置。你可以：

- 同時開啟多個工作階段作為分頁，或以垂直、水平方式並排分割；
- 將某個窗格最大化，或讓它浮在配置之上；
- 把工作階段從工作階段清單直接拖曳到配置中。

背景的工作階段會繼續串流，而配置會依專案儲存。每個窗格都保有自己的模型、推理強度與代理，因此一個窗格可以用大型模型規劃功能，另一個則用快速的模型回答簡單問題。請見[代理與模型](https://ai-game.dev/zh-hant/docs/wiki/app/agents-and-models)。

### 工作階段群組

側邊欄會把工作階段整理成群組，你可以建立、重新命名、上色與排序。群組設定會隨專案一起提交，因此複製儲存庫的隊友會看到相同的配置。每一列會顯示 AI 正在做什麼以及已工作多久，搜尋欄位則可依名稱或群組篩選工作階段。標記為完成的工作階段可以還原或永久移除。

對於很長的對話，提示導覽器讓你跳回先前的訊息，並附有滑鼠停留預覽。

## 在聊天旁邊預覽檔案

當代理建立或變更檔案時，可在工作階段旁的預覽窗格中開啟它。聊天訊息中的檔案路徑可以點擊：點一下就會開啟檔案，若訊息有提供行號也會跳到該行。

| 檔案類型 | 預覽顯示的內容 |
| --- | --- |
| 程式碼與 Markdown | 語法醒目提示、渲染後的 Markdown |
| 圖片與貼圖 | PNG、JPEG 等，以及 TGA、TIFF、PSD、HDR、EXR、DDS、KTX 與 SVG |
| 3D 模型 | 模型與其貼圖、可切換的光照與陰影、方位指示器 |
| 音訊 | 波形、實際取樣率、編解碼器、位元深度與聲道數、循環播放切換 |
| 影片、字型、CSV | 播放、字形、表格 |
| 其他任何內容 | 十六進位檢視 |

按一下會開啟暫時預覽，按兩下則讓它保持開啟。檔案在磁碟上變更時預覽會重新載入，所以如果你要求更暗的貼圖，只要代理寫入檔案，已開啟的預覽就會立即更新。套件可以為其他檔案類型加入自己的預覽與編輯器。

## 右側面板：Explorer、Search、Source Control

右側面板有三個分頁：

- **Explorer**：以即時樹狀檢視呈現專案檔案，附有 Git 裝飾、行內重新命名與建立，並可把檔案拖放進聊天輸入框。
- **Search**：內容搜尋，支援 include 與 exclude glob，並可對所有符合項目進行取代。
- **Source Control**：分支、領先與落後數量以及差異統計；可從這裡提交與拉取。

在 Source Control 中點擊變更的檔案，會以差異形式開啟。圖片的話，差異是並排比較，讓你在提交前確切看到貼圖的變化。

套件可以為側邊面板加入自己的分頁；例如 Knowledge Base 套件會加入 Knowledge Base 檢視。

CLI 也有相同的操作指令：`/git` 用於狀態、暫存、提交、捨棄、拉取與推送，`/search` 與 `/replace` 用於專案搜尋，`/file` 用於檔案變更，`/files` 用於聊天中提及的檔案。請見 [CLI 參考](https://ai-game.dev/zh-hant/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，以及你安裝的其他套件工具。
- 底部的 **狀態列** 會顯示套件項目，例如 Knowledge Base 的筆記數量，以及可開啟 Packages 視窗的套件圖示。
- **命令面板** 列出應用程式與套件的命令。
- 套件可以在輸入框工具列加入按鈕，並在右鍵選單加入項目。

## 打造成你自己的樣子

工作區內建六種主題，從中性的黑色 Dark 到炭灰色 Carbon 以及淺色主題；可在 **Settings**、**Appearance** 中挑選。視窗變窄時，輸入框會依固定順序隱藏控制項，因此即使分割得很小仍然好用。簡短的應用程式內提示會在功能首次派上用場時介紹它；你可以在 **Settings**、**General** 中重設。

## 深入了解

- 文章 [一個工作區搞定窗格、預覽與 Git](https://ai-game.dev/zh-hant/blog/ai-game-dev-workspace-panes-previews-git) 以一款示範遊戲展示整個循環。
- [套件](https://ai-game.dev/zh-hant/docs/wiki/app/packages) 說明如何加入面板、預覽與工具。

---

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

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