5bd59fe415
为了简化LLM的上下文并提高代码可维护性，对聊天记录中图片的处理方式进行了彻底重构。 旧系统使用 [图片1] 等占位符，并在消息头部附加一个独立的图片描述映射块。这种方式结构复杂，容易造成上下文分离。 新系统将图片描述直接内联到消息文本中，格式为 `[图片：一只猫]`，使聊天记录对LLM更加自然和易于理解。 主要变更： - **消息构建 (`chat_message_builder`):** 在构建可读消息时，异步将数据库中的 `[picid:...]` 标签直接替换为完整的 `[图片：描述]`。 - **废弃映射:** 移除了独立的图片映射信息块 (`build_pic_mapping_info` 函数)，所有信息都在消息内联。 - **图片处理 (`utils_image`):** `process_image` 流程现在同步返回完整的描述字符串，并增强了VLM调用的重试逻辑和缓存机制，提高了健壮性。 - **消息存储 (`storage`):** 在消息存入数据库前，将 `[图片：描述]` 转换为 `[picid:...]`，以保持存储规范化。 - **修复:** 增加了多处空值检查，提高了代码的稳定性。这不得之前稳定好用多了😋😋😋
🌟 MoFox_Bot
🚀 基于 MaiCore 的增强型 AI 智能体，功能更强大，体验更流畅
📖 项目简介
MoFox_Bot 是一个基于 MaiCore 0.10.0 snapshot.5 的增强型 fork 项目。我们保留了原项目几乎所有核心功能，并在此基础上进行了深度优化与功能扩展，致力于打造一个更稳定、更智能、更具趣味性的 AI 智能体。
[IMPORTANT] 第三方项目声明
本项目由 MoFox Studio 独立维护，为 MaiBot 的第三方分支，并非官方版本。所有更新与支持均由我们团队负责，与 MaiBot 官方无直接关系。
[WARNING] 迁移风险提示
由于我们对数据库结构进行了重构与优化，从官方 MaiBot 直接迁移至 MoFox_Bot 可能导致数据不兼容。请在迁移前务必备份原始数据，以避免信息丢失。
✨ 核心功能
🔧 原版功能（全部保留）
|
🚀 拓展功能
|
🔧 系统要求
💻 基础环境
| 项目 | 要求 |
|---|---|
| 🖥️ 操作系统 | Windows 10/11、macOS 10.14+、Linux (Ubuntu 18.04+) |
| 🐍 Python 版本 | Python 3.10 或更高版本 |
| 💾 内存 | 建议 ≥ 4GB 可用内存 |
| 💿 存储空间 | 建议 ≥ 2GB 可用空间 |
🛠️ 依赖服务
| 服务 | 描述 |
|---|---|
| 🤖 QQ 协议端 | NapCatQQ 或其他兼容协议端 |
| 🗃️ 数据库 | SQLite（默认）或 MySQL（可选） |
| 🔧 管理工具 | Chat2DB（可选，用于数据库可视化管理） |
🏁 快速开始
📦 安装与部署
Note
详细安装与配置指南请参考官方文档：
⚙️ 配置要点
- 📝 核心配置：编辑
config/bot_config.toml，设置 LLM API Key、Bot 名称等基础参数。 - 🤖 协议端配置：确保使用 NapCatQQ 或兼容协议端，建立稳定通信。
- 🗃️ 数据库配置：选择 SQLite（默认）或配置 MySQL 数据库连接。
- 🔌 插件配置：在
config/plugins/目录中启用或配置所需插件。
🙏 致谢
我们衷心感谢以下开源项目为本项目提供的坚实基础：
| 项目 | 描述 | 贡献 |
|---|---|---|
| 🎯 MaiM-with-u/MaiBot | 原版 MaiBot 框架 | 提供核心架构与设计 |
| 🐱 NapNeko/NapCatQQ | 高性能 QQ 协议端 | 实现稳定通信 |
| 🌌 internetsb/Maizone | 魔改空间插件 | 功能借鉴与启发 |
⚠️ 重要提示
Caution
请务必阅读以下内容：
- 本项目使用前，请仔细阅读并同意 用户协议 (EULA.md)。
- 本应用生成的内容由 AI 大模型提供，请谨慎甄别其准确性。
- 请勿将 AI 生成内容用于任何违法、违规或不当用途。
- 所有 AI 输出不代表 MoFox Studio 的立场或观点。
📄 开源协议
本项目基于 GPL-3.0 协议开源。
Copyright © 2025 MoFox Studio
Licensed under the GNU General Public License v3.0