LivingMemory v2.0 - 动态生命周期记忆插件
版本: v2.0.0 (重构版) | 作者: lxfight | 许可证: AGPLv3
🎉 v2.0 重大更新
v2.0是一个完全重构的版本，在保持所有功能的同时，大幅提升了代码质量和可维护性。
主要改进
- 架构重构: main.py从1662行简化到300行
- 模块化设计: 拆分为5个独立模块，职责清晰
- 错误处理: 统一的异常体系和错误码
- 配置管理: 集中化配置加载和验证
- 测试基础: 完整的测试框架和初步测试
- 文档完善: 详细的功能分析和重构文档
详见 CHANGELOG.md
核心特性
- 混合检索: 结合 BM25 稀疏检索和 Faiss 向量检索，使用 RRF 融合算法
- 智能总结: 使用 LLM 自动总结对话历史，生成结构化记忆
- 会话隔离: 支持按人格和会话隔离记忆
- 自动遗忘: 基于时间和重要性的智能清理机制
- WebUI 管理: 可视化记忆管理界面
快速开始
安装
将插件文件夹放置于 AstrBot 的 data/plugins 目录下，AstrBot 将自动安装依赖。
配置
通过 AstrBot 控制台的插件配置页面进行配置：
必需配置:
embedding_provider_id: 向量嵌入模型 ID（留空使用默认）llm_provider_id: 大语言模型 ID（留空使用默认）
WebUI 配置:
{
"webui_settings": {
"enabled": true,
"host": "127.0.0.1",
"port": 8080,
"access_password": "your_password"
}
}
命令
| 命令 | 说明 |
|---|---|
/lmem status |
查看记忆库状态 |
/lmem search <query> [k] |
搜索记忆 |
/lmem forget <id> |
删除指定记忆 |
/lmem rebuild-index |
重建索引 |
/lmem webui |
查看 WebUI 信息 |
/lmem reset |
重置当前会话记忆上下文 |
/lmem help |
显示帮助 |
架构说明（v2.0新增）
模块结构
astrbot_plugin_livingmemory/
├── main.py # 插件注册和生命周期管理
├── core/
│ ├── exceptions.py # 自定义异常定义
│ ├── config_manager.py # 配置管理器
│ ├── plugin_initializer.py # 插件初始化器
│ ├── event_handler.py # 事件处理器
│ ├── command_handler.py # 命令处理器
│ ├── memory_engine.py # 记忆引擎
│ ├── memory_processor.py # 记忆处理器
│ ├── conversation_manager.py # 会话管理器
│ └── ...
├── storage/ # 存储层
├── webui/ # Web管理界面
├── tests/ # 测试套件
└── docs/ # 文档
核心组件
PluginInitializer: 负责插件初始化
- 非阻塞初始化机制
- Provider等待和重试
- 自动数据库迁移
EventHandler: 处理事件钩子
- 群聊消息捕获
- 记忆召回
- 记忆反思
CommandHandler: 处理命令
- 统一命令响应格式
- 完善的错误处理
ConfigManager: 配置管理
- 集中配置加载
- 配置验证
- 嵌套键访问
开发者指南
测试
# 运行所有测试
pytest tests/
# 运行特定测试
pytest tests/test_config_manager.py
# 查看覆盖率
pytest --cov=core tests/
文档
数据迁移（v1.4.0-1.4.2）
如果您从 v1.4.0-1.4.2 版本升级，旧数据可能无法自动迁移。手动恢复步骤：
- 找到备份文件：
data/plugin_data/astrbot_plugin_livingmemory/backups/livingmemory_backup_<时间戳>.db - 将该文件移动到：
data/plugin_data/astrbot_plugin_livingmemory/ - 重命名为：
livingmemory.db - 重载插件，系统会自动加载和处理数据
更新记录
v2.0.0 (2025-12-17) - 重大重构
架构改进:
- 模块化设计，main.py从1662行简化到300行
- 新增5个核心模块，职责清晰
- 统一的异常处理和配置管理
代码质量:
- 代码覆盖率提升
- 完整的测试基础设施
- 详细的文档和注释
向后兼容:
- ✅ 所有功能完全保留
- ✅ 数据库完全兼容
- ✅ 配置文件完全兼容
详见 CHANGELOG.md
支持
- GitHub: astrbot_plugin_livingmemory
- 问题反馈: GitHub Issues
- QQ 群:
（口令：lxfight）
许可证
本项目遵循 AGPLv3 许可证。