通用指令序列

GFCommandSequence 用于把一组步骤、命令对象或 callable 串行执行。它只处理顺序、等待和架构注入，不绑定任何项目规则。步骤可以继承 GFSequenceStep，也可以是实现了 execute() / resolve() 的普通对象。

自定义步骤

class_name WaitForTweenStep
extends GFSequenceStep

var target: Node2D


func execute(_context: GFSequenceContext) -> Variant:
    var tween := target.create_tween()
    tween.tween_property(target, "modulate:a", 0.0, 0.2)
    return tween.finished

运行序列

var context := GFSequenceContext.new()
var wait_step := GFWaitSequenceStep.new()
wait_step.duration = 0.2

var sequence := GFCommandSequence.new([
    WaitForTweenStep.new(),
    wait_step,
    func() -> void:
        print("sequence finished")
], context)

sequence.run()

使用边界

如果步骤返回 Signal，默认会等待。Signal 发出的第一个参数会作为该步骤结果继续进入失败策略判断；多个参数会以数组形式保留。因此异步步骤可以 completed.emit({ "ok": false, "error": "..." })，序列会像同步返回失败字典一样处理。

GFSequenceStep.wait_for_result = false 可把某个步骤声明为不阻塞序列。需要取消、超时或失败回滚时，继续阅读 取消、超时与失败策略。