eb1feeeb0b
将工具缓存的实现从`ToolExecutor`的装饰器模式重构为直接集成。缓存逻辑被移出`cache_manager.py`并整合进`ToolExecutor.execute_tool_call`方法中，简化了代码结构并使其更易于维护。 主要变更： - 从`cache_manager.py`中移除了`wrap_tool_executor`函数。 - 在`tool_use.py`中，`execute_tool_call`现在包含完整的缓存检查和设置逻辑。 - 调整了`llm_models/utils_model.py`中的LLM请求逻辑，为模型生成的空回复或截断响应增加了内部重试机制，增强了稳定性。 - 清理了项目中未使用的导入和过时的文档文件，以保持代码库的整洁。
81 lines
2.9 KiB
Markdown
81 lines
2.9 KiB
Markdown
# MoFox_Bot插件开发文档
|
||
|
||
> 欢迎来到MoFox_Bot插件系统开发文档！这里是你开始插件开发旅程的最佳起点。
|
||
|
||
## 新手入门
|
||
|
||
- [📖 快速开始指南](quick-start.md) - 快速创建你的第一个插件
|
||
|
||
## 组件功能详解
|
||
|
||
- [🧱 Action组件详解](action-components.md) - 掌握最核心的Action组件
|
||
- [💻 Command组件详解](PLUS_COMMAND_GUIDE.md) - 学习直接响应命令的组件
|
||
- [🔧 Tool组件详解](tool-components.md) - 了解如何扩展信息获取能力
|
||
- [⚙️ 配置文件系统指南](configuration-guide.md) - 学会使用自动生成的插件配置文件
|
||
- [📄 Manifest系统指南](manifest-guide.md) - 了解插件元数据管理和配置架构
|
||
|
||
Command vs Action 选择指南
|
||
|
||
1. 使用Command的场景
|
||
|
||
- ✅ 用户需要明确调用特定功能
|
||
- ✅ 需要精确的参数控制
|
||
- ✅ 管理和配置操作
|
||
- ✅ 查询和信息显示
|
||
- ✅ 系统维护命令
|
||
|
||
2. 使用Action的场景
|
||
|
||
- ✅ 增强麦麦的智能行为
|
||
- ✅ 根据上下文自动触发
|
||
- ✅ 情绪和表情表达
|
||
- ✅ 智能建议和帮助
|
||
- ✅ 随机化的互动
|
||
|
||
|
||
## API浏览
|
||
|
||
### 消息发送与处理API
|
||
- [📤 发送API](api/send-api.md) - 各种类型消息发送接口
|
||
- [消息API](api/message-api.md) - 消息获取，消息构建，消息查询接口
|
||
- [聊天流API](api/chat-api.md) - 聊天流管理和查询接口
|
||
|
||
### AI与生成API
|
||
- [LLM API](api/llm-api.md) - 大语言模型交互接口，可以使用内置LLM生成内容
|
||
- [✨ 回复生成器API](api/generator-api.md) - 智能回复生成接口，可以使用内置风格化生成器
|
||
|
||
### 表情包API
|
||
- [😊 表情包API](api/emoji-api.md) - 表情包选择和管理接口
|
||
|
||
### 关系系统API
|
||
- [人物信息API](api/person-api.md) - 用户信息，处理麦麦认识的人和关系的接口
|
||
|
||
### 数据与配置API
|
||
- [🗄️ 数据库API](api/database-api.md) - 数据库操作接口
|
||
- [⚙️ 配置API](api/config-api.md) - 配置读取和用户信息接口
|
||
|
||
### 插件和组件管理API
|
||
- [🔌 插件API](api/plugin-manage-api.md) - 插件加载和管理接口
|
||
- [🧩 组件API](api/component-manage-api.md) - 组件注册和管理接口
|
||
|
||
### 日志API
|
||
- [📜 日志API](api/logging-api.md) - logger实例获取接口
|
||
### 工具API
|
||
- [🔧 工具API](api/tool-api.md) - tool获取接口
|
||
|
||
|
||
|
||
## 支持
|
||
|
||
> 如果你在文档中发现错误或需要补充，请：
|
||
|
||
1. 检查最新的文档版本
|
||
2. 查看相关示例代码
|
||
3. 参考其他类似插件
|
||
4. 提交文档仓库issue
|
||
|
||
## 一个方便的小设计
|
||
|
||
我们在`__init__.py`中定义了一个`__all__`变量，包含了所有需要导出的类和函数。
|
||
这样在其他地方导入时，可以直接使用 `from src.plugin_system import *` 来导入所有插件相关的类和函数。
|
||
或者你可以直接使用 `from src.plugin_system import BasePlugin, register_plugin, ComponentInfo` 之类的方式来导入你需要的部分。 |