# 工作区 — AI Game Dev 应用与 CLI · AI Game Developer Wiki

AI Game Dev 桌面工作区：项目窗口、窗格中的会话、纹理/3D 模型/音频的文件预览，以及 Explorer、Search 和 Git。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/docs/wiki/app/workspace)。

这个桌面应用是一个游戏开发工作区，围绕着你每天与 AI agent 反复进行的循环构建：发送请求、查看结果、检查改动。本页介绍项目窗口、会话与窗格、文件预览、右侧带有 Explorer、Search 和 Source Control 的面板，以及如何把工作区调成你自己的样子。

## 每个项目一个窗口

每个项目都住在自己的窗口里，和 VS Code 一样。重新启动应用时，之前打开的每个项目窗口都会连同它自己的大小、位置、侧边面板和窗格布局一起恢复。

空窗口是一个启动器，包含最近项目、**Open folder…** 和 **Create new project**。Ctrl 点击（Windows、Linux）或 Cmd 点击（macOS）会在新窗口中打开项目，而不是替换当前窗口。打开和创建项目请参见 [项目与引擎](https://ai-game.dev/zh-hans/docs/wiki/app/projects-and-engines)。

## 窗格中的会话

窗口中央是一片窗格布局。你可以：

- 把多个会话作为标签页保留，或将它们垂直、水平并排拆分；
- 将某个窗格最大化，或让它浮动在布局之上；
- 把会话从会话列表直接拖进布局。

后台的会话会继续流式输出，布局按项目保存。每个窗格保留自己的模型、推理强度和 agent，因此一个窗格可以用大模型规划功能，另一个则用快速模型回答小问题。参见 [Agents and models](https://ai-game.dev/zh-hans/docs/wiki/app/agents-and-models)。

### 会话分组

侧边栏把会话组织成组，你可以创建、重命名、上色和重新排序。分组信息随项目一起提交，因此克隆仓库的队友会看到相同的布局。每一行显示 AI 正在做什么以及已经工作了多久，搜索框可按名称或分组筛选会话。标记为完成的会话可以恢复或永久删除。

对于长对话，提示词导航器让你可以跳回更早的消息，并带有悬停预览。

## 在聊天旁边预览文件

当 agent 创建或修改文件时，在会话旁的预览窗格中打开它。聊天消息中的文件路径可以点击：点击会打开该文件，若消息中给出了行号还会跳转到对应行。

| 文件类型 | 预览显示的内容 |
| --- | --- |
| 代码和 Markdown | 语法高亮、渲染后的 Markdown |
| 图像和纹理 | PNG、JPEG 等，以及 TGA、TIFF、PSD、HDR、EXR、DDS、KTX 和 SVG |
| 3D 模型 | 带纹理的模型、可切换的光照和阴影、朝向指示器 |
| 音频 | 波形、真实采样率、编码、位深和声道，以及循环开关 |
| 视频、字体、CSV | 播放、字形、表格 |
| 其他任何内容 | 十六进制视图 |

单击打开临时预览，双击则让它保持打开。文件在磁盘上变更时预览会重新加载，所以如果你要求把纹理调暗，agent 一写入文件，打开的预览就会更新。包可以为其他文件类型添加自己的预览和编辑器。

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

右侧面板有三个标签页：

- **Explorer**：项目文件以实时树状展示，带 Git 状态装饰，可就地重命名和创建，并能把文件拖放到聊天输入框中。
- **Search**：内容搜索，支持包含和排除的 glob，并可为所有匹配项执行替换。
- **Source Control**：分支、领先和落后提交数以及 diffstat；可在此提交和拉取。

在 Source Control 中点击已更改的文件，会以 diff 形式打开。对于图像，diff 是并排对比，因此你可以在提交前准确看到纹理是如何变化的。

包可以在侧边面板中添加自己的标签页；例如 Knowledge Base 包会添加一个 Knowledge Base 视图。

CLI 有对应的命令完成相同操作：`/git` 用于 status、stage、commit、discard、pull 和 push，`/search` 和 `/replace` 用于项目搜索，`/file` 用于文件变更，`/files` 用于聊天中提到的文件。参见 [CLI 参考](https://ai-game.dev/zh-hans/docs/wiki/app/cli#slash-commands)。

## 循环：请求、预览、审查

1. 发送一个请求，例如：“把 Meadow Isle 切换到夜晚草地纹理，并把滑翔下落调慢一点。”
2. 在聊天旁边查看结果：图像预览中的纹理、3D 预览中的角色、音频预览中的音乐。
3. 打开 Source Control，比较新旧纹理，并阅读代码 diff。
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-hans/blog/ai-game-dev-workspace-panes-previews-git) 在一个演示游戏上展示了整个循环。
- [Packages](https://ai-game.dev/zh-hans/docs/wiki/app/packages) 介绍了如何添加面板、预览和工具。

---

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

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