diff --git a/README.md b/README.md index 84e70de0b..879f70112 100644 --- a/README.md +++ b/README.md @@ -1,61 +1,63 @@
# 🌟 MoFox_Bot -**🚀 基于 MaiCore 的增强版 AI 智能体，提供更完善的功能和更好的使用体验** +**🚀 基于 MaiCore 的增强型 AI 智能体，功能更强大，体验更流畅** +

- - license + + License - python - - pyright + + Python 3.11+ + + + Pyright - ruff - Ask DeepWiki + Ruff + + + Ask DeepWiki
- QQ Chat Group + QQ Group - - QQ Chat Group + + QQ Group

- + --- - +
- -## 📖 项目介绍 - -**MoFox_Bot** 是一个基于 [MaiCore](https://github.com/MaiM-with-u/MaiBot) `0.10.0 snapshot.5` 版本的增强型 `fork` 项目。 -我们在保留原版几乎所有功能的基础上，进行了一系列的改进和功能拓展，致力于提供更强的稳定性、更丰富的功能和更流畅的用户体验 - + +## 📖 项目简介 + +**MoFox_Bot** 是一个基于 [MaiCore](https://github.com/MaiM-with-u/MaiBot) `0.10.0 snapshot.5` 的增强型 fork 项目。我们保留了原项目几乎所有核心功能，并在此基础上进行了深度优化与功能扩展，致力于打造一个**更稳定、更智能、更具趣味性**的 AI 智能体。 + > [!IMPORTANT] > **第三方项目声明** > -> 本项目是由 **MoFox Studio** 独立维护的第三方项目，并非 MaiBot 官方版本。 -> 所有后续更新和维护均由我们团队负责，与 MaiBot 官方无直接关系。 - +> 本项目由 **MoFox Studio** 独立维护，为 **MaiBot 的第三方分支**，并非官方版本。所有更新与支持均由我们团队负责，与 MaiBot 官方无直接关系。 + > [!WARNING] > **迁移风险提示** > -> 由于我们对数据库结构进行了重构和优化，从 MaiBot 官方版本直接迁移到 MoFox_Bot **可能会遇到数据不兼容的问题**。 -> 在迁移前，请务必做好数据备份。 - +> 由于我们对数据库结构进行了重构与优化，从官方 MaiBot 直接迁移至 MoFox_Bot **可能导致数据不兼容**。请在迁移前**务必备份原始数据**，以避免信息丢失。 +
- + --- - +
- -## ✨ 功能特性 - + +## ✨ 核心功能 +
- +
@@ -89,93 +91,93 @@
- + --- - +
- + ## 🔧 系统要求 - + ### 💻 基础环境 - -| 项目 | 要求 | -| ------------ | ---------------------------------------------------- | -| 🖥️ 操作系统 | Windows 10/11, macOS 10.14+, Linux (Ubuntu 18.04+) | -| 🐍 Python 版本 | Python 3.10 或更高版本 | -| 💾 内存 | 建议 4GB 以上可用内存 | -| 💿 存储空间 | 至少 2GB 可用空间 | - + +| 项目 | 要求 | +| ------------ | ---------------------------------------- | +| 🖥️ 操作系统 | Windows 10/11、macOS 10.14+、Linux (Ubuntu 18.04+) | +| 🐍 Python 版本 | Python 3.10 或更高版本 | +| 💾 内存 | 建议 ≥ 4GB 可用内存 | +| 💿 存储空间 | 建议 ≥ 2GB 可用空间 | + ### 🛠️ 依赖服务 - + | 服务 | 描述 | | ------------ | ------------------------------------------ | | 🤖 QQ 协议端 | [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 或其他兼容协议端 | -| 🗃️ 数据库 | SQLite (内置) 或 MySQL (可选) | -| 🔧 管理工具 | Chat2DB (可选，用于数据库管理) | - -
- +| 🗃️ 数据库 | SQLite（默认）或 MySQL（可选） | +| 🔧 管理工具 | Chat2DB（可选，用于数据库可视化管理） | + --- - +
- + ## 🏁 快速开始 - + ### 📦 安装与部署 - -
- + > [!NOTE] -> 详细的安装和配置步骤，请务必参考我们的官方文档： -> * **Windows 用户部署指南**: [https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/deployment_guide.html](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](https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/bot_config_guide.html) - -
- -### ⚙️ 配置要点 - -1. 📝 **核心配置**: 修改 `config/bot_config.toml` 中的基础设置，如 LLM API Key 等。 -2. 🤖 **协议端配置**: 设置 NapCatQQ 或其他兼容的 QQ 协议端，确保通信正常。 -3. 🗃️ **数据库配置**: 根据需求选择 SQLite 或配置你的 MySQL 服务器。 -4. 🔌 **插件配置**: 在 `config/plugins/` 目录下按需配置插件。 - +> 详细安装与配置指南请参考官方文档： +> - **Windows 用户部署指南**：[https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/deployment_guide.html](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](https://mofox-studio.github.io/MoFox-Bot-Docs/docs/guides/bot_config_guide.html) +
- ---- - +
- + +### ⚙️ 配置要点 + +1. 📝 **核心配置**：编辑 `config/bot_config.toml`，设置 LLM API Key、Bot 名称等基础参数。 +2. 🤖 **协议端配置**：确保使用 [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 或兼容协议端，建立稳定通信。 +3. 🗃️ **数据库配置**：选择 SQLite（默认）或配置 MySQL 数据库连接。 +4. 🔌 **插件配置**：在 `config/plugins/` 目录中启用或配置所需插件。 + +
+ +--- + +
+ ## 🙏 致谢 - -我们衷心感谢以下优秀的开源项目，没有它们，就没有 MoFox_Bot。 - + +我们衷心感谢以下开源项目为本项目提供的坚实基础： + | 项目 | 描述 | 贡献 | | ------------------------------------------ | -------------------- | ---------------- | -| 🎯 [MaiM-with-u/MaiBot](https://github.com/MaiM-with-u/MaiBot) | 原版 MaiBot 项目 | 提供优秀的基础框架 | -| 🐱 [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) | 基于 NTQQ 的 Bot 协议端 | 现代化的 QQ 协议实现 | -| 🌌 [internetsb/Maizone](https://github.com/internetsb/Maizone) | 魔改空间插件 | 插件部分功能借鉴 | - +| 🎯 [MaiM-with-u/MaiBot](https://github.com/MaiM-with-u/MaiBot) | 原版 MaiBot 框架 | 提供核心架构与设计 | +| 🐱 [NapNeko/NapCatQQ](https://github.com/NapNeko/NapCatQQ) | 高性能 QQ 协议端 | 实现稳定通信 | +| 🌌 [internetsb/Maizone](https://github.com/internetsb/Maizone) | 魔改空间插件 | 功能借鉴与启发 | +
- + --- - +
- -## ⚠️ 注意事项 - + +## ⚠️ 重要提示 + > [!CAUTION] -> **重要提醒** +> **请务必阅读以下内容：** > -> - 使用本项目前，你必须阅读并同意 [**📋 用户协议 (EULA.md)**](EULA.md)。 -> - 本应用生成的内容来自人工智能大模型，请仔细甄别其准确性，并请勿用于任何违反法律法规的用途。 -> - AI 生成的所有内容不代表本项目团队的任何观点和立场。 - +> - 本项目使用前，请仔细阅读并同意 [**用户协议 (EULA.md)**](EULA.md)。 +> - 本应用生成的内容由 AI 大模型提供，请谨慎甄别其准确性。 +> - 请勿将 AI 生成内容用于任何违法、违规或不当用途。 +> - 所有 AI 输出不代表 MoFox Studio 的立场或观点。 +
- + --- - +
- + + ## 📄 开源协议 本项目基于 **[GPL-3.0](LICENSE)** 协议开源。 @@ -183,8 +185,8 @@ [![GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg?style=for-the-badge&logo=gnu)](LICENSE) ``` - Copyright © 2025 MoFox Studio - Licensed under the GNU General Public License v3.0 + Copyright © 2025 MoFox Studio + Licensed under the GNU General Public License v3.0 ```
diff --git a/pyproject.toml b/pyproject.toml index 97b44a510..048ad52c9 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -21,7 +21,7 @@ dependencies = [ "google>=3.0.0", "google-genai>=1.29.0", "httpx>=0.28.1", - "rjieba>=0.1.13", + "jieba>=0.1.13", "json-repair>=0.47.6", "json5>=0.12.1", "jsonlines>=4.0.0", @@ -75,7 +75,7 @@ dependencies = [ "aiomysql>=0.2.0", "aiosqlite>=0.21.0", "inkfox>=0.1.1", - "rrjieba>=0.1.13", + "rjieba>=0.1.13", "mcp>=0.9.0", "sse-starlette>=2.2.1", ] diff --git a/template/bot_config_template.toml b/template/bot_config_template.toml index 5e12ee48e..ac3a25596 100644 --- a/template/bot_config_template.toml +++ b/template/bot_config_template.toml @@ -612,7 +612,7 @@ interval = 1500 # 默认25分钟 interval_sigma = 120 # 每日活跃度调整，格式：[["", "HH:MM,factor", ...], ["stream_id", ...]] # factor > 1.0 会缩短思考间隔，更活跃；factor < 1.0 会延长间隔。 -talk_frequency_adjust = [['', '8:00,1', '12:00,1.2', '18:00,1.5', '01:00,0.6']] +talk_frequency_adjust = [["", "8:00,1", "12:00,1.2", "18:00,1.5", "01:00,0.6"]] # --- 作用范围 --- enable_in_private = true # 是否允许在私聊中主动发起对话 @@ -652,4 +652,4 @@ cold_start_cooldown = 86400 # 默认24小时 # 1. MCP服务器需要单独启动，Bot启动后会自动连接 # 2. 每个服务器提供的工具会自动注册到Bot的工具系统 # 3. AI会自动发现并在需要时调用这些工具 -# 4. 详细文档请参考: docs/MCP_TOOLS_INTEGRATION.md \ No newline at end of file +# 4. 详细文档请参考: docs/MCP_TOOLS_INTEGRATION.md