docs(technical): 交互系统技术方案 v1.0 重写：Effect/Action 数据驱动架构

2026-06-11 19:04:14 +08:00
parent ac7a3abda9
commit 2342b63fc2
4 changed files with 985 additions and 868 deletions
@@ -0,0 +1,31 @@
+---
+name: interaction-effect-architecture
+description: 交互系统 v1.0 Effect/Action 数据驱动架构决策记录
+metadata:
+  type: project
+---
+
+## 交互系统架构决策（v1.0 重构，2026-06-11）
+
+### 核心架构：Effect/Action 数据驱动
+
+交互物不关心"交互后发生什么"，只配置 Effect（由 Action 组成）交给 EffectManager 执行。
+
+**Why:** v0.1 用 switch(Type) 硬编码，新增交互类型需改代码。v1.0 配数据即可。
+
+### Manager 归属
+- FInteractionManager / FEffectManager 是普通 C++ 类，不是 UObject
+- 由 ASystemDriver (AInfo) 持有，随 World 生灭
+- 不依赖 UE Subsystem 生命周期，显式控制创建顺序和 Tick 顺序
+- 所有 UObject 引用用 TWeakObjectPtr，回调用 TFunction
+- GameInstance 不持有任何交互系统对象，只有 UPersistenceSubsystem 跨 World
+
+### 分层规则
+- 表现层只读 Manager 缓存（getter），不碰 Component
+- Manager 在选择变化时从 Component 读一次并缓存
+- 逻辑事件仅用于 "A 影响 B"（如 Consume → Persistence）
+
+### 协调方式
+- Character 输入回调通过 ASystemDriver::Get(World) 访问两个 Manager
+- Driver::BeginPlay 中 TFunction 连线 EffectManager.OnEffectComplete → Manager.OnInteractionFinished
+- PromptComponent 通过 Driver 获取 Manager，只读缓存