feat: 新增自动同意请求插件和API文档

docs: 更新文档结构和内容
This commit is contained in:
2026-01-14 23:53:56 +08:00
parent 520462b4c6
commit 03bcded7ed
10 changed files with 1998 additions and 1 deletions

61
docs/api/index.md Normal file
View 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) 开始,因为发消息是最常用的功能。