核心功能
godot-bridge 是一款面向 Godot 4.x 引擎的远程控制 CLI 工具，通过 HTTP 或 WebSocket 协议实现对运行中游戏实例的实时操控。该工具提供超过 100 条命令，覆盖从基础 UI 到复杂物理模拟的完整游戏开发需求。
主要命令类别
UI 系统：支持创建 Label、Button、Progress、Slider、Panel 等组件，内置阴影、描边、渐变、模糊等视觉效果，以及淡入淡出、脉冲、抖动、弹跳等交互动画。
2D/3D 图形：可动态生成矩形、圆形、多边形、星形等 2D 图元，以及 Box、Sphere、Cylinder、Capsule、Torus 等 3D 基础体。
粒子与特效：内置火焰、烟雾、火花等预设粒子效果，支持自定义粒子参数。
光照与物理：提供方向光、点光源控制，以及刚体、角色控制器等物理组件的远程配置。
场景管理：支持节点树查看和场景清空操作。
显著优点
1. AI 原生设计：CLI 接口天然适合大模型调用，无需学习 GDScript 即可操控 Godot 引擎
2. 双协议支持：HTTP 适合简单请求，WebSocket 支持实时双向通信
3. 参数化精细控制：位置、颜色、动画时长、物理属性等均可通过命令行参数调节
4. 即时反馈：修改无需重启游戏，适合快速原型迭代
局限性与风险
- 依赖 Node.js 环境：需预装 Node 运行时
- 网络暴露风险：WebSocket/HTTP 端口若配置不当可能暴露于公网
- Godot 版本锁定：仅支持 4.x 版本，与 3.x 不兼容
- 命令复杂度：高级效果需组合多条命令，单条命令表达能力有限
适用场景
- AI 自动化的游戏内容生成（NPC 对话 UI、动态场景搭建）
- 远程游戏测试与自动化 QA
- 教育演示中的实时图形编程教学
- 快速游戏原型验证（Rapid Prototyping）
安全建议
建议在本地网络或 VPN 环境中使用，避免直接暴露 WebSocket 端口；生产环境应配合身份验证机制。