fd5d951501fff4e807465a42c7dfa65bc6e8fd7b
引入了一个新的聊天交互机制:当机器人发送了包含“错别字”的消息后,会在短暂延迟后自动撤回该消息,并发送正确的版本。此功能旨在模拟更真实的人类打字行为,增加交互的趣味性和拟人化程度。 主要变更: - **错别字处理流程**: - `ResponseHandler`现在会识别出带有错别字的消息,并在发送后创建一个异步任务来处理后续的修正。 - 新增`handle_typo_correction`方法,该方法会随机延迟2-4秒,然后调用新的`recall_message` API撤回原消息,并重新发送修正后的内容。 - **API扩展**: - `send_api`中增加了`recall_message`函数,用于调用适配器执行消息撤回操作。 - `send_response`的返回值从单个字符串`reply_text`变更为元组`(reply_text, sent_messages)`,以便将已发送的消息信息(包括ID和类型)传递给上层调用者。 - **数据结构调整**: - `process_llm_response`的返回类型从`list[str]`调整为`list[dict[str, str]]`,以支持更复杂的响应类型,如包含原文、错别字和修正建议的`typo`类型。 - **代码优化与重构**: - 对`ChineseTypoGenerator`进行了大量的代码清理、注释补充和逻辑优化,使其代码更清晰、更易于维护。 - 修复了多处代码中的类型注解和潜在的空指针问题,提高了代码的健壮性。
📖 项目介绍
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%