Hikari

战舰世界水表BOT

💘您不打算给可爱的Hikari点个Star吗QAQ

简介

战舰世界水表BOT，基于Nonebot2
水表人，出击！wws me recent！！！
QQ频道官方机器人已上线，请点击上方链接加入体验~
Hoshino版插件

特色

在Windows系统上快速部署

点我查看视频教程

windows安装python版本请勿大于3.11,建议版本3.10

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

只显示了.env，没有后面的后缀？请百度windows如何显示文件后缀名
```
API_TOKEN = xxxxxxxx #无需引号，TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串
SUPERUSERS=["QQ号"]
```
- 最后TOKEN应该长这样 API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33
- 从0.3.2.2版本开始，您没有填写的配置将按.env文件中的默认配置执行，具体逻辑为
  - 私聊、频道默认禁用
  - 群聊默认开启，默认屏蔽官方交流群
- 从2024-04-23开始，不再推荐使用go-cqhttp作为无头协议端，请参考下方配置LLOneBot
参考LLOneBot配置教程，配置NoneBot+LLOneBot的端口号及连接token，记得点击保存
双击启动.bat

Linux一键脚本

仅支持Debian、CentOS、Ubuntu

wget -qO - https://fastly.jsdelivr.net/gh/benx1n/HikariBot@master/install.sh | bash

使用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 run -d --volumes-from 1a2b -P 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 随机映射
or
docker run -d --volumes-from 1a2b -p 12345:8080 12hydrogen/hikari-bot:latest -t [token] -i [qqid] # 指定映射
9z8y... # 注意标识符变化了
docker rm 1a2b # 删除旧容器，
1a2b...

将配置文件与容器分离使用volume在宿主机保存相关账号信息，更新时按照相关步骤继承volume即可

在Windows系统上完整部署（gocq部分已过时）

下载Git、Python并安装

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

等效于在cmd中执行如下代码

python -m pip install nb-cli hikari-bot nonebot-plugin-apscheduler nonebot-plugin-gocqhttp -i https://pypi.tuna.tsinghua.edu.cn/simple

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

