Gen_Hack-and-Slash-Roguelite/Client/Assets/Scripts/AI/LeafNodeBase.cs

using System;

namespace AI
{
    public abstract class LeafNodeBase : BehaviorTreeBase
    {
        // 已经运行的帧数
        protected int _elapsedFrames;

        // 默认超时帧数
        protected int _timeoutFrames = 180;

        /// <summary>
        ///     获取或设置该叶节点的超时帧数。确保超时帧数至少为1。
        /// </summary>
        public int TimeoutFrames
        {
            get => _timeoutFrames;
            set => _timeoutFrames = Math.Max(1, value);
        }

        // 剩余帧数
        public int RemainingFrames => TimeoutFrames - _elapsedFrames;

        /// <summary>
        ///     抽象方法，由具体的叶节点实现其核心业务逻辑。
        ///     <see cref="LeafNodeBase" /> 会在计时器管理后调用此方法。
        /// </summary>
        /// <returns>节点的执行状态（Running, Success, Failure）。</returns>
        protected abstract Status ExecuteLeafLogic();

        /// <summary>
        ///     <see cref="LeafNodeBase" /> 的 Tick 方法，包含了计时器和状态管理逻辑。
        ///     此方法被密封，子类应实现 <see cref="ExecuteLeafLogic" /> 而不是重写 Tick。
        /// </summary>
        public sealed override Status Tick()
        {
            if (CurrentStatus == Status.Ready)
            {
                CurrentStatus = Status.Running;
                _elapsedFrames = 0;
            }

            if (CurrentStatus == Status.Running)
            {
                _elapsedFrames++;

                if (_elapsedFrames > _timeoutFrames)
                {
                    CurrentStatus = Status.Failure;
                    Reset();
                    return Status.Failure;
                }

                var logicResult = ExecuteLeafLogic();

                if (logicResult != Status.Running)
                {
                    CurrentStatus = logicResult;
                    Reset();
                }

                return logicResult;
            }

            return CurrentStatus;
        }

        /// <summary>
        ///     重置叶节点的状态，包括基类状态和内部计时器。
        /// </summary>
        public override void Reset()
        {
            base.Reset();
            _elapsedFrames = 0;
        }
    }
}