一个使用gocq作为协议端的QQ群聊机器人，可以接受处理QQ消息并回复，接入了www.jx3api.com的数据后，可以查询《剑网三》内的游戏数据,你可以：
- 自己部署到服务器，创建自己的机器人
- 添加自己写的插件，适配到机器人中
此库目前没有适配多账号，请使用单gocq链接。
项目需要python环境，且需要python3.8+，可以自行选择python版本。
apt-get install python3.8QQ协议端采用go-cqhttp。
- go-cqhttp需要下载ffmpeg环境，否则无法发送语音消息，具体安装请参考文档。
# 在bot目录下
pip install -r requirements.txt# 数据站设置
jx3api:
# ws链接地址
ws_path: wss://socket.nicemoe.cn
# ws的token授权，关联ws服务器推送消息类型
ws_token: ~
# 主站地址
jx3_url: https://www.jx3api.com
# 主站token，不填将不能访问带ticket的接口
jx3_token: ~
# 剩余部分自行参考填写使用腾讯云API进行闲聊操作，如果没有将使用青云客API返回聊天
阿里云API进行语音合成，如果没有将不会发送语音信息。
nickname=["团子"] # 这里设置机器人的昵称
superusers=["你的QQ"] # 这里设置超级管理员QQ# 在bot目录下
nb run日志保存路径在：/log/，分为3个等级：ERROR，INFO，DEBUG，日志默认保存10天，以日期命名。
| 插件 | 命令 | 说明 |
|---|---|---|
| 自动插话 | - | 机器人会自动插话，可以修改活跃度 |
| 签到 | 签到 | 简单的签到系统 |
| 智能闲聊 | @机器人+XXX | 默认使用腾讯API，辅助青云客API |
| 查询功能 | 参考“帮助” | 提供查询消息接口，接口使用jx3api |
| 天气查询 | XX天气/天气XX | 查询天气，数据使用和风天气 |
| 疫情查询 | XX疫情/疫情 XX | 查询疫情情况 |
| 功能 | 命令 | 说明 |
|---|---|---|
| *话 | *话 | 返回一条剑网三*话 |
| 日常查询 | 日常 [服务器] | 查询服务器当天日常，服务器可省略 |
| 开服查询 | 开服 [服务器] | 查询服务器开服情况，服务器可省略 |
| 更新公告 | 更新/公告/更新公告 | 查看最新更新公告 |
| 金价查询 | 金价 [服务器] | 查询服务器金价，服务器可省略 |
| 前置查询 | 前置/条件 [奇遇名] | 查询奇遇的前置条件和奖励 |
| 奇遇查询 | 查询 [服务器] [角色名] | 查询角色奇遇记录，服务器可省略 |
| 奇遇列表 | 奇遇 [服务器] [奇遇名] | 查询服务器的某个奇遇记录，服务器可省略 |
| 奇遇汇总 | 汇总 [服务器] | 查询服务器的奇遇记录，服务器可省略 |
| 配装查询 | 配装 [职业] | 查询职业配装，如“配装 冰心”或“冰心配装” |
| 奇穴查询 | 奇穴 [职业] | 查询职业奇穴，如“奇穴 冰心”或“冰心奇穴” |
| 小药查询 | 小药 [职业] | 查询职业小药，如“小药 冰心”或“冰心小药” |
| 宏查询 | 宏 [职业] | 查询职业的宏，如“宏 冰心”或“冰心宏” |
| 物价查询 | 物价 [外观] | 查询外观的物价 |
| 攻略查询 | 攻略 [宠物]/[宠物]攻略 | 查询宠物攻略 |
| 角色属性 | 装备/属性 [服务器] [角色] | 查询角色的装备属性，服务器可省略 |
| 战绩查询 | 战绩 [服务器] [角色] | 查询名剑大会战绩，服务器可省略 |
管理功能需要群管理，或者超级用户才能使用
| 功能 | 命令 | 说明 |
|---|---|---|
| 绑定服务器 | 绑定 [服务器名] | 更换群绑定的服务器 |
| 插件开关 | 打开/关闭 [插件名] | 开关某一个插件 |
| 活跃值 | 活跃值 [1-99] | 设置机器人活跃值 |
| 通知开关 | 打开/关闭 XX通知/XX推送 | 可以开关菜单内通知和ws的推送消息 |
| 通知内容 | XX通知 [消息内容] | 设置XX通知内容，晚安/进群/离群通知 |
| 滴滴 | 滴滴 [消息内容] | 发送消息给机器人管理员。 |
机器人管理员私聊机器人可以管理机器人
| 指令 | 说明 |
|---|---|
| 帮助 | 获取管理帮助 |
| 好友列表 | 查看机器人好友列表 |
| 删除好友 [QQ号] | 删除该好友 |
| 群列表 | 查看bot的群列表 |
| 打开/关闭 [群号] | 远程打开/关闭群机器人开关 |
| 退群 [群号] | 让bot退出该群 |
| 广播 [QQ群号] [消息] | 给指定群发送一条广播消息 |
| 全体广播 [消息] | 给所有打开机器人的群发送一条广播消息 |
具体配置请参考gocq的文档，在本项目下，你可能需要修改以下：
message:
# 上报数据类型
# 可选: string,array
post-format: array
servers:
- ws-reverse:
# 反向WS Universal 地址
# 注意 设置了此项地址后下面两项将会被忽略
universal: ws://127.0.0.1:8080/onebot/v11/ws这主要是nb2升级到了beta1，ws地址发生了变化。
linux系统推荐使用ubuntu20+，自带python3.8，而且apt可以获取3.9+
sudo apt-get install python3.8如果需要编译安装，请自行查找相关资料
不论是windows下，还是linux下，都推荐使用虚拟环境进行部署项目，可以选择你喜欢的工具,venv,conda都行，这里展示venv使用。
# windows下，创建venv目录
python -m venv ./venv
# 激活虚拟环境
./venv/scripts/activate
# 在bot目录下安装依赖
pip install -r requirements.txt
# 运行bot
nb run
# linux下，需要先安装venv模块
sudo apt-get install python3.9-venv
# 创建虚拟环境，这里python需要改成你的3.9软连接
python -m venv ./venv
# 激活虚拟环境
source ./venv/bin/activate
# 在bot目录下安装依赖
pip install -r requirements.txt
# 运行bot
nb run在linux下，截图出来的字可能是方框乱码，这是你的系统没有中文字库的原因，请安装中文字库。
因为这些图片是中文名，windows下的文件名以GBK编码，而linux下的文件 名为utf-8编码。所以需要使用个小工具进行转换
sudo apt-get install convmv
# 在bot目录下
convmv -f GBK -t utf-8 --notest ./*这是数据站www.jx3api.com决定的，和本项目无关，我只是做了对应适配。
你可以在这里购买，token可以获得使用一些高级功能的权限。
这里的ticket是指《剑网三推栏》抓包到的账号token，是使用高级功能的参数之一，抓包方法可以联系api站长，也可以进群了解。
目前项目结构如下：
📦mini_jx3_bot
┣ 📂data # 运行数据目录
┣ 📂docs
┣ 📂log # 运行日志目录
┃ ┣ 📂debug
┃ ┣ 📂error
┃ ┗ 📂info
┣ 📂src # 代码目录
┃ ┣ 📂managers # 管理插件
┃ ┣ 📂modules # 数据库表
┃ ┣ 📂plugins # 自定义插件
┃ ┗ 📂utils # 工具模块
┣ 📂template # 渲染模板目录
┣ 📜.env.prod # 项目环境文件
┣ 📜bot.py # 项目入口
┣ 📜config.yml # 项目配置文件
┗ 📜requirements.txt # 项目依赖
如果需要自定义插件，则可加入在src/plugins目录下，请注意
自己加入的插件不会受到项目自带的插件管理器管理，并且不会显示在菜单中，如果有需要，请在插件__ini__.py文件中加入以下代码：
from nonebot import export
Export = export()
Export.plugin_name = "你的插件名"
Export.plugin_command = "使用命令"
Export.plugin_usage = "简单的使用说明"
Export.default_status = True # 默认插件开关