只显示了.env，没有后面的后缀？请百度windows如何显示文件后缀名
```
API_TOKEN = xxxxxxxx #无需引号，TOKEN即回复您的邮件所带的一串由[数字+冒号+英文/数字]组成的字符串
SUPERUSERS=["QQ号"]
```
- 最后TOKEN应该长这样 API_TOKEN = 123764323:ba1f2511fc30423bdbb183fe33
- 从0.3.2.2版本开始，您没有填写的配置将按.env文件中的默认配置执行，具体逻辑为
  - 私聊、频道默认禁用
  - 群聊默认开启，默认屏蔽官方交流群`
  - 默认WEB登录账号密码为admin/admin，如有需要请自行修改，无需设置密码请删除env.prod中的配置项
  - 默认开启噗噗
  - 默认开启缓存上报
  - 默认关闭代理
双击启动.bat，在打开的浏览器中添加bot账号密码，重新启动Hikari
- 页面加载不出请尝试刷新一下，已知IE浏览器可能存在一些问题
- 此时若没有报错，您可以在打开的页面http://127.0.0.1:8080/go-cqhttp/中点击左侧添加账号，重启bot即可在网页上看到相应信息（大概率需要扫码）
- 如果重启后go-cqhhtp一直卡在扫码或无限重启，请跳转无法使用内嵌go-cqhttp登录

在Linux上完整部署

需要Python基本环境
Clone本仓库
使用./manage.sh，基于原有批处理脚本
无参数调用以获取使用帮助

install
- 安装必须的依赖与bot本体
update
- 更新bot
start [-t/--token] [token] [-i/--id] [qqid]
- 运行bot
- 在当前目录下不存在.env.prod的情况下从参数获取token和qqid以创建相应文件，否则直接运行
- 考虑到使用Linux部署时多数情况下本地不存在图形界面，有风险的向公网开放访问
- 加入验证机制（listed）

作为已有Bot的插件部署（如真寻、Haruka）

如果您已经有了一个基于Nonebot2的机器人（例如真寻），您可以直接
```
pip install hikari-bot
```

在bot的bot.py中加入

nonebot.load_plugin('nonebot_plugin_htmlrender')
nonebot.load_plugin('hikari_bot')

在环境文件中加入以下配置项

API_TOKEN = xxxxxxxxxxxx
SUPERUSERS=["QQ号"]             #超级管理员，填写你需要控制机器人的QQ号
private = false                 #开启私聊
group = true                    #开启群聊
channel = false                 #开启频道
all_channel = false             #是否全频道生效，无论此项配置如何，channel_list中的频道一定会开启
channel_list = []               #频道列表白名单，数组形式，可在控制台中获取相应的channel_id
admin_list = []                 #管理员列表，可以添加删除监控等权限，但无法控制机器人
ban_group_list = [967546463]    #群列表黑名单，默认屏蔽了开发者交流群
pupu = true                     #是否开启噗噗
check_cache = true              #是否开启缓存上报,可降低高峰期延迟,如果错误日志中频繁报错上报url:XXXXXXXX,请关闭此项或配置代理
proxy_on = false                #是否启用代理
proxy = http://localhost:7890   #代理地址，如果上面选项开启，这边替换为你本地的
ocr_on = true                   #是否开启ocr(识图指令)
ocr_offline = false             #是否只使用hash验证，即设置为true后只能识别服务器已记录的图片，如果群较多(>300)导致响应延迟较高可以开启
ocr_url = http://ocr.benx1n.com:23338           #默认ocr地址，一般不用动
http2 = true                    #是否开启http2，默认开启，如果有问题请设置为false
battle_listen_time = 1          #监控刷新时间，分钟级，如果性能或流量不够可以适当延长，推荐在5分钟以内
htmlrender_browser = "chromium"         #默认使用chromium启动，出现问题了请改为"firefox"尝试

一般来说该文件为.env.dev 也有可能是.env.pord，具体需要看.env中是否有指定

重启bot

更新

实验性更新指令：wws 更新Hikari 请确保在能登录上服务器的情况下使用以下是旧更新方法

按不同版本
- Windows一键包：下载最新一键包，复制旧版本中accounts文件夹和env.prod文件替换至新版文件夹中即可
- 完整版：以管理员身份运行更新.bat或执行./manage.sh update
  
  等效于在cmd中执行如下代码
```
pip install --upgrade hikari-bot
git pull
```
- 插件版：在cmd中执行如下代码
```
pip install --upgrade hikari-bot
```
对比.env.prod-example中新增的配置项，并同步至你本地的env.prod
- install结束后会打印当前版本
- 您也可以通过pip show hikari-bot查看当前Hikari版本
- 如果没有更新到最新版请等待一会儿，镜像站一般每五分钟同步
- 从0.3.2.2版本开始，您没有填写的配置将按.env文件中的默认配置执行，具体逻辑为
  - 私聊、频道默认禁用
  - 群聊默认开启，默认屏蔽官方交流群

可能会遇到的问题

go-cqhttp扫码后提示异地无法登录

一般提示需要扫码，扫码后提示异地无法登录
关于该问题，您可以查看这里获得相应解决办法，这里简单列举三种办法
- 启动时登录方式选择浏览器滑条，按后续提示登录
- 手机下载爱加速等代理，连接到服务器对应市级地区
- 在本地电脑使用go-cqhttp登录成功后，将会在exe同级目录下生成session.token和device.json两个文件将这两个文件复制到服务器对应目录下并重启
  - 内嵌go-cqhttp为account\QQ号
  - 独立go-cqhttp为exe所在同级目录下，请注意使用独立go-cqhttp时需要将.env.prod的USE_PLUGIN_GO_CQHTTP的值改为false

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

下载 go-cqhttp 至合适的文件夹
- github 发布页：https://github.com/Mrs4s/go-cqhttp/releases/latest
您需要根据自己的机器架构选择版本，Windows一般为x86/64架构，通常选择go-cqhttp_windows_amd64.exe
双击go-cqhttp，提示释出bat，重新运行bat，选择websocket反向代理，go-cqhttp将会在同文件夹内自动创建一个config.yml，右键使用notepad++打开，根据注释填写QQ账号密码，并将以下内容写入文件结尾（需替换原有的ws-reverse节点）：
```
  - ws-reverse:
      universal: ws://127.0.0.1:8080/onebot/v11/ws
      reconnect-interval: 5000
      middlewares:
        <<: *default
