批量操作的威力如何用Godot AI的batch_execute原子化修改上百个节点【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-aiGodot AI 是一款为 Godot 引擎打造的 MCP 服务器与 AI 工具集让 Claude Code、Cursor 等 AI 客户端直接操作实时 Godot 编辑器。它内置的batch_execute 工具是批量操作的利器一次调用即可原子化执行上百个节点修改出错时自动整体回滚让 AI 批量编辑 Godot 节点既快又安全。为什么需要 batch_execute 批量工具用 AI 编辑 Godot 场景时多步操作建节点、设属性、挂脚本如果拆成多次工具调用会面临两个问题慢每条命令都要走一轮请求—传输—执行往返改 100 个节点就是 100 轮不稳定中途某一步失败场景会停在改了一半的中间状态需要手动撤销Godot AI 的batch_execute一次性解决这两个问题定义见 batch_handler.gd顺序执行、首错即停按顺序跑完所有子命令遇到第一个错误立即停止失败即回滚默认undoTrue任何后续命令失败时之前已成功的修改会通过场景的 UndoRedo 历史整体撤销——即失败即原子atomic-on-failure语义500 条上限单次最多 500 个子命令足够覆盖绝大多数场景批量编辑同时防止编辑器长时间冻结在 TOOLS.md 中它被概括为一句话Run multiple plugin commands atomically (rollback on first error)。3 步上手批量修改节点的最快配置方法第 1 步准备子命令列表每个子命令是{command: 插件命令名, params: {...}}。注意这里用的是插件命令名如create_node、set_property而不是 MCP 工具名如node_create——这一点在 tool-surface.md 中有专门说明。第 2 步调用 batch_execute直接向 AI 下达自然语言指令即可例如给 /Main 下的所有敌人节点批量设置 position 高度为 2并挂上 enemy.gd 脚本。AI 会生成类似这样的批量调用完整示例见 batch.py 的工具说明{ commands: [ {command: create_node, params: {type: Node3D, name: Enemy, parent_path: /Main}}, {command: set_property, params: {path: /Main/Enemy, property: position, value: {x: 5, y: 2, z: 0}}} ] }第 3 步读懂返回结果返回字典包含 5 个关键字段字段含义succeeded成功执行的子命令数stopped_at首个失败子命令的下标无失败为 nullresults每条子命令的状态 / 数据 / 错误明细rolled_back是否执行了整体回滚undoable整批操作能否被当作一个单元撤销原子性如何保证回滚机制详解batch_handler.gd 中的实现相当讲究精确测量提交量每执行完一条子命令就对比场景 UndoRedo 与全局 UndoRedo 的get_version()版本号只回滚真正提交了修改的那些动作——既不会多撤你批量前自己的编辑也不会漏撤任何实际写入严格 LIFO 回滚回滚时按提交顺序的逆序、且针对每个动作实际所属的历史栈执行撤销跨场景 / 全局历史也不会乱序写前全量预校验执行前先检查所有子命令的名称与params类型、是否为禁用命令畸形输入在任何修改提交之前就会被拒绝守住全有或全无契约哪些命令不能放进批量里为了保证批量执行的同步性和原子性以下命令被禁止作为子命令源码中的FORBIDDEN_SUBCOMMANDS表命令拒绝原因batch_execute不能嵌套另一个批量reload_plugin卸载过程会中断批量执行run_tests批量内无传输服务测试套件会饿死 WebSocket 心跳请直接调用 test_rungame_command响应是异步带外返回的批量内没有完成通道configure_client/remove_client同样是延迟响应型需单独调用写批量脚本前对照这张清单能避免批量跑到一半卡住的困惑。实战建议高效批量编辑 Godot 节点技巧相对路径场景路径相对被编辑场景的根节点如/Main/Enemy不是运行时的/root/...路径拆分超大批量超过 500 条时按功能域拆成多个批量每个仍保持独立回滚能力先小批量试跑改 200 个节点前先用 3~5 个节点验证命令名和参数格式善用未知命令提示写错命令名时返回错误会附带模糊匹配的suggestions如 Did you mean: create_node?照着改即可回滚失败再撤销如果返回中rolled_back为 false 但操作已完成可在编辑器中按 CtrlZ 手动撤销深入阅读工具总览与命令清单docs/TOOLS.md批量工具的实现说明src/godot_ai/tools/batch.py、src/godot_ai/handlers/batch.py插件侧执行与回滚逻辑plugin/addons/godot_ai/handlers/batch_handler.gd工具面与命名规范docs/tool-surface.md把多步场景编辑折叠进一次batch_execute调用Godot AI 的原子回滚会兜底——你可以放心让 AI 一口气改上百个节点。【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考