消息存储

消息存储

Lingchu Bot 包含一个可选的消息存储服务，用于记录事件数据、处理结果、Bot 生命周期事件和平台 API 调用摘要。本页说明存储了什么、如何配置，以及如何访问存储的数据。

概述

消息存储在 services/message_store.py 中实现。它挂载到 NoneBot 的事件处理管道，记录结构化摘要而非原始消息内容。事件会经过仓储层模型选择，高频的平台 / 适配器 / 框架组合可以使用专用 ORM 表。

存储内容

每条记录包含平台、适配器、框架、事件类别和适配器事件类型字段。QQ + OneBot V11 + NoneBot 事件会写入专用分区表；不支持的组合回退到旧的全局表。

配置

数据保留

记录根据 message_store_retention_days 保留：

• 设置为正数时，超过指定天数的记录会被清理。
• 设置为 0 时，禁用基于天数的过期；记录将无限期保留。
• 当 message_store_cleanup_enabled 为 true 时，清理在 Bot 关闭期间运行。

平台识别

存储记录中的 platform 字段从适配器注册表派生：

只有 LINGCHUAdapter 选中的适配器决定平台值。其他已注册的适配器被忽略。

存储后端

消息存储使用 nonebot-plugin-orm 进行数据库访问。database/orm_crud.py 中的 ORM 辅助提供异步 CRUD 操作，在 worker thread 中运行以避免阻塞 NoneBot 事件循环。

禁用消息存储

要完全禁用消息存储：

{
  message_store_enabled: false,
}

禁用后，不会注册任何事件钩子，也不会写入任何记录。现有记录不会被自动删除。