```
关于go-cqhttp的配置，你可以在这里找到更多说明。
启动go-cqhttp，按照提示登录。
此处如出现异地登陆保护，请尝试
- 在本地电脑使用go-cqhttp登录成功后，将会在exe同级目录下生成session.token和device.json两个文件
- 将这两个文件复制到服务器对应go-cqhttp目录下并重启
此处如出现Code:45，请参考该视频配置签名服务
修改Hikari文件夹下.env.prod中USE_PLUGIN_GO_CQHTTP的值为false
```
USE_PLUGIN_GO_CQHTTP = false
```
在文件夹下打开终端，输入python bot.py启动bot
- 一键包双击启动.bat即可

出现ZoneInfoNotFoundError报错

您可以在这里找到相关解决办法

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

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

'Config' Object has no attribute XXXX

检查视力，重新阅读更新章节

Failed to import "nonebot_plugin_guild_patch"

以下方法任选一种

更新python版本至3.9+
降低Hikari版本至3.1，等待后续版本修复
使用Hikari一键包，其中自带了3.10的python虚拟环境
修改依赖包代码，见这里

Ubuntu系统下部署字体不正常(针对一些云服务器的Ubuntu镜像，不保证成功，只是提供一个解决方案)

执行以下命令，完善字体库并将中文设置成默认语言（部分Ubuntu可能不需要该步骤，可直接从第二步开始）

sudo apt install fonts-noto  
sudo locale-gen zh_CN zh_CN.UTF-8  
sudo update-locale LC_ALL=zh_CN.UTF-8 LANG=zh_CN.UTF-8  
sudo fc-cache -fv

在你的Windows电脑上打开C:\Windows\fonts文件夹，找到里面的微软雅黑字体，将其复制出来，放在任意目录，应该会得到msyh.ttc，mshybd.ttc，msyhl.ttc三个文件。（不会有人还用Win7吧？）
进入到/usr/share/fonts文件夹下，创建一个文件夹命名为msyh，然后进入其中

cd /usr/share/fonts 
sudo mkdir msyh 
cd msyh

将三个字体文件上传到msyh文件夹中(过程中遇到的问题请自行解决)
执行以下命令（此时你应该是在msyh文件夹下），加载字体

sudo mkfontscale 
sudo mkfontdir 
sudo fc-cache -fv

（可选，若不正常可尝试）重启Hikari。

首次启动时plugin-gocqhttp的startup方法报错(traceback中一般还有ssl的错误)

下载 go-cqhttp
- github 发布页：https://github.com/Mrs4s/go-cqhttp/releases/latest
您需要根据自己的机器架构选择版本，Windows一般为x86/64架构，通常选择go-cqhttp_windows_amd64.exe
重命名为go-cqhttp.*(*为所选择版本后缀,如windowx就是go-cqhttp.exe)并放入HikariBot\accounts\binary文件夹下
重新启动Hikari

贡献代码

请向dev分支提交PR

鸣谢

感谢以下开发者及项目做出的贡献与支持

Nonebot2
go-cqhttp
战舰世界API平台

开源相关

MIT 修改、分发代码时请保留原作者相关信息

Name		Name	Last commit message	Last commit date
Latest commit History 373 Commits
.github/workflows		.github/workflows
Docker		Docker
menu_config		menu_config
src/plugins/hikari_bot		src/plugins/hikari_bot
.env		.env
.env.prod-example		.env.prod-example
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
bot.py		bot.py
install.sh		install.sh
manage.sh		manage.sh
poetry.lock		poetry.lock
pyproject.toml		pyproject.toml
一键安装（一键包不用点）.bat		一键安装（一键包不用点）.bat
启动.bat		启动.bat
强制同步git（一键包不用点）.bat		强制同步git（一键包不用点）.bat
更新（一键包不用点）.bat		更新（一键包不用点）.bat

License

benx1n/HikariBot

Folders and files

Latest commit

History

Repository files navigation

Hikari

💘您不打算给可爱的Hikari点个Star吗QAQ

简介

特色

在Windows系统上快速部署

Linux一键脚本

使用Docker部署

在Windows系统上完整部署（gocq部分已过时）

在Linux上完整部署

作为已有Bot的插件部署（如真寻、Haruka）

更新

最近的更新日志

23-08-29 v1.0.0

23-05-07 v0.3.9

23-04-07 v0.3.8

23-04-04 v0.3.7

23-02-22 v0.3.6.4

22-11-18 v0.3.6 包含配置项更新，请添加env.prod-example中新增的配置

22-10-29 v0.3.5.5 添加测试功能OCR，支持图片指令

22-10-27 v0.3.5.4 修复一键更新指令bug

22-10-26 v0.3.5.3 添加缓存上报机制，修复噗噗误触发的bug

22-10-25 v0.3.5.2 新增噗噗

22-07-24 v0.3.5 适配nontbo2 v2.0.0rc1

22-07-24 v0.3.4 配置项及入口文件更新 请完整拉取最新仓库，并同步添加env.prod-example中新增的配置

22-07-14 v0.3.3 积累更新

22-07-05 v0.3.2.2 一些修复

22-07-04 v0.3.2.1 配置项及入口文件更新 请完整拉取最新仓库，并同步添加env.prod-example中新增的配置

22-06-23 v0.3.1 重要功能更新

22-06-15 v0.3.0.1 重要功能更新

22-06-08 v0.2.9.4 重要功能更新

22-06-03 v0.2.8 一些修复

22-06-03 v0.2.6 [#]修复wws recent胜率颜色的bug

22-06-03 v0.2.5 [#]修复wws recent击杀显示成命中的bug

22-06-03 v0.2.4 重要功能更新 否则您将无法使用wws recent功能

22-06-02 v0.2.3 一些修复

22-06-01 v0.2.2 修复了一个VSC导致的依赖错误

22-06-01 v0.2.1 修复问题

22-06-01 v0.2.0 重要功能更新

22-05-31 v0.1.9 一些修复

22-05-30 v0.1.8 重要更新

22-05-30 v0.1.7 一些修复

22-05-28 v0.1.6 重要功能更新

22-05-28 v0.1.5 一些功能更新

22-05-27 v0.1.4 一些功能优化

22-05-27 v0.1.3 一些修复和适配

22-05-27 v0.1.2 调整info接口，不更新无法使用

22-05-27 v0.1.1 一些小改动

22-05-27 v0.1.0 一些更新

可能会遇到的问题

go-cqhttp扫码后提示异地无法登录

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

出现ZoneInfoNotFoundError报错

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

'Config' Object has no attribute XXXX

Failed to import "nonebot_plugin_guild_patch"

Ubuntu系统下部署字体不正常(针对一些云服务器的Ubuntu镜像，不保证成功，只是提供一个解决方案)

首次启动时plugin-gocqhttp的startup方法报错(traceback中一般还有ssl的错误)

贡献代码

鸣谢

开源相关

赞助

About

Topics

Resources

License

Stars

Watchers

Forks

Languages

22-11-18 v0.3.6 包含配置项更新，请添加`env.prod-example`中新增的配置

22-07-24 v0.3.4 配置项及入口文件更新请完整拉取最新仓库，并同步添加`env.prod-example`中新增的配置

22-07-04 v0.3.2.1 配置项及入口文件更新请完整拉取最新仓库，并同步添加`env.prod-example`中新增的配置

22-06-03 v0.2.6 [#]修复`wws recent`胜率颜色的bug

22-06-03 v0.2.5 [#]修复`wws recent`击杀显示成命中的bug

22-06-03 v0.2.4 重要功能更新否则您将无法使用`wws recent`功能