89 lines
2.6 KiB
Python
89 lines
2.6 KiB
Python
from __future__ import annotations
|
||
|
||
from dataclasses import dataclass
|
||
from typing import Optional, Dict, Any, List
|
||
from enum import Enum
|
||
|
||
|
||
class ActionStatus(Enum):
|
||
"""
|
||
动作推进过程中的标准状态枚举。
|
||
- RUNNING: 仍在进行中，需要在未来的 tick 中继续推进
|
||
- COMPLETED: 已正常完成
|
||
- FAILED: 执行失败（参数/前置条件等导致）
|
||
- CANCELLED: 被外部取消（如被其他动作抢占）
|
||
- INTERRUPTED: 运行中被打断（如战斗/事件中断）
|
||
"""
|
||
|
||
RUNNING = "running"
|
||
COMPLETED = "completed"
|
||
FAILED = "failed"
|
||
CANCELLED = "cancelled"
|
||
INTERRUPTED = "interrupted"
|
||
|
||
|
||
@dataclass
|
||
class ActionResult:
|
||
"""
|
||
标准动作返回体。所有 Action.step() 必须返回该类型。
|
||
|
||
Attributes:
|
||
status: 当前推进后的状态（见 ActionStatus）
|
||
events: 在本次推进过程中生成的事件（通常由 Avatar 收集并展示）
|
||
payload: 可选的结构化数据，便于上层消费（如数值、战斗结果等）
|
||
next_action: 可选的“建议下一个动作”（名称, 参数）供上层调度策略参考
|
||
"""
|
||
|
||
status: ActionStatus
|
||
events: List[Any]
|
||
payload: Optional[Dict[str, Any]] = None
|
||
next_action: Optional[tuple[str, Dict[str, Any]]] = None
|
||
|
||
|
||
@dataclass
|
||
class ActionPlan:
|
||
"""
|
||
计划中的动作项：尚未提交执行。
|
||
仅包含 class 名与参数，外加可选的调度策略字段。
|
||
"""
|
||
action_name: str
|
||
params: Dict[str, Any]
|
||
priority: int = 0
|
||
expiry_month: Optional[int] = None # 到期月戳；None 为不过期
|
||
max_retries: int = 0
|
||
attempted: int = 0
|
||
|
||
def to_dict(self) -> dict:
|
||
"""转换为可序列化的字典"""
|
||
return {
|
||
"action_name": self.action_name,
|
||
"params": self.params,
|
||
"priority": self.priority,
|
||
"expiry_month": self.expiry_month,
|
||
"max_retries": self.max_retries,
|
||
"attempted": self.attempted
|
||
}
|
||
|
||
@classmethod
|
||
def from_dict(cls, data: dict) -> "ActionPlan":
|
||
"""从字典重建ActionPlan"""
|
||
return cls(
|
||
action_name=data["action_name"],
|
||
params=data["params"],
|
||
priority=data.get("priority", 0),
|
||
expiry_month=data.get("expiry_month"),
|
||
max_retries=data.get("max_retries", 0),
|
||
attempted=data.get("attempted", 0)
|
||
)
|
||
|
||
|
||
@dataclass
|
||
class ActionInstance:
|
||
"""
|
||
已提交并开始执行的动作实例。
|
||
"""
|
||
action: Any # src.classes.action.Action
|
||
params: Dict[str, Any]
|
||
status: str = "running" # 遗留字段：Avatar 以字符串记录运行态
|
||
|