该文档将讲述如何部署Hoka-bot（以下称为Hoka）。

Hokabot-bot

在开始本教程前，需要知道该教程：

  • 基于Python3.9
  • 基于Linux系统 / Ubuntu（我是20.04.1版本）
  • 是6月30日版本的Hoka-bot部署教程

开始部署之前

理所当然的，你需要将Hoka的代码克隆至本地。

  1. 进入Hoka的仓库。

  2. 如下图所示，克隆或下载代码的压缩文件：

克隆或下载ZIP
  1. 得到的文件夹应如下图：
主文件夹

关于bot代码结构可以看看这篇Nonebot2教程

你已经得到了一个Hoka！但他还是个空壳，无法立马投入使用。

————————

配置Hoka的环境配置文件

Hoka部署最为紧要的部分是.env文件，也就是环境配置文件。

  1. 进入.env文件进行编辑：
1
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
37
38
39
# .env

ENVIRONMENT=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、生产环境；
1
ENVIRONMENT=dev

  1. 如下，这里分别是HOST 监听IP/主机名、PORT 监听端口、LOG LEVEL 日志等级和FASTAPI_RELOAD的配置：
    • 下面的端口如果已被使用可以修改为其他数字，其它则都不需要碰。
1
2
3
4
HOST=127.0.0.1
PORT=56766
LOG_LEVEL=INFO
FASTAPI_RELOAD=true

    • 配置SUPERUSERS 超级用户：超级用户是Hoka的管理员，有着最高权限。
      这里推荐只写你自己的QQ号；
    • 配置NICKNAME bot昵称：不建议修改，因为我都是直接在代码里写的Hoka，改了没啥用；
    • 配置COMMAND_START 命令前缀：不建议修改，但也不是不能改；
    • 配置COMMAND_SEP 命令隔开符：不咋用到这个，随意更改。
1
2
3
4
SUPERUSERS = [""]
NICKNAME = ["hoka"]
COMMAND_START = ["hoka", ""]
COMMAND_SEP = ["*"]

  1. 配置Go-CQHTTP插件：
    • 介于该插件的前端可以登录账号，你不需要配置GOCQ_ACCOUNR；
    • 该插件将会下载GOCQ_URL中填写的地址，什么都不输入将自动使用该插件默认的镜像站以及最新版本。
1
2
3
4
5
6
7
8
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

  1. 不需要管这俩。
1
2
3
APSCHEDULER_AUTOSTART = true

API_TIMEOUT = 3600

  1. rauthman 权限管理插件的配置项：
    • 其实只是指令名更改，不建议修改。
1
2
3
4
5
RAM_CMD = 功能
RAM_ADD = 开启
RAM_RM = 关闭
RAM_SHOW = 查询
RAM_AVAILABLE = 全局查询

  1. game 群组游戏插件的配置项：
    • GAME_PATH不要碰；
    • MAX_BET_GOLD为俄罗斯轮盘中赌注的上限，可以调低防止一夜暴富一夜回到解放前。
1
2
GAME_PATH = ''
MAX_BET_GOLD = 10000

  1. read_60s 60秒读世界插件的配置项：
    • READ_QQ_FRIENDS为每日定时发送的QQ好友号；
    • READ_QQ_GROUPS为每日定时发送的QQ群聊号；
    • READ_INFORM_TIME为每日定时发送的时间，按照本地时间为标准，如下便是每日早上9点5分。
1
2
3
READ_QQ_FRIENDS = []
READ_QQ_GROUPS = []
READ_INFORM_TIME = [{"HOUR": 9, "MINUTE": 5}]

  1. 你已经配置好了环境配置文件！
————————

配置Hoka的群组游戏

需要配置的只有群组卡池。

  1. 进入src/plugins/game/gacha.py，找到class NormalData：
1
2
3
4
5
6
7
8
9
10
11
12
13
class NormalData:
    sixList = []

    fiveList = []

    fourList = []

    threeList = []

    onelist = ['虾虾']

    fiveListUp = []
    sixListUP = []

  1. sixList为卡池的六星角色，fiveList为五星…以此类推。
    oneList建议保留为虾虾，因为虾虾这个名字也在代码内，当然你也可以自己一次性全部修改。
    fiveListUp和sixListUP都是概率UP角色。

  2. 填写格式像这样：sixList = ['名字', '另一个名字']。

————————

配置Go-CQHTTP & 运行Hoka

  1. 首先需要运行一次Hoka。
    在有bot.py的主文件夹内开终端输入python3.9 bot.py。

  2. 在终端中找到这么一行：

1
[INFO] nonebot_plugin_gocqhttp | Startup complete, Web UI has served to http://127.0.0.1:56766/go-cqhttp/
  1. 进入后面的这个地址，页面应如下：
Go-CQHTTP前端

  1. 点击左上角的添加账号。
    依次输入bot的QQ号、密码，并选择登录设备类型。个人通常使用Android Phone。

  2. 提交后关闭页面，回到终端关闭过程，再次输入python3.9 bot.py。
    此时终端会多出来自于nonebot_plugin_gocqhttp的信息，并开始登录bot账号。
    在网络诊断完成后，Hoka便运行成功，可以使用了。

————————

后言

你已经学会如何配置&部署Hoka了！

如有任何疑惑、建议、反馈，务必联系我！
Hoka本体号：3363863549，将会有最新功能我又鸽了。