使用文件存储

当你希望在不引入外部数据库的情况下，用文件系统持久化 threads、runs 和 messages 时，使用本页。

前置条件

• awaken-stores 启用了 file feature

步骤

1. 添加依赖：

[dependencies]
awaken-stores = { version = "...", features = ["file"] }

如果使用 awaken 门面 crate，也建议直接加 awaken-stores 来启用 file feature。

2. 创建 FileStore：

use std::sync::Arc;
use awaken::stores::FileStore;

let store = Arc::new(FileStore::new("./data"));

目录会在首次写入时自动创建，布局如下：

./data/
  threads/<thread_id>.json
  messages/<thread_id>.json
  runs/<run_id>.json

3. 接入 runtime：

use awaken::AgentRuntimeBuilder;

let runtime = AgentRuntimeBuilder::new()
    .with_thread_run_store(store)
    .with_agent_spec(spec)
    .with_provider("anthropic", Arc::new(provider))
    .build()?;

4. 生产环境建议使用绝对路径：

use std::path::PathBuf;

let data_dir = PathBuf::from("/var/lib/myapp/awaken");
let store = Arc::new(FileStore::new(data_dir));

验证

运行 agent 后检查目录，应该看到 threads/、messages/、runs/ 下生成了 JSON 文件。

常见错误

相关示例

crates/awaken-stores/src/file.rs

关键文件

• crates/awaken-stores/Cargo.toml
• crates/awaken-stores/src/file.rs
• crates/awaken-stores/src/lib.rs

相关

• 构建 Agent
• 使用 Postgres 存储