用途:在开发 Godot Engine 项目时提供专门指导,重点是让编码辅助工具正确处理 Godot 的混合文件结构——GDScript 代码(.gd)与文本资源文件(.tscn 场景、.tres 资源)。适用于创建或修改场景/资源文件、实现游戏系统(交互、属性、法术、背包)、排查“file failed to load”类资源错误、搭建组件化或信号驱动架构、基于资源实现数据。
主要能力:讲解三类文件格式差异;强调 .tres/.tscn 中的关键规则,例如用 ExtResource("id") 而非 preload()、不使用 var/const/func、数组需写成 ArrayType;建议逻辑放 .gd、数据放 .tres、复杂场景变更交给编辑器;提供组件化架构与信号驱动通信模式;附带校验脚本与模板。
使用方式:编辑资源或场景后运行 python3 scripts/validate_tres.py path/to/file.tres 与 python3 scripts/validate_tscn.py path/to/file.tscn 校验;用 cp 从 assets/templates/ 复制模板作为起点;需要细节时查阅 references/ 下的 file-formats.md、architecture-patterns.md、common-pitfalls.md、godot4-physics-api.md。单元测试使用 GUT,可运行 godot -d -s --path "$PWD" addons/gut/gut_cmdln.gd -gexit,或通过 -gtest=、-gdir=、-gselect= 过滤。
限制:适合纯逻辑的 RefCounted/Resource 类做单元测试,不建议对依赖场景树的渲染、UI、输入做单测;复杂 .tscn 层级编辑易被编辑器重存破坏,应谨慎并即时测试。具体收费、价格、平台支持等资料暂未提供。