# Godot AI 代理。

一个能理解你整个 Godot 项目的 AI 代理。通过对话生成场景、编写 GDScript、管理资源并构建游戏系统。

[下载 Summer Engine ](https://www.summerengine.com/download)

## 超越代码补全

大多数面向 Godot 的 AI 工具只做一件事：代码补全或代码生成。你输入一段注释，工具建议接下来的几行代码。这很有用，但只在文件层面起作用。它不知道你有哪些场景、哪些信号已连接，也不知道你的游戏系统如何交互。

Summer Engine 的代理在项目层面工作。它理解场景树、节点关系、资源依赖以及游戏架构。当你说「添加一个跟踪玩家 HP 的血条」时，它不只是写一段脚本。它会创建 UI 节点、正确放置位置、连接信号，并挂接到现有的玩家控制器。

这就是自动补全与真正协作者之间的差别。代理会规划多步骤任务，按正确的顺序执行，并验证一切都正确连接。

## 代理能做什么

你可以让代理构建的真实示例，以及它会产生的输出。

### 场景生成

「创建一个带有小路、树木和环境光照的森林场景。」

创建场景层级、放置网格、配置 DirectionalLight3D 与环境设置，并在空间上布置对象。得到的是一个可玩的场景，而不是代码片段。

### GDScript 生成

「为敌人 AI 编写一个包含巡逻、追击与攻击状态的状态机。」

产出干净、带注释、遵循 Godot 规范的 GDScript。导出变量以便在检查器中调参。能正确处理边界情况与状态切换。

### 系统架构

「添加一个支持堆叠、分类和拖放的背包系统。」

跨多个脚本和场景创建完整系统：数据模型、UI、输入处理、存档与读取集成。不是单个文件，而是一个完整、互联的系统。

### 调试

「玩家跳跃时会穿过墙壁。」

检查碰撞层、物理设置、CharacterBody3D 配置与移动代码。定位根本原因并应用修复，而不是只给建议。

### 资源创建

「为玩家生成一把低多边形剑。」

创建或查找合适的 3D 模型，生成材质，并放入正确的资源目录。可直接挂到角色上或加入背包。

### 重构

「这段代码越来越乱，清理一下玩家控制器。」

在保留行为、信号连接与节点引用的前提下重新组织代码。将过大的脚本拆分为聚焦的组件。保持所有既有功能。

## 工作原理

代理会读取你的整个项目上下文。场景文件、脚本、资源、项目设置。它知道有哪些节点、哪些信号已连接、注册了哪些 autoload，以及你的场景之间如何相互引用。

代理的每个动作都基于你实际的项目状态，而非通用的代码模式。它写脚本时使用正确的节点路径，创建场景时遵循你既有的命名规范，连接信号时知道哪些节点可用以及它们暴露了哪些方法。

你通过对话来工作。描述你想要什么，查看代理构建的内容，然后迭代。每一次修改都发生在引擎内部，所以你可以直接点击播放立即测试，不用从聊天窗口里复制粘贴代码。

## Godot AI 代理 vs 通用 AI 工具

### Copilot / Cursor

通用代码工具

* 只看单个代码文件
* 逐行给出补全建议
* 不了解场景或节点
* 无法创建或修改 .tscn 文件
* 对 Godot 专属 API 了解不深
* 输出停留在聊天窗口里

### Summer Engine 代理

引擎原生的 AI

* 看到你的整个项目：场景、脚本、资源
* 规划并执行多步骤任务
* 直接创建和修改场景
* 理解节点、信号、分组、物理层
* 深入掌握 Godot 4 的 API 与模式
* 修改直接发生在引擎内部

## 常见问题

### 什么是 Godot AI 代理？

Godot AI 代理是一种能够理解 Godot 项目完整上下文的 AI 系统，涵盖场景、脚本、节点、信号与资源。与只建议下一行代码的补全工具不同，代理可以规划并执行多步骤任务：创建场景、编写脚本、连接信号，并通过一次对话构建完整的游戏系统。

### 它和 GitHub Copilot 有什么不同？

Copilot 查看代码文件，并逐行给出补全建议。Summer Engine 的代理看到的是你整个项目的状态：场景树、节点属性、信号连接、物理层、autoload 以及资源依赖。它可以创建场景、修改节点层级，并构建跨多个文件的系统。Copilot 让你打字更快，代理则让你构建更快。

### 代理能修改场景，还是只能写代码？

两者都可以。代理可以创建和修改场景，添加并配置节点，在检查器中设置属性，连接信号，编写 GDScript 或 C#。它在引擎层面工作，而不只是在文本层面。当你说「在玩家头顶加一个血条」时，它会创建 UI 节点、定位、写脚本，并把它连接到玩家的血量信号上。

### 它能配合现有的 Godot 4 项目吗？

可以。Summer Engine 兼容 Godot 4 项目。打开你现有的 .godot 项目，代理会读取你完整的项目上下文：每一个场景、脚本、资源和配置文件。它理解你已经构建了什么，并在你现有的架构内工作。

### Summer Engine 是免费的吗？

Summer Engine 可以免费下载使用。核心引擎开源。AI 代理功能按使用量计费，你只为用到的部分付费。

## 今天就试试 Godot AI 代理。

免费下载。兼容你现有的 Godot 4 项目。

[下载 Summer Engine ](https://www.summerengine.com/download)

Source: https://www.summerengine.com/zh/godot-ai-agent

---

## Machine-readable resources

- Site index for agents: https://www.summerengine.com/llms.txt
- Full inlined content: https://www.summerengine.com/llms-full.txt
- Porting catalog: https://www.summerengine.com/llms-porting.txt
- Structured catalog: https://www.summerengine.com/agent-catalog.json
- Sitemap: https://www.summerengine.com/sitemap.xml
- Documentation: https://docs.summerengine.com
- Summer API (assets from any agent or code; public per-call model prices): https://docs.summerengine.com/api