9e52bb85a8a5e7c634c7908aef9c689d064d6301
feat(planner): 引入内心思考流,优化规划器推理与日志可读性 本次更新引入了“内心思考”机制,旨在取代原有简单的`reason`字段,使AI的决策过程更加透明、自然,并富有角色扮演的特色。这不仅增强了AI的人设表现力,也极大地提升了日志的可读性和调试效率。 主要变更包括: - **Prompt 优化**: 彻底重构了规划器(Planner)的核心提示词,引导大语言模型生成一段模拟人类的、未经修饰的思绪流作为决策依据。新的 Prompt 强调展现思考过程而非结论,并提供了详细的示例。 - **日志高亮与格式化**: 在日志系统中增加了对“内心思考:”关键词的特殊渲染逻辑。现在,AI的思考过程会在控制台中以醒目的粉色高亮并独立成段显示,让调试者可以一眼洞察AI的决策动机。 - **异步健壮性提升**: 重构了`_sync_db_get`函数,采用`asyncio.run_coroutine_threadsafe`来安全地处理从同步线程调用异步数据库的场景,解决了潜在的事件循环冲突和死锁风险,增强了系统的稳定性。 - **日志完整性**: 移除了对图片描述等日志内容的长度截断,确保在调试过程中可以查看完整信息,方便问题定位。
📖 项目介绍
MoFox_Bot 是一个基于 MaiCore 0.10.0 snapshot.5 版本的增强型 fork 项目。
我们在保留原版所有功能的基础上,进行了一系列的改进和功能拓展,致力于提供更强的稳定性、更丰富的功能和更流畅的用户体验
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
详细的安装和配置步骤,请务必参考我们的官方文档:
- Windows 用户部署指南: https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/deployment_guide.html
bot_config.toml究极详细教程: https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/bot_config_guide.html
⚙️ 配置要点
- 📝 核心配置: 修改
config/bot_config.toml中的基础设置,如 LLM API Key 等。 - 🤖 协议端配置: 设置 NapCatQQ 或其他兼容的 QQ 协议端,确保通信正常。
- 🗃️ 数据库配置: 根据需求选择 SQLite 或配置你的 MySQL 服务器。
- 🔌 插件配置: 在
config/plugins/目录下按需配置插件。
🙏 致谢
我们衷心感谢以下优秀的开源项目,没有它们,就没有 MoFox_Bot。
| 项目 | 描述 | 贡献 |
|---|---|---|
| 🎯 MaiM-with-u/MaiBot | 原版 MaiBot 项目 | 提供优秀的基础框架 |
| 🐱 NapNeko/NapCatQQ | 基于 NTQQ 的 Bot 协议端 | 现代化的 QQ 协议实现 |
| 🌌 internetsb/Maizone | 魔改空间插件 | 插件部分功能借鉴 |
⚠️ 注意事项
Caution
重要提醒
- 使用本项目前,你必须阅读并同意 📋 用户协议 (EULA.md)。
- 本应用生成的内容来自人工智能大模型,请仔细甄别其准确性,并请勿用于任何违反法律法规的用途。
- AI 生成的所有内容不代表本项目团队的任何观点和立场。
📄 开源协议
本项目基于 GPL-3.0 协议开源。
Copyright © 2025 MoFox Studio
Licensed under the GNU General Public License v3.0
Languages
Python
97.2%
HTML
1.7%
JavaScript
0.9%
CSS
0.2%