# 安裝 — 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、各作業系統提供哪些版本，以及更新如何運作。兩者皆可免費下載；代理能執行哪些功能取決於你的方案（請參閱 [登入與帳號](https://ai-game.dev/zh-hant/docs/wiki/app/sign-in-and-account)）。

## 安裝桌面應用程式

開啟[下載頁面](https://ai-game.dev/zh-hant/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-hant/download)下載安裝程式。
2. 執行 `.exe` 並依照安裝程式指示操作。
3. 從開始功能表啟動 **AI Game Dev**。

### macOS

1. 下載適用於你 Mac 的 `.dmg`（Apple 晶片或 Intel）。
2. 開啟它並將應用程式拖曳到「應用程式」資料夾。
3. 從「應用程式」或 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 就是終端機中的同一個代理。它以 `@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-hant/docs/wiki/app/cli)。

## 更新

### 桌面應用程式更新

桌面應用程式會自行檢查更新。有新版本時，它會在背景下載並顯示 **Restart to update**；重新啟動後即會安裝更新。你也可以在 **Settings**、**About** 中手動檢查，那裡會顯示應用程式版本與更新狀態。

各版本的變更內容請參閱[版本說明頁面](https://ai-game.dev/zh-hant/releases)。

### CLI 更新

用一個指令更新 CLI：

```bash
gamedev update
```

這會為你執行 `npm install -g @baizor/gamedev@latest`。在互動式 CLI 中，`/update` 會說明如何升級並顯示背景服務的狀態；`/update now` 則會替換正在等待更新的背景服務。

### 套件更新

套件（例如 Blender 或 Knowledge Base）會與應用程式分開更新：啟動時以及每四小時會檢查一次，且你可以針對每個套件關閉自動更新。請參閱[套件](https://ai-game.dev/zh-hant/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-hant/docs/wiki/app/cli#daemon)。

## 各項目安裝在哪裡

- 應用程式會將設定、登入資訊與套件快取保存在家目錄中的 `.ai-game-dev` 資料夾（`~/.ai-game-dev/`）。
- 只有在專案層級儲存了內容時，專案才會有 `.ai-game-dev/` 資料夾，例如為整個團隊新增的套件或 Knowledge Base 筆記。
- 本機 AI 模型會存放在模型儲存資料夾中，你可以在 **Settings**、**Model storage** 將它移到其他磁碟（或在 CLI 中使用 `/images storage`）。

## 後續步驟

- 使用你的帳號[登入](https://ai-game.dev/zh-hant/docs/wiki/app/sign-in-and-account)。
- [開啟你的第一個專案](https://ai-game.dev/zh-hant/docs/wiki/app/projects-and-engines)。
- 想手動設定引擎外掛？請參閱 [Unity](https://ai-game.dev/zh-hant/docs/wiki/unity/installation)、[Unreal](https://ai-game.dev/zh-hant/docs/wiki/unreal/installation) 與 [Godot](https://ai-game.dev/zh-hant/docs/wiki/godot/installation) 的外掛安裝指南。

---

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

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