# 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-hant/download)取得已簽章的安裝程式 | `npm install -g @baizor/gamedev` |
| 最適合 | 日常工作：面板、預覽、Source Control、Packages 視窗 | 終端機工作流程、腳本化（`--print`）、ACP 用戶端（例如 T3 Code 或 Zed） |
| 套件 | Packages 視窗加上 `/packages` | `gamedev pkg` 與 `/packages` |
| 更新 | 下載更新並提供 **Restart to update** | `gamedev update` |

你可以在同一台電腦上同時使用兩者。在其中一個開始的聊天會保存在共用的歷史記錄中，而在使用者層級安裝的套件會同時套用到兩者。

## 它如何與引擎外掛及 MCP 搭配

應用程式不會取代引擎外掛，而是使用它們。每個引擎都有自己的 MCP 外掛，用來提供編輯器工具（建立物件、編輯場景、執行測試、擷取螢幕截圖等，功能繁多）：

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

當你開啟 Unity、Unreal 或 Godot 專案時，應用程式會偵測引擎、提供安裝或更新對應外掛的選項、在代理需要時開啟編輯器，並透過 ai-game.dev 以你登入的 session 將編輯器工具連接到你的聊天。安裝程式隨應用程式一起提供，因此桌面應用程式不需要 Node.js 或 npm。

這些外掛也能在沒有應用程式的情況下運作：任何 MCP 用戶端（Claude Code、Cursor、VS Code、Codex 等）都能連線到 [MCP 端點](https://ai-game.dev/zh-hant/mcp-endpoint-info)。[生態系總覽](https://ai-game.dev/zh-hant/docs/ecosystem)說明應用程式、外掛與 MCP 伺服器如何搭配運作，而[工具目錄](https://ai-game.dev/docs/tools)列出外掛提供給代理的工具。

## 應用程式在外掛之上額外提供的功能

- 一個聊天代理，能讀取並編輯你的專案檔案、執行命令並呼叫引擎工具，並由你掌控核准。
- 可從多家供應商選擇 AI 模型，依你的方案與地區指派。請參閱[代理與模型](https://ai-game.dev/zh-hant/docs/wiki/app/agents-and-models)。
- 桌面工作區，每個專案一個視窗，工作階段可分置於面板中，並具備檔案預覽（貼圖、3D 模型、音訊、視訊）與 Git。請參閱[工作區](https://ai-game.dev/zh-hant/docs/wiki/app/workspace)。
- **套件**可加入完整的能力：Blender、以 SuperCollider 製作音樂、專案知識庫、Tripo 3D、在你的 GPU 上執行本機影像與視訊生成，以及雲端視訊與音訊模型。請參閱[套件](https://ai-game.dev/zh-hant/docs/wiki/app/packages)。
- 工作階段工具：每個聊天可選擇要攜帶哪些工具，讓代理的上下文保持精簡。

## 頁面導覽

如果你是新手，請從這裡開始：

1. [安裝](https://ai-game.dev/zh-hant/docs/wiki/app/installation)：在 Windows、macOS 或 Linux 上安裝桌面應用程式，或安裝 `gamedev` CLI，並保持更新。
2. [登入與帳號](https://ai-game.dev/zh-hant/docs/wiki/app/sign-in-and-account)：登入、方案、以百分比顯示的用量、切換帳號。
3. [專案與引擎](https://ai-game.dev/zh-hant/docs/wiki/app/projects-and-engines)：開啟或建立專案，並讓應用程式設定 Unity、Unreal 或 Godot 外掛。
4. [代理與模型](https://ai-game.dev/zh-hant/docs/wiki/app/agents-and-models)：選擇模型、推理強度與代理、核准、本機模型。

接著深入了解更多：

- [工作區](https://ai-game.dev/zh-hant/docs/wiki/app/workspace)：桌面應用程式中的面板、預覽、Explorer、Search 與 Source Control。
- [套件](https://ai-game.dev/zh-hant/docs/wiki/app/packages)：什麼是套件、Packages 視窗、`gamedev pkg`、等級、更新。
- [套件目錄](https://ai-game.dev/zh-hant/docs/wiki/app/packages-catalog)：目前可用的每個套件及其功能。
- [建立套件](https://ai-game.dev/zh-hant/docs/wiki/app/creating-packages)：撰寫、測試並分享你自己的套件。
- [CLI 參考](https://ai-game.dev/zh-hant/docs/wiki/app/cli)：每個 `gamedev` 命令與終端機中的斜線命令。
- [疑難排解](https://ai-game.dev/zh-hant/docs/wiki/app/troubleshooting)：登入、引擎連線、套件與模型。
- [常見問題](https://ai-game.dev/zh-hant/docs/wiki/app/faq)：常見問題的簡短解答。

## 快速開始

1. 從[下載頁面](https://ai-game.dev/zh-hant/download)下載應用程式，或執行 `npm install -g @baizor/gamedev`。
2. 使用你的 AI Game Developer 帳戶登入。
3. 開啟你的遊戲專案資料夾。
4. 描述你想要的功能，例如「列出作用中場景中的所有內容」。

四步驟的[快速入門](https://ai-game.dev/zh-hant/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-hant/docs/wiki/app/installation)
- [**登入與帳號** 登入 AI Game Dev 應用程式與 gamedev CLI、切換帳號、瞭解方案與用量百分比，以及管理你的其他裝置。](https://ai-game.dev/zh-hant/docs/wiki/app/sign-in-and-account)
- [**專案與引擎** 在 AI Game Dev 應用程式中開啟或建立 Unity、Unreal 或 Godot 專案、安裝引擎外掛，並讓代理在需要時開啟編輯器。](https://ai-game.dev/zh-hant/docs/wiki/app/projects-and-engines)
- [**代理與模型** 在 AI Game Dev 應用程式與 CLI 中選擇 AI 模型、推理強度與代理，控制工具核准，並在自己的 GPU 上執行本機 AI 模型。](https://ai-game.dev/zh-hant/docs/wiki/app/agents-and-models)
- [**工作區** AI Game Dev 桌面工作區：專案視窗、窗格中的工作階段、貼圖、3D 模型與音訊的檔案預覽，以及 Explorer、Search 與 Git。](https://ai-game.dev/zh-hant/docs/wiki/app/workspace)
- [**套件** AI Game Dev 應用程式中有哪些套件、如何在 Packages 視窗或使用 gamedev pkg 安裝、更新、排除與移除套件，以及層級如何運作。](https://ai-game.dev/zh-hant/docs/wiki/app/packages)
- [**套件目錄** 現今所有官方 AI Game Dev 套件：Blender、SuperCollider 音樂、Knowledge Base、Tripo 3D、本機影像與影片模型、雲端模型。](https://ai-game.dev/zh-hant/docs/wiki/app/packages-catalog)
- [**建立套件** 撰寫自己的 AI Game Dev 套件：aigd-package.json 資訊清單、指令、斜線指令、MCP 工具、以 gamedev pkg dev 在本機開發，以及如何分享。](https://ai-game.dev/zh-hant/docs/wiki/app/creating-packages)
- [**gamedev CLI 參考** 所有 gamedev CLI 命令與選項：互動與無頭模式、pkg、remote、daemon、acp、image-runtime、update，以及終端機中的斜線命令。](https://ai-game.dev/zh-hant/docs/wiki/app/cli)
- [**疑難排解** 解決 AI Game Dev 應用程式與 gamedev CLI 的常見問題：登入、模型、引擎外掛與編輯器連線、套件、本機與雲端生成。](https://ai-game.dev/zh-hant/docs/wiki/app/troubleshooting)
- [**常見問題** 關於 AI Game Dev 應用程式與 gamedev CLI 的簡答：引擎、平台、方案、用量、套件、本機模型、隱私，以及使用自己的 AI 用戶端。](https://ai-game.dev/zh-hant/docs/wiki/app/faq)

---

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

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