Hoka-bot 部署教程
该文档将讲述如何部署 Hoka-bot(以下称为 Hoka)。

在开始本教程前,需要知道该教程:
- 基于 Python3.9
- 基于 Linux 系统 / Ubuntu(我是 20.04.1 版本)
- 是 6 月 30 日版本的 Hoka-bot 部署教程
开始部署之前
理所当然的,你需要将 Hoka 的代码克隆至本地。
-
进入 Hoka 的仓库。
-
如下图所示,克隆或下载代码的压缩文件:

- 得到的文件夹应如下图:

关于 bot 代码结构可以看看这篇 Nonebot2 教程
你已经得到了一个 Hoka!但他还是个空壳,无法立马投入使用。
配置 Hoka 的环境配置文件
Hoka 部署最为紧要的部分是
.env
文件,也就是环境配置文件。
-
进入
.env
文件进行编辑:plaintext1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37ENVIRONMENT=dev
HOST=127.0.0.1
PORT=56766
LOG_LEVEL=INFO
FASTAPI_RELOAD=true
SUPERUSERS = [""]
NICKNAME = ["hoka"]
COMMAND_START = ["hoka", ""]
COMMAND_SEP = ["*"]
GOCQ_ACCOUNR = [
{
"uin": ,
"password": "",
"protocol": 1
}
]
GOCQ_URL = https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-rc3/go-cqhttp_linux_amd64.tar.gz
APSCHEDULER_AUTOSTART = true
API_TIMEOUT = 3600
RAM_CMD = 功能
RAM_ADD = 开启
RAM_RM = 关闭
RAM_SHOW = 查询
RAM_AVAILABLE = 全局查询
GAME_PATH = ''
MAX_BET_GOLD = 10000
READ_QQ_FRIENDS = []
READ_QQ_GROUPS = []
READ_INFORM_TIME = [{"HOUR": 9, "MINUTE": 5}] -
-
环境默认为
dev
,即development
、开发环境; -
可更改为
prod
,即production
、生产环境;plaintext1
ENVIRONMENT=dev
-
-
如下,这里分别是
HOST 监听IP/主机名
、PORT 监听端口
、LOG LEVEL 日志等级
和FASTAPI_RELOAD
的配置:-
下面的端口如果已被使用可以修改为其他数字,其它则都不需要碰。
plaintext1
2
3
4HOST=127.0.0.1
PORT=56766
LOG_LEVEL=INFO
FASTAPI_RELOAD=true
-
-
-
配置
SUPERUSERS 超级用户
:超级用户是 Hoka 的管理员,有着最高权限。
这里推荐只写你自己的 QQ 号; -
配置
NICKNAME bot昵称
:不建议修改,因为我都是直接在代码里写的 Hoka,改了没啥用; -
配置
COMMAND_START 命令前缀
:不建议修改,但也不是不能改; -
配置
COMMAND_SEP 命令隔开符
:不咋用到这个,随意更改。plaintext1
2
3
4SUPERUSERS = [""]
NICKNAME = ["hoka"]
COMMAND_START = ["hoka", ""]
COMMAND_SEP = ["*"]
-
-
配置
Go-CQHTTP插件
:-
介于该插件的前端可以登录账号,你不需要配置
GOCQ_ACCOUNR
; -
该插件将会下载
GOCQ_URL
中填写的地址,什么都不输入将自动使用该插件默认的镜像站以及最新版本。plaintext1
2
3
4
5
6
7
8GOCQ_ACCOUNR = [
{
"uin": ,
"password": "",
"protocol": 1
}
]
GOCQ_URL = https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.0-rc3/go-cqhttp_linux_amd64.tar.gz
-
-
不需要管这俩。
plaintext1
2
3APSCHEDULER_AUTOSTART = true
API_TIMEOUT = 3600 -
rauthman 权限管理插件
的配置项:-
其实只是指令名更改,不建议修改。
plaintext1
2
3
4
5RAM_CMD = 功能
RAM_ADD = 开启
RAM_RM = 关闭
RAM_SHOW = 查询
RAM_AVAILABLE = 全局查询
-
-
game 群组游戏插件
的配置项:-
GAME_PATH
不要碰; -
MAX_BET_GOLD
为俄罗斯轮盘中赌注的上限,可以调低防止一夜暴富一夜回到解放前。plaintext1
2GAME_PATH = ''
MAX_BET_GOLD = 10000
-
-
read_60s 60秒读世界插件
的配置项:-
READ_QQ_FRIENDS
为每日定时发送的 QQ 好友号; -
READ_QQ_GROUPS
为每日定时发送的 QQ 群聊号; -
READ_INFORM_TIME
为每日定时发送的时间,按照本地时间为标准,如下便是每日早上 9 点 5 分。plaintext1
2
3READ_QQ_FRIENDS = []
READ_QQ_GROUPS = []
READ_INFORM_TIME = [{"HOUR": 9, "MINUTE": 5}]
-
-
你已经配置好了环境配置文件!
配置 Hoka 的群组游戏
需要配置的只有群组卡池。
-
进入
src/plugins/game/gacha.py
,找到class NormalData
:python1
2
3
4
5
6
7
8
9
10
11
12
13class NormalData:
sixList = []
fiveList = []
fourList = []
threeList = []
onelist = ['虾虾']
fiveListUp = []
sixListUP = [] -
sixList
为卡池的六星角色,fiveList
为五星… 以此类推。
oneList
建议保留为虾虾,因为虾虾这个名字也在代码内,当然你也可以自己一次性全部修改。
fiveListUp
和sixListUP
都是概率 UP 角色。 -
填写格式像这样:
sixList = ['名字', '另一个名字']
。
配置 Go-CQHTTP & 运行 Hoka
-
首先需要运行一次 Hoka。
在有bot.py
的主文件夹内开终端输入python3.9 bot.py
。 -
在终端中找到这么一行:
plaintext1
[INFO] nonebot_plugin_gocqhttp | Startup complete, Web UI has served to http://127.0.0.1:56766/go-cqhttp/
-
进入后面的这个地址,页面应如下:

-
点击左上角的
添加账号
。
依次输入 bot 的 QQ 号、密码,并选择登录设备类型。个人通常使用 Android Phone。 -
提交后关闭页面,回到终端关闭过程,再次输入
python3.9 bot.py
。
此时终端会多出来自于nonebot_plugin_gocqhttp
的信息,并开始登录 bot 账号。
在网络诊断完成后,Hoka 便运行成功,可以使用了。
后言
你已经学会如何配置 & 部署 Hoka 了!