节点状态 Hook、资源片段与校验

这一组文档说明节点状态如何访问架构依赖、注册事件、组合条件与行为资源、分发状态事件，并在编辑器中执行结构校验。

阅读入口

• 依赖代理与事件注册：GFNodeState 的架构代理和激活期事件监听。
• 条件与行为资源：GFNodeStateCondition、GFNodeStateBehavior 和脚本守卫。
• 编辑器模板与结构校验：NodeState 模板、Inspector 初始状态选择和 GFNodeStateMachineValidator。

使用边界

这些资源基类只定义状态节点上下文和生命周期钩子，不规定动画命名、输入动作、AI 黑板字段或业务事件含义。

状态事件与快照

GFNodeStateMachine.dispatch_state_event(event_id, payload, group_name) 可以指定某个状态组，也可以在 group_name 为空时按已注册状态组顺序广播。单个 GFNodeStateGroup 会先交给当前状态，再交给暂停栈中的状态。状态脚本重写 _handle_state_event() 并返回 true 即表示事件已处理。

get_state_snapshot() 可返回各状态组当前状态、栈、历史、注册状态和黑板副本，适合调试面板或诊断命令消费。