[Q&A] make setup 默认配置下，重启后历史会话不会恢复吗？

[zhuiyueya]

大家好，我使用 make setup 完成本地默认配置和安装，之后创建了一个会话并发送了多条消息。

我看到生成的 config.yaml 默认使用：

database:
  backend: sqlite

run_events:
  backend: memory

重启 DeerFlow 服务或电脑后，重新打开原来的会话，前端无法看到完整的历史消息，只能看到重启后产生的新消息。

我检查后发现 SQLite 中的 thread 和 checkpoint 仍然存在，但 run_events 使用内存后端，重启后会被清空。

请问这是当前的预期设计吗？也就是说，make setup 的默认配置只持久化 checkpoint，而不会持久化前端显示的会话历史？

[willem-bd]

你的排查基本正确。当前实现中，database 和 run_events 是两套独立的存储配置：

• database.backend: sqlite 持久化 thread、run 等应用数据，以及默认配置下的 checkpoint。
• run_events.backend: memory 把消息事件和执行轨迹保存在进程内存中，服务重启后会丢失；不会因为启用了 SQLite 就自动写入数据库。配置说明

但需要补充：checkpoint 不等于完整的聊天记录。前端也会加载最新 checkpoint 中仍保留的消息，所以不能简单理解为“重启后所有旧消息一定不可见”。完整历史分页依赖 run-event 存储，而 checkpoint 中的消息可能已经经过压缩或裁剪。历史读取说明

如果希望重启后保留完整会话历史，可以保留现有 SQLite 配置和数据目录，把根目录 config.yaml 中的事件后端改为：

database:
  backend: sqlite
  # 保留现有 sqlite_dir 等配置，不要切换数据目录

run_events:
  backend: db

随后重启 DeerFlow。这里的 db 可以使用 SQLite，并不要求部署 PostgreSQL。

注意，切换后会持久化后续消息，不会自动补回已经随重启丢失的内存事件。已有 checkpoint 中可能仍保留部分消息，但不能保证恢复完整历史。

因此，这确实是当前默认配置的实际结果；不过，从本地聊天产品的使用预期来看，默认 SQLite 搭配内存事件存储容易让人误以为“聊天记录已经全部持久化”，值得调整默认值，或在 make setup 中明确提示。

[zhuiyueya]

感谢确认和详细说明。我愿意继续为这个问题准备一个小范围 PR。

为了避免自行改变项目的默认存储策略，想先确认项目更倾向哪种处理方式：

1. 对 make setup 生成的本地 SQLite 配置，将 run_events.backend 默认设为 db，使后续完整会话历史默认能够跨重启保留；
2. 保持 memory 默认值不变，但在 setup 流程中明确说明完整消息和执行轨迹不会跨重启保留，并提示可以切换为 db。

如果更适合先增加提示、再单独讨论默认值，也可以拆成两个阶段。请问哪种方向更符合项目当前的规划？确认后我可以准备相应的实现和测试。