Nonebot2 HikariBot,支持战舰世界水表查询
Project description
Hikari
战舰世界水表BOT
简介
战舰世界水表BOT,基于Nonebot2
水表人,出击!wws me recent!!!
如果觉得本插件还不错的话请点个Star哦~
Hoshino版插件
特色
- 账号总体、单船、近期战绩
- 全指令支持参数乱序
- 快速切换绑定账号
- 支持@快速查询
- 全异步,高并发下性能更优
- 支持频道(非官方bot类型)
在Windows系统上快速部署
- 下载Hikari的最新Release并解压到合适文件夹
- 复制一份
.env.prod-example
文件,并将其重命名为.env.prod
,打开并编辑API_TOKEN = xxxxxxxx #无需引号,TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串 SUPERUSERS=["QQ号"]
总之最后TOKEN应该长这样
API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33
只显示了.env,没有后面的后缀?请百度
windows如何显示文件后缀名
- 双击
启动.bat
在Windows系统上完整部署
-
Python版本需>3.8,或参考Hoshino版插件中使用Conda虚拟环境
请注意python安装时勾选或点击
添加到环境变量
,可以安装后cmd中输入python --version
来验证是否成功否则请自行百度如何添加python到环境变量
-
打开一个合适的文件夹,鼠标右键——Git Bash here,输入以下命令(任选一条)克隆本Hikari仓库
git clone https://github.com/benx1n/HikariBot.git git clone https://gitee.com/benx1n/HikariBot.git
-
以管理员身份运行
一键安装.bat
执行下列两条命令安装nonebot2和hikari-bot插件
pip install nb-cli pip install hikari-bot
-
复制一份
.env.prod-example
文件,并将其重命名为.env.prod
,打开并编辑API_TOKEN = xxxxxxxx #无需引号,TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串 SUPERUSERS=["QQ号"]
总之最后应该长这样
API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33
只显示了.env,没有后面的后缀?请百度
windows如何显示文件后缀名
-
双击
启动.bat
,在打开的浏览器中添加bot账号密码,重新启动Hikari打开终端,进入HikariBot文件夹下,输入下方命令运行bot
nb run
此时若没有报错,您可以打开http://127.0.0.1:8080/go-cqhttp/
点击左侧添加账号,重启bot即可在网页上看到相应信息(大概率需要扫码)
如果重启后go-cqhhtp一直卡在扫码或无限重启,请继续往下阅读
在Ubuntu/Debian系统上的管理
- 使用
./manage.sh
,基于原有批处理脚本 - 无参数调用以获取使用帮助
install
- 安装必须的依赖与bot本体
update
- 更新bot
start [-t/--token] [token] [-i/--id] [qqid]
- 运行bot
- 在当前目录下不存在
.env.prod
的情况下从参数获取token和qqid以创建相应文件,否则直接运行 - 考虑到使用Linux部署时多数情况下本地不存在图形界面,有风险的向公网开放访问
- 加入验证机制(listed)
使用Docker部署
- Docker目录下是一个简单的Dockerfile,可以基于官方的Python容器封装一个完整的HikariBot
- 以
12hydrogen/hikari-bot:latest
上线官方仓库
- 以
- 注意需要将内部的8080端口映射出来
docker run -d -P 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 首次使用需输入token和qqid,-P表示将8080端口随机映射至主机 docker run -d -p 12345:8080 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 使用-p以指定映射在外的端口
- 运行上述指令后会在终端显示一串字符,即Docker容器的标识符,一般使用前几位即可唯一确定一个容器
1a2b3c4d5e..... # 标识符 docker stop 1a2b # 使用前四位确定,stop即停止容器 1a2b3c4d5e..... docker start 1a2b # start即启动容器 1a2b3c4d5e..... docker restart 1a2b # restart即重启容器 1a2b3c4d5e.....
- 在更新后即上传新版本容器
docker pull 12hydrogen/hikari-bot:latest # 更新 docker stop 1a2b 1a2b... docker rm 1a2b # 删除旧容器, 1a2b... docker run -d -P 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 随机映射 docker run -d -p 12345:8080 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 指定映射 9z8y... # 注意标识符变化了
- 将配置文件与容器分离(listed)
作为已有Bot的插件部署(如真寻、Haruka)
- 如果您已经有了一个基于Nonebot2的机器人(例如真寻),您可以直接
pip install hikari-bot
- 在bot的bot.py中加入
nonebot.load_plugin('hikari_bot')
- 在环境文件中加入
API_TOKEN = xxxxxxxxxxxx SUPERUSERS=["QQ号"]
一般来说该文件为.env.dev
也有可能是.env.pord,具体需要看.env中是否有指定
如果啥都不懂,bot.py里,在
nonebot.init()
下面加上config = nonebot.get_driver().config config.api_token = "xxxxxxxxxxxx"
请点击页面顶部链接加群获取Token哦~
- 重启bot
更新
- Windows一键包:下载最新一键包,复制旧版本中
accounts
文件夹和env.prod
文件替换至新版文件夹中即可 - Bot版:以管理员身份运行
更新.bat
或执行./manage.sh update
pip install --upgrade hikari-bot git pull
- 插件版:pip install --upgrade hikari-bot
对比
.env.prod-example
中新增的配置项,并同步至你本地的env.prod
install结束后会打印当前版本
您也可以通过pip show hikari-bot查看
如果没有更新到最新版请等待一会儿,镜像站一般每五分钟同步
可能会遇到的问题
go-cqhttp扫码后提示异地无法登录
一般提示需要扫码,扫码后提示异地无法登录
关于该问题,您可以查看#1469获得相应解决办法,这里简单列举三种办法
- 启动时登录方式选择
浏览器滑条
,按后续提示登录- 手机下载
爱加速
等代理,连接到服务器对应市级地区- 在本地电脑使用go-cqhttp登录成功后,复制生成的
session.token
和device.json
到服务器对应目录下,内嵌go-cqhttp为account\QQ号
,外置直接将整个本地文件夹拷贝过去即可,请注意使用外置go-cqhttp时需要将.env.prod
的USE_PLUGIN_GO_CQHTTP
的值改为false
无法使用内嵌go-cqhttp登录bot
-
下载 go-cqhttp 至合适的文件夹
- github 发布页:https://github.com/Mrs4s/go-cqhttp/releases
您需要根据自己的机器架构选择版本,Windows一般为x86/64架构,通常选择go-cqhttp_windows_386.exe
-
双击go-cqhttp,提示释出bat,重新运行bat,选择websocket反向代理,go-cqhttp将会在同文件夹内自动创建一个
config.yml
,右键使用notepad++打开,根据注释填写QQ账号密码,并将以下内容写入文件结尾:- ws-reverse: universal: ws://127.0.0.1:8080/onebot/v11/ws reconnect-interval: 5000 middlewares: <<: *default
关于go-cqhttp的配置,你可以在这里找到更多说明。
-
启动go-cqhttp,按照提示登录。
-
修改Hikari文件夹下.env.prod中
USE_PLUGIN_GO_CQHTTP
的值为false
USE_PLUGIN_GO_CQHTTP = false
-
在文件夹下打开终端,输入
nb run
启动bot
出现ZoneInfoNotFoundError报错
Recent和绑定提示'鉴权失败'
- 检查Token是否配置正确,token格式为
XXXXX:XXXXXX
- 如果配置正确可能是Token失效了,请重新申请
感谢
开源协议
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hikari_bot-0.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0843e650c239f9fb65c2ed31cffb5ea55e32621c8b5f677a15a1316ce1c73234 |
|
MD5 | de12e70e4033d9cf67e22fa8f2d7498d |
|
BLAKE2b-256 | 9e8c33fb02281fb4625b573e975da3c3f025457e426cbb7724e9e4ead1611941 |