该文档将讲述如何部署 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 文件进行编辑:

    plaintext
    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
    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、生产环境;

      plaintext
      1
      ENVIRONMENT=dev

  1. 如下,这里分别是 HOST 监听IP/主机名PORT 监听端口LOG LEVEL 日志等级FASTAPI_RELOAD 的配置:

    • 下面的端口如果已被使用可以修改为其他数字,其它则都不需要碰。

      plaintext
      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 命令隔开符:不咋用到这个,随意更改。

      plaintext
      1
      2
      3
      4
      SUPERUSERS = [""]
      NICKNAME = ["hoka"]
      COMMAND_START = ["hoka", ""]
      COMMAND_SEP = ["*"]
  2. 配置 Go-CQHTTP插件

    • 介于该插件的前端可以登录账号,你不需要配置 GOCQ_ACCOUNR

    • 该插件将会下载 GOCQ_URL 中填写的地址,什么都不输入将自动使用该插件默认的镜像站以及最新版本。

      plaintext
      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
  3. 不需要管这俩。

    plaintext
    1
    2
    3
    APSCHEDULER_AUTOSTART = true

    API_TIMEOUT = 3600
  4. rauthman 权限管理插件 的配置项:

    • 其实只是指令名更改,不建议修改。

      plaintext
      1
      2
      3
      4
      5
      RAM_CMD = 功能
      RAM_ADD = 开启
      RAM_RM = 关闭
      RAM_SHOW = 查询
      RAM_AVAILABLE = 全局查询
  5. game 群组游戏插件 的配置项:

    • GAME_PATH 不要碰;

    • MAX_BET_GOLD 为俄罗斯轮盘中赌注的上限,可以调低防止一夜暴富一夜回到解放前。

      plaintext
      1
      2
      GAME_PATH = ''
      MAX_BET_GOLD = 10000
  6. read_60s 60秒读世界插件 的配置项:

    • READ_QQ_FRIENDS 为每日定时发送的 QQ 好友号;

    • READ_QQ_GROUPS 为每日定时发送的 QQ 群聊号;

    • READ_INFORM_TIME 为每日定时发送的时间,按照本地时间为标准,如下便是每日早上 9 点 5 分。

      plaintext
      1
      2
      3
      READ_QQ_FRIENDS = []
      READ_QQ_GROUPS = []
      READ_INFORM_TIME = [{"HOUR": 9, "MINUTE": 5}]
  7. 你已经配置好了环境配置文件!

————————

配置 Hoka 的群组游戏

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

  1. 进入 src/plugins/game/gacha.py,找到 class NormalData

    python
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    class NormalData:
    sixList = []

    fiveList = []

    fourList = []

    threeList = []

    onelist = ['虾虾']

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

  3. 填写格式像这样:sixList = ['名字', '另一个名字']

————————

配置 Go-CQHTTP & 运行 Hoka

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

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

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

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

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

————————

后言

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