Struct SessionMemory 

pub struct SessionMemory { /* private fields */ }

Session Memory 实现

使用 HashMap 存储会话期间的记忆，支持可选的文件持久化。

特性：

• Drop 时自动保存（如果 dirty）
• 原子文件写入
• 版本迁移支持

Implementations

impl SessionMemory

pub fn new(session_id: impl Into<String>) -> Self

创建新的 Session Memory（无持久化）

pub fn with_persistence( session_id: impl Into<String>, backend: Arc<dyn FileBackend>, auto_save: AutoSaveConfig, ) -> Self

创建带文件持久化的 Session Memory

pub fn with_persistent_storage( session_id: impl Into<String>, path: impl Into<PathBuf>, auto_save_on_drop: bool, ) -> Self

创建带持久化存储的 Session Memory（推荐使用）

这是 with_persistence 的简化版本，使用 JSON 后端。

参数

• session_id: 会话唯一标识符
• path: 存储文件路径
• auto_save_on_drop: 是否在 Drop 时自动保存

示例

let memory = SessionMemory::with_persistent_storage(
    "my-session",
    "session.json",
    true
);

pub fn with_json_backend( session_id: impl Into<String>, path: impl Into<PathBuf>, ) -> Self

创建带 JSON 文件持久化的 Session Memory

pub async fn load_from_file( session_id: impl Into<String>, path: impl Into<PathBuf>, ) -> Layer3Result<Self>

从文件加载已保存的会话

如果文件不存在，创建新的空会话。 如果文件存在，加载其中的数据并支持版本迁移。

pub async fn load_or_create( session_id: impl Into<String>, path: impl Into<PathBuf>, ) -> Layer3Result<Self>

尝试从文件加载，失败则创建新会话

pub async fn save(&self) -> Layer3Result<()>

手动保存到文件

pub fn session_id(&self) -> &str

获取会话 ID

pub fn changes_since_save(&self) -> usize

获取变更计数

pub fn is_dirty(&self) -> bool

检查是否有未保存的变更

pub fn persistence_path(&self) -> Option<&Path>

获取文件后端路径（如果有）

Trait Implementations

impl Default for SessionMemory

fn default() -> Self

Returns the “default value” for a type.

impl Drop for SessionMemory

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl MemoryStore for SessionMemory

fn tier(&self) -> MemoryTier

记忆层级

fn store<'life0, 'async_trait>( &'life0 self, entry: MemoryEntry, ) -> Pin<Box<dyn Future<Output = Layer3Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

存储记忆条目

fn get<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Layer3Result<Option<MemoryEntry>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

获取记忆条目

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Layer3Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

删除记忆条目

fn query<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 MemoryQuery, ) -> Pin<Box<dyn Future<Output = Layer3Result<Vec<MemoryEntry>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

查询记忆（按内容搜索）

fn list<'life0, 'async_trait>( &'life0 self, limit: Option<usize>, ) -> Pin<Box<dyn Future<Output = Layer3Result<Vec<MemoryEntry>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

列出所有记忆（按时间排序）

fn clear<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Layer3Result<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

清空该层所有记忆

fn count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Layer3Result<usize>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

记忆条目数量