安装

本页介绍如何安装 AI Game Dev 桌面应用和 gamedev CLI，各操作系统提供哪些构建版本，以及更新是如何进行的。两者都可免费下载；AI 代理能做什么取决于你的套餐（见登录与账户）。

安装桌面应用#

打开下载页面。它会检测你的系统并提供匹配的构建版本，同时会在主按钮下方列出所有构建版本。

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

Windows#

1. 从下载页面下载安装程序。
2. 运行 .exe 并按照安装程序的指引操作。
3. 从开始菜单启动 AI Game Dev。

macOS#

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

Linux#

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

# 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

安装 gamedev CLI#

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

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

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

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

cd /path/to/your/game
gamedev

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

npx @baizor/gamedev

首次启动时 CLI 会要求你登录。完整命令列表见 CLI 参考。

更新#

桌面应用更新#

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

每个版本的变化见发行说明页面。

CLI 更新#

用一条命令更新 CLI：

gamedev update

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

包更新#

包（例如 Blender 或知识库）与应用分开更新：它们在启动时以及每四小时检查一次，你可以按包关闭自动更新。见包。

后台服务#

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

gamedev daemon status
gamedev daemon install

其他 daemon 子命令见 CLI 参考。

安装内容与位置#

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

后续步骤#

• 使用你的账户登录。
• 打开你的第一个项目。
• 更想手动设置引擎插件？请参阅 Unity、Unreal 和 Godot 的插件安装指南。