Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/yyuueexxiinngg/onebot-kotlin

OneBot标准的Kotlin实现及mirai插件 - 原cqhttp-mirai
https://github.com/yyuueexxiinngg/onebot-kotlin
coolq coolq-http-api cqhttp-api cqhttp-mirai mirai mirai-bot onebot onebot-plugin qqbot qqrobot
Last synced: about 2 months ago
JSON representation
OneBot标准的Kotlin实现及mirai插件 - 原cqhttp-mirai
Host: GitHub
URL: https://github.com/yyuueexxiinngg/onebot-kotlin
Owner: yyuueexxiinngg
License: agpl-3.0
Created: 2020-05-22T11:47:57.000Z (over 4 years ago)
Default Branch: dev
Last Pushed: 2023-10-21T17:20:50.000Z (11 months ago)
Last Synced: 2024-07-29T10:13:07.862Z (about 2 months ago)
Topics: coolq, coolq-http-api, cqhttp-api, cqhttp-mirai, mirai, mirai-bot, onebot, onebot-plugin, qqbot, qqrobot
Language: Kotlin
Homepage:
Size: 84.3 MB
Stars: 585
Watchers: 14
Forks: 139
Open Issues: 28
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project

awesome-mirai - yyuueexxiinngg/cqhttp-mirai
README

        # OneBot Mirai - CQHTTP Mirai

