hikari-bot 0.3.2

Nonebot2 HikariBot,支持战舰世界水表查询

Hikari

战舰世界水表BOT

简介

战舰世界水表BOT，基于Nonebot2
水表人，出击！wws me recent！！！
如果觉得本插件还不错的话请点个Star哦~
Hoshino版插件

特色

• 账号总体、单船、近期战绩
• 全指令支持参数乱序
• 快速切换绑定账号
• 支持@快速查询
• 全异步，高并发下性能更优
• 支持频道（非官方bot类型）

在Windows系统上快速部署

视频教程

1. 下载Hikari的最新Release并解压到合适文件夹
2. 复制一份.env.prod-example文件，并将其重命名为.env.prod,打开并编辑

   API_TOKEN = xxxxxxxx #无需引号，TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串
   SUPERUSERS=["QQ号"]
   

   总之最后TOKEN应该长这样

   API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33

   只显示了.env，没有后面的后缀？请百度windows如何显示文件后缀名

3. 双击启动.bat

在Windows系统上完整部署

1. 下载Git、Python并安装

   Python版本需>3.8，或参考Hoshino版插件中使用Conda虚拟环境

   请注意python安装时勾选或点击添加到环境变量，可以安装后cmd中输入python --version来验证是否成功

   否则请自行百度如何添加python到环境变量

2. 打开一个合适的文件夹，鼠标右键——Git Bash here，输入以下命令（任选一条）克隆本Hikari仓库

   git clone https://github.com/benx1n/HikariBot.git
   
   git clone https://gitee.com/benx1n/HikariBot.git
   

3. 以管理员身份运行一键安装.bat

   执行下列两条命令安装nonebot2和hikari-bot插件

   pip install nb-cli
   pip install hikari-bot
   

4. 复制一份.env.prod-example文件，并将其重命名为.env.prod,打开并编辑

   API_TOKEN = xxxxxxxx #无需引号，TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串
   SUPERUSERS=["QQ号"]
   

   总之最后应该长这样

   API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33

   只显示了.env，没有后面的后缀？请百度windows如何显示文件后缀名

5. 双击启动.bat，在打开的浏览器中添加bot账号密码，重新启动Hikari

   打开终端，进入HikariBot文件夹下，输入下方命令运行bot

   nb run
   

   此时若没有报错，您可以打开http://127.0.0.1:8080/go-cqhttp/

   点击左侧添加账号，重启bot即可在网页上看到相应信息（大概率需要扫码）

   如果重启后go-cqhhtp一直卡在扫码或无限重启，请继续往下阅读

在Ubuntu/Debian系统上的管理

• 使用./manage.sh，基于原有批处理脚本
• 无参数调用以获取使用帮助

1. install
   • 安装必须的依赖与bot本体
2. update
   • 更新bot
3. 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）

1. 如果您已经有了一个基于Nonebot2的机器人（例如真寻），您可以直接

   pip install hikari-bot
   

2. 在bot的bot.py中加入

   nonebot.load_plugin('hikari_bot')
   

3. 在环境文件中加入

   API_TOKEN = xxxxxxxxxxxx
   SUPERUSERS=["QQ号"]
   

一般来说该文件为.env.dev

也有可能是.env.pord，具体需要看.env中是否有指定

如果啥都不懂，bot.py里,在nonebot.init()下面加上

config = nonebot.get_driver().config
config.api_token = "xxxxxxxxxxxx"

请点击页面顶部链接加群获取Token哦~

4. 重启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获得相应解决办法，这里简单列举三种办法

1. 启动时登录方式选择浏览器滑条，按后续提示登录
2. 手机下载爱加速等代理，连接到服务器对应市级地区
3. 在本地电脑使用go-cqhttp登录成功后，复制生成的session.token和device.json到服务器对应目录下，内嵌go-cqhttp为account\QQ号，外置直接将整个本地文件夹拷贝过去即可，请注意使用外置go-cqhttp时需要将.env.prod的USE_PLUGIN_GO_CQHTTP的值改为false

无法使用内嵌go-cqhttp登录bot

1. 下载 go-cqhttp 至合适的文件夹

   • github 发布页：https://github.com/Mrs4s/go-cqhttp/releases

   您需要根据自己的机器架构选择版本，Windows一般为x86/64架构，通常选择go-cqhttp_windows_386.exe

2. 双击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的配置，你可以在这里找到更多说明。

3. 启动go-cqhttp，按照提示登录。

4. 修改Hikari文件夹下.env.prod中USE_PLUGIN_GO_CQHTTP的值为false

   USE_PLUGIN_GO_CQHTTP = false
   

5. 在文件夹下打开终端，输入nb run启动bot

出现ZoneInfoNotFoundError报错

issue#78

Recent和绑定提示'鉴权失败'

1. 检查Token是否配置正确，token格式为XXXXX:XXXXXX
2. 如果配置正确可能是Token失效了，请重新申请

感谢

Nonebot2
go-cqhttp
战舰世界API平台

开源协议

MIT