tt-P607 2671a6e7e5 feat(profile):对用户关系和分析系统进行重构,采用结构化数据和异步更新
此提交完全重写了用户关系和分析系统,创建了一个更强大、详细和响应式的框架。旧系统已被弃用,取而代之的是一个集中式的`UserRelationships`模型。

主要变更:

1.  ‌**增强数据库模型(`UserRelationships`):**‌
    - 添加`impression_text`用于长期、叙述式印象。
    - 引入`key_facts`(JSON)存储结构化数据如生日、工作和位置。
    - 添加`relationship_stage`跟踪关系进展(如陌生人、朋友、挚友)。
    - 添加`first_met_time`和`last_impression_update`的时间戳。

2.  ‌**重设计`UserProfileTool`:**‌
    - 工具的用途被限定为仅捕捉重要新信息,防止用于小聊。
    - 更新现在在后台异步处理,确保机器人回复不被延迟。
    - 引入`key_info_type`和`key_info_value`参数供LLM提交结构化事实。

3.  ‌**复杂的印象和情感逻辑:**‌
    - 关系追踪LLM现在分析最近聊天历史生成更丰富、更上下文的印象。
    - 用渐进的`affection_change`(最大±0.03)取代直接情感分数设置,使关系发展更真实。

4.  ‌**数据源整合:**‌
    - `RelationshipFetcher`重构为仅依赖`UserRelationships`表作为唯一数据源。
    - 简化`get_user_relationship` API并移除其缓存,确保分析的实时数据访问。

破坏性变更:`UserProfileTool`已重设计,新增参数(`key_info_type`、`key_info_value`)并改变用途。移除`affection_score`参数。此外,`get_user_relationship`数据库API签名简化为仅接受`user_id`。
2025-12-03 16:53:40 +08:00
2025-08-11 19:34:18 +08:00
2025-11-26 21:16:16 +08:00
2025-10-31 21:32:06 +08:00
2025-10-02 20:26:01 +08:00
2025-08-11 19:34:18 +08:00
2025-11-29 19:22:06 +08:00
2025-08-11 19:34:18 +08:00
2025-08-30 14:15:39 +08:00
2025-11-21 19:03:06 +08:00

🌟 MoFox_Bot

🚀 基于 MaiCore 0.10.0 snapshot.5进一步开发的 AI 智能体,插件功能更强大

License Python 3.11+ Pyright Ruff Ask DeepWiki
QQ Group


📖 项目简介

MoFox_Bot 是一个基于 MaiCore 0.10.0 snapshot.5 的 fork 项目。我们保留了原项目几乎所有核心功能,并在此基础上进行了深度优化与功能扩展,致力于打造一个更稳定、更智能、更具趣味性的 AI 智能体。

[IMPORTANT] 第三方项目声明

本项目Fork后由 MoFox Studio 独立维护,为 MaiBot 的第三方分支,并非官方版本。所有更新与支持均由我们团队负责,后续的更新与 MaiBot 官方无直接关系。

[WARNING] 迁移风险提示

由于我们对数据库结构进行了重构与优化,从官方 MaiBot 直接迁移至 MoFox_Bot 可能导致数据不兼容。请在迁移前务必备份原始数据,以避免信息丢失。


核心功能

🔧 MaiBot 0.10.0 snapshot.5 原版功能

  • 🔌 强大插件系统 - 全面重构的插件架构,支持完整的管理 API 和权限控制
  • 💭 实时思维系统 - 模拟人类思考过程
  • 📚 表达学习功能 - 学习群友的说话风格和表达方式
  • 😊 情感表达系统 - 情绪系统和表情包系统
  • 🧠 持久记忆系统 - 基于图的长期记忆存储
  • 🎭 动态人格系统 - 自适应的性格特征和表达方式
  • 📊 数据分析 - 内置数据统计和分析功能,更好了解麦麦状态

🚀 拓展功能

  • 🧠 AFC 智能对话 - 基于亲和力流,实现兴趣感知和动态关系构建
  • 🔄 数据库切换 - 支持 SQLite 与 MySQL 自由切换,采用 SQLAlchemy 2.0 重新构建
  • 🛡️ 反注入集成 - 内置一整套回复前注入过滤系统,为人格保驾护航
  • 🎥 视频分析 - 支持多种视频识别模式,拓展原版视觉
  • 📅 日程系统 - 让MoFox规划每一天
  • 🧠 拓展记忆系统 - 支持瞬时记忆和长期记忆等多种记忆方式
  • 🎪 完善的 Event - 支持动态事件注册和处理器订阅,并实现了聚合结果管理
  • 🔍 内嵌魔改插件 - 内置联网搜索等诸多功能,等你来探索
  • 🔌 MCP 协议支持 - 集成 Model Context Protocol支持外部工具服务器连接仅 Streamable HTTP
  • 🌟 还有更多 - 请参阅详细修改 commits

🔧 系统要求

💻 基础环境

项目 要求
🖥️ 操作系统 Windows 10/11、macOS 10.14+、Linux (Ubuntu 18.04+)
🐍 Python 版本 Python 3.11 或更高版本
💾 内存 建议 ≥ 4GB 可用内存
💿 存储空间 建议 ≥ 4GB 可用空间

🛠️ 依赖服务

服务 描述
🤖 QQ 协议端 NapCatQQ 或其他兼容协议端
🗃️ 数据库 SQLite默认或 MySQL可选
🔧 管理工具 Chat2DB可选用于数据库可视化管理

🏁 快速开始

📦 安装与部署

Note

详细安装与配置指南请参考官方文档:

⚙️ 配置要点

  1. 📝 核心配置:编辑 config/bot_config.toml,设置 LLM API Key、Bot 名称等基础参数。
  2. 🤖 协议端配置:确保使用 NapCatQQ 或兼容协议端,建立稳定通信。
  3. 🗃️ 数据库配置:选择 SQLite默认或配置 MySQL 数据库连接。
  4. 🔌 插件配置:在 config/plugins/ 目录中启用或配置所需插件。

🙏 致谢

我们衷心感谢以下开源项目为本项目提供的坚实基础:

项目 描述 贡献
🎯 MaiM-with-u/MaiBot 原版 MaiBot 框架 提供核心架构与设计
🐱 NapNeko/NapCatQQ 高性能 QQ 协议端 实现稳定通信
🌌 internetsb/Maizone 魔改空间插件 功能借鉴与启发

如果可以的话,请为这些项目也点个 (尤其是MaiBot)


⚠️ 重要提示

Caution

请务必阅读以下内容:

  • 本项目使用前,请仔细阅读并同意 用户协议 (EULA.md)
  • 本应用生成的内容由 AI 大模型提供,请谨慎甄别其准确性。
  • 请勿将 AI 生成内容用于任何违法、违规或不当用途。
  • 所有 AI 输出不代表 MoFox Studio 的立场或观点。

📄 开源协议

本项目基于 GPL-3.0 协议开源。

GPL-3.0

                                   Copyright © 2025 MoFox Studio
                            Licensed under the GNU General Public License v3.0

🌟 如果这个项目对你有帮助,请给我们一个 Star

💬 有任何问题或建议?欢迎提交 Issue 或 Pull Request

💬 点击加入 QQ 交流群

Made with ❤️ by MoFox Studio

Description
No description provided
Readme GPL-3.0 73 MiB
Languages
Python 97.2%
HTML 1.7%
JavaScript 0.9%
CSS 0.2%