Godot 引擎 CLI
用于 Godot 游戏引擎的智能体原生 CLI。可从命令行管理项目、场景、导出及 GDScript 执行。
安装
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
要求
- 系统 PATH 中包含 Godot 4.x（或设置
GODOT_BIN环境变量）
命令
项目管理
# 创建新 Godot 项目
cli-anything-godot project create <path> [--name "我的游戏"]
# 获取项目信息（名称、功能、主场景）
cli-anything-godot --json -p <project> project info
# 列出所有场景
cli-anything-godot --json -p <project> project scenes
# 列出所有脚本
cli-anything-godot --json -p <project> project scripts
# 列出所有资源
cli-anything-godot --json -p <project> project resources
# 重新导入项目资源
cli-anything-godot -p <project> project reimport
场景操作
# 创建新场景，指定根节点类型
cli-anything-godot -p <project> scene create scenes/Level1.tscn --root-type Node3D
# 读取场景结构（节点、资源、连接）
cli-anything-godot --json -p <project> scene read scenes/Level1.tscn
# 向场景添加子节点
cli-anything-godot -p <project> scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent .
GDScript 执行
# 运行 GDScript 文件（需扩展 SceneTree）
cli-anything-godot -p <project> script run tools/build_navmesh.gd
# 运行内联 GDScript 代码
cli-anything-godot -p <project> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# 验证 GDScript 语法
cli-anything-godot -p <project> script validate scripts/player.gd
导出
# 列出已配置的导出预设
cli-anything-godot --json -p <project> export presets
# 导出所有预设
cli-anything-godot -p <project> export build
# 导出特定预设
cli-anything-godot -p <project> export build --preset "Windows Desktop" --output build/game.exe
引擎
# 检查 Godot 可用性和二进制路径
cli-anything-godot --json engine status
# 获取引擎版本
cli-anything-godot engine version
JSON 模式
为任何命令添加 --json 标志，即可获得适合智能体消费的结构化 JSON 输出：
cli-anything-godot --json -p ./my-game project info
交互式 REPL
cli-anything-godot -p ./my-game session