Class Session

tutorials/12_session_persistence.py:201–225

会话：消息的有序集合。 对应源码: session.rs:42-46 pub struct Session { pub version: u32, pub messages: Vec , }

@dataclass
class Session:
    """
    会话：消息的有序集合。

    对应源码: session.rs:42-46
        pub struct Session {
            pub version: u32,
            pub messages: Vec<ConversationMessage>,
        }
    """
    version: int = 1
    messages: list[ConversationMessage] = field(default_factory=list)
    session_id: str = ""

    def __post_init__(self):
        if not self.session_id:
            self.session_id = str(uuid.uuid4())[:12]

    def add_message(self, message: ConversationMessage):
        """
        添加消息，自动设置 parent_uuid 形成链表。
        """
        if self.messages:
            message.parent_uuid = self.messages[-1].uuid
        self.messages.append(message)


# ============================================================