conversation.py 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. """会话级对话记忆:维护单次会话的消息列表与中间状态"""
  2. from __future__ import annotations
  3. from typing import Any
  4. class ConversationMemory:
  5. """单次会话的对话记忆
  6. - messages:对话消息列表,每条形如 {role, content}
  7. - intermediate:七步链路中间产物(如已解析论文数、已抽取记录等)
  8. """
  9. def __init__(self) -> None:
  10. # 对话消息列表,每条 {role: str, content: str}
  11. self._messages: list[dict] = []
  12. # 中间状态存储,key -> value
  13. self._intermediate: dict[str, Any] = {}
  14. def add(self, role: str, content: str) -> None:
  15. """添加一条对话消息(role: system/user/assistant/tool 等)"""
  16. self._messages.append({"role": role, "content": content})
  17. def add_system(self, content: str) -> None:
  18. """添加 system 消息,插入到列表开头(保证 system 始终在前)"""
  19. # 若已存在 system 消息,则将新的 system 插入到所有 system 之后、其他消息之前
  20. insert_idx = 0
  21. for i, msg in enumerate(self._messages):
  22. if msg.get("role") == "system":
  23. insert_idx = i + 1
  24. else:
  25. break
  26. self._messages.insert(insert_idx, {"role": "system", "content": content})
  27. def get_messages(self) -> list[dict]:
  28. """返回全部消息(浅拷贝,避免外部直接修改内部状态)"""
  29. return list(self._messages)
  30. def get_recent(self, n: int = 10) -> list[dict]:
  31. """返回最近 n 条消息,防止上下文过长
  32. 注意:system 消息始终保留在最前,以保证系统提示不被截断
  33. """
  34. if n <= 0 or not self._messages:
  35. return []
  36. # 分离 system 消息与其他消息
  37. system_msgs = [m for m in self._messages if m.get("role") == "system"]
  38. non_system = [m for m in self._messages if m.get("role") != "system"]
  39. # 取非 system 消息的最近 n 条
  40. recent_non_system = non_system[-n:] if n < len(non_system) else non_system
  41. return system_msgs + recent_non_system
  42. def add_intermediate(self, key: str, value: Any) -> None:
  43. """存储中间状态(七步链路中间产物,如已解析论文数、已抽取记录等)"""
  44. self._intermediate[key] = value
  45. def get_intermediate(self, key: str, default: Any = None) -> Any:
  46. """读取中间状态,不存在则返回 default"""
  47. return self._intermediate.get(key, default)
  48. def clear(self) -> None:
  49. """清空对话消息与中间状态"""
  50. self._messages.clear()
  51. self._intermediate.clear()