feat(角色状态机): 重构角色状态系统为基于类的设计

新增通用状态类和职业专属状态类，将状态逻辑从状态机中解耦
添加状态注册机制，支持按职业配置状态
实现基础状态如待机、移动、跳跃、受击等
为剑士职业实现专属攻击状态
补充状态机开发说明文档

Game/include/character/states/CharacterStateBase.h

@@ -0,0 +1,94 @@
+#pragma once
+
+#include "character/CharacterActionTypes.h"
+#include <string>
+
+namespace frostbite2D {
+
+class CharacterObject;
+class CharacterStateMachine;
+struct CharacterActionDefinition;
+
+struct CharacterStateContext {
+  CharacterObject& owner;
+  CharacterCommandBuffer& commandBuffer;
+  const CharacterIntent& intent;
+  float deltaTime = 0.0f;
+};
+
+class ICharacterStateNode {
+public:
+  virtual ~ICharacterStateNode() = default;
+
+  virtual CharacterStateId GetId() const = 0;
+  virtual void OnEnter(CharacterStateMachine& machine,
+                       CharacterStateContext& context,
+                       CharacterStateId previousState) {
+    (void)machine;
+    (void)context;
+    (void)previousState;
+  }
+  virtual void OnUpdate(CharacterStateMachine& machine,
+                        CharacterStateContext& context) = 0;
+  virtual void OnExit(CharacterStateMachine& machine,
+                      CharacterStateContext& context,
+                      CharacterStateId nextState) {
+    (void)machine;
+    (void)context;
+    (void)nextState;
+  }
+};
+
+class ICharacterActionStateNode {
+public:
+  virtual ~ICharacterActionStateNode() = default;
+  virtual bool TryEnter(CharacterStateMachine& machine,
+                        CharacterStateContext& context) = 0;
+};
+
+class CharacterStateBase : public ICharacterStateNode {
+public:
+  explicit CharacterStateBase(CharacterStateId stateId);
+  ~CharacterStateBase() override = default;
+
+  CharacterStateId GetId() const override;
+
+protected:
+  void ChangeState(CharacterStateMachine& machine,
+                   CharacterStateContext& context,
+                   CharacterStateId nextState) const;
+  void PlayActionById(CharacterObject& owner,
+                      const std::string& actionId,
+                      const std::string& fallbackTag = "rest") const;
+  void InvokeHook(CharacterStateMachine& machine,
+                  CharacterObject& owner,
+                  const CharacterActionDefinition* action,
+                  const char* phase) const;
+  bool TryStartAction(CharacterStateMachine& machine,
+                      CharacterStateContext& context,
+                      CharacterCommandType commandType,
+                      const std::string& actionId) const;
+  bool TryStartRegisteredAction(CharacterStateMachine& machine,
+                                CharacterStateContext& context) const;
+  void ApplyFrameEvents(CharacterStateMachine& machine,
+                        CharacterObject& owner,
+                        int previousFrame,
+                        int currentFrame) const;
+
+  const CharacterActionDefinition* GetCurrentAction(const CharacterStateMachine& machine) const;
+  const std::string& GetCurrentActionId(const CharacterStateMachine& machine) const;
+  void SetCurrentAction(CharacterStateMachine& machine,
+                        const CharacterActionDefinition* action,
+                        const std::string& actionId) const;
+  void ClearCurrentAction(CharacterStateMachine& machine) const;
+
+  float& StateTime(CharacterStateMachine& machine) const;
+  float& ActionFrameProgress(CharacterStateMachine& machine) const;
+  int& ActionFrame(CharacterStateMachine& machine) const;
+  float& LandingTimer(CharacterStateMachine& machine) const;
+
+private:
+  CharacterStateId stateId_ = CharacterStateId::Idle;
+};
+
+} // namespace frostbite2D

Game/include/character/states/CharacterStateRegistry.h

@@ -0,0 +1,13 @@
+#pragma once
+
+#include "character/CharacterDataLoader.h"
+
+namespace frostbite2D {
+
+class CharacterStateMachine;
+
+void RegisterCommonCharacterStates(CharacterStateMachine& machine);
+void RegisterJobCharacterStates(CharacterStateMachine& machine,
+                                const character::CharacterConfig& config);
+
+} // namespace frostbite2D

Game/include/character/states/common/DeadState.h

@@ -0,0 +1,15 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class DeadState : public CharacterStateBase {
+public:
+  DeadState();
+
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/FallState.h

@@ -0,0 +1,18 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class FallState : public CharacterStateBase {
+public:
+  FallState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/HurtState.h

@@ -0,0 +1,21 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class HurtState : public CharacterStateBase {
+public:
+  HurtState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+  void OnExit(CharacterStateMachine& machine,
+              CharacterStateContext& context,
+              CharacterStateId nextState) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/IdleState.h

@@ -0,0 +1,18 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class IdleState : public CharacterStateBase {
+public:
+  IdleState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/JumpState.h

@@ -0,0 +1,18 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class JumpState : public CharacterStateBase {
+public:
+  JumpState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/LandingState.h

@@ -0,0 +1,18 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class LandingState : public CharacterStateBase {
+public:
+  LandingState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/common/MoveState.h

@@ -0,0 +1,18 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class MoveState : public CharacterStateBase {
+public:
+  MoveState();
+
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+};
+
+} // namespace frostbite2D

Game/include/character/states/jobs/swordman/SwordmanAttackState.h

@@ -0,0 +1,23 @@
+#pragma once
+
+#include "character/states/CharacterStateBase.h"
+
+namespace frostbite2D {
+
+class SwordmanAttackState : public CharacterStateBase, public ICharacterActionStateNode {
+public:
+  SwordmanAttackState();
+
+  bool TryEnter(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+  void OnEnter(CharacterStateMachine& machine,
+               CharacterStateContext& context,
+               CharacterStateId previousState) override;
+  void OnUpdate(CharacterStateMachine& machine,
+                CharacterStateContext& context) override;
+  void OnExit(CharacterStateMachine& machine,
+              CharacterStateContext& context,
+              CharacterStateId nextState) override;
+};
+
+} // namespace frostbite2D