gardel/Mofox-Core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'master' of https://github.com/MaiBot-Plus/MaiMbot-Pro-Max

Browse Source
This commit is contained in:
tt-P607
2025-08-26 12:03:07 +08:00
parent 45ccab6033 83ff158dd8
commit 9cea223c13
21 changed files with 92 additions and 115 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
README.md
View File

@@ -1,24 +1,24 @@
<div align="center"> <div align="center">
<img src="depends-data/maimai.png" alt="MaiBot-Pro-Max" title="作者:略nd" width="300"> <img src="depends-data/maimai.png" alt="MoFox_Bot" title="作者:略nd" width="300">
# 麦麦Plus！MaiMbot-Pro-Max # 麦麦Plus！MoFox_Bot
<p> <p>
<strong>基于 MaiCore 的增强版智能体，提供更完善的功能和更好的使用体验</strong> <strong>基于 MaiCore 的增强版智能体，提供更完善的功能和更好的使用体验</strong>
</p> </p>
[![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python&style=for-the-badge)](https://www.python.org/) [![Python](https://img.shields.io/badge/Python-3.10+-blue?logo=python&style=for-the-badge)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-GPLv3-blue?logo=gnu&style=for-the-badge)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/blob/master/LICENSE) [![License](https://img.shields.io/badge/License-GPLv3-blue?logo=gnu&style=for-the-badge)](https://github.com/MoFox-Studio/MoFox_Bot/blob/master/LICENSE)
[![Status](https://img.shields.io/badge/%E7%8A%B6%E6%80%81-%E6%B4%BB%E8%B7%83%E5%BC%80%E5%8F%91-brightgreen?style=for-the-badge)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max) [![Status](https://img.shields.io/badge/%E7%8A%B6%E6%80%81-%E6%B4%BB%E8%B7%83%E5%BC%80%E5%8F%91-brightgreen?style=for-the-badge)](https://github.com/MoFox-Studio/MoFox_Bot)
[![Contributors](https://img.shields.io/github/contributors/MaiBot-Plus/MaiMbot-Pro-Max.svg?style=for-the-badge&label=贡献者)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/graphs/contributors) [![Contributors](https://img.shields.io/github/contributors/MaiBot-Plus/MaiMbot-Pro-Max.svg?style=for-the-badge&label=贡献者)](https://github.com/MoFox-Studio/MoFox_Bot/graphs/contributors)
[![Forks](https://img.shields.io/github/forks/MaiBot-Plus/MaiMbot-Pro-Max.svg?style=for-the-badge&label=分支数)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/network/members) [![Forks](https://img.shields.io/github/forks/MaiBot-Plus/MaiMbot-Pro-Max.svg?style=for-the-badge&label=分支数)](https://github.com/MoFox-Studio/MoFox_Bot/network/members)
[![Stars](https://img.shields.io/github/stars/MaiBot-Plus/MaiMbot-Pro-Max?style=for-the-badge&label=星标数)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/stargazers) [![Stars](https://img.shields.io/github/stars/MaiBot-Plus/MaiMbot-Pro-Max?style=for-the-badge&label=星标数)](https://github.com/MoFox-Studio/MoFox_Bot/stargazers)
[![Issues](https://img.shields.io/github/issues/MaiBot-Plus/MaiMbot-Pro-Max?style=for-the-badge&label=问题)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/issues) [![Issues](https://img.shields.io/github/issues/MaiBot-Plus/MaiMbot-Pro-Max?style=for-the-badge&label=问题)](https://github.com/MoFox-Studio/MoFox_Bot/issues)
[![Enhanced](https://img.shields.io/badge/Enhanced-MaiMbot_Pro_Max-purple?style=for-the-badge&logo=github)](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max) [![Enhanced](https://img.shields.io/badge/Enhanced-MaiMbot_Pro_Max-purple?style=for-the-badge&logo=github)](https://github.com/MoFox-Studio/MoFox_Bot)
<p> <p>
<strong> <strong>
<a href="https://github.com/MaiBot-Plus/MaiMbot-Pro-Max">项目主页</a> • <a href="https://github.com/MoFox-Studio/MoFox_Bot">项目主页</a> •
<a href="#-快速开始">快速开始</a> • <a href="#-快速开始">快速开始</a> •
<a href="#-核心优势">核心优势</a> • <a href="#-核心优势">核心优势</a> •
<a href="#-讨论交流">讨论交流</a> • <a href="#-讨论交流">讨论交流</a> •
@@ -48,17 +48,17 @@
## 项目介绍 ## 项目介绍
**MaiMbot-Pro-Max** 是基于 MaiCore 的增强版智能体，在保留原版0.10.0 snapshot.5所有功能的基础上，提供了更完善的功能、更好的稳定性和更丰富的使用体验。 **MoFox_Bot** 是基于 MaiCore 的增强版智能体，在保留原版0.10.0 snapshot.5所有功能的基础上，提供了更完善的功能、更好的稳定性和更丰富的使用体验。
**请注意！这个版本的所有后续更新均为我们的第三方更新，不代表MaiBot官方立场** **请注意！这个版本的所有后续更新均为我们的第三方更新，不代表MaiBot官方立场**
无论你是想要一个智能的聊天伙伴，还是需要一个功能强大的群聊助手，MaiMbot-Pro-Max 都能满足你的需求。 无论你是想要一个智能的聊天伙伴，还是需要一个功能强大的群聊助手，MoFox_Bot 都能满足你的需求。
## 核心优势 ## 核心优势
相比官方版本，MaiMbot-Pro-Max 带来以下增强： 相比官方版本，MoFox_Bot 带来以下增强：
| 特性 | 官方版本 | Pro-Max 版本 | | 特性 | 官方版本 | MoFox_Bot 版本 |
|------|----------|-------------| |------|----------|-------------|
| **多模型支持** | 基础支持 | 适配 Gemini 等主流大语言模型 | | **多模型支持** | 基础支持 | 适配 Gemini 等主流大语言模型 |
| **插件生态** | 标准插件 | 额外提供实用插件，涵盖更多使用场景 | | **插件生态** | 标准插件 | 额外提供实用插件，涵盖更多使用场景 |
@@ -67,11 +67,11 @@
| **性能** | 标准 | 优化性能，响应更快速 | | **性能** | 标准 | 优化性能，响应更快速 |
> [!TIP] > [!TIP]
> 请注意！ 从官方版本到 Pro-Max 版本迁移暂时存在问题，因为数据库结构有改变 > 请注意！ 从官方版本到 MoFox_Bot 版本迁移暂时存在问题，因为数据库结构有改变
### 核心优势 ### 核心优势
相比官方版本，MaiMbot-Pro-Max 拥有更完善的功能： 相比官方版本，MoFox_Bot 拥有更完善的功能：
- **增强插件**：额外提供 一些插件，涵盖更多使用场景 - **增强插件**：额外提供 一些插件，涵盖更多使用场景
- **稳定性提升**：修复官方版本的一些已知问题，提供更稳定的运行体验 - **稳定性提升**：修复官方版本的一些已知问题，提供更稳定的运行体验
@@ -101,12 +101,12 @@
- **QQ协议端**: [NapCat](https://github.com/NapNeko/NapCatQQ) 或其他兼容协议端 - **QQ协议端**: [NapCat](https://github.com/NapNeko/NapCatQQ) 或其他兼容协议端
- **数据库**: SQLite (内置) 或 MySQL (可选) - **数据库**: SQLite (内置) 或 MySQL (可选)
**MaiMbot-Pro-Max 是基于 MaiCore 的增强版智能体，提供更完善的功能和更好的使用体验** **MoFox_Bot 是基于 MaiCore 的增强版智能体，提供更完善的功能和更好的使用体验**
## 更新和安装 ## 更新和安装
**最新版本: v1.0.0-maibotProMax** **最新版本: v1.0.0-MoFox_Bot**
**GitHub 分支说明：** **GitHub 分支说明：**
@@ -121,13 +121,13 @@
## 讨论交流 ## 讨论交流
### 官方社区 ### 官方社区
- **交流群**: [maibot-Pro-Max 交流群] - 群号：169850076 - **交流群**: [MoFox_Bot 交流群] - 群号：169850076
- **功能建议**: [GitHub Discussions](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/discussions) - **功能建议**: [GitHub Discussions](https://github.com/MoFox-Studio/MoFox_Bot/discussions)
- **问题反馈**: [GitHub Issues](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/issues) - **问题反馈**: [GitHub Issues](https://github.com/MoFox-Studio/MoFox_Bot/issues)
**其他资源：** **其他资源：**
- [问题反馈](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/issues) - [问题反馈](https://github.com/MoFox-Studio/MoFox_Bot/issues)
- [功能建议](https://github.com/MaiBot-Plus/MaiMbot-Pro-Max/discussions) - [功能建议](https://github.com/MoFox-Studio/MoFox_Bot/discussions)
## 文档资源 ## 文档资源
@@ -138,11 +138,11 @@
## 贡献和致谢 ## 贡献和致谢
MaiMbot-Pro-Max 是一个开源项目，欢迎所有人参与贡献！ MoFox_Bot 是一个开源项目，欢迎所有人参与贡献！
### 贡献者 ### 贡献者
感谢所有为 Pro-Max 版本做出贡献的开发者！ 感谢所有为 MoFox_Bot 做出贡献的开发者！
### 致谢 ### 致谢
@@ -150,7 +150,7 @@ MaiMbot-Pro-Max 是一个开源项目，欢迎所有人参与贡献！
- [MaiM-with-u](https://github.com/MaiM-with-u/MaiBot): 原版 MaiBot 项目，感谢提供优秀的基础框架 - [MaiM-with-u](https://github.com/MaiM-with-u/MaiBot): 原版 MaiBot 项目，感谢提供优秀的基础框架
- [略nd](https://space.bilibili.com/1344099355): 为麦麦绘制人设 - [略nd](https://space.bilibili.com/1344099355): 为麦麦绘制人设
- [NapCat](https://github.com/NapNeko/NapCatQQ): 现代化的基于 NTQQ 的 Bot 协议端实现 - [NapCat](https://github.com/NapNeko/NapCatQQ): 现代化的基于 NTQQ 的 Bot 协议端实现
- **Pro-Max 社区**: 感谢所有提供建议和反馈的用户 - **MoFox_Bot 社区**: 感谢所有提供建议和反馈的用户
## 注意事项 ## 注意事项

12
docs/CONTRIBUTE.md
View File

@@ -1,4 +1,4 @@
# 如何给MaiCore做贡献v1.0 # 如何给MoFox_Bot做贡献v1.0
修改时间2025/4/5 修改时间2025/4/5
@@ -6,7 +6,7 @@
首先，非常感谢你抽出时间来做贡献！❤️ 首先，非常感谢你抽出时间来做贡献！❤️
这份文档是告诉你，当你想向MaiMbot-Pro-Max提交代码，或者想要以其他形式加入MaiMbot-Pro-Max的开发，或周边插件的开发，你可以怎么做。 这份文档是告诉你，当你想向MoFox_Bot提交代码，或者想要以其他形式加入MoFox_Bot的开发，或周边插件的开发，你可以怎么做。
我们鼓励并重视任何形式的贡献，但无序的贡献只会使麦麦的维护与更新变成一团糟。因此，我们建议您在做出贡献之前，先查看本指南。 我们鼓励并重视任何形式的贡献，但无序的贡献只会使麦麦的维护与更新变成一团糟。因此，我们建议您在做出贡献之前，先查看本指南。
@@ -39,8 +39,8 @@
## 我想做贡献 ## 我想做贡献
> ### 项目所有权与维护 > ### 项目所有权与维护
> MaiMbot-Pro-Max项目（基于MaiBot修改，核心为MaiCore）由雅诺狐创建，采用GPL3开源协议。 > MoFox_Bot项目（基于MaiBot修改，核心为MaiCore）由雅诺狐创建，采用GPL3开源协议。
> MaiMbot-Pro-Max项目现已移动至MaiMbot-Pro-Max组织下，目前主要内容由核心开发组维护，整体由核心开发组、reviewer和所有贡献者共同维护（该部分在未来将会明确）。 > MoFox_Bot项目现已移动至MoFox_Bot组织下，目前主要内容由核心开发组维护，整体由核心开发组、reviewer和所有贡献者共同维护（该部分在未来将会明确）。
> 为了保证设计的统一和节省不必要的精力，以及为了对项目有整体的把控，我们对不同类型的贡献采取不同的审核策略： > 为了保证设计的统一和节省不必要的精力，以及为了对项目有整体的把控，我们对不同类型的贡献采取不同的审核策略：
> >
> #### 功能新增 > #### 功能新增
@@ -66,7 +66,7 @@
## 提出建议 ## 提出建议
这一部分指导您如何为MaiMbot-Pro-Max提交一个建议，包括全新的功能和对现有功能的小改进。遵循这些指南将有助于维护人员和社区了解您的建议并找到相关的建议。 这一部分指导您如何为MoFox_Bot提交一个建议，包括全新的功能和对现有功能的小改进。遵循这些指南将有助于维护人员和社区了解您的建议并找到相关的建议。
在提交建议之前 在提交建议之前
@@ -83,6 +83,6 @@
### 附（暂定）： ### 附（暂定）：
核心组成员：@foxcyber907(雅诺狐) @Furina-1013-create(Navinatte)@tt-P607(言柒)@ikun-11451(ikun两年半）@minecraft1024a(一闪） 核心组成员：@foxcyber907(雅诺狐) @Furina-1013-create(Navinatte)@tt-P607(言柒)@ikun-11451(ikun两年半）@minecraft1024a(一闪）
reviewer：核心组+MaiMbot-Pro-Max主仓库合作者/权限者 reviewer：核心组+MoFox_Bot主仓库合作者/权限者
贡献者：所有提交过贡献的用户 贡献者：所有提交过贡献的用户

2
docs/PERMISSION_SYSTEM.md
View File

@@ -2,7 +2,7 @@
## 概述 ## 概述
MaiMbot-Pro-Max的权限系统提供了完整的权限管理功能，支持权限等级和权限节点配置。系统包含以下核心概念： MoFox_Bot的权限系统提供了完整的权限管理功能，支持权限等级和权限节点配置。系统包含以下核心概念：
- **Master用户**：拥有最高权限，无视所有权限节点，在配置文件中设置 - **Master用户**：拥有最高权限，无视所有权限节点，在配置文件中设置
- **权限节点**：细粒度的权限控制单元，由插件自行创建和管理 - **权限节点**：细粒度的权限控制单元，由插件自行创建和管理

2
docs/memory_system_design_v3.md
View File

@@ -1,4 +1,4 @@
# 麦麦记忆系统架构 v3.0 设计文档 # MoFox_Bot记忆系统架构 v3.0 设计文档
*融合 Mem0 先进理念的生产级记忆系统* *融合 Mem0 先进理念的生产级记忆系统*
## 🎯 1. 核心思想 ## 🎯 1. 核心思想

2
docs/model_configuration_guide.md
View File

@@ -1,6 +1,6 @@
# 模型配置指南 # 模型配置指南
本文档将指导您如何配置 `model_config.toml` 文件，该文件用于配置 MaiBot 的各种AI模型和API服务提供商。 本文档将指导您如何配置 `model_config.toml` 文件，该文件用于配置 MoFox_Bot 的各种AI模型和API服务提供商。
## 配置文件结构 ## 配置文件结构

6
docs/plugins/action-components.md
View File

@@ -2,13 +2,13 @@
## 📖 什么是Action ## 📖 什么是Action
Action是给麦麦在回复之外提供额外功能的智能组件，**由麦麦的决策系统自主选择是否使用**，具有随机性和拟人化的调用特点。Action不是直接响应用户命令，而是让麦麦根据聊天情境智能地选择合适的动作，使其行为更加自然和真实。 Action是给MoFox_Bot在回复之外提供额外功能的智能组件，**由MoFox_Bot的决策系统自主选择是否使用**，具有随机性和拟人化的调用特点。Action不是直接响应用户命令，而是让MoFox_Bot根据聊天情境智能地选择合适的动作，使其行为更加自然和真实。
### Action的特点 ### Action的特点
- 🧠 **智能激活**：麦麦根据多种条件智能判断是否使用 - 🧠 **智能激活**：MoFox_Bot根据多种条件智能判断是否使用
- 🎲 **可随机性**：可以使用随机数激活，增加行为的不可预测性，更接近真人交流 - 🎲 **可随机性**：可以使用随机数激活，增加行为的不可预测性，更接近真人交流
- 🤖 **拟人化**：让麦麦的回应更自然、更有个性 - 🤖 **拟人化**：让MoFox_Bot的回应更自然、更有个性
- 🔄 **情境感知**：基于聊天上下文做出合适的反应 - 🔄 **情境感知**：基于聊天上下文做出合适的反应
--- ---

4
docs/plugins/index.md
View File

@@ -1,6 +1,6 @@
# MaiBot插件开发文档 # MoFox_Bot插件开发文档
> 欢迎来到MaiBot插件系统开发文档！这里是你开始插件开发旅程的最佳起点。 > 欢迎来到MoFox_Bot插件系统开发文档！这里是你开始插件开发旅程的最佳起点。
## 新手入门 ## 新手入门

2
docs/plugins/manifest-guide.md
View File

@@ -2,7 +2,7 @@
## 概述 ## 概述
MaiBot插件系统现在强制要求每个插件都必须包含一个 `_manifest.json` 文件。这个文件描述了插件的基本信息、依赖关系、组件等重要元数据。 MoFox_Bot插件系统现在强制要求每个插件都必须包含一个 `_manifest.json` 文件。这个文件描述了插件的基本信息、依赖关系、组件等重要元数据。
### 🔄 配置架构：Manifest与Config的职责分离 ### 🔄 配置架构：Manifest与Config的职责分离

41
docs/plugins/quick-start.md
View File

@@ -1,10 +1,10 @@
# 🚀 快速开始指南 # 🚀 快速开始指南
本指南将带你从零开始创建一个功能完整的MaiCore插件。 本指南将带你从零开始创建一个功能完整的MoFox_Bot插件。
## 📖 概述 ## 📖 概述
这个指南将带你快速创建你的第一个MaiCore插件。我们将创建一个简单的问候插件，展示插件系统的基本概念。 这个指南将带你快速创建你的第一个MoFox_Bot插件。我们将创建一个简单的问候插件，展示插件系统的基本概念。
以下代码都在我们的`plugins/hello_world_plugin/`目录下。 以下代码都在我们的`plugins/hello_world_plugin/`目录下。
@@ -18,7 +18,7 @@
确保你已经： 确保你已经：
1. 克隆了MaiCore项目 1. 克隆了MoFox_Bot项目
2. 安装了Python依赖 2. 安装了Python依赖
3. 了解基本的Python语法 3. 了解基本的Python语法
@@ -58,7 +58,7 @@ from src.plugin_system import BasePlugin, register_plugin, ComponentInfo
@register_plugin # 注册插件 @register_plugin # 注册插件
class HelloWorldPlugin(BasePlugin): class HelloWorldPlugin(BasePlugin):
"""Hello World插件 - 你的第一个MaiCore插件""" """Hello World插件 - 你的第一个MoFox_Bot插件"""
# 以下是插件基本信息和方法（必须填写） # 以下是插件基本信息和方法（必须填写）
plugin_name = "hello_world_plugin" plugin_name = "hello_world_plugin"
@@ -73,7 +73,7 @@ class HelloWorldPlugin(BasePlugin):
return [] return []
``` ```
🎉 恭喜！你刚刚创建了一个最简单但完整的MaiCore插件！ 🎉 恭喜！你刚刚创建了一个最简单但完整的MoFox_Bot插件！
**解释一下这些代码：** **解释一下这些代码：**
@@ -84,9 +84,9 @@ class HelloWorldPlugin(BasePlugin):
### 4. 测试基础插件 ### 4. 测试基础插件
现在就可以测试这个插件了！启动MaiCore： 现在就可以测试这个插件了！启动MoFox_Bot：
直接通过启动器运行MaiCore或者 `python bot.py` 直接通过启动器运行MoFox_Bot或者 `python bot.py`
在日志中你应该能看到插件被加载的信息。虽然插件还没有任何功能，但它已经成功运行了！ 在日志中你应该能看到插件被加载的信息。虽然插件还没有任何功能，但它已经成功运行了！
@@ -96,9 +96,9 @@ class HelloWorldPlugin(BasePlugin):
现在我们要给插件加入一个有用的功能，我们从最好玩的Action做起 现在我们要给插件加入一个有用的功能，我们从最好玩的Action做起
Action是一类可以让MaiCore根据自身意愿选择使用的“动作”，在MaiCore中，不论是“回复”还是“不回复”，或者“发送表情”以及“禁言”等等，都是通过Action实现的。 Action是一类可以让MoFox_Bot根据自身意愿选择使用的“动作”，在MoFox_Bot中，不论是“回复”还是“不回复”，或者“发送表情”以及“禁言”等等，都是通过Action实现的。
你可以通过编写动作，来拓展MaiCore的能力，包括发送语音，截图，甚至操作文件，编写代码...... 你可以通过编写动作，来拓展MoFox_Bot的能力，包括发送语音，截图，甚至操作文件，编写代码......
现在让我们给插件添加第一个简单的功能。这个Action可以对用户发送一句问候语。 现在让我们给插件添加第一个简单的功能。这个Action可以对用户发送一句问候语。
@@ -138,7 +138,7 @@ class HelloAction(BaseAction):
@register_plugin @register_plugin
class HelloWorldPlugin(BasePlugin): class HelloWorldPlugin(BasePlugin):
"""Hello World插件 - 你的第一个MaiCore插件""" """Hello World插件 - 你的第一个MoFox_Bot插件"""
# 插件基本信息 # 插件基本信息
plugin_name = "hello_world_plugin" plugin_name = "hello_world_plugin"
@@ -160,21 +160,21 @@ class HelloWorldPlugin(BasePlugin):
- `HelloAction` 是我们定义的问候动作类，继承自 `BaseAction`，并实现了核心功能。 - `HelloAction` 是我们定义的问候动作类，继承自 `BaseAction`，并实现了核心功能。
- 在 `HelloWorldPlugin` 中，我们通过 `get_plugin_components()` 方法，通过调用`get_action_info()`这个内置方法将 `HelloAction` 注册为插件的一个组件。 - 在 `HelloWorldPlugin` 中，我们通过 `get_plugin_components()` 方法，通过调用`get_action_info()`这个内置方法将 `HelloAction` 注册为插件的一个组件。
- 这样一来，当插件被加载时，问候动作也会被一并加载，并可以在MaiCore中使用。 - 这样一来，当插件被加载时，问候动作也会被一并加载，并可以在MoFox_Bot中使用。
- `execute()` 函数是Action的核心，定义了当Action被MaiCore选择后，具体要做什么 - `execute()` 函数是Action的核心，定义了当Action被MoFox_Bot选择后，具体要做什么
- `self.send_text()` 是发送文本消息的便捷方法 - `self.send_text()` 是发送文本消息的便捷方法
Action 组件中有关`activation_type`、`action_parameters`、`action_require`、`associated_types` 等的详细说明请参考 [Action组件指南](./action-components.md)。 Action 组件中有关`activation_type`、`action_parameters`、`action_require`、`associated_types` 等的详细说明请参考 [Action组件指南](./action-components.md)。
### 6. 测试问候Action ### 6. 测试问候Action
重启MaiCore，然后在聊天中发送任意消息，比如： 重启MoFox_Bot，然后在聊天中发送任意消息，比如：
``` ```
你好 你好
``` ```
MaiCore可能会选择使用你的问候Action，发送回复： MoFox_Bot可能会选择使用你的问候Action，发送回复：
``` ```
嗨！很开心见到你！😊 嗨！很开心见到你！😊
@@ -182,7 +182,7 @@ MaiCore可能会选择使用你的问候Action，发送回复：
![1750332508760](image/quick-start/1750332508760.png) ![1750332508760](image/quick-start/1750332508760.png)
> **💡 小提示**：MaiCore会智能地决定什么时候使用它。如果没有立即看到效果，多试几次不同的消息。 > **💡 小提示**：MoFox_Bot会智能地决定什么时候使用它。如果没有立即看到效果，多试几次不同的消息。
🎉 太棒了！你的插件已经有实际功能了！ 🎉 太棒了！你的插件已经有实际功能了！
@@ -222,7 +222,7 @@ class TimeCommand(BaseCommand):
@register_plugin @register_plugin
class HelloWorldPlugin(BasePlugin): class HelloWorldPlugin(BasePlugin):
"""Hello World插件 - 你的第一个MaiCore插件""" """Hello World插件 - 你的第一个MoFox_Bot插件"""
# 插件基本信息 # 插件基本信息
plugin_name = "hello_world_plugin" plugin_name = "hello_world_plugin"
@@ -250,7 +250,7 @@ class HelloWorldPlugin(BasePlugin):
### 8. 测试时间查询Command ### 8. 测试时间查询Command
重启MaiCore，发送命令： 重启MoFox_Bot，发送命令：
``` ```
/time /time
@@ -319,7 +319,7 @@ class HelloWorldPlugin(BasePlugin):
```toml ```toml
# hello_world_plugin - 自动生成的配置文件 # hello_world_plugin - 自动生成的配置文件
# 我的第一个MaiCore插件，包含问候功能和时间查询等基础示例 # 我的第一个MoFox_Bot插件，包含问候功能和时间查询等基础示例
# 插件基本信息 # 插件基本信息
[plugin] [plugin]
@@ -417,11 +417,6 @@ class TimeCommand(BaseCommand):
你可以创建一个 `README.md` 文件，描述插件的功能和使用方法。 你可以创建一个 `README.md` 文件，描述插件的功能和使用方法。
### 3. 发布到插件市场
如果你想让更多人使用你的插件，可以将它发布到MaiCore的插件市场。
这部分请参考 [plugin-repo](https://github.com/Maim-with-u/plugin-repo) 的文档。
--- ---

10
docs/plugins/tool-components.md
View File

@@ -2,11 +2,11 @@
## 📖 什么是工具 ## 📖 什么是工具
工具是MaiBot的信息获取能力扩展组件。如果说Action组件功能五花八门，可以拓展麦麦能做的事情，那么Tool就是在某个过程中拓宽了麦麦能够获得的信息量。 工具是MoFox_Bot的信息获取能力扩展组件。如果说Action组件功能五花八门，可以拓展麦麦能做的事情，那么Tool就是在某个过程中拓宽了麦麦能够获得的信息量。
### 🎯 工具的特点 ### 🎯 工具的特点
- 🔍 **信息获取增强**：扩展麦麦获取外部信息的能力 - 🔍 **信息获取增强**：扩展MoFox_Bot获取外部信息的能力
- 📊 **数据丰富**：帮助麦麦获得更多背景信息和实时数据 - 📊 **数据丰富**：帮助麦麦获得更多背景信息和实时数据
- 🔌 **插件式架构**：支持独立开发和注册新工具 - 🔌 **插件式架构**：支持独立开发和注册新工具
- ⚡ **自动发现**：工具会被系统自动识别和注册 - ⚡ **自动发现**：工具会被系统自动识别和注册
@@ -15,9 +15,9 @@
| 特征 | Action | Command | Tool | | 特征 | Action | Command | Tool |
|-----|-------|---------|------| |-----|-------|---------|------|
| **主要用途** | 扩展麦麦行为能力 | 响应用户指令 | 扩展麦麦信息获取 | | **主要用途** | 扩展MoFox_Bot行为能力 | 响应用户指令 | 扩展MoFox_Bot信息获取 |
| **触发方式** | 麦麦智能决策 | 用户主动触发 | LLM根据需要调用 | | **触发方式** | MoFox_Bot智能决策 | 用户主动触发 | LLM根据需要调用 |
| **目标** | 让麦麦做更多事情 | 提供具体功能 | 让麦麦知道更多信息 | | **目标** | 让MoFox_Bot做更多事情 | 提供具体功能 | 让MoFox_Bot知道更多信息 |
| **使用场景** | 增强交互体验 | 功能服务 | 信息查询和分析 | | **使用场景** | 增强交互体验 | 功能服务 | 信息查询和分析 |
## 🏗️ Tool组件的基本结构 ## 🏗️ Tool组件的基本结构

2
docs/schedule_enhancement (1).md
View File

@@ -2,7 +2,7 @@
## 1. 系统概述与目标 ## 1. 系统概述与目标
本系统旨在为Bot引入一个动态的、由大型语言模型（LLM）驱动的“月层计划”机制。其核心目标是取代静态、预设的任务模板，转而利用LLM在程序启动时自动生成符合Bot人设的、具有时效性的月度计划。这些计划将被存储、管理，并在构建每日日程时被动态抽取和使用，从而极大地丰富日程内容的个性和多样性。 本系统旨在为MoFox_Bot引入一个动态的、由大型语言模型（LLM）驱动的“月层计划”机制。其核心目标是取代静态、预设的任务模板，转而利用LLM在程序启动时自动生成符合Bot人设的、具有时效性的月度计划。这些计划将被存储、管理，并在构建每日日程时被动态抽取和使用，从而极大地丰富日程内容的个性和多样性。
--- ---

8
plugins/permission_example/_manifest.json
View File

@@ -4,15 +4,13 @@
"version": "1.0.0", "version": "1.0.0",
"description": "MaiCore权限系统演示插件，包含权限节点注册、权限检查和多种权限命令示例。", "description": "MaiCore权限系统演示插件，包含权限节点注册、权限检查和多种权限命令示例。",
"author": { "author": {
"name": "MaiBot开发团队", "name": "MoFox-Studio",
"url": "https://github.com/MaiM-with-u" "url": "https://github.com/MoFox-Studio"
}, },
"license": "GPL-v3.0-or-later", "license": "GPL-v3.0-or-later",
"host_application": { "host_application": {
"min_version": "0.8.0" "min_version": "0.10.0"
}, },
"homepage_url": "https://github.com/MaiM-with-u/maibot",
"repository_url": "https://github.com/MaiM-with-u/maibot",
"keywords": ["permission", "example", "权限", "admin", "user", "master", "demo", "tutorial"], "keywords": ["permission", "example", "权限", "admin", "user", "master", "demo", "tutorial"],
"categories": ["Examples", "Tutorial", "Permission"], "categories": ["Examples", "Tutorial", "Permission"],
"default_locale": "zh-CN", "default_locale": "zh-CN",

12
plugins/set_emoji_like/_manifest.json
View File

@@ -4,16 +4,14 @@
"version": "1.0.0", "version": "1.0.0",
"description": "通过大模型判断或指令，为特定的聊天消息设置QQ表情回应。需要NapCat服务支持。", "description": "通过大模型判断或指令，为特定的聊天消息设置QQ表情回应。需要NapCat服务支持。",
"author": { "author": {
"name": "yishan", "name": "MoFox-Studio",
"url": "https://github.com/MaiM-with-u" "url": "https://github.com/MoFox-Studio"
}, },
"license": "GPL-v3.0-or-later", "license": "GPL-v3.0-or-later",
"host_application": { "host_application": {
"min_version": "0.8.0" "min_version": "0.10.0"
}, },
"homepage_url": "https://github.com/MaiM-with-u/maibot",
"repository_url": "https://github.com/MaiM-with-u/maibot",
"keywords": ["emoji", "reaction", "like", "表情", "回应", "点赞"], "keywords": ["emoji", "reaction", "like", "表情", "回应", "点赞"],
"categories": ["Chat", "Integration"], "categories": ["Chat", "Integration"],
@@ -32,9 +30,7 @@
], ],
"features": [ "features": [
"通过LLM理解并为消息添加表情回应", "通过LLM理解并为消息添加表情回应",
"支持通过表情名称或ID指定表情", "支持通过表情名称或ID指定表情"
"需要连接到NapCat服务",
"可配置NapCat服务器地址"
] ]
} }
} }

6
src/plugins/built_in/WEB_SEARCH_TOOL/_manifest.json
View File

@@ -4,16 +4,14 @@
"version": "1.0.0", "version": "1.0.0",
"description": "一个用于在互联网上搜索信息的工具", "description": "一个用于在互联网上搜索信息的工具",
"author": { "author": {
"name": "MaiBot-Plus开发团队", "name": "MoFox-Studio",
"url": "https://github.com/MaiBot-Plus" "url": "https://github.com/MoFox-Studio"
}, },
"license": "GPL-v3.0-or-later", "license": "GPL-v3.0-or-later",
"host_application": { "host_application": {
"min_version": "0.10.0" "min_version": "0.10.0"
}, },
"homepage_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"repository_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"keywords": ["web_search", "url_parser"], "keywords": ["web_search", "url_parser"],
"categories": ["web_search", "url_parser"], "categories": ["web_search", "url_parser"],

2
src/plugins/built_in/WEB_SEARCH_TOOL/plugin.py
View File

@@ -151,7 +151,7 @@ class WEBSEARCHPLUGIN(BasePlugin):
enable_tool = [] enable_tool = []
# 从主配置文件读取组件启用配置 # 从主配置文件读取组件启用配置
if True: if config_api.get_global_config("web_search.enable_web_search_tool", True):
enable_tool.append((WebSurfingTool.get_tool_info(), WebSurfingTool)) enable_tool.append((WebSurfingTool.get_tool_info(), WebSurfingTool))
if config_api.get_global_config("web_search.enable_url_tool", True): if config_api.get_global_config("web_search.enable_url_tool", True):

11
src/plugins/built_in/maizone_refactored/_manifest.json
View File

@@ -4,17 +4,14 @@
"version": "3.0.0", "version": "3.0.0",
"description": "（重构版）让你的麦麦发QQ空间说说、评论、点赞，支持AI配图、定时发送和自动监控功能", "description": "（重构版）让你的麦麦发QQ空间说说、评论、点赞，支持AI配图、定时发送和自动监控功能",
"author": { "author": {
"name": "MaiBot-Plus", "name": "MoFox-Studio",
"url": "https://github.com/MaiBot-Plus" "url": "https://github.com/MoFox-Studio"
}, },
"license": "AGPL-v3.0", "license": "GPL-v3.0",
"host_application": { "host_application": {
"min_version": "0.8.0", "min_version": "0.10.0"
"max_version": "0.11.0"
}, },
"homepage_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"repository_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"keywords": ["QQ空间", "说说", "动态", "评论", "点赞", "自动化", "AI配图"], "keywords": ["QQ空间", "说说", "动态", "评论", "点赞", "自动化", "AI配图"],
"categories": ["社交", "自动化", "QQ空间"], "categories": ["社交", "自动化", "QQ空间"],

18
src/plugins/built_in/permission_management/_manifest.json
View File

@@ -1,28 +1,22 @@
{ {
"manifest_version": 1, "manifest_version": 1,
"name": "插件和组件管理 (Plugin and Component Management)", "name": "权限管理插件（Permission Management）",
"version": "1.0.0", "version": "1.0.0",
"description": "通过系统API管理插件和组件的生命周期，包括加载、卸载、启用和禁用等操作。", "description": "通过系统API管理权限",
"author": { "author": {
"name": "MaiBot团队", "name": "MoFox-Studio",
"url": "https://github.com/MaiM-with-u" "url": "https://github.com/MoFox-Studio"
}, },
"license": "GPL-v3.0-or-later", "license": "GPL-v3.0-or-later",
"host_application": { "host_application": {
"min_version": "0.9.1" "min_version": "0.10.0"
}, },
"homepage_url": "https://github.com/MaiM-with-u/maibot",
"repository_url": "https://github.com/MaiM-with-u/maibot",
"keywords": [ "keywords": [
"plugins", "plugins",
"components", "permission",
"management", "management",
"built-in" "built-in"
], ],
"categories": [
"Core System",
"Plugin Management"
],
"default_locale": "zh-CN", "default_locale": "zh-CN",
"locales_path": "_locales", "locales_path": "_locales",
"plugin_info": { "plugin_info": {

5
src/plugins/built_in/permission_management/plugin.py
View File

@@ -24,11 +24,12 @@ class PermissionCommand(BaseCommand):
command_name = "permission" command_name = "permission"
command_description = "权限管理命令" command_description = "权限管理命令"
command_pattern = r"^/permission" command_pattern = r"^/permission(?:\s|$)"
command_help = "/permission <子命令> [参数...]" command_help = "/permission <子命令> [参数...]"
intercept_message = True intercept_message = True
def __init__(self): def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
# 注册权限节点 # 注册权限节点
permission_api.register_permission_node( permission_api.register_permission_node(
"plugin.permission.manage", "plugin.permission.manage",

2
src/plugins/built_in/plugin_management/plugin.py
View File

@@ -439,7 +439,7 @@ class PluginManagementPlugin(BasePlugin):
config_file_name: str = "config.toml" config_file_name: str = "config.toml"
config_schema: dict = { config_schema: dict = {
"plugin": { "plugin": {
"enabled": ConfigField(bool, default=True, description="是否启用插件"), "enabled": ConfigField(bool, default=False, description="是否启用插件"),
"config_version": ConfigField(type=str, default="1.1.0", description="配置文件版本"), "config_version": ConfigField(type=str, default="1.1.0", description="配置文件版本"),
"permission": ConfigField( "permission": ConfigField(
list, default=[], description="有权限使用插件管理命令的用户列表，请填写字符串形式的用户ID" list, default=[], description="有权限使用插件管理命令的用户列表，请填写字符串形式的用户ID"

6
src/plugins/built_in/web_search_tool/_manifest.json
View File

@@ -4,16 +4,14 @@
"version": "1.0.0", "version": "1.0.0",
"description": "一个用于在互联网上搜索信息的工具", "description": "一个用于在互联网上搜索信息的工具",
"author": { "author": {
"name": "MaiBot-Plus开发团队", "name": "MoFox-Studio",
"url": "https://github.com/MaiBot-Plus" "url": "https://github.com/MoFox-Studio"
}, },
"license": "GPL-v3.0-or-later", "license": "GPL-v3.0-or-later",
"host_application": { "host_application": {
"min_version": "0.10.0" "min_version": "0.10.0"
}, },
"homepage_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"repository_url": "https://github.com/MaiBot-Plus/MaiMbot-Pro-Max",
"keywords": ["web_search", "url_parser"], "keywords": ["web_search", "url_parser"],
"categories": ["web_search", "url_parser"], "categories": ["web_search", "url_parser"],

2
src/plugins/built_in/web_search_tool/plugin.py
View File

@@ -151,7 +151,7 @@ class WEBSEARCHPLUGIN(BasePlugin):
enable_tool = [] enable_tool = []
# 从主配置文件读取组件启用配置 # 从主配置文件读取组件启用配置
if True: if config_api.get_global_config("web_search.enable_web_search_tool", True):
enable_tool.append((WebSurfingTool.get_tool_info(), WebSurfingTool)) enable_tool.append((WebSurfingTool.get_tool_info(), WebSurfingTool))
if config_api.get_global_config("web_search.enable_url_tool", True): if config_api.get_global_config("web_search.enable_url_tool", True):