83 lines
2.4 KiB
Markdown
83 lines
2.4 KiB
Markdown
# MaiBot 与 Napcat 的 Adapter
|
|
运行方式：独立/放在MaiBot本体作为插件
|
|
|
|
# 使用说明
|
|
请参考[官方文档](https://docs.mai-mai.org/manual/adapters/napcat.html)
|
|
|
|
# 消息流转过程
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
participant Napcat as Napcat客户端
|
|
participant Adapter as MaiBot-Napcat适配器
|
|
participant Queue as 消息队列
|
|
participant Handler as 消息处理器
|
|
participant MaiBot as MaiBot服务
|
|
|
|
Note over Napcat,MaiBot: 初始化阶段
|
|
Napcat->>Adapter: WebSocket连接(ws://localhost:8095)
|
|
Adapter->>MaiBot: WebSocket连接(ws://localhost:8000)
|
|
|
|
Note over Napcat,MaiBot: 心跳检测
|
|
loop 每30秒
|
|
Napcat->>Adapter: 发送心跳包
|
|
Adapter->>Napcat: 心跳响应
|
|
end
|
|
|
|
Note over Napcat,MaiBot: 消息处理流程
|
|
Napcat->>Adapter: 发送消息
|
|
Adapter->>Queue: 消息入队(message_queue)
|
|
Queue->>Handler: 消息出队处理
|
|
Handler->>Handler: 解析消息类型
|
|
alt 文本消息
|
|
Handler->>MaiBot: 发送文本消息
|
|
else 图片消息
|
|
Handler->>MaiBot: 发送图片消息
|
|
else 混合消息
|
|
Handler->>MaiBot: 发送混合消息
|
|
else 转发消息
|
|
Handler->>MaiBot: 发送转发消息
|
|
end
|
|
MaiBot-->>Adapter: 消息响应
|
|
Adapter-->>Napcat: 消息响应
|
|
|
|
Note over Napcat,MaiBot: 优雅关闭
|
|
Adapter->>MaiBot: 关闭连接
|
|
Adapter->>Queue: 清空消息队列
|
|
Adapter->>Napcat: 关闭连接
|
|
```
|
|
|
|
|
|
# TO DO List
|
|
- [x] 读取自动心跳测试连接
|
|
- [x] 接受消息解析
|
|
- [x] 文本解析
|
|
- [x] 图片解析
|
|
- [x] 文本与消息混合解析
|
|
- [x] 转发解析（含图片动态解析）
|
|
- [ ] 群公告解析
|
|
- [x] 回复解析
|
|
- [ ] 群临时消息（可能不做）
|
|
- [ ] 链接解析
|
|
- [x] 戳一戳解析
|
|
- [x] 读取戳一戳的自定义内容
|
|
- [ ] 语音解析（？）
|
|
- [ ] 所有的notice类
|
|
- [x] 撤回（已添加相关指令）
|
|
- [x] 发送消息
|
|
- [x] 发送文本
|
|
- [x] 发送图片
|
|
- [x] 发送表情包
|
|
- [x] 引用回复（完成但是没测试）
|
|
- [ ] 戳回去（？）
|
|
- [x] 发送语音
|
|
- [x] 使用echo与uuid保证消息顺序
|
|
- [x] 执行部分管理员功能
|
|
- [x] 禁言别人
|
|
- [x] 全体禁言
|
|
- [x] 群踢人功能
|
|
|
|
# 特别鸣谢
|
|
特别感谢[@Maple127667](https://github.com/Maple127667)对本项目代码思路的支持
|
|
|
|
以及[@墨梓柒](https://github.com/DrSmoothl)对部分代码想法的支持 |