我和AI一起开发了一款全功能GodotAIAgent插件

本文系用户投稿，不代表机核网观点

本文含有AI生成，请注意甄别

⚠️ 未经作者授权禁止转载

项目仓库地址：https://github.com/snougo/Godot-AI-Chat
大家好，很久没有这么正式地写一篇文章了，还是给自己开发的Godot插件写，一时有点不知道从哪里说起。
这个插件项目始于很久之前的一场随意测试（时间有点长以至于我都不记得多久了），那时候我抱着随便试试的心态让gpt为我生成一个用于Godot编辑器内的chatbot插件，没想到经过几轮修修改改之后，确实成功在Godot编辑器里运行了起来，后来迭代了一段时间后，感觉遇到了瓶颈，就没再继续。
之后gemini 2.5发布，刚好我又从google cloud上免费薅到了为期3个月的300美金的体验金，至此，我又重启了这个插件的开发一直到体验金到期。
然而随着体验金的到期，插件的开发马上又进入了一段停滞期，不过很快我就过渡到了使用国产大语言模型的道路上了。初期是kimi 2.5，然后是glm5，最近则是token价格屠夫deepseek v4，只能说赶上好时候了。
而随着token价格终于降到一个合理的区间，我想这款插件终于迎来了它的时间，为此我决定写一篇文章介绍一下它。
简单来说，这是一款直接嵌入进Godot编辑器的全功能AI Agent插件，能对项目上下文自动进行感知，不需要第三方Agent，也不需要MCP。并且从插件可以进行工具调用后，就几乎只使用插件自己来迭代自己，因此这款插件的工程实现均来自我自己的真实痛点，而不是单纯的套壳模仿。
插件不仅支持主流的OpenAI Chat Compatible，还支持新的OpenAI Responses。不止如此，本插件还额外支持Gemini API以及Anthropic API，可以说把能想到的API端点都进行了支持。当然国内几乎所有的模型提供商提供的都是OpenAI Chat Compatible格式的API端点，因此也是插件维护的重点。
插件还参照Anthropic Skill的设计理念，结合实际情况，实现了一套自己的Skill + Sub-Agent结合的子智能体调用系统，这样Main-Agent就从一些特定自动化流水线任务中解脱了出来，其上下文窗口不会被这些自动化流水线任务所污染。
除了这套特殊的子智能体调用系统，在插件中，供AI调用的工具本身其实是一个特殊的工具脚本，因此自定义开发相关工具也变得极其简单，通常无需手动自己实现，只需要告知AI你的需求，AI就会自己分析插件的工具架构实现，从而自动生成复合要求的新工具脚本。
当然一款Agent工具不能只是功能强大，其安全性也必须进行考虑，为此我在AI工具的父类中实现了一个基于路径检查逻辑的黑名单方法，供开发者定制自己的路径黑名单。其次AI在Godot编辑器中通过引擎API进行写入操作时，本质上是对编辑器中的文件内存对象进行操作，由于所有的写入操作工具均未提供保存操作，因此实际上文件本身没有被修改，只是其内存状态发生了变化，开发者完全可以安全撤销AI的写入痕迹。
还有一些特色小功能我在最后一并介绍一下：
插件在系统提示词中引入了多个概念用于控制模型的行为，比如工作区、管控区以及前置文档，当模型的指令跟随能力比较优秀时，这些概念均能得到很好的贯彻。
插件支持向多模态模型发送图片内容，你可以通过部署一个本地的小参数多模态模型来体验这个特性。
插件的用户输入框支持向里面拖拽文件，当拖拽完毕后，会自动将其处理成文件路径，当你点击发送按钮后，插件会根据文件类型自动将文件路径转换成对应的内容。
支持流式输出和部分markdown语法的渲染
如果你使用Godot引擎，并且希望直接在编辑器中使用Agent的话，欢迎使用我开发的这款插件，也欢迎给我提插件使用上的建议。