feat: 新增自动同意请求插件和API文档
docs: 更新文档结构和内容
This commit is contained in:
61
docs/api/index.md
Normal file
61
docs/api/index.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# API 参考
|
||||
|
||||
嘿,这里是 NEO Bot 的 API 参考文档。
|
||||
|
||||
如果你在写插件,那这里就是你的工具库。所有能和 OneBot 交互的方法都在这了。
|
||||
|
||||
## 快速导航
|
||||
|
||||
### 1. 基础概念
|
||||
- [API 调用方式](./base.md): 怎么调用 API、参数格式、返回格式
|
||||
- [消息段 (MessageSegment)](./message.md#消息段): 除了文字,还能发图片、表情、@人……
|
||||
|
||||
### 2. 分类 API
|
||||
- [消息 API](./message.md): 发消息、撤回、转发
|
||||
- [群组 API](./group.md): 管群、禁言、踢人、改名片
|
||||
- [好友 API](./friend.md): 好友列表、点赞、加好友请求
|
||||
- [账号 API](./account.md): 机器人自己的信息、状态设置
|
||||
- [媒体 API](./media.md): 图片、语音相关
|
||||
|
||||
### 3. 高级功能
|
||||
- [合并转发](./message.md#合并转发): 怎么发那种一条消息展开好多条的“聊天记录”
|
||||
- [智能回复](./message.md#智能回复): `event.reply()` 和 `bot.send()` 怎么选
|
||||
|
||||
## 怎么用这些 API
|
||||
|
||||
在插件里,你拿到的 `event` 对象自带一个 `bot` 属性,那就是你的机器人实例:
|
||||
|
||||
```python
|
||||
from core.managers.command_manager import matcher
|
||||
from models.events.message import MessageEvent
|
||||
|
||||
@matcher.command("test")
|
||||
async def handle_test(event: MessageEvent):
|
||||
# 方法 1: 快捷回复(推荐)
|
||||
await event.reply("你好!")
|
||||
|
||||
# 方法 2: 直接调用 bot 上的 API
|
||||
bot = event.bot
|
||||
await bot.send_group_msg(123456, "这是一条群消息")
|
||||
|
||||
# 方法 3: 如果你只有 bot 实例,没有 event
|
||||
# (这种情况比较少见,一般只在初始化时用到)
|
||||
await bot.get_login_info()
|
||||
```
|
||||
|
||||
大部分时候,用 `event.reply()` 就够了。它帮你判断是群聊还是私聊,自动调用正确的 API。
|
||||
|
||||
## 兼容性说明
|
||||
|
||||
NEO Bot 基于 **OneBot v11** 标准实现,兼容:
|
||||
- [NapCatQQ](https://github.com/NapNeko/NapCatQQ) (推荐)
|
||||
- go-cqhttp
|
||||
- 以及其他实现了 OneBot v11 标准的客户端
|
||||
|
||||
但要注意:不同客户端的实现细节可能有差异。比如某些 API 可能不支持,或者参数格式稍有不同。
|
||||
|
||||
如果你发现某个 API 调用失败,先看看日志里的错误信息,或者去对应客户端的文档里查查。
|
||||
|
||||
## 接下来?
|
||||
|
||||
挑一个你感兴趣的类别开始看吧。建议从 [消息 API](./message.md) 开始,因为发消息是最常用的功能。
|
||||
Reference in New Issue
Block a user