# 安装 — AI Game Dev 应用与 CLI · AI Game Developer Wiki

在 Windows、macOS 或 Linux 上安装 AI Game Dev 桌面应用，或用 npm 安装 gamedev CLI，并让两者保持最新。

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

本页介绍如何安装 AI Game Dev 桌面应用和 `gamedev` CLI，各操作系统提供哪些构建版本，以及更新是如何进行的。两者都可免费下载；AI 代理能做什么取决于你的套餐（见[登录与账户](https://ai-game.dev/zh-hans/docs/wiki/app/sign-in-and-account)）。

## 安装桌面应用

打开[下载页面](https://ai-game.dev/zh-hans/download)。它会检测你的系统并提供匹配的构建版本，同时会在主按钮下方列出所有构建版本。

| 操作系统 | 构建版本 | 说明 |
| --- | --- | --- |
| Windows | 已签名的 `.exe` 安装程序，x64 | 在 Windows on ARM 上通过模拟运行 |
| macOS，Apple 芯片 | 适用于 arm64 的原生 `.dmg` | 推荐所有 M 系列 Mac 使用 |
| macOS，Intel | 适用于 x64 的 `.dmg` | 适用于 Intel Mac |
| Linux | AppImage 和 `.deb`，x86\_64 | 暂无 arm64 Linux 构建版本 |

没有通用的 macOS 二进制包：请选择 Apple 芯片或 Intel 构建版本。如果你的浏览器无法报告你的 Mac 架构（Safari 和 Firefox 不会报告），页面会同时显示两种构建版本供你选择。

### Windows

1. 从[下载页面](https://ai-game.dev/zh-hans/download)下载安装程序。
2. 运行 `.exe` 并按照安装程序的指引操作。
3. 从开始菜单启动 **AI Game Dev**。

### macOS

1. 下载适用于你的 Mac 的 `.dmg`（Apple 芯片或 Intel）。
2. 打开它并将应用拖入 Applications。
3. 从 Applications 或 Launchpad 启动应用。

### Linux

在基于 Debian 和 Ubuntu 的系统上使用 `.deb`，在其他系统上使用 AppImage：

```bash
# Debian / Ubuntu: use the name of the file you downloaded
sudo apt install ./<downloaded-file>.deb

# Any distribution: make the AppImage executable, then run it
chmod +x ./<downloaded-file>.AppImage
./<downloaded-file>.AppImage
```

**说明**

桌面应用不需要 Node.js、npm 或引擎 CLI。Unity、Unreal 和 Godot 插件的安装程序已内置其中。

## 安装 gamedev CLI

`gamedev` CLI 就是终端里的同一个 AI 代理。它以 `@baizor/gamedev` 为名发布在 npm 上，会为你的平台安装自包含的预编译二进制文件：Windows x64、macOS arm64 和 x64、Linux x64 和 arm64。

要求：Node.js 22 或更新版本，并带有 npm。

```bash
npm install -g @baizor/gamedev
gamedev --version
```

然后进入你的游戏项目并启动它：

```bash
cd /path/to/your/game
gamedev
```

你也可以不进行全局安装，直接运行一次：

```bash
npx @baizor/gamedev
```

首次启动时 CLI 会要求你登录。完整命令列表见 [CLI 参考](https://ai-game.dev/zh-hans/docs/wiki/app/cli)。

## 更新

### 桌面应用更新

桌面应用会自动检查更新。当有新版本可用时，它会在后台下载并显示 **Restart to update**；重启后即安装更新。你也可以在 **Settings** 的 **About** 中手动检查，那里会显示应用版本和更新状态。

每个版本的变化见[发行说明页面](https://ai-game.dev/zh-hans/releases)。

### CLI 更新

用一条命令更新 CLI：

```bash
gamedev update
```

它会替你运行 `npm install -g @baizor/gamedev@latest`。在交互式 CLI 中，`/update` 会说明如何升级并显示后台服务的状态；`/update now` 会替换正在等待更新的后台服务。

### 包更新

包（例如 Blender 或知识库）与应用分开更新：它们在启动时以及每四小时检查一次，你可以按包关闭自动更新。见[包](https://ai-game.dev/zh-hans/docs/wiki/app/packages#updates)。

## 后台服务

桌面应用、CLI 和 `gamedev acp` 都连接到你电脑上的同一个 AI Game Dev 后台服务。它掌管你的登录、聊天、包和项目文件，因此即使你关闭了启动聊天的终端，聊天仍会继续运行。通常你完全不需要接触它。对于需要能从其他设备访问的电脑，CLI 可以将其安装为随登录启动的按用户操作系统服务：

```bash
gamedev daemon status
gamedev daemon install
```

其他 `daemon` 子命令见 [CLI 参考](https://ai-game.dev/zh-hans/docs/wiki/app/cli#daemon)。

## 安装内容与位置

- 应用将配置、登录信息和包缓存保存在主目录下的 `.ai-game-dev` 文件夹中（`~/.ai-game-dev/`）。
- 只有当项目级别存储了内容时，项目才会获得 `.ai-game-dev/` 文件夹，例如为整个团队添加的包或知识库笔记。
- 本地 AI 模型存储在模型存储文件夹中，你可以在 **Settings** 的 **Model storage** 中将其移到其他磁盘（或在 CLI 中使用 `/images storage`）。

## 后续步骤

- 使用你的账户[登录](https://ai-game.dev/zh-hans/docs/wiki/app/sign-in-and-account)。
- [打开你的第一个项目](https://ai-game.dev/zh-hans/docs/wiki/app/projects-and-engines)。
- 更想手动设置引擎插件？请参阅 [Unity](https://ai-game.dev/zh-hans/docs/wiki/unity/installation)、[Unreal](https://ai-game.dev/zh-hans/docs/wiki/unreal/installation) 和 [Godot](https://ai-game.dev/zh-hans/docs/wiki/godot/installation) 的插件安装指南。

---

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

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