From bb95ae934ae76b07f82566b4affcee9d62d08763 Mon Sep 17 00:00:00 2001 From: Windpicker-owo <3431391539@qq.com> Date: Thu, 13 Nov 2025 21:27:54 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20changelog.md=EF=BC=8C?= =?UTF-8?q?=E5=8F=91=E5=B8=83=20MoFox=5FBot=20v0.12.0=20=E6=AD=A3=E5=BC=8F?= =?UTF-8?q?=E7=89=88=EF=BC=8C=E5=8C=85=E5=90=AB=E6=9E=B6=E6=9E=84=E9=87=8D?= =?UTF-8?q?=E6=9E=84=E3=80=81=E6=80=A7=E8=83=BD=E4=BC=98=E5=8C=96=E5=8F=8A?= =?UTF-8?q?=E6=96=B0=E5=8A=9F=E8=83=BD=E4=BB=8B=E7=BB=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelogs/changelog.md | 317 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 317 insertions(+) diff --git a/changelogs/changelog.md b/changelogs/changelog.md index 33e6e5f23..d86cac843 100644 --- a/changelogs/changelog.md +++ b/changelogs/changelog.md @@ -1,4 +1,321 @@ # Changelog +# 🎉 MoFox_Bot v0.12.0 正式版发布 + +
+ +**🚀 全新架构 | 💪 性能飞跃 | 🧠 智能升级** + +[![Version](https://img.shields.io/badge/version-0.12.0-blue.svg)](https://github.com/MoFox-Studio/MoFox_Bot/releases/tag/v0.12.0) +[![Python](https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=edb641)](https://www.python.org/) +[![License](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE) + +
+ +--- + +## 📖 版本概述 + +**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) 文件。 + +--- + +
+ +**🌟 如果这个项目对你有帮助，请给我们一个 Star！** + +**Made with ❤️ by [MoFox Studio](https://github.com/MoFox-Studio)** + +
## [0.10.0-alpha] - 2025-8-28