[![OneBot v10](https://img.shields.io/badge/OneBot-v10-black)](https://github.com/howmanybots/onebot/blob/master/v10/specs/README.md)

[![Gradle CI](https://github.com/yyuueexxiinngg/onebot-kotlin/workflows/Gradle%20CI/badge.svg)](https://github.com/yyuueexxiinngg/onebot-kotlin/actions)

[![Downloads](https://img.shields.io/github/downloads/yyuueexxiinngg/onebot-kotlin/total)](https://github.com/yyuueexxiinngg/onebot-kotlin/releases)

[![Release](https://img.shields.io/github/v/release/yyuueexxiinngg/onebot-kotlin?include_prereleases)](https://github.com/yyuueexxiinngg/onebot-kotlin/releases)

[![Downloads @latest](https://img.shields.io/github/downloads-pre/yyuueexxiinngg/onebot-kotlin/latest/total)](https://github.com/yyuueexxiinngg/onebot-kotlin/releases)

__[OneBot标准](https://github.com/howmanybots/onebot) mirai 插件版 *(原cqhttp-mirai)*__

### 开始使用

0. 请首先运行[mirai-console](https://github.com/mamoe/mirai-console)相关客户端生成plugins文件夹

1. 将`onebot-mirai`生成的`jar包文件`放入`plugins`文件夹中

2. 运行`mirai-console`, 将在`config/OneBot`文件夹中自动生成样本配置文件`settings.yml`

3. 编辑`config/OneBot/settings.yml`配置文件, 按照以下配置给出的注释修改保存

4. 再次启动[mirai-console](https://github.com/mamoe/mirai-console)相关客户端

# OneBot Kotlin - CQHTTP Mirai Embedded

__[OneBot标准](https://github.com/howmanybots/onebot) Kotlin实现 *(原cqhttp-mirai-embedded)*__

### 注意事项

- 此版本内置`mirai-core`和`mirai-console`

- 请将此版本Jar包放至与`mirai-console-loader`, `miraiOK`同级目录

- 此版本启动方式`java -jar onebot-kotlin-**.jar`

- 请不要将此版本与主分支单插件版同时使用, 即不要在`plugins`文件夹下放置`onebot-mirai`的Jar包

### 开始使用

1. 运行Jar包: `java -jar onebot-kotlin-**.jar`

2. 编辑`config/OneBot/settings.yml`配置文件, 将以下配置给出的注释修改保存

3. 重新运行

### 接收的参数

- `--account 123456789` 要自动登录的账号

- `--password *******` 要自动登录账号的密码

- `--args -- --xx`传入参数至`mirai-console`, 如`--args -- --help`将`--help`传入获取`mirai-console`提供的帮助信息

### 读取的环境变量

- `ONEBOT_ACCOUNT` 同`--account`参数, 但优先级低, 会被参数覆盖

- `ONEBOT_PASSWORD` 同`--password`参数, 但优先级低, 会被参数覆盖

### 更新日志: [CHANGELOG](https://github.com/yyuueexxiinngg/onebot-kotlin/blob/master/CHANGELOG.md)

## 配置相关

```yaml

# 下载图片/语音时使用的Proxy, 配置后, 发送图片/语音时指定`proxy=1`以通过Proxy下载, 如[CQ:image,proxy=1,url=http://***]

# 支持HTTP及Sock两种Proxy, 设置举例 proxy: "http=http://127.0.0.1:8888", proxy : "sock=127.0.0.1:1088"

proxy: ''

# Mirai支持多帐号登录, 故需要对每个帐号进行单独设置

bots:

  # 要进行配置的QQ号

  1234567890: 

    # 是否缓存所有收到的图片, 默认为否 (仅包含图片信息, 不包含图片本身,  < 0.5KB)

    cacheImage: false

    # 是否缓存所有收到的语音, 默认为否 (将下载完整语音进行保存)

    cacheRecord: false

    # 心跳包相关配置

    heartbeat: 

      # 是否发送心跳包, 默认为否

      enable: false

      # 心跳包发送间隔, 默认为 15000毫秒

      interval: 15000

    # HTTP 相关配置

    http: 

      # 可选，是否启用HTTP API服务器, 默认为不启用, 此项开始与否跟postUrl无关

      enable: true

      # 可选，HTTP API服务器监听地址, 默认为0.0.0.0

      host: 0.0.0.0

      # 可选，HTTP API服务器监听端口, 5700

      port: 5700

      # 可选，访问口令, 默认为空, 即不设置Token

      accessToken: ''

      # 可选，事件及数据上报URL, 默认为空, 即不上报

      postUrl: ''

      # 可选，上报消息格式，string 为字符串格式，array 为数组格式, 默认为string

      postMessageFormat: string

      # 可选，上报数据签名密钥, 默认为空

      secret: ''

      # 上报超时时间, 单位毫秒, 须大于0才会生效

      timeout: 0

    # 可选，反向客户端服务

    ws_reverse: 

      # 可选，是否启用反向客户端，默认不启用

      - enable: true

        # 上报消息格式，string 为字符串格式，array 为数组格式

        postMessageFormat: string

        # 反向Websocket主机

        reverseHost: 127.0.0.1

        # 反向Websocket端口

        reversePort: 8080

        # 访问口令, 默认为空, 即不设置Token

        accessToken: ''

        # 反向Websocket路径

        reversePath: /ws

        # 可选, 反向Websocket Api路径, 默认为reversePath

        reverseApiPath: /api

        # 可选, 反向Websocket Event路径, 默认为reversePath

        reverseEventPath: /event

        # 是否使用Universal客户端 默认为true

        useUniversal: true

        # 可选, 是否通过HTTPS连接, 默认为false

        useTLS: false

        # 反向 WebSocket 客户端断线重连间隔，单位毫秒

        reconnectInterval: 3000

      - enable: true # 这里是第二个连接, 相当于CQHTTP分身版

        postMessageFormat: string

        reverseHost: 127.0.0.1

        reversePort: 9222

        reversePath: /ws

        useUniversal: false

        reconnectInterval: 3000

    # 正向Websocket服务器

    ws: 

      # 可选，是否启用正向Websocket服务器，默认不启用

      enable: true

      # 可选，上报消息格式，string 为字符串格式，array 为数组格式, 默认为string

      postMessageFormat: string

      # 监听主机

      wsHost: 0.0.0.0

      # 监听端口

      wsPort: 6700

      # 可选，访问口令, 默认为空, 即不设置Token

      accessToken: ''

  0987654321: # 这里是第二个QQ Bot的配置

    ws_reverse: 

      - enable: true

        postMessageFormat: string

        reverseHost:

        reversePort:

        reversePath: /ws

        reconnectInterval: 3000

```

#### 实现

- [x] 反向Websocket客户端

- [x] HTTP上报服务

- [x] Websocket服务端

- [x] HTTP API

已实现CQ码

- [CQ:at]

- [CQ:image]

- [CQ:record]

- [CQ:face]

- [CQ:emoji]

- [CQ:share]

- [CQ:contact]

- [CQ:music]

- [CQ:shake]

- [CQ:poke]

- [CQ:xml]

- [CQ:json]

已支持的OneBot API

#### 特别注意, 很多信息Mirai不支持获取, 如群成员的年龄、性别等, 为保证兼容性, 这些项已用`Unknown`, `0`之类的信息填充占位

| API 
| ------------------------ 
| /send_private_msg 
| /send_group_msg 
| /send_msg 
| /delete_msg 
| /set_group_kick 
| /set_group_ban 
| /set_group_whole_ban 
| /set_group_card 
| /set_group_leave 
| /set_group_special_title 
| /set_friend_add_request 
| /set_group_add_request 
| /get_login_info 
| /get_friend_list 
| /get_group_honor_info 
| /get_image 
| /get_group_list 
| /get_group_info 
| /get_group_member_info 
| /get_group_member_list 
| /can_send_image 
| /can_send_record 
| /get_status 
| /get_version_info 
| /set_group_name

| 功能                                                         | 备注                        | | ------------------------------------------------------------ | -------------------------- | | [发送私聊消息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#send_private_msg-发送私聊消息) | | | [发送群消息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#send_group_msg-发送群消息) | | | [发送消息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#send_msg-发送消息) | (不包含讨论组消息) | | [撤回信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#delete_msg-撤回消息) | | | [群组T人](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_kick-群组踢人) | | | [群组单人禁言](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_ban-群组单人禁言) | | | [群组全员禁言](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_whole_ban-群组全员禁言) | | | [设置群名片(群备注)](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_card-设置群名片（群备注）) | | | [退出群组](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_leave-退出群组) | (不支持解散群组) | | [设置群组专属头衔](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_special_title-设置群组专属头衔) | (不支持设置有效期) | | [处理加好友请求](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_friend_add_request-处理加好友请求) | (不支持设置备注) | | [处理加群请求/邀请](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_add_request-处理加群请求／邀请) | | | [获取登录号信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_login_info-获取登录号信息) | | | [获取好友列表](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_friend_list-获取好友列表) | | | [获取群荣誉信息](https://github.com/howmanybots/onebot/blob/master/v11/specs/api/public.md#get_group_honor_info-%E8%8E%B7%E5%8F%96%E7%BE%A4%E8%8D%A3%E8%AA%89%E4%BF%A1%E6%81%AF) | | | [获取图片](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_image-获取图片) | | | [获取群列表](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_group_list-获取群列表) | | | [获取群信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_group_info-获取群信息) | | | [获取群成员信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_group_member_info-获取群成员信息) | | | [获取群成员列表](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_group_member_list-获取群成员列表) | | | [检查是否可以发送图片](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#can_send_image-检查是否可以发送图片) | (恒为true) | | [检查是否可以发送语音](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#can_send_record-检查是否可以发送语音) | | | [获取插件运行状态](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_status-获取插件运行状态) | (不完全支持, 仅返回`online`和`good`两项) | | [获取 酷Q 及 CQHTTP插件的版本信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_version_info-获取-酷q-及-cqhttp-插件的版本信息) | | | [设置群名](https://github.com/howmanybots/onebot/blob/master/v11/specs/api/public.md#set_group_name-%E8%AE%BE%E7%BD%AE%E7%BE%A4%E5%90%8D)                                        |

尚未支持的OneBot API

| API                      | 功能                                                         | 备注                        |

| ------------------------ | ------------------------------------------------------------ | -------------------------- |

| /get_record              | [获取语音](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_record-获取语音) | |

| /send_discuss_msg        | [发送讨论组消息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#send_discuss_msg-发送讨论组消息) | 已无讨论组 |

| /set_discuss_leave       | [退出讨论组](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_discuss_leave-退出讨论组) | 已无讨论组 |

| /get_stranger_info       | [获取陌生人信息](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_stranger_info-获取陌生人信息) | |

| /set_group_anonymous_ban | [群组匿名用户禁言](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_anonymous_ban-群组匿名用户禁言) | |

| /set_group_admin         | [群组设置管理员](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_group_admin-群组设置管理员) | |

| /send_like               | [发送好友赞](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#end_like-发送好友赞) | Mirai不会支持 |

| /get_cookies             | [获取 Cookies](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_cookies-获取-cookies) | Mirai不会支持 |

| /get_csrf_token          | [获取 CSRF Token](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_csrf_token-获取-csrf-token) | Mirai不会支持 |

| /get_credentials         | [获取 QQ 相关接口凭证](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#get_credentials-获取-qq-相关接口凭证) | Mirai不会支持 |

| /set_restart_plugin      | [重启 CQHTTP](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#set_restart_plugin-重启-cqhttp) | |

| /clean_data_dir          | [清理数据目录](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#clean_data_dir-清理数据目录) | |

| /clean_plugin_log        | [清理日志](https://github.com/richardchien/cqhttp-protocol/blob/master/v11/specs/api/public.md#clean_plugin_log-清理日志) | |

## 开源协议

[AGPL-3.0](LICENSE) © yyuueexxiinngg

## 直接或间接引用到的其他开源项目

- [mirai-api-http](https://github.com/mamoe/mirai-api-http) -  [LICENSE](https://github.com/mamoe/mirai-api-http/blob/master/LICENSE)

- [Mirai Native](https://github.com/iTXTech/mirai-native)  -  [LICENSE](https://github.com/iTXTech/mirai-native/blob/master/LICENSE)

- [CQHTTP](https://github.com/richardchien/coolq-http-api) -  [LICENSE](https://github.com/richardchien/coolq-http-api/blob/master/LICENSE)

- [OneBot标准](https://github.com/howmanybots/onebot) 

- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp)  -  [LICENSE](https://github.com/Mrs4s/go-cqhttp/blob/master/LICENSE)