# AI Game Dev 应用与 gamedev CLI — AI Game Developer Wiki

介绍 AI Game Dev 桌面应用与 gamedev CLI 是什么、它们如何配合 Unity、Unreal 和 Godot 插件工作，以及从哪里开始。

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

AI Game Dev 是 AI Game Developer 的 AI 游戏开发应用：一个能理解你的游戏项目、编辑项目文件，并通过自然语言驱动引擎编辑器的 AI 智能体。它有两种形态，共用同一个账号、同一个后台服务和同一份聊天记录：**桌面应用**和面向终端的 **`gamedev` CLI**。本部分 wiki 介绍如何安装它们、登录、打开项目、选择模型、用包扩展应用，以及解决常见问题。

## 桌面应用还是 CLI

两个前端运行同一个智能体，由 Claude Agent SDK 驱动，并且都通过你的 AI Game Developer 账号进行身份验证。

|  | 桌面应用 | `gamedev` CLI |
| --- | --- | --- |
| 运行环境 | Windows、macOS、Linux | Windows、macOS、Linux 终端 |
| 安装方式 | 从[下载页面](https://ai-game.dev/zh-hans/download)获取签名安装程序 | `npm install -g @baizor/gamedev` |
| 最适合 | 日常开发：窗格、预览、Source Control、Packages 窗口 | 终端工作流、脚本调用（`--print`）、T3 Code 或 Zed 等 ACP 客户端 |
| 包 | Packages 窗口以及 `/packages` | `gamedev pkg` 和 `/packages` |
| 更新 | 下载更新并提示 **Restart to update** | `gamedev update` |

你可以在同一台电脑上同时使用两者。在一端开始的聊天会保存在共享历史中，在用户级别安装的包对两者都生效。

## 它与引擎插件和 MCP 的关系

应用并不取代引擎插件，而是使用它们。每个引擎都有自己的 MCP 插件，对外暴露编辑器工具（创建对象、编辑场景、运行测试、截图等等）：

- 用于 Unity 的 [Unity MCP](https://ai-game.dev/zh-hans/docs/wiki/unity)，由 `unity-mcp-cli` 管理。
- 用于 Unreal Engine 的 [Unreal MCP](https://ai-game.dev/zh-hans/docs/wiki/unreal)，由 `unreal-mcp-cli` 管理。
- 用于 Godot 的 [Godot MCP](https://ai-game.dev/zh-hans/docs/wiki/godot)，由 `godot-cli` 管理。

当你打开一个 Unity、Unreal 或 Godot 项目时，应用会检测引擎，提示你安装或更新对应的插件，在智能体需要时启动编辑器，并通过 ai-game.dev 借助你已登录的会话把编辑器的工具接入聊天。安装程序已内置在应用中，因此桌面应用不需要 Node.js 或 npm。

这些插件也可以脱离应用使用：任何 MCP 客户端（Claude Code、Cursor、VS Code、Codex 等）都能连接到 [MCP 端点](https://ai-game.dev/zh-hans/mcp-endpoint-info)。[生态系统概览](https://ai-game.dev/zh-hans/docs/ecosystem)展示了应用、插件和 MCP 服务器如何协同工作，[工具目录](https://ai-game.dev/docs/tools)则列出了插件为智能体提供的全部能力。

## 应用在插件之上额外提供的能力

- 一个聊天智能体，可以读取和编辑你的项目文件、运行命令、调用引擎工具，所有操作都需经你批准。
- 来自多家供应商的 AI 模型可选，具体可用模型由你的套餐和所在地区决定。参见[智能体与模型](https://ai-game.dev/zh-hans/docs/wiki/app/agents-and-models)。
- 桌面工作区为每个项目提供一个窗口，支持窗格中的会话、文件预览（贴图、3D 模型、音频、视频）以及 Git。参见[工作区](https://ai-game.dev/zh-hans/docs/wiki/app/workspace)。
- **包**可添加完整的功能能力：Blender、基于 SuperCollider 的音乐、项目知识库、Tripo 3D、在你 GPU 上运行的本地图像与视频生成，以及云端视频和音频模型。参见[包](https://ai-game.dev/zh-hans/docs/wiki/app/packages)。
- 会话工具：每个聊天自行选择携带哪些工具，从而让智能体的上下文保持精简。

## 页面导航

如果你是新手，从这里开始：

1. [安装](https://ai-game.dev/zh-hans/docs/wiki/app/installation)：在 Windows、macOS 或 Linux 上安装桌面应用，或安装 `gamedev` CLI，并保持它们更新。
2. [登录与账号](https://ai-game.dev/zh-hans/docs/wiki/app/sign-in-and-account)：登录、套餐、以百分比显示的用量、切换账号。
3. [项目与引擎](https://ai-game.dev/zh-hans/docs/wiki/app/projects-and-engines)：打开或创建项目，让应用自动配置 Unity、Unreal 或 Godot 插件。
4. [智能体与模型](https://ai-game.dev/zh-hans/docs/wiki/app/agents-and-models)：选择模型、推理强度与智能体、审批设置、本地模型。

接下来深入了解：

- [工作区](https://ai-game.dev/zh-hans/docs/wiki/app/workspace)：桌面应用中的窗格、预览、Explorer、Search 和 Source Control。
- [包](https://ai-game.dev/zh-hans/docs/wiki/app/packages)：什么是包、Packages 窗口、`gamedev pkg`、级别、更新。
- [包目录](https://ai-game.dev/zh-hans/docs/wiki/app/packages-catalog)：目前可用的所有包及其功能。
- [创建包](https://ai-game.dev/zh-hans/docs/wiki/app/creating-packages)：编写、测试并分享你自己的包。
- [CLI 参考](https://ai-game.dev/zh-hans/docs/wiki/app/cli)：所有 `gamedev` 命令以及终端中的斜杠命令。
- [故障排查](https://ai-game.dev/zh-hans/docs/wiki/app/troubleshooting)：登录、引擎连接、包与模型。
- [常见问题](https://ai-game.dev/zh-hans/docs/wiki/app/faq)：常见问题的简短解答。

## 快速开始

1. 从[下载页面](https://ai-game.dev/zh-hans/download)下载应用，或运行 `npm install -g @baizor/gamedev`。
2. 使用你的 AI Game Developer 账号登录。
3. 打开你的游戏项目文件夹。
4. 描述你的需求，例如“列出活动场景中的所有内容。”

四步[快速入门](https://ai-game.dev/zh-hans/docs/quickstart)以截图演示了同样的流程，[应用指南](https://ai-game.dev/docs/app)提供了一页纸的概览。有关提示词技巧，请阅读[最佳实践](https://ai-game.dev/docs/best-practices)。

- [**安装** 在 Windows、macOS 或 Linux 上安装 AI Game Dev 桌面应用，或用 npm 安装 gamedev CLI，并让两者保持最新。](https://ai-game.dev/zh-hans/docs/wiki/app/installation)
- [**登录与账户** 登录 AI Game Dev 应用和 gamedev CLI，切换账户，了解套餐与用量百分比，并管理你的其他设备。](https://ai-game.dev/zh-hans/docs/wiki/app/sign-in-and-account)
- [**项目与引擎** 在 AI Game Dev 应用中打开或创建 Unity、Unreal 或 Godot 项目，安装引擎插件，并让 agent 在需要时打开编辑器。](https://ai-game.dev/zh-hans/docs/wiki/app/projects-and-engines)
- [**智能体与模型** 在 AI Game Dev 应用和 CLI 中选择 AI 模型、推理强度和智能体，控制工具审批，并在自己的 GPU 上使用本地 AI 模型。](https://ai-game.dev/zh-hans/docs/wiki/app/agents-and-models)
- [**工作区** AI Game Dev 桌面工作区：项目窗口、窗格中的会话、纹理/3D 模型/音频的文件预览，以及 Explorer、Search 和 Git。](https://ai-game.dev/zh-hans/docs/wiki/app/workspace)
- [**包** AI Game Dev 应用中有哪些包，如何在 Packages 窗口或使用 gamedev pkg 安装、更新、排除和删除它们，以及层级如何工作。](https://ai-game.dev/zh-hans/docs/wiki/app/packages)
- [**软件包目录** 当前可用的全部第一方 AI Game Dev 软件包：Blender、SuperCollider 音乐、Knowledge Base、Tripo 3D、本地图像与视频模型、云端模型。](https://ai-game.dev/zh-hans/docs/wiki/app/packages-catalog)
- [**创建包** 编写你自己的 AI Game Dev 包：aigd-package.json 清单、命令、斜杠命令、MCP 工具，用 gamedev pkg dev 本地开发，以及分享。](https://ai-game.dev/zh-hans/docs/wiki/app/creating-packages)
- [**gamedev CLI 参考** gamedev CLI 的每条命令与选项：交互模式与无头模式、pkg、remote、daemon、acp、image-runtime、update，以及终端中的斜杠命令。](https://ai-game.dev/zh-hans/docs/wiki/app/cli)
- [**故障排查** 解决 AI Game Dev 应用和 gamedev CLI 的常见问题：登录、模型、引擎插件与编辑器连接、包、本地与云端生成。](https://ai-game.dev/zh-hans/docs/wiki/app/troubleshooting)
- [**常见问题** 关于 AI Game Dev 应用和 gamedev CLI 的简明解答：支持的引擎、平台、套餐、用量、包、本地模型、隐私，以及使用你自己的 AI 客户端。](https://ai-game.dev/zh-hans/docs/wiki/app/faq)

---

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

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