onebots 0.4.22 → 0.4.25

package/README.md

@@ -1,52 +1,63 @@
 <div align="center">
-    <h1>基于icqq的oneBot实现</h1>
+    <h1>使用ts实现的oneBot应用启动器，支持icqq和qq官方机器人</h1>
     <p>
 
-[![npm](https://img.shields.io/npm/v/onebots)](https://www.npmjs.com/package/onebots)
-[![Release and Publish](https://github.com/icqqjs/onebots/actions/workflows/release.yml/badge.svg?branch=master&event=push)](https://github.com/icqqjs/onebots/actions/workflows/release.yml)
-[![dm](https://shields.io/npm/dm/onebots)](https://www.npmjs.com/package/onebots)
-[![oneBot V11](https://img.shields.io/badge/OneBot-11-black?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAHAAAABwCAMAAADxPgR5AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAAxQTFRF////29vbr6+vAAAAk1hCcwAAAAR0Uk5T////AEAqqfQAAAKcSURBVHja7NrbctswDATQXfD//zlpO7FlmwAWIOnOtNaTM5JwDMa8E+PNFz7g3waJ24fviyDPgfhz8fHP39cBcBL9KoJbQUxjA2iYqHL3FAnvzhL4GtVNUcoSZe6eSHizBcK5LL7dBr2AUZlev1ARRHCljzRALIEog6H3U6bCIyqIZdAT0eBuJYaGiJaHSjmkYIZd+qSGWAQnIaz2OArVnX6vrItQvbhZJtVGB5qX9wKqCMkb9W7aexfCO/rwQRBzsDIsYx4AOz0nhAtWu7bqkEQBO0Pr+Ftjt5fFCUEbm0Sbgdu8WSgJ5NgH2iu46R/o1UcBXJsFusWF/QUaz3RwJMEgngfaGGdSxJkE/Yg4lOBryBiMwvAhZrVMUUvwqU7F05b5WLaUIN4M4hRocQQRnEedgsn7TZB3UCpRrIJwQfqvGwsg18EnI2uSVNC8t+0QmMXogvbPg/xk+Mnw/6kW/rraUlvqgmFreAA09xW5t0AFlHrQZ3CsgvZm0FbHNKyBmheBKIF2cCA8A600aHPmFtRB1XvMsJAiza7LpPog0UJwccKdzw8rdf8MyN2ePYF896LC5hTzdZqxb6VNXInaupARLDNBWgI8spq4T0Qb5H4vWfPmHo8OyB1ito+AysNNz0oglj1U955sjUN9d41LnrX2D/u7eRwxyOaOpfyevCWbTgDEoilsOnu7zsKhjRCsnD/QzhdkYLBLXjiK4f3UWmcx2M7PO21CKVTH84638NTplt6JIQH0ZwCNuiWAfvuLhdrcOYPVO9eW3A67l7hZtgaY9GZo9AFc6cryjoeFBIWeU+npnk/nLE0OxCHL1eQsc1IciehjpJv5mqCsjeopaH6r15/MrxNnVhu7tmcslay2gO2Z1QfcfX0JMACG41/u0RrI9QAAAABJRU5ErkJggg==)](https://onebot.dev/)
-[![oneBot V12](https://img.shields.io/badge/OneBot-12-black?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAHAAAABwCAMAAADxPgR5AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAAxQTFRF////29vbr6+vAAAAk1hCcwAAAAR0Uk5T////AEAqqfQAAAKcSURBVHja7NrbctswDATQXfD//zlpO7FlmwAWIOnOtNaTM5JwDMa8E+PNFz7g3waJ24fviyDPgfhz8fHP39cBcBL9KoJbQUxjA2iYqHL3FAnvzhL4GtVNUcoSZe6eSHizBcK5LL7dBr2AUZlev1ARRHCljzRALIEog6H3U6bCIyqIZdAT0eBuJYaGiJaHSjmkYIZd+qSGWAQnIaz2OArVnX6vrItQvbhZJtVGB5qX9wKqCMkb9W7aexfCO/rwQRBzsDIsYx4AOz0nhAtWu7bqkEQBO0Pr+Ftjt5fFCUEbm0Sbgdu8WSgJ5NgH2iu46R/o1UcBXJsFusWF/QUaz3RwJMEgngfaGGdSxJkE/Yg4lOBryBiMwvAhZrVMUUvwqU7F05b5WLaUIN4M4hRocQQRnEedgsn7TZB3UCpRrIJwQfqvGwsg18EnI2uSVNC8t+0QmMXogvbPg/xk+Mnw/6kW/rraUlvqgmFreAA09xW5t0AFlHrQZ3CsgvZm0FbHNKyBmheBKIF2cCA8A600aHPmFtRB1XvMsJAiza7LpPog0UJwccKdzw8rdf8MyN2ePYF896LC5hTzdZqxb6VNXInaupARLDNBWgI8spq4T0Qb5H4vWfPmHo8OyB1ito+AysNNz0oglj1U955sjUN9d41LnrX2D/u7eRwxyOaOpfyevCWbTgDEoilsOnu7zsKhjRCsnD/QzhdkYLBLXjiK4f3UWmcx2M7PO21CKVTH84638NTplt6JIQH0ZwCNuiWAfvuLhdrcOYPVO9eW3A67l7hZtgaY9GZo9AFc6cryjoeFBIWeU+npnk/nLE0OxCHL1eQsc1IciehjpJv5mqCsjeopaH6r15/MrxNnVhu7tmcslay2gO2Z1QfcfX0JMACG41/u0RrI9QAAAABJRU5ErkJggg==)](https://12.onebot.dev/)
-[![node engine](https://img.shields.io/node/v/onebots?color=339933&style=flat-square&labelColor=FAFAFA&logo=Node.js)](https://nodejs.org)
+[![npm](https://img.shields.io/npm/v/onebots)](https://www.npmjs.com/package/onebots) [![Release and Publish](https://github.com/icqqjs/onebots/actions/workflows/release.yml/badge.svg?branch=master&event=push)](https://github.com/icqqjs/onebots/actions/workflows/release.yml) [![dm](https://shields.io/npm/dm/onebots)](https://www.npmjs.com/package/onebots) [![oneBot V11](https://img.shields.io/badge/OneBot-11-black?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAHAAAABwCAMAAADxPgR5AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAAxQTFRF////29vbr6+vAAAAk1hCcwAAAAR0Uk5T////AEAqqfQAAAKcSURBVHja7NrbctswDATQXfD//zlpO7FlmwAWIOnOtNaTM5JwDMa8E+PNFz7g3waJ24fviyDPgfhz8fHP39cBcBL9KoJbQUxjA2iYqHL3FAnvzhL4GtVNUcoSZe6eSHizBcK5LL7dBr2AUZlev1ARRHCljzRALIEog6H3U6bCIyqIZdAT0eBuJYaGiJaHSjmkYIZd+qSGWAQnIaz2OArVnX6vrItQvbhZJtVGB5qX9wKqCMkb9W7aexfCO/rwQRBzsDIsYx4AOz0nhAtWu7bqkEQBO0Pr+Ftjt5fFCUEbm0Sbgdu8WSgJ5NgH2iu46R/o1UcBXJsFusWF/QUaz3RwJMEgngfaGGdSxJkE/Yg4lOBryBiMwvAhZrVMUUvwqU7F05b5WLaUIN4M4hRocQQRnEedgsn7TZB3UCpRrIJwQfqvGwsg18EnI2uSVNC8t+0QmMXogvbPg/xk+Mnw/6kW/rraUlvqgmFreAA09xW5t0AFlHrQZ3CsgvZm0FbHNKyBmheBKIF2cCA8A600aHPmFtRB1XvMsJAiza7LpPog0UJwccKdzw8rdf8MyN2ePYF896LC5hTzdZqxb6VNXInaupARLDNBWgI8spq4T0Qb5H4vWfPmHo8OyB1ito+AysNNz0oglj1U955sjUN9d41LnrX2D/u7eRwxyOaOpfyevCWbTgDEoilsOnu7zsKhjRCsnD/QzhdkYLBLXjiK4f3UWmcx2M7PO21CKVTH84638NTplt6JIQH0ZwCNuiWAfvuLhdrcOYPVO9eW3A67l7hZtgaY9GZo9AFc6cryjoeFBIWeU+npnk/nLE0OxCHL1eQsc1IciehjpJv5mqCsjeopaH6r15/MrxNnVhu7tmcslay2gO2Z1QfcfX0JMACG41/u0RrI9QAAAABJRU5ErkJggg==)](https://onebot.dev/)
+[![oneBot V12](https://img.shields.io/badge/OneBot-12-black?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAHAAAABwCAMAAADxPgR5AAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAAxQTFRF////29vbr6+vAAAAk1hCcwAAAAR0Uk5T////AEAqqfQAAAKcSURBVHja7NrbctswDATQXfD//zlpO7FlmwAWIOnOtNaTM5JwDMa8E+PNFz7g3waJ24fviyDPgfhz8fHP39cBcBL9KoJbQUxjA2iYqHL3FAnvzhL4GtVNUcoSZe6eSHizBcK5LL7dBr2AUZlev1ARRHCljzRALIEog6H3U6bCIyqIZdAT0eBuJYaGiJaHSjmkYIZd+qSGWAQnIaz2OArVnX6vrItQvbhZJtVGB5qX9wKqCMkb9W7aexfCO/rwQRBzsDIsYx4AOz0nhAtWu7bqkEQBO0Pr+Ftjt5fFCUEbm0Sbgdu8WSgJ5NgH2iu46R/o1UcBXJsFusWF/QUaz3RwJMEgngfaGGdSxJkE/Yg4lOBryBiMwvAhZrVMUUvwqU7F05b5WLaUIN4M4hRocQQRnEedgsn7TZB3UCpRrIJwQfqvGwsg18EnI2uSVNC8t+0QmMXogvbPg/xk+Mnw/6kW/rraUlvqgmFreAA09xW5t0AFlHrQZ3CsgvZm0FbHNKyBmheBKIF2cCA8A600aHPmFtRB1XvMsJAiza7LpPog0UJwccKdzw8rdf8MyN2ePYF896LC5hTzdZqxb6VNXInaupARLDNBWgI8spq4T0Qb5H4vWfPmHo8OyB1ito+AysNNz0oglj1U955sjUN9d41LnrX2D/u7eRwxyOaOpfyevCWbTgDEoilsOnu7zsKhjRCsnD/QzhdkYLBLXjiK4f3UWmcx2M7PO21CKVTH84638NTplt6JIQH0ZwCNuiWAfvuLhdrcOYPVO9eW3A67l7hZtgaY9GZo9AFc6cryjoeFBIWeU+npnk/nLE0OxCHL1eQsc1IciehjpJv5mqCsjeopaH6r15/MrxNnVhu7tmcslay2gO2Z1QfcfX0JMACG41/u0RrI9QAAAABJRU5ErkJggg==)](https://12.onebot.dev/) [![node engine](https://img.shields.io/node/v/onebots?color=339933&style=flat-square&labelColor=FAFAFA&logo=Node.js)](https://nodejs.org)
 [![qq group](https://img.shields.io/badge/group-860669870-blue?style=flat-square&labelColor=FAFAFA&logo=data:image/png;base64,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&logoColor=000000)](https://jq.qq.com/?_wv=1027&k=B22VGXov)
 
-
-
-[Type Docs](https://lc-cn.github.io/onebots) 
-
+[Type Docs](https://lc-cn.github.io/onebots)
 
 </p>
 </div>
 
 # 使用示例
+
 ## 全局安装(0.4.8以后不推荐)
+
 ### 1 安装依赖
+
 ```shell
 npm install -g onebots
 # 0.4.8以上版本需要安装icqq
 npm install -g icqq
 ```
+
 ### 2 初始化配置文件
+
 在你想存放配置文件的目录执行如下命令
+
 ```shell
 onebots
 ```
+
 ### 3 更改生成的默认配置文件成你想要的配置配置后再次运行上面的指令，启动项目
+
 ## 局部安装
+
 ## 1 初始化node项目
+
 ```shell
 npm init -y
 ```
+
 ## 2. 安装onebots和icqq
+
 ```shell
 npm install onebots icqq
 ```
+
 ## 3. 执行如下命令生成配置文件
+
 ```shell
-npx onebots
+npx onebots -r icqq #注册icqq适配器并启动onebots
+npx onebots -r qq #注册qq官方适配器并启动onebots
 ```
+
 ## 4. 更改生成的默认配置文件成你想要的配置配置后再次运行上面的指令，启动项目
+
 # 默认配置文件
+
 ```yaml
 port: 6727 # 监听端口
 log_level: info # 日志等级
@@ -55,9 +66,9 @@ timeout: 30 #登录超时时间(秒)
 general: # 通用配置，在单个配置省略时的默认值
   V11: # oneBotV11的通用配置
     heartbeat: 3 # 心跳间隔 (秒)
-    access_token: '' # 访问api的token
+    access_token: "" # 访问api的token
     post_timeout: 15 # 上报超时时间，(秒)
-    secret: '' # 上报数据的sha1签名密钥
+    secret: "" # 上报数据的sha1签名密钥
     rate_limit_interval: 4 # ws心跳间隔(秒)
     post_message_format: string # "string"或"array"
     reconnect_interval: 3 # 重连间隔 (秒)
@@ -65,120 +76,159 @@ general: # 通用配置，在单个配置省略时的默认值
     enable_cors: true # 是否允许跨域
     filters: {} # 过滤器配置
     use_ws: true # 是否使用websocket
-    http_reverse: [ ] # http上报地址
-    ws_reverse: [ ] # 反向ws连接地址
+    http_reverse: [] # http上报地址
+    ws_reverse: [] # 反向ws连接地址
   V12: # oneBotV12的通用配置
     heartbeat: 3 # 心跳间隔 (秒)
-    access_token: '' # 访问api的token
+    access_token: "" # 访问api的token
     request_timeout: 15 # 上报超时时间 (秒)
     reconnect_interval: 3 # 重连间隔 (秒)
     enable_cors: true # 是否允许跨域
     use_http: true # 是否启用http
     use_ws: true # 是否启用 websocket
     filters: {} # 过滤器配置
-    webhook: [ ] # http 上报地址
-    ws_reverse: [ ] # 反向ws连接地址
+    webhook: [] # http 上报地址
+    ws_reverse: [] # 反向ws连接地址
   protocol:
     platform: 2
-    sign_api_addr: '' #你的签名地址
-    password: '' # 账号密码，未配置则扫码登陆
+    sign_api_addr: "" #你的签名地址
+    password: "" # 账号密码，未配置则扫码登陆
     # ...其他配置项参考icqq的Config配置
 # 每个账号的单独配置(用于覆盖通用配置)
-123456789:
-  password: '' # 账号密码，未配置则扫码登陆
+icqq.123456789:
+  password: "" # 账号密码，未配置则扫码登陆
   version: V11 # 使用的oneBot版本
   # ...其他配置项参见上方对应oneBot版本的通用配置
   protocol:
     platform: 2
-    sign_api_addr: '' #你的签名地址
+    sign_api_addr: "" #你的签名地址
     # ...其他配置项参考icqq的Config配置
+
+qq.123456789: # `${适配器名称}:${appId}`
+  versions:
+    - version: V11
+  # 。。。其他配置项参见上方对应oneBot版本的通用配置
+  protocol: # 将会覆盖通用配置中的protocol
+    token: '' # qq机器人token
+    secret: '' # qq机器人secret
+    sandbox: false # 是否沙箱环境
+    intents: # 需要监听的intents
+      - 'GROUP_AT_MESSAGE_CREATE' # 群聊@事件 没有群聊权限请注释
+      - 'C2C_MESSAGE_CREATE' # 私聊事件 没有私聊权限请注释
+      - 'DIRECT_MESSAGE' # 频道私信事件
+      #     - 'GUILD_MESSAGES' # 私域机器人频道消息事件，公域机器人请注释
+      - 'GUILDS' # 频道变更事件
+      - 'GUILD_MEMBERS' # 频道成员变更事件
+      - 'GUILD_MESSAGE_REACTIONS' # 频道消息表态事件
+      - 'INTERACTION' # 互动事件
+      - 'PUBLIC_GUILD_MESSAGES' # 公域机器人频道消息事件，私域机器人请注释
+  # 。。。其他配置项参见上方对应oneBot版本的通用配置
+
 ```
 
 # 配置解释
 
 ## Config
-| 配置项      | 类型                           | 默认值     | desc   |
-|:---------|:-----------------------------|:--------|:-------|
+
+| 配置项   | 类型                         | 默认值  | desc         |
+| :------- | :--------------------------- | :------ | :----------- |
 | port     | number                       | 6727    | 服务监听端口 |
-| logLevel | string                       | info    | 日志级别   |
-| general  | OneBotConfig                 | general | 通用配置   |
-| [number] | OneBotConfig\|OneBotConfig[] | -       | 机器人配置  |
+| logLevel | string                       | info    | 日志级别     |
+| general  | OneBotConfig                 | general | 通用配置     |
+| [number] | OneBotConfig\|OneBotConfig[] | -       | 机器人配置   |
+
 ## OneBotConfig
-| 配置项      | 类型        | 默认值       | desc               |
-|:---------|:----------|:----------|:-------------------|
+
+| 配置项   | 类型      | 默认值    | desc                                |
+| :------- | :-------- | :-------- | :---------------------------------- |
 | password | string    | -         | 账号密码 未填写或填写为空则扫码登陆 |
-| V11      | ConfigV11 | configV11 | V11配置              |
-| V12      | ConfigV12 | configV12 | V12配置              |
-| protocol | Config    | {}        | icqq配置             |
+| V11      | ConfigV11 | configV11 | V11配置                             |
+| V12      | ConfigV12 | configV12 | V12配置                             |
+| protocol | Config    | {}        | icqq配置                            |
+
 ## ConfigV11
-| 配置项                 | 类型       | 默认值    | desc       |
-|:--------------------|:---------|:-------|:-----------|
-| heartbeat           | number   | 3      | 心跳间隔 单位：秒  |
-| access_token        | string   | -      | 访问令牌       |
-| secret              | string   | -      | 签名密钥       |
-| rate_limit_interval | number   | 4      | 限速间隔 单位：秒  |
-| post_message_format | string   | string | 消息格式化      |
-| reconnect_interval  | number   | 3      | 重连间隔 单位：秒  |
-| use_http            | boolean  | false  | 是否使用http协议 |
-| enable_cors         | boolean  | false  | 是否允许跨域     |
+
+| 配置项              | 类型     | 默认值 | desc              |
+| :------------------ | :------- | :----- | :---------------- |
+| heartbeat           | number   | 3      | 心跳间隔 单位：秒 |
+| access_token        | string   | -      | 访问令牌          |
+| secret              | string   | -      | 签名密钥          |
+| rate_limit_interval | number   | 4      | 限速间隔 单位：秒 |
+| post_message_format | string   | string | 消息格式化        |
+| reconnect_interval  | number   | 3      | 重连间隔 单位：秒 |
+| use_http            | boolean  | false  | 是否使用http协议  |
+| enable_cors         | boolean  | false  | 是否允许跨域      |
 | filters             | Filters  | {}     | 事件过滤器配置    |
-| use_ws              | boolean  | false  | 是否使用ws协议   |
-| http_reverse_url    | string[] | -      | http上报地址地址 |
-| ws_reverse_url      | string[] | -      | 反向ws连接地址   |
+| use_ws              | boolean  | false  | 是否使用ws协议    |
+| http_reverse_url    | string[] | -      | http上报地址地址  |
+| ws_reverse_url      | string[] | -      | 反向ws连接地址    |
+
 ## ConfigV12
-| 配置项                 | 类型       | 默认值   | desc        |
-|:--------------------|:---------|:------|:------------|
-| heartbeat           | number   | 3     | 心跳间隔 单位：秒   |
-| access_token        | string   | -     | 访问令牌        |
-| request_timeout     | number   | 15    | 请求超时 单位：秒   |
-| reconnect_interval  | number   | 3     | 重连间隔 单位：秒   |
-| enable_cors         | boolean  | false | 是否允许跨域      |
+
+| 配置项              | 类型     | 默认值 | desc              |
+| :------------------ | :------- | :----- | :---------------- |
+| heartbeat           | number   | 3      | 心跳间隔 单位：秒 |
+| access_token        | string   | -      | 访问令牌          |
+| request_timeout     | number   | 15     | 请求超时 单位：秒 |
+| reconnect_interval  | number   | 3      | 重连间隔 单位：秒 |
+| enable_cors         | boolean  | false  | 是否允许跨域      |
 | filters             | Filters  | {}     | 事件过滤器配置    |
-| use_http            | boolean  | false | 是否使用http协议  |
-| use_ws              | boolean  | false | 是否使用ws协议    |
-| webhook_reverse_url | string[] | -     | webhook上报地址 |
-| ws_reverse_url      | string[] | -     | 反向ws连接地址    |
+| use_http            | boolean  | false  | 是否使用http协议  |
+| use_ws              | boolean  | false  | 是否使用ws协议    |
+| webhook_reverse_url | string[] | -      | webhook上报地址   |
+| ws_reverse_url      | string[] | -      | 反向ws连接地址    |
+
 # 事件过滤器
+
 ## 语法说明
+
 - `onebots` 的事件过滤器最外层是一个JSON对象，其中的键是键如果是运算法，则值作为运算符的参数，如果不是运算符，则表示对事件数据对象相应 `key` 进行过滤。
 - 过滤规则中任何一个对象, 只有在它的所有项都匹配的情况下, 才会让事件通过（等价于一个 and 运算），如果值为一个数组，则表示事件对应 `key` 值需满足其中一个。
 - 可用逻辑运算符有：`$and` (逻辑与) 、`$or` (逻辑或) 、 `$not` (逻辑非)、`$nor` (逻辑异或)、`$regexp` (文本正则匹配)、`$like` (文本模糊匹配)、`$gt` (数值大于比较)、`$gte` (数值大于等于比较)、`$lt` (数值小于比较)、`$lte` (数值小于等于比较)、`$between` (数值范围比较)
+
 ## 示例
+
 ### 1. 仅上报私聊事件
+
 ```yaml
 filters:
   message_type: private
 ```
+
 ### 2. 私聊或指定群聊
+
 ```yaml
 filters:
   $or:
     message_type: private
-    group_id: 
-      - 123456789
-        987654321
+    group_id:
+      - 123456789 987654321
 ```
+
 ### 3. 私聊事件且不是指定用户
+
 ```yaml
 filters:
   message_type: private
   $not:
     user_id:
-      - 123456789
-        987654321
+      - 123456789 987654321
 ```
+
 ### 4. 私聊事件(排除指定用户的事件)或指定群聊事件
+
 ```yaml
 filters:
   $or:
     - message_type: private
       $not:
         user_id: 123456789
-    -  
-      message_type: group
+    - message_type: group
       group_id: 987654321
 ```
+
 ### 5. 仅上报消息事件且用户年龄大于18岁
+
 ```yaml
 filters:
   type: message
@@ -186,14 +236,18 @@ filters:
     age:
       $gt: 18
 ```
+
 ### 6. 仅上报消息事件且消息内容以！开头的消息
+
 ```yaml
 filters:
   type: message
   raw_message:
     .regexp: '^！|\!'
 ```
+
 ### 7. 不上报消息内容包含`cnm`的消息
+
 ```yaml
 filters:
   $not:
@@ -201,16 +255,19 @@ filters:
     raw_message:
       $like: cnm
 ```
+
 # 使用API管理oneBot
 
-| url     | method | params          | desc                           |
-|:--------|:-------|:----------------|:-------------------------------|
-| /list   | GET    |                 | 获取当前运行的机器人列表                   |
-| /detail | GET    | uin             | 获取指定机器人配置                      |
-| /qrcode | GET    | uin             | 获取指定机器人登录二维码                   |
-| /add    | POST   | {uin,...config} | 添加机器人 config 为机器人配置            |
-| /edit   | POST   | {uin,...config} | 修改机器人配置 config 为机器人配置          |
+| url     | method | params          | desc                                           |
+| :------ | :----- | :-------------- | :--------------------------------------------- |
+| /list   | GET    |                 | 获取当前运行的机器人列表                       |
+| /detail | GET    | uin             | 获取指定机器人配置                             |
+| /qrcode | GET    | uin             | 获取指定机器人登录二维码                       |
+| /add    | POST   | {uin,...config} | 添加机器人 config 为机器人配置                 |
+| /edit   | POST   | {uin,...config} | 修改机器人配置 config 为机器人配置             |
 | /remove | get    | uin,force       | 移除机器人,force为true时，将删除机器人data目录 |
+
 # 鸣谢
+
 1. [icqqjs/icqq](https://github.com/icqqjs/icqq) 底层服务支持
 2. [takayama-lily/onebot](https://github.com/takayama-lily/node-onebot) oneBot V11 原先版本

package/lib/adapter.d.ts

@@ -0,0 +1,55 @@
+/// <reference types="node" />
+import { EventEmitter } from "events";
+import { App } from "./server/app";
+import { OneBot } from "./onebot";
+import { Dict } from "@zhinjs/shared";
+import { Logger } from "log4js";
+export declare abstract class Adapter<T extends string = string> extends EventEmitter {
+    #private;
+    app: App;
+    platform: T;
+    config: Adapter.Configs[T];
+    oneBots: Map<string, OneBot>;
+    protected constructor(app: App, platform: T, config: Adapter.Configs[T]);
+    get logger(): Logger;
+    getLogger(uin: string, version?: string): Logger;
+    createOneBot(uin: string, protocol: Dict, versions: OneBot.Config[]): OneBot;
+    start(uin?: string): Promise<any>;
+    stop(uin?: string, force?: boolean): Promise<any>;
+}
+export interface Adapter extends Adapter.Base {
+    call<V extends OneBot.Version>(uin: string, version: V, method: string, args?: any[]): Promise<any>;
+}
+export declare namespace Adapter {
+    interface Base {
+        toSegment<V extends OneBot.Version>(version: V, message: OneBot.MessageElement<V>[]): OneBot.Segment<V>[];
+        fromSegment<V extends OneBot.Version>(version: V, segment: OneBot.Segment<V>): OneBot.MessageElement<V>[];
+        toCqcode<V extends OneBot.Version>(version: V, message: OneBot.MessageElement<V>[]): string;
+        fromCqcode<V extends OneBot.Version>(version: V, message: string): OneBot.MessageElement<V>[];
+        getSelfInfo<V extends OneBot.Version>(uin: string, version: V): OneBot.SelfInfo<V>;
+        /** 格式化事件 */
+        formatEventPayload<V extends OneBot.Version>(version: V, event: string, payload: Dict): OneBot.Payload<V>;
+        /** 解析消息事件的消息 */
+        parseMessage<V extends OneBot.Version>(version: V, payload: Dict): OneBot.Message<V>[];
+        /** 获取群列表 */
+        getGroupList<V extends OneBot.Version>(uin: string, version: V): Promise<OneBot.GroupInfo<V>[]>;
+        /** 获取好友列表 */
+        getFriendList<V extends OneBot.Version>(uin: string, version: V): Promise<OneBot.UserInfo<V>[]>;
+        getGroupMemberList<V extends OneBot.Version>(uin: string, version: V, args: [string]): Promise<OneBot.GroupMemberInfo<V>[]>;
+        /** 发送群消息 */
+        sendGroupMessage<V extends OneBot.Version>(uin: string, version: V, args: [string, OneBot.MessageElement<V>[]]): Promise<OneBot.MessageRet<V>>;
+        /** 发送私聊消息 */
+        sendPrivateMessage<V extends OneBot.Version>(uin: string, version: V, args: [string, OneBot.MessageElement<V>[]]): Promise<OneBot.MessageRet<V>>;
+        /** 获取消息 */
+        getMessage<V extends OneBot.Version>(uin: string, version: V): Promise<OneBot.Message<V>>;
+        deleteMessage<V extends OneBot.Version>(uin: string, version: V, args: [string]): Promise<boolean>;
+    }
+    interface Configs {
+        [key: string]: Adapter.Config;
+    }
+    type Config<T extends string = string> = {
+        platform?: T;
+        versions: OneBot.Config<OneBot.Version>[];
+        protocol?: Dict;
+    } & Record<string, any>;
+}

package/lib/adapter.js

@@ -0,0 +1,60 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _Adapter_logger;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Adapter = void 0;
+const events_1 = require("events");
+const onebot_1 = require("./onebot");
+class Adapter extends events_1.EventEmitter {
+    constructor(app, platform, config) {
+        super();
+        this.app = app;
+        this.platform = platform;
+        this.config = config;
+        this.oneBots = new Map();
+        _Adapter_logger.set(this, void 0);
+    }
+    get logger() {
+        return __classPrivateFieldSet(this, _Adapter_logger, __classPrivateFieldGet(this, _Adapter_logger, "f") || this.app.getLogger(this.platform), "f");
+    }
+    getLogger(uin, version) {
+        if (!version)
+            return this.app.getLogger(`${this.platform}-${uin}`);
+        return this.app.getLogger(`${this.platform}-${version}(${uin})`);
+    }
+    createOneBot(uin, protocol, versions) {
+        const oneBot = new onebot_1.OneBot(this, uin, versions);
+        this.oneBots.set(uin, oneBot);
+        return oneBot;
+    }
+    async start(uin) {
+        const startOneBots = [...this.oneBots.values()].filter(oneBot => {
+            return uin ? oneBot.uin === uin : true;
+        });
+        for (const oneBot of startOneBots) {
+            await oneBot.start();
+        }
+        this.app.emit('adapter.start', this.platform);
+    }
+    async stop(uin, force) {
+        const stopOneBots = [...this.oneBots.values()].filter(oneBot => {
+            return uin ? oneBot.uin === uin : true;
+        });
+        for (const oneBot of stopOneBots) {
+            await oneBot.stop(force);
+        }
+        this.app.emit('adapter.stop', this.platform);
+    }
+}
+exports.Adapter = Adapter;
+_Adapter_logger = new WeakMap();

package/lib/adapters/icqq/index.d.ts

@@ -0,0 +1,36 @@
+import { Adapter } from "../../adapter";
+import { App } from "../../server/app";
+import { Config as IcqqConfig } from "icqq/lib/client";
+import { Dict } from "@zhinjs/shared";
+import { OneBot } from "../../onebot";
+export default class IcqqAdapter extends Adapter<'icqq'> {
+    #private;
+    constructor(app: App, config: IcqqAdapter.Config);
+    createOneBot(uin: string, protocol: Dict, versions: OneBot.Config[]): OneBot;
+    formatEventPayload<V extends OneBot.Version>(version: V, event: string, data: any): OneBot.Payload<V>;
+    toMessageElement<V extends OneBot.Version>(event: any): OneBot.MessageElement<V>[];
+    sendPrivateMessage<V extends OneBot.Version>(uin: string, version: V, args: [string, OneBot.MessageElement<V>[]]): Promise<OneBot.MessageRet<V>>;
+    sendGroupMessage<V extends OneBot.Version>(uin: string, version: V, args: [string, OneBot.MessageElement<V>[]]): Promise<OneBot.MessageRet<V>>;
+    call<V extends OneBot.Version>(uin: string, version: V, method: string, args?: any[]): Promise<any>;
+    fromSegment<V extends OneBot.Version>(version: V, segment: OneBot.Segment<V> | OneBot.Segment<V>[]): OneBot.MessageElement<V>[];
+    toSegment<V extends OneBot.Version>(version: V, message: OneBot.MessageElement<V>[]): OneBot.Segment<V>[];
+    fromCqcode<V extends OneBot.Version>(version: V, message: string): OneBot.MessageElement<V>[];
+    toCqcode<V extends OneBot.Version>(version: V, messageArr: OneBot.MessageElement<V>[]): string;
+    getSelfInfo<V extends OneBot.Version>(uin: string, version: V): OneBot.SelfInfo<V>;
+    startOneBot(oneBot: OneBot): Promise<Function>;
+    start(uin?: string): Promise<void>;
+    stop(uin?: string, force?: boolean): Promise<void>;
+}
+declare module '../../adapter' {
+    namespace Adapter {
+        interface Configs {
+            icqq: IcqqAdapter.Config;
+        }
+    }
+}
+export declare namespace IcqqAdapter {
+    interface Config extends Adapter.Config<'icqq'> {
+        protocol?: IcqqConfig;
+        password?: string;
+    }
+}