核心用法
godot-bridge是一个Node.js CLI工具，通过HTTP或WebSocket协议与运行中的Godot 4.x游戏建立双向通信。用户需先将ClawBridge.gd服务器脚本配置为Godot项目的Autoload（自动加载），然后在Godot运行时通过CLI发送JSON命令，实现实时场景操控。
工作流程：
1. 配置：将ClawBridge.gd放入项目并设为Autoload
2. 启动：运行Godot项目（服务器监听localhost:9080）
3. 操控：通过node clawbridge.js <command>发送指令
支持的功能覆盖完整游戏开发管线：UI控件（Label、Button、Slider等）、3D基元（Box、Sphere、Cylinder）、粒子系统（Fire、Smoke、Sparks）、灯光系统（Directional/Omni/Spot）、摄像机控制、物理刚体与角色控制器、动画补间、场景切换等。
显著优点
- 实时反馈：无需重新编译或重启Godot，命令即时生效，适合快速原型和直播编码演示
- 双重协议：HTTP简单易调试，WebSocket低延迟适合高频交互场景
- AI友好：结构化CLI接口便于LLM生成调用，实现AI驱动的程序化内容生成
- 零侵入设计：仅需一个Autoload脚本，不修改现有项目架构
- 完整覆盖：从UI到物理、从2D到3D、从静态到动画，功能全面
潜在局限
- 运行依赖：必须保持Godot项目运行状态，无法离线执行
- 单项目限制：默认仅支持本地单一项目（端口9080），多项目需手动配置
- 网络边界：设计为localhost通信，跨机器部署需额外网络配置
- 版本锁定：明确限定Godot 4.x，3.x及更早版本不兼容
- 无持久化：纯运行时操控，不修改.tscn或.gd源文件
适合人群
- 游戏开发者进行快速原型验证和交互式调试
- 技术主播/教育者进行实时编码演示
- QA工程师构建自动化测试场景
- 生成式AI实验者（通过LLM驱动游戏内容生成）
- 游戏设计课程的教学辅助工具
常规风险
- 端口冲突：9080端口被占用会导致服务启动失败
- 运行时异常：错误命令可能导致Godot脚本运行时错误，需查看Godot控制台排查
- 无鉴权机制：本地服务无身份验证，多用户环境需谨慎
- WebSocket稳定性：高频率或大数据量传输下可能出现连接中断，建议关键操作使用HTTP模式
- Godot版本差异：4.x小版本更新可能引入API变动，需关注ClawBridge.gd兼容性