安装与授权

使用前准备

• 安装 Cocos Dashboard，以及 Creator 3.8.0 或更高版本。
• 准备一个可以正常打开的 Creator 项目。初次体验可以新建空项目。
• 使用购买 Game Agent 的 Cocos 账号登录 Dashboard / Creator。
• 准备一种可用的语言模型接入方式：模型服务的 API Key，或插件支持的 ChatGPT/Codex 账号授权。

插件授权和模型服务分别管理。 购买插件后，仍需自行准备模型服务的可用额度；语言模型、生图、联网搜索等服务的费用由对应服务商计算。

安装插件

通过 Cocos 商城 Game Agent 页面 获取插件，并按商城 / Dashboard 的提示安装到目标项目。

如果你拿到的是发布 ZIP，可以手动安装：

1. 完全关闭目标项目的 Creator 编辑器。
2. 解压 ZIP，把里面的 game_agent 文件夹放到项目的 extensions 目录。没有 extensions 时可自行创建。
3. 检查下方目录结构。package.json 应直接位于 game_agent 文件夹内。
4. 回到 Cocos Dashboard，打开该项目。
5. 在 Creator 的 扩展 → 扩展管理器 中确认 Game Agent 已启用。
6. 点击 扩展 → 打开 Game Agent。资产面板的入口是 扩展 → 打开 Game Agent 资产管理。

你的项目/
├── assets/
├── package.json
└── extensions/
    └── game_agent/
        ├── package.json
        ├── README.zh.md
        ├── dist/
        └── static/

更新插件时，同样先退出 Creator，再替换插件文件夹，最后通过 Dashboard 重新打开项目。避免同时安装两份 Game Agent。

首次授权

插件会检查当前 Cocos 登录账号的购买状态。如果出现授权提示，按提示登录购买账号，然后点击 重新检测。刚购买的订单需要同步时间；页面提示稍后重试时，等待后再检测即可。

如果提示网络异常，先检查网络连接，再重新检测。授权通过后，聊天面板会正常显示。