检查运行环境¶
check_env.py 用于确认你的机器已正确配置，可以运行 GodotMaker。遇到任何异常时都可以执行它。
一切正常时，输出末尾会显示：
如果有项目缺失，你会看到一份失败检查列表以及每项的修复建议。
检查内容¶
Git¶
- 已安装 Git 2.30 或更高版本。
- 已设置
git user.name和git user.email（/gm-scaffold及 worktree 系统创建提交时需要用到）。
Python¶
- 运行本脚本的 Python 版本为 3.10 或更高。
- 已安装核心包：
requests、pillow、numpy。 - 根据
.godotmaker/config.yaml检查提供方包：Gemini 需要google-genai，OpenAI 需要openai，Grok 图片或视频生成需要xai-sdk。
Node.js¶
- 已安装 Node.js 18 或更高版本（通过
npx运行godot-mcp时需要）。 npx在 PATH 中可用（随 Node.js 一起安装）。
Godot¶
- Godot 4.5 或更高版本可通过 PATH 中的
godot或godot4命令访问。
如果 Godot 不在 PATH 中，这项检查会显示警告而非硬性失败——你仍可以在运行 publish.py 时手动输入可执行文件的完整路径，它会被保存到 .claude/godotmaker.yaml 供后续使用。
Claude Code¶
claude命令行工具已安装且在 PATH 中可用。
API 密钥¶
| 密钥 | 状态 | 用途 |
|---|---|---|
GOOGLE_API_KEY 或 GEMINI_API_KEY |
选中时必填 | Gemini 图片生成或 VQA |
OPENAI_API_KEY |
选中时必填 | OpenAI 图片生成或 VQA |
XAI_API_KEY |
选中时必填 | xAI Grok 图片或视频生成 |
TRIPO3D_API_KEY |
可选 | 3D 模型生成（仅 3D 游戏需要） |
API 后端选择器缺少对应 key 时会失败。asset_image_model: native 对 Codex 会通过；对 Claude Code 会给出警告，因为环境检查无法证明 Claude 侧原生生图工具可用。Claude Code 项目中的 asset_image_model: codex 会在 Codex CLI 位于 PATH 时通过。asset_video_model: none 不需要 XAI_API_KEY。
检查工具还会验证被选中提供方的 Python 包能否正常导入，从而捕获单靠版本号检查无法发现的安装问题。
读懂输出结果¶
每行以以下三种标记之一开头：
[PASS] Git 2.43.0 (>= 2.30)
[FAIL] Package 'google-genai' missing. Run: pip install google-genai
[WARN] XAI_API_KEY not set (optional, cheaper image generation)
[WARN] 表示可选项——不影响 GodotMaker 的使用。[FAIL] 表示阻断性问题。
输出末尾会汇总所有失败项，方便你一次性全部修复：
========================================
Total: 14 checks
PASS: 12
FAIL: 1
WARN: 1
Failed checks:
- Package 'google-genai' missing. Run: pip install google-genai
Fix the above issues before using GodotMaker.
退出码¶
| 退出码 | 含义 |
|---|---|
| 0 | 所有必填检查通过（有警告也没关系） |
| 1 | 一项或多项必填检查失败 |
脚本和 CI 流水线可以依靠这个退出码来决定是否继续执行后续步骤。
刚开始上手？¶
参阅安装指南，按步骤完成所有前置条件的配置，再运行 check_env.py。