gdcli

从命令行和编码智能体里驾驶 Godot 编辑器。

**In English:** gdcli lets coding agents (Claude Code, Codex, Cursor and any MCP client) and people at a terminal build Godot 4 games through the real editor: read and change the open scene with every step on the editor's undo stack, run the game and inspect, steer and debug it while it runs, check scripts and run scenes without an editor, and look up the engine's API and manual. Changes that would run code inside the editor wait for a person to approve them. It is three parts: a bridge plugin in the editor, the `gd` command line (`npm install -g @spardanviro/gdcli`), and a Claude Code plugin with 13 skills. The documentation is in Chinese.

---

它解决什么问题

让 AI 写 Godot 游戏，常见的做法是让它直接改 `.tscn` 和 `.gd` 文件。这样做的问题很多：场景文件的格式容易写坏，改动不进编辑器的撤销栈，看不到游戏实际跑起来是什么样，而且任何代码都可能被写进编辑器里运行。

gdcli 换了一条路：**智能体通过编辑器来做事**，和人点编辑器的效果一样。

• 改场景走编辑器：建节点、改属性、挂脚本、连信号、做动画、画瓦片，每一步都是编辑器撤销栈里的一步，Ctrl+Z 能撤销。
• 能看见游戏在干什么：从编辑器运行游戏后，可以读运行中节点的属性、模拟按键、调用方法、读报错和输出、下断点、单步、看局部变量。
• 不开编辑器也能做的事：运行场景并拿到结构化的报错、检查脚本、导入、导出、查当前引擎版本的接口和官方手册。
• 危险的改动要人点头：会让代码进入编辑器进程的改动（@tool 脚本、addons/、自动加载、C#、eval 等）会在编辑器里弹窗，人同意才执行；没