MaiBot 与 Napcat 的 Adapter

运行方式：独立/放在MaiBot本体作为插件

使用说明

首先，napcat开websocket客户端，设置URL为类似这样：ws://localhost:8095

然后说明一下配置文件：

[Nickname] # 现在没用
nickname = ""

[Napcat_Server] # Napcat连接的ws服务设置
host = "localhost" # Napcat设定的url地址
port = 8095        # Napcat设定的ws端口

[MaiBot_Server] # 连接麦麦的ws服务设置
platform_name = "qq" # 标识adapter的名称（必填）
host = "localhost"   # 麦麦在.env文件中设置的url地址
port = 8000          # 麦麦在.env文件中设置的ws端口

[Napcat]
heartbeat = 30 # 与Napcat设置的心跳相同（按秒计）

[Whitelist] # 白名单功能（未启用）（未实现）
group_list = []
private_list = []
enable_temp = false

[Debug]
level = "INFO" # 日志等级（DEBUG, INFO, WARNING, ERROR）

你需要的就是把template_config.toml复制到根目录，然后改

至于requirements，需要maim_message，安装略

消息流转过程

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

• 读取自动心跳测试连接

• 接受消息解析

  • 文本解析
  • 图片解析
  • 文本与消息混合解析
  • 转发解析（含图片动态解析）
  • 群公告解析
  • 回复解析
  • 群临时消息（可能不做）
  • 链接解析
  • 戳一戳解析
    • 读取戳一戳的自定义内容
  • 语音解析（？）
  • 所有的notice类
    • 撤回

• 发送消息

  • 发送文本
  • 发送图片
  • 发送表情包
  • 引用回复（完成但是没测试）
  • 戳回去（？）
  • 发送语音

• 使用echo与uuid保证消息顺序

  特别鸣谢

  特别感谢@Maple127667对本项目代码思路的支持