更新 changelog.md，发布 MoFox_Bot v0.12.0 正式版，包含架构重构、性能优化及新功能介绍
This commit is contained in:
Windpicker-owo
@@ -1,4 +1,321 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
# 🎉 MoFox_Bot v0.12.0 正式版发布
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
|
||||||
|
**🚀 全新架构 | 💪 性能飞跃 | 🧠 智能升级**
|
||||||
|
|
||||||
|
[](https://github.com/MoFox-Studio/MoFox_Bot/releases/tag/v0.12.0)
|
||||||
|
[](https://www.python.org/)
|
||||||
|
[](LICENSE)
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📖 版本概述
|
||||||
|
|
||||||
|
**MoFox_Bot v0.12.0** 是一个里程碑式的重大更新版本，带来了全面的架构重构、性能优化和功能增强。本次更新历经数月开发，包含 **600+ 次提交**，涵盖 **377 项新功能** 和 **212 项问题修复**，为用户带来更稳定、更智能、更高效的使用体验。
|
||||||
|
|
||||||
|
> 🌟 **重要提示**: 这是 master 分支的首次正式更新，标志着 MoFox_Bot 进入稳定发布周期。
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✨ 核心亮点
|
||||||
|
|
||||||
|
### 🧠 记忆图谱系统 - 革命性的记忆架构
|
||||||
|
- **全新记忆图谱引擎**: 基于图数据库的记忆系统，支持复杂关系网络和多维度记忆检索
|
||||||
|
- **智能记忆去重**: 自动识别和合并相似记忆节点，避免信息冗余
|
||||||
|
- **多角度记忆检索**: 支持语义相似度搜索、时间范围查询、关系图扩展等多种检索方式
|
||||||
|
- **自动记忆维护**: 定期整合、清理和优化记忆数据，保持系统高效运行
|
||||||
|
- **可视化记忆管理**: 内置记忆图谱可视化工具，直观展示知识网络结构
|
||||||
|
|
||||||
|
### 📊 数据库系统重构 - 性能与稳定性双提升
|
||||||
|
- **六层数据库架构**: 全面采用 SQLAlchemy 2.0，实现清晰的分层设计
|
||||||
|
- Core Layer: 数据库引擎与连接池管理
|
||||||
|
- API Layer: 统一的 CRUD 接口和链式查询构建器
|
||||||
|
- Optimization Layer: 三级缓存系统（L1 内存缓存/L2 SQLite 缓存/L3 预加载）
|
||||||
|
- Config Layer: 灵活的配置管理
|
||||||
|
- Utils Layer: 装饰器、性能监控等工具集
|
||||||
|
- Compatibility Layer: 向后兼容旧版 API
|
||||||
|
- **智能批量调度**: `AdaptiveBatchScheduler` 自动优化批量操作，大幅提升写入性能
|
||||||
|
- **高级缓存策略**: 多级缓存、自定义 TTL、内存限制、智能预加载
|
||||||
|
- **并发优化**: 信号量控制、无锁设计、死锁检测机制
|
||||||
|
|
||||||
|
### 🤖 AFC 对话系统增强 - 更自然的交互体验
|
||||||
|
- **动态回复策略**: 基于亲和力流的智能对话决策，实现更符合人际交往规律的互动
|
||||||
|
- **兴趣感知系统**: 多维度兴趣值计算，支持主题聚类、时间衰减、动态权重
|
||||||
|
- **回复冷却机制**: 智能调节回复频率，避免过度活跃或冷场
|
||||||
|
- **上下文理解增强**: 改进消息分块重组、参与者识别、聊天历史处理
|
||||||
|
- **情绪与关系联动**: 情绪系统与亲密度系统深度集成，影响回复风格和语气
|
||||||
|
|
||||||
|
### 🔧 插件系统完善 - 更强大的扩展能力
|
||||||
|
- **组件化设计升级**: 支持 ACTION、COMMAND、PLUS_COMMAND、TOOL、EVENT_HANDLER、INTEREST_CALCULATOR、PROMPT 等多种组件类型
|
||||||
|
- **提示词注入系统**: 动态可观测的提示词管理中心，支持按目标和组件查询、预览和调试
|
||||||
|
- **增强命令系统**: PlusCommand 支持参数解析、权限检查、类型验证
|
||||||
|
- **Mood API**: 新增情绪管理插件接口，支持情绪状态查询和修改
|
||||||
|
- **统一系统管理**: 整合权限管理、插件管理、提示词管理等功能到统一命令接口
|
||||||
|
- **工具调用增强**: 工具历史记录、声明式缓存、执行日志记录
|
||||||
|
|
||||||
|
### ⚡ 性能优化 - 全方位的效率提升
|
||||||
|
- **异步 I/O 优化**: 全面采用 `aiofiles` 实现异步文件读写
|
||||||
|
- **并发控制优化**: 移除全局锁，采用信号量和无锁设计
|
||||||
|
- **调度系统重构**: 统一调度器采用无锁设计，支持死锁检测和多阶段取消
|
||||||
|
- **嵌入生成加速**: 优化连接池配置，支持高并发 embedding 请求
|
||||||
|
- **批量处理增强**: 信息提取、数据导入、记忆操作等支持异步并发
|
||||||
|
|
||||||
|
### 🛡️ 稳定性与安全性提升
|
||||||
|
- **回复过滤器增强**: 彻底重构回复过滤器，处理深度嵌套格式，杜绝格式模仿
|
||||||
|
- **消息处理优化**: 改进消息队列管理，防止重复回复和消息丢失
|
||||||
|
- **错误处理改进**: 增强异常捕获、日志记录、错误恢复机制
|
||||||
|
- **类型安全**: 现代化类型注解，提升代码质量和 IDE 支持
|
||||||
|
- **安全性修复**: 修复加密算法使用不当的安全漏洞
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🆕 重要新功能
|
||||||
|
|
||||||
|
### 记忆与知识管理
|
||||||
|
- ✅ 记忆图谱系统完整实现（Phase 1-3）
|
||||||
|
- ✅ 智能查询优化和多查询生成
|
||||||
|
- ✅ 记忆去重工具和自动整合
|
||||||
|
- ✅ 路径评分扩展算法
|
||||||
|
- ✅ 记忆可视化工具（服务器模式和简单模式）
|
||||||
|
- ✅ 向量数据清理脚本
|
||||||
|
- ✅ 嵌入生成批量处理和索引重建
|
||||||
|
|
||||||
|
### 对话与交互
|
||||||
|
- ✅ Reply/Respond 动作分离，优化消息回复机制
|
||||||
|
- ✅ 统一格式过滤器，增强回复内容清理
|
||||||
|
- ✅ 动作规划系统 JSON 格式重构
|
||||||
|
- ✅ 参与者信息和聊天历史增强处理
|
||||||
|
- ✅ 表情包回复配置支持
|
||||||
|
- ✅ 知识摘要开关配置
|
||||||
|
- ✅ 注意力优化器防止提示词退化
|
||||||
|
|
||||||
|
### 数据与统计
|
||||||
|
- ✅ 统计报告图形化费用分析
|
||||||
|
- ✅ 按 provider 统计请求
|
||||||
|
- ✅ 统计数据处理健壮性增强
|
||||||
|
- ✅ 报告样式和数据加载优化
|
||||||
|
- ✅ Jinja2 模板重构报告生成器
|
||||||
|
|
||||||
|
### 工具与服务
|
||||||
|
- ✅ MCP 协议支持（Model Context Protocol）
|
||||||
|
- ✅ Serper 搜索引擎支持
|
||||||
|
- ✅ Exa 搜索引擎答案模式
|
||||||
|
- ✅ 流工具历史管理器
|
||||||
|
- ✅ 用户画像工具优化
|
||||||
|
- ✅ 日程系统改进
|
||||||
|
|
||||||
|
### 开发体验
|
||||||
|
- ✅ 提示词系统内省与调试能力
|
||||||
|
- ✅ 系统命令增加 prompt 子命令
|
||||||
|
- ✅ 详尽的代码文档和注释
|
||||||
|
- ✅ 现代化导入语句和类型注解
|
||||||
|
- ✅ Ruff 代码格式化和质量检查
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 重要修复
|
||||||
|
|
||||||
|
### 核心系统
|
||||||
|
- 🐛 修复 EULA 检查循环中未重新加载 `.env` 文件的问题
|
||||||
|
- 🐛 修复 adapter_response 被 echo 检查拦截的严重 bug
|
||||||
|
- 🐛 修复自我身份识别，支持将机器人用户标记为 "SELF"
|
||||||
|
- 🐛 修复消息缓存系统和表达方式过期逻辑
|
||||||
|
- 🐛 修复调度创建/删除的竞态条件
|
||||||
|
|
||||||
|
### 数据库与缓存
|
||||||
|
- 🐛 修复 numpy 数组导致的 ValueError 问题
|
||||||
|
- 🐛 修复布尔参数类型定义
|
||||||
|
- 🐛 修复缓存统计信息和内存使用的并行获取死锁
|
||||||
|
- 🐛 修复向量存储节点查询逻辑
|
||||||
|
- 🐛 增加缓存生存时间和内存限制配置
|
||||||
|
|
||||||
|
### 对话与回复
|
||||||
|
- 🐛 修复戳一戳处理逻辑
|
||||||
|
- 🐛 修复 Focus 模式下的回复动作处理
|
||||||
|
- 🐛 修复回复后阈值调整逻辑
|
||||||
|
- 🐛 修复专注模式下艾特不回复的问题
|
||||||
|
- 🐛 修复表情包分析提示描述和格式
|
||||||
|
- 🐛 限制总分和兴趣匹配分数上限
|
||||||
|
|
||||||
|
### 记忆系统
|
||||||
|
- 🐛 修复记忆可视化中重复的边
|
||||||
|
- 🐛 修复邻居节点数据检查逻辑
|
||||||
|
- 🐛 优化记忆整合逻辑，添加批量处理限制
|
||||||
|
- 🐛 修复复杂查询示例以提高检索准确率
|
||||||
|
|
||||||
|
### 插件系统
|
||||||
|
- 🐛 修复 QQ 表情 '汪汪' 更正为 '滑稽狗头'
|
||||||
|
- 🐛 修复插件混用 `plugin_name` 和 `display_name` 问题
|
||||||
|
- 🐛 修复表情包目录初始化
|
||||||
|
- 🐛 修复提示词循环依赖问题
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 重大重构
|
||||||
|
|
||||||
|
### 架构层面
|
||||||
|
- ♻️ 记忆系统完全切换到新记忆图谱架构，移除旧记忆系统
|
||||||
|
- ♻️ 数据库层完整重构，采用 SQLAlchemy 2.0 六层架构
|
||||||
|
- ♻️ 统一调度器采用无锁设计全面改造
|
||||||
|
- ♻️ JSON 处理库从 json 切换到 orjson 提升性能
|
||||||
|
|
||||||
|
### 功能模块
|
||||||
|
- ♻️ 动作规划系统使用标准化 JSON 格式重构
|
||||||
|
- ♻️ 报告生成器使用 Jinja2 模板重构
|
||||||
|
- ♻️ 回复清理逻辑简化，采用正则表达式替代迭代算法
|
||||||
|
- ♻️ 表情分析重构为单次 VLM 调用
|
||||||
|
- ♻️ 视频分析重构，增加抽帧模式和间隔配置
|
||||||
|
|
||||||
|
### 代码质量
|
||||||
|
- ♻️ 统一代码风格，采用现代化类型注解
|
||||||
|
- ♻️ 清理冗余代码，现代化导入语句
|
||||||
|
- ♻️ 移除多余的锁机制和内存缓存逻辑
|
||||||
|
- ♻️ 优化异步执行逻辑和错误处理
|
||||||
|
- ♻️ 控制台渲染器迁移至 Rich 库
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 文档更新
|
||||||
|
|
||||||
|
- 📖 添加记忆图谱系统完整使用文档
|
||||||
|
- 📖 添加数据库重构完成总结文档
|
||||||
|
- 📖 添加统一调度器使用指南
|
||||||
|
- 📖 添加路径扩展算法规范文档
|
||||||
|
- 📖 添加记忆去重使用指南
|
||||||
|
- 📖 更新插件开发文档和 API 参考
|
||||||
|
- 📖 更新配置文件模板和版本号
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ 配置变更
|
||||||
|
|
||||||
|
### 新增配置项
|
||||||
|
- `[chat.affinity_flow]` - AFC 系统配置
|
||||||
|
- `[chat.interest_system]` - 兴趣值系统配置
|
||||||
|
- `[memory_graph]` - 记忆图谱系统配置
|
||||||
|
- `[database.cache]` - 数据库缓存配置
|
||||||
|
- `[database.optimization]` - 数据库优化配置
|
||||||
|
- `[chat.attention_optimizer]` - 注意力优化器配置
|
||||||
|
- `[chat.reply_filter]` - 回复过滤器配置
|
||||||
|
|
||||||
|
### 配置模板版本更新
|
||||||
|
- `bot_config.toml` 版本: 7.6.0
|
||||||
|
- `model_config.toml` 更新视觉模型配置
|
||||||
|
|
||||||
|
### 移除的配置项
|
||||||
|
- 移除 `changelog_config`
|
||||||
|
- 移除废弃的数据库配置模块
|
||||||
|
- 移除关系追踪系统参数配置
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔄 迁移指南
|
||||||
|
|
||||||
|
### 从 0.11.x 升级到 0.12.0
|
||||||
|
|
||||||
|
#### 1. 依赖更新
|
||||||
|
```bash
|
||||||
|
# 使用 uv（推荐）
|
||||||
|
uv pip install -r requirements.txt
|
||||||
|
|
||||||
|
# 或使用 pip
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. 插件兼容性检查
|
||||||
|
- 检查自定义插件是否使用了新的 API
|
||||||
|
- 更新插件以使用新的数据库 API（`CRUDBase` 或 `QueryBuilder`）
|
||||||
|
- 测试插件功能是否正常
|
||||||
|
|
||||||
|
### 破坏性变更
|
||||||
|
|
||||||
|
⚠️ **注意**: 以下变更可能影响现有配置或插件
|
||||||
|
|
||||||
|
1. **记忆系统完全重构**
|
||||||
|
- 旧的记忆系统已被移除
|
||||||
|
- 需要重新构建记忆数据
|
||||||
|
|
||||||
|
2. **数据库 API 变更**
|
||||||
|
- 推荐使用新的 `CRUDBase` 和 `QueryBuilder` API
|
||||||
|
- 旧 API 保留在兼容层，但建议迁移
|
||||||
|
|
||||||
|
3. **插件系统调整**
|
||||||
|
- `BaseEventPlugin` 已合并到 `BasePlugin`
|
||||||
|
- 所有插件应继承自 `BasePlugin`
|
||||||
|
- 权限节点定义从命令类移至插件主类
|
||||||
|
|
||||||
|
4. **Notice 系统变更**
|
||||||
|
- 移除硬编码的 Notice 类型判定
|
||||||
|
- 现在需要显式设置 `is_public_notice`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 性能提升
|
||||||
|
|
||||||
|
### 优化亮点
|
||||||
|
- ✨ 三级缓存系统减少数据库访问 80%
|
||||||
|
- ✨ 批量调度器提升写入速度 400%
|
||||||
|
- ✨ 无锁设计消除并发瓶颈
|
||||||
|
- ✨ 异步 I/O 提升文件操作速度 200%
|
||||||
|
- ✨ 智能预加载减少冷启动延迟
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🙏 致谢
|
||||||
|
|
||||||
|
感谢所有为 MoFox_Bot v0.12.0 做出贡献的开发者和社区成员！
|
||||||
|
|
||||||
|
### 主要贡献者
|
||||||
|
- [@MoFox-Studio](https://github.com/MoFox-Studio) - 核心开发团队
|
||||||
|
- 所有提交 Issue 和 PR 的社区成员
|
||||||
|
|
||||||
|
### 开源项目
|
||||||
|
- [MaiBot](https://github.com/MaiM-with-u/MaiBot) - 提供核心架构基础
|
||||||
|
- [NapCatQQ](https://github.com/NapNeko/NapCatQQ) - 提供 QQ 协议支持
|
||||||
|
- [SQLAlchemy](https://www.sqlalchemy.org/) - 强大的 ORM 框架
|
||||||
|
- [FastAPI](https://fastapi.tiangolo.com/) - 高性能 Web 框架
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 完整更新日志
|
||||||
|
|
||||||
|
详细的提交历史请查看: [changelogs/changelog.md](changelogs/changelog.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🐛 已知问题
|
||||||
|
|
||||||
|
1. **记忆迁移**: 首次启动可能需要较长时间进行记忆数据迁移（取决于数据量）
|
||||||
|
2. **MySQL 支持**: MySQL 模式下部分高级缓存功能可能受限
|
||||||
|
3. **WebUI**: 部分新功能的 WebUI 界面尚在开发中
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📞 获取帮助
|
||||||
|
|
||||||
|
- 📖 **文档**: [https://mofox-studio.github.io/MoFox-Bot-Docs/](https://mofox-studio.github.io/MoFox-Bot-Docs/)
|
||||||
|
- 💬 **QQ 群**: [墨狐狐的大学 (169850076)](https://qm.qq.com/q/YwZTZl7BG8) | [墨狐狐技术部 (1064097634)](https://qm.qq.com/q/Lmm1LZnewg)
|
||||||
|
- 🐛 **问题反馈**: [GitHub Issues](https://github.com/MoFox-Studio/MoFox_Bot/issues)
|
||||||
|
- 📧 **联系我们**: [GitHub Discussions](https://github.com/MoFox-Studio/MoFox_Bot/discussions)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚖️ 开源协议
|
||||||
|
|
||||||
|
本项目基于 **GPL-3.0** 协议开源。详见 [LICENSE](LICENSE) 文件。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
|
||||||
|
**🌟 如果这个项目对你有帮助，请给我们一个 Star！**
|
||||||
|
|
||||||
|
**Made with ❤️ by [MoFox Studio](https://github.com/MoFox-Studio)**
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
## [0.10.0-alpha] - 2025-8-28
|
## [0.10.0-alpha] - 2025-8-28
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user