feat(interaction): 新增交互系统核心C++框架（6a-6f）

Source/ChildHood/Interaction/InteractableActor.h

@@ -0,0 +1,69 @@
+// ChildHood Project - 通用交互物 Actor 基类
+// 对应技术方案: docs/technical/交互系统-技术方案.md 第3节（类设计）
+// 职责：持有 Mesh + InteractableComponent，提供可被子类覆盖的交互回调
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameFramework/Actor.h"
+#include "InteractableActor.generated.h"
+
+class UInteractableComponent;
+
+/**
+ * AInteractableActor
+ *
+ * 通用交互物 Actor 基类。场景中的每个交互物（冰箱、门、NPC 等）
+ * 均为该类的实例或其子类的实例。
+ *
+ * 组成：
+ *   - UStaticMeshComponent* MeshComp（根组件，承载可视模型）
+ *   - UInteractableComponent* InteractableComp（交互逻辑与数据）
+ *
+ * 子类可覆盖 OnInteractStarted / OnInteractEnded 以实现类型特定行为，
+ * 如门开关时的 Mesh 旋转、拾取物的消失效果等。
+ */
+UCLASS()
+class AInteractableActor : public AActor
+{
+	GENERATED_BODY()
+
+public:
+
+	AInteractableActor();
+
+	// === 组件访问 ===
+
+	/** 获取静态网格组件 */
+	UFUNCTION(BlueprintCallable, Category = "Interact")
+	UStaticMeshComponent* GetMeshComp() const { return MeshComp; }
+
+	/** 获取交互组件 */
+	UFUNCTION(BlueprintCallable, Category = "Interact")
+	UInteractableComponent* GetInteractableComp() const { return InteractableComp; }
+
+	// === 可被子类覆盖的交互回调 ===
+
+	/**
+	 * 交互开始时调用（门开关切换、状态恢复时也调用）。
+	 * 默认实现：门类型根据开关状态对 Mesh 做 Yaw 旋转（开门+90度/关门0度）。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category = "Interact")
+	void OnInteractStarted(UInteractableComponent* Comp);
+	virtual void OnInteractStarted_Implementation(UInteractableComponent* Comp);
+
+	/** 交互结束时调用。默认为空实现，子类可覆盖。 */
+	UFUNCTION(BlueprintNativeEvent, Category = "Interact")
+	void OnInteractEnded(UInteractableComponent* Comp);
+	virtual void OnInteractEnded_Implementation(UInteractableComponent* Comp);
+
+protected:
+
+	/** 交互物的可视模型 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components", meta = (AllowPrivateAccess = "true"))
+	UStaticMeshComponent* MeshComp;
+
+	/** 交互物的交互组件（数据 + 检测 + 状态） */
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components", meta = (AllowPrivateAccess = "true"))
+	UInteractableComponent* InteractableComp;
+};