各位开发者大家好！
很荣幸为您介绍我们新的AI工具，LayaIdea 是 LayaAir IDE 内置的 AI 编程助手，支持对话式开发、AI 生成 2D/3D 资源、需求分析等功能，帮你用自然语言快速搭建游戏。有什么问题可以在评论区留言。感谢支持。
一、安装与配置
1. 安装插件
确保使用 LayaAir 3.3.9 及以上版本，创建或打开一个项目。
进入 IDE 资源商店 购买 LayaIdea 插件并添加至我的资源，然后通过 开发者 → 包管理器 安装。安装需要几分钟，完成后界面右侧会出现 LayaIdea 聊天窗口。
2. 配置 API_KEY
首次使用需要配置 API_KEY：
- 点击聊天窗口中的「获取 LayaIdea API_KEY」链接
- 在打开的页面中点击「新建 API_KEY」
- 将生成的密钥复制回填到 IDE 输入框
- 按
Ctrl+Alt+R 刷新编辑器
3. 检查 MCP 连接
打开 文件 → 项目设置 → MCP Tools，确认以下三项服务均为正常连接状态：
- Ide-tools
- Laya-ide-mcp-server
- laya_mcp_server
如显示异常，按 Ctrl+Alt+R 刷新即可。
二、两种模式
LayaIdea 提供 普通模式 和 专业模式，通过顶部齿轮图标切换。
| | 普通模式 | 专业模式 |
| -------- | ----------------------------- | --------------------------------------------------- |
| 适合人群 | 快速上手体验 | 有明确项目需求 |
| 核心功能 | AI 对话、生成 2D 图片/3D 模型 | 普通模式全部功能 + 需求分析 + 资源管理 + 自定义指令 |
专业模式多了 # 自定义指令、设置偏好、需求分析、资源管理等功能入口：
三、快速制作游戏
直接在聊天输入框描述你的需求即可，例如：
也可以通过专业模式的 需求分析 功能，先让 AI 细化需求再生成：
- 点击右侧 📋 图标，双击编辑区输入需求，点击「保存需求」
- 在聊天框输入
/build 开始构建
四、AI 生成资源
点击聊天框底部 / 按钮，选择生成技能：
- 2D 图片生成：输入提示词 + 可选参考图
- 3D 模型生成：支持文字生成、单图生成、多视图生成三种方式
还可以点击「专业生成模式」打开独立界面，进行更精细的参数控制。
生成完成后点击缩略图右下角的「下载」按钮，资源会保存到项目的 aigc_res 文件夹。
五、实用技巧
引用文件/资源
- @ 引用：点击底部
@ 图标，搜索并引用项目文件，让 AI 更精准理解上下文
- 资源引用：选中场景节点或项目资源后，点击聊天窗口出现的引用按钮
资源替换
替换模型时，先导入贴图再替换模型。如果出现白模，右键模型源文件 →「重新导入」→「提取模型内部资源」即可恢复。
自定义快捷指令
专业模式下点击底部 # → 右上角 +，可创建自定义提示词快捷指令（最多 10 条）。
常见问题
Q：安装后右侧没有聊天窗口？
耐心等待安装完成，或按 Ctrl+Alt+R 刷新编辑器。
Q：MCP Tools 显示连接异常？
先刷新编辑器，若仍未恢复可尝试重新安装插件。
Q：切换模型后没生效？
需要点击「重启IDE后生效」按钮重启 IDE。
Q：代币不够用？
点击右上角「查看/订阅」进入管理后台充值，部分订阅服务会赠送通用代币。
完整文档请查询我们的官方文档LayaIdea部分
