安裝

本頁說明如何安裝 AI Game Dev 桌面應用程式與 gamedev CLI、各作業系統提供哪些版本，以及更新如何運作。兩者皆可免費下載；代理能執行哪些功能取決於你的方案（請參閱 登入與帳號）。

安裝桌面應用程式#

開啟下載頁面。它會偵測你的系統並提供相符的版本，並在主按鈕下方列出所有版本。

macOS 沒有通用二進位檔：請選擇 Apple 晶片或 Intel 版本。如果你的瀏覽器未回報你 Mac 的架構（Safari 與 Firefox 不會回報），頁面會同時顯示兩種版本供你選擇。

Windows#

1. 從下載頁面下載安裝程式。
2. 執行 .exe 並依照安裝程式指示操作。
3. 從開始功能表啟動 AI Game Dev。

macOS#

1. 下載適用於你 Mac 的 .dmg（Apple 晶片或 Intel）。
2. 開啟它並將應用程式拖曳到「應用程式」資料夾。
3. 從「應用程式」或 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 就是終端機中的同一個代理。它以 @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 或 Knowledge Base）會與應用程式分開更新：啟動時以及每四小時會檢查一次，且你可以針對每個套件關閉自動更新。請參閱套件。

背景服務#

桌面應用程式、CLI 與 gamedev acp 都會連線到你電腦上的同一個 AI Game Dev 背景服務。它負責你的登入、聊天、套件與專案檔案，因此即使你關閉啟動聊天的終端機，聊天仍會繼續執行。你通常完全不需要碰它。若希望電腦能持續從其他裝置存取，CLI 可以將它安裝為使用者層級的作業系統服務，於登入時啟動：

gamedev daemon status
gamedev daemon install

其他 daemon 子指令請參閱 CLI 參考。

各項目安裝在哪裡#

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

後續步驟#

• 使用你的帳號登入。
• 開啟你的第一個專案。
• 想手動設定引擎外掛？請參閱 Unity、Unreal 與 Godot 的外掛安裝指南。