SuperAPI AI 工具集

godot-composition-apps

通用与其它

查看项目

更新于 10-15 22:11

技能介绍

用途:为可扩展的 Godot 应用、工具、EditorPlugin 和以 Control 为主的 UI 提供架构标准,核心是组合(Has-A):根节点作为编排器(Orchestrator),业务能力拆成独立组件。适用于仪表盘、工具窗口、表单、设置面板、EditorPlugin UI;玩法实体(Player/Enemy/Weapon/Hitbox)应改用 godot-composition。

主要能力与规则:

  • 决策门:Control、EditorPlugin、工具窗口、设置停靠、表单 UI 留在本技能;玩法角色走 godot-composition。
  • 试金石(Rock Test):脚本挂到一块石头上仍能工作才算合格,用 comp_rock_test_boilerplate.gd 验证。
  • 通信层级:编排器向下调用组件用函数调用;组件向上用信号;组件之间禁止直接通信,需经编排器转发。
  • 编排器只做状态接线,不写业务逻辑;组件保持无状态,数据由编排器传入。
  • 依赖注入用 @export 或 %UniqueName,禁止用 get_node 路径取组件,禁止 get_parent() 取数据。
  • 逻辑与视觉分离:逻辑发 state_changed,由 VLS(comp_logic_visual_syncer.gd)驱动动画与主题。
  • 可保存状态用 comp_persistence_component.gd 注册 Saveable 组并提供 get_save_data(),不在表单控件里做 I/O。
  • 主题变更由主题组件负责,编排器在逻辑信号后向下调用;焦点由编排器授予/释放。

使用方式:实现前先阅读对应脚本,如 comp_orchestrator_base.gd、comp_base_component.gd、comp_dependency_injector.gd、comp_data_driven_config.gd、comp_ability_sequencer.gd、clipboard_copier.gd 等;按需参考 app-orchestrator-examples.md 与官方文档链接。

限制:不用于玩法实体;不提供具体收费、价格或平台信息(资料未提供);示例代码仅为模式示意,需按项目实际接线。