Method append_message

tutorials/12_session_persistence.py:307–323

追加一条消息到 JSONL 文件。 这是最核心的写入操作。每条消息一行，追加到文件末尾。 对应 Reference: EP09 §2 Project.appendEntry() → enqueueWrite(filePath, entry)

(self, session_id: str, message: ConversationMessage)

        return os.path.join(self.base_dir, f"{session_id}.jsonl")

    def append_message(self, session_id: str, message: ConversationMessage):
        """
        追加一条消息到 JSONL 文件。

        这是最核心的写入操作。每条消息一行，追加到文件末尾。

        对应 Reference: EP09 §2
            Project.appendEntry() → enqueueWrite(filePath, entry)
        """
        path = self._session_path(session_id)
        entry = {
            "type": message.role,
            **message.to_dict(),
        }
        line = json.dumps(entry, ensure_ascii=False) + "\n"
        with open(path, "a") as f:
            f.write(line)

    def append_metadata(self, session_id: str, meta_type: str, data: dict):
        """