57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# Action Isolation Strategy (动作隔离策略)
|
||
|
||
## 背景
|
||
|
||
在修仙世界模拟中，角色会执行各种持续性动作（如闭关、战斗、移动等）。同时，系统存在各种全局机制（如拍卖会、大比、奇遇、霉运等）会尝试与角色互动。
|
||
|
||
此前存在的问题是：全局机制无视角色当前状态，导致“正在闭关的角色跑去参加拍卖会”或“闭关时路边捡到神兵”等逻辑违和现象。
|
||
|
||
## 解决方案：Trait-based Declarative Control
|
||
|
||
我们采用“基于特性的声明式控制”方案，将“是否允许被打扰”的定义权下放给 `Action` 类本身。
|
||
|
||
### 1. Action 基类定义
|
||
|
||
在 `src/classes/action/action.py` 中，所有动作默认开放交互：
|
||
|
||
```python
|
||
class Action(ABC):
|
||
# ...
|
||
# 是否允许参与聚会（如拍卖会、大比）
|
||
ALLOW_GATHERING: bool = True
|
||
|
||
# 是否允许触发世界随机事件（如奇遇、霉运）
|
||
ALLOW_WORLD_EVENTS: bool = True
|
||
```
|
||
|
||
### 2. 特定动作重写策略
|
||
|
||
例如 `Retreat` (闭关) 动作 (`src/classes/action/retreat.py`) 需要与世隔绝：
|
||
|
||
```python
|
||
class Retreat(TimedAction):
|
||
# ...
|
||
# 闭关期间，不问世事，不染因果
|
||
ALLOW_GATHERING = False
|
||
ALLOW_WORLD_EVENTS = False
|
||
```
|
||
|
||
### 3. Avatar 状态检查接口
|
||
|
||
在 `Avatar` (`src/classes/avatar/action_mixin.py`) 中封装了状态检查属性：
|
||
|
||
- `avatar.can_join_gathering`: 检查当前动作是否允许参加聚会。
|
||
- `avatar.can_trigger_world_event`: 检查当前动作是否允许触发奇遇/霉运。
|
||
|
||
### 4. 外部调用规范
|
||
|
||
- **Gathering (如 Auction)**: 在获取参与者列表时，必须过滤 `can_join_gathering` 为 True 的角色。
|
||
- **Passive Effects (Fortune/Misfortune)**: 在触发前，必须检查 `can_trigger_world_event` 为 True。
|
||
|
||
## 扩展指南
|
||
|
||
当你创建一个新的 Action 时：
|
||
- 如果该动作需要角色全神贯注（如“突破”、“炼丹”），应考虑将 `ALLOW_GATHERING` 设为 `False`。
|
||
- 如果该动作处于特殊空间或心流状态（如“心魔劫”、“顿悟”），应考虑将 `ALLOW_WORLD_EVENTS` 设为 `False`。
|
||
- 默认情况下不需要做任何修改。
|