开始部署之前

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

进入Hoka的仓库。
如下图所示，克隆或下载代码的压缩文件：

得到的文件夹应如下图：

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

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

————————

配置Hoka的环境配置文件

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

进入.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

如下，这里分别是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 = ["*"]
配置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
2
3

APSCHEDULER_AUTOSTART = true

API_TIMEOUT = 3600

rauthman 权限管理插件的配置项：

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

RAM_CMD = 功能
RAM_ADD = 开启
RAM_RM = 关闭
RAM_SHOW = 查询
RAM_AVAILABLE = 全局查询

game 群组游戏插件的配置项：
- GAME_PATH不要碰；
- MAX_BET_GOLD为俄罗斯轮盘中赌注的上限，可以调低防止一夜暴富一夜回到解放前。
  1
  2
  GAME_PATH = ''
  MAX_BET_GOLD = 10000
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}]
你已经配置好了环境配置文件！

————————

配置Hoka的群组游戏

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

进入src/plugins/game/gacha.py，找到class NormalData：

class 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。

在终端中找到这么一行：

1	[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了！

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

Hoka-bot部署教程

开始部署之前

配置Hoka的环境配置文件

配置Hoka的群组游戏

配置Go-CQHTTP & 运行Hoka

后言