159 lines
4.3 KiB
Markdown
159 lines
4.3 KiB
Markdown
# MaiBot插件开发文档
|
||
|
||
> 欢迎来到MaiBot插件系统开发文档！这里是你开始插件开发旅程的最佳起点。
|
||
|
||
## 🎯 快速导航
|
||
|
||
### 🌟 新手入门
|
||
|
||
- [📖 快速开始指南](quick-start.md) - 5分钟创建你的第一个插件
|
||
- [🧱 Action组件详解](action-components.md) - 掌握最核心的Action组件
|
||
- [💻 Command组件详解](command-components.md) - 学习直接响应命令的组件
|
||
- [⚙️ 配置管理指南](configuration-guide.md) - 学会使用配置驱动开发
|
||
|
||
### 📖 API参考
|
||
|
||
- [📡 消息API](api/message-api.md) - 消息发送接口
|
||
|
||
### 🔧 高级主题
|
||
|
||
- [📦 依赖管理系统](dependency-management.md) - Python包依赖管理
|
||
- [🔧 工具系统详解](tool-system.md) - 工具系统的使用和开发
|
||
|
||
## 🔥 最新更新 (v2.0 新API格式)
|
||
|
||
### 🎉 重大变更
|
||
|
||
1. **新API格式**：
|
||
- 不再使用 `self.api`，改为直接方法调用
|
||
- `await self.send_text()` 替代旧的发送方式
|
||
- `await self.send_emoji()` 专门的表情发送方法
|
||
- `self.get_config()` 简化的配置访问
|
||
|
||
2. **replyer_1集成**：
|
||
- 新增专用的 `generator_api` 模块
|
||
- 在Action中直接使用 `replyer_1` 生成个性化内容
|
||
- 支持多种生成风格和情感色彩
|
||
|
||
3. **更好的类型安全**：
|
||
- 完整的类型注解支持
|
||
- 更清晰的返回值类型
|
||
- 更好的IDE支持
|
||
|
||
## 🚀 最佳学习路径
|
||
|
||
### 📚 初学者路径（推荐）
|
||
|
||
1. **基础入门**：
|
||
```
|
||
快速开始指南 → Action组件详解 → Command组件详解
|
||
```
|
||
|
||
2. **API掌握**：
|
||
```
|
||
消息API指南 → 配置管理指南
|
||
```
|
||
|
||
3. **高级功能**：
|
||
```
|
||
依赖管理系统 → 工具系统详解
|
||
```
|
||
|
||
## 💡 核心概念速览
|
||
|
||
### 🧱 Action组件
|
||
|
||
- **用途**：增强麦麦的主动行为，让对话更自然
|
||
- **激活**：关键词、LLM判断、随机等多种方式
|
||
- **新特性**：支持replyer_1智能生成、更简洁的API
|
||
|
||
### 💻 Command组件
|
||
|
||
- **用途**：响应用户的明确指令，提供确定性功能
|
||
- **触发**：正则表达式匹配用户输入
|
||
- **特点**：即时响应、参数解析、拦截控制
|
||
|
||
### ⚙️ 配置系统
|
||
|
||
- **Schema驱动**：使用ConfigField定义配置结构
|
||
- **类型安全**：强类型配置验证
|
||
- **嵌套访问**：支持 `section.key` 形式访问
|
||
|
||
### 🧠 replyer_1集成
|
||
|
||
- **智能生成**：AI驱动的个性化内容生成
|
||
- **简单易用**：通过 `generator_api` 轻松调用
|
||
- **灵活配置**：支持多种生成风格和参数
|
||
|
||
## 📋 开发清单
|
||
|
||
在开始开发之前，确保你已经：
|
||
|
||
- [ ] 阅读了[快速开始指南](quick-start.md)
|
||
- [ ] 了解了Action组件或Command组件
|
||
- [ ] 熟悉了[Action组件](action-components.md)或[Command组件](command-components.md)
|
||
- [ ] 查看了[配置管理](configuration-guide.md)
|
||
|
||
开发完成后，请检查：
|
||
|
||
- [ ] 使用了新的API格式（`self.send_text()`等）
|
||
- [ ] 正确配置了Schema和ConfigField
|
||
- [ ] 添加了适当的错误处理
|
||
- [ ] 测试了所有功能路径
|
||
|
||
## 🤝 获取帮助
|
||
|
||
### 📖 文档问题
|
||
|
||
如果你在文档中发现错误或需要补充，请：
|
||
|
||
1. 检查最新的文档版本
|
||
2. 查看相关示例代码
|
||
3. 参考其他类似插件
|
||
|
||
### 💻 开发问题
|
||
|
||
遇到开发问题时：
|
||
|
||
1. 查看现有插件示例
|
||
2. 检查配置是否正确
|
||
3. 参考API文档
|
||
|
||
### 🎯 最佳实践建议
|
||
|
||
为了创建高质量的插件：
|
||
|
||
1. 始终使用新的API格式
|
||
2. 充分利用replyer_1的智能生成能力
|
||
3. 设计配置驱动的功能
|
||
4. 实现完善的错误处理
|
||
5. 编写清晰的文档注释
|
||
|
||
---
|
||
|
||
## 🌟 推荐插件示例
|
||
|
||
### 🎯 新手友好
|
||
|
||
- **Hello World插件**：展示基础API使用
|
||
- **简单计算器**：Command组件入门
|
||
- **智能问候**：Action组件和replyer_1集成
|
||
|
||
### 🔧 实用工具
|
||
|
||
- **智能聊天助手**：完整的replyer_1集成示例
|
||
- **用户管理系统**：配置驱动的复杂功能
|
||
- **定时提醒插件**：状态管理和持久化
|
||
|
||
### 🚀 高级应用
|
||
|
||
- **多功能聊天助手**：综合功能展示
|
||
- **游戏管理插件**：复杂状态管理
|
||
- **数据分析插件**：外部服务集成
|
||
|
||
---
|
||
|
||
**🎉 准备好开始了吗？从[快速开始指南](quick-start.md)开始你的插件开发之旅！**
|
||
|
||
使用新的API格式，你可以创建更强大、更智能、更易维护的插件。让我们一起构建更好的MaiBot生态系统！
|