chingkingm

部署说明

chingkingm ... 2022-1-4 大约 7 分钟

# 部署说明

Windows平台下部署HoshinoBot的简单说明

# 硬件

一台运行Windows的服务器或个人电脑

如果你希望bot全天候在线,那么就需要使用服务器.

  1. 开始之前,先要确定一下你使用的系统是多少位的,以便下载合适的软件.
    • 在桌面右键'此电脑',选择属性;
    • 弹出的窗口中会有'系统类型'的字段,记住自己是32位还是64位.

系统类型

  1. 选择合适的位置,新建一个文件夹用来存放软件,下文中将使用bot_folder代指这个文件夹.

# 软件

软件分为2部分,go-cqhttp和HoshinoBot

其中gocq相当于一个QQ客户端,负责收发消息;Hoshino负责处理,计算.

示意图

图[1]

# go-cqhttp

  1. 前往其Github Release页面 (opens new window),下载符合你系统的安装包.对应关系为:
  • go-cqhttp_windows_386.exe:32位
  • go-cqhttp_windows_amd64.exe:64位
  1. 在bot_folder中新建文件夹go_cqhttp,将下载的安装包移入并更名为go-cqhttp.exe
  2. 在go_cqhttp文件夹中新建文本文件go_cqhttp.txt,写入以下代码.
    start cmd /K go-cqhttp.exe
    1
  3. 保存并关闭go_cqhttp.txt,将其重命名为go_cqhttp.bat,双击运行go_cqhttp.bat.
  4. 按照提示选择配置:
     未找到配置文件，正在为您生成配置文件中！
 请选择你需要的通信方式:
 > 0: HTTP通信
 > 1: 云函数服务
 > 2: 正向 Websocket 通信
 > 3: 反向 Websocket 通信
 > 4: pprof 性能分析服务器
 请输入你需要的编号(0-9)，可输入多个，同一编号也可输入多个(如: 233)
 您的选择是:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    输入反向 Websocket 通信对应的序号,回车,待程序响应后关闭窗口.

注意

以上使用的为v1.0.0-beta8-fix2版本,其余版本可能会有出入.

  1. 更改自动生成的配置文件,打开config.yml
    1. 第4行,填写QQ号
    2. 第5行,填写密码.留空则每次登录需要扫码.
    3. 第96行,更改为ws://127.0.0.1:8080/ws/
自动生成的config.yml



 
 


























































































 










# go-cqhttp 默认配置文件

account: # 账号相关
  uin: 1233456 # QQ账号
  password: '' # 密码为空时使用扫码登录
  encrypt: false  # 是否开启密码加密
  status: 0      # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
  relogin: # 重连设置
    delay: 3   # 首次重连延迟, 单位秒
    interval: 3   # 重连间隔
    max-times: 0  # 最大重连次数, 0为无限制

  # 是否使用服务器下发的新地址进行重连
  # 注意, 此设置可能导致在海外服务器上连接情况更差
  use-sso-address: true

heartbeat:
  # 心跳频率, 单位秒
  # -1 为关闭心跳
  interval: 5

message:
  # 上报数据类型
  # 可选: string,array
  post-format: string
  # 是否忽略无效的CQ码, 如果为假将原样发送
  ignore-invalid-cqcode: false
  # 是否强制分片发送消息
  # 分片发送将会带来更快的速度
  # 但是兼容性会有些问题
  force-fragment: false
  # 是否将url分片发送
  fix-url: false
  # 下载图片等请求网络代理
  proxy-rewrite: ''
  # 是否上报自身消息
  report-self-message: false
  # 移除服务端的Reply附带的At
  remove-reply-at: false
  # 为Reply附加更多信息
  extra-reply-data: false
  # 跳过 Mime 扫描, 忽略错误数据
  skip-mime-scan: false

output:
  # 日志等级 trace,debug,info,warn,error
  log-level: warn
  # 日志时效 单位天. 超过这个时间之前的日志将会被自动删除. 设置为 0 表示永久保留.
  log-aging: 15
  # 是否在每次启动时强制创建全新的文件储存日志. 为 false 的情况下将会在上次启动时创建的日志文件续写
  log-force-new: true
  # 是否启用日志颜色
  log-colorful: true
  # 是否启用 DEBUG
  debug: false # 开启调试模式

# 默认中间件锚点
default-middlewares: &default
  # 访问密钥, 强烈推荐在公网的服务器设置
  access-token: ''
  # 事件过滤器文件目录
  filter: ''
  # API限速设置
  # 该设置为全局生效
  # 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
  # 目前该限速设置为令牌桶算法, 请参考:
  # https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
  rate-limit:
    enabled: false # 是否启用限速
    frequency: 1  # 令牌回复频率, 单位秒
    bucket: 1     # 令牌桶大小

database: # 数据库相关设置
  leveldb:
    # 是否启用内置leveldb数据库
    # 启用将会增加10-20MB的内存占用和一定的磁盘空间
    # 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
    enable: true

  # 媒体文件缓存， 删除此项则使用缓存文件(旧版行为)
  cache:
    image: data/image.db
    video: data/video.db

# 连接服务列表
servers:
  # 添加方式，同一连接方式可添加多个，具体配置说明请查看文档
  #- http: # http 通信
  #- ws:   # 正向 Websocket
  #- ws-reverse: # 反向 Websocket
  #- pprof: #性能分析服务器
  # 反向WS设置
  - ws-reverse:
      # 反向WS Universal 地址
      # 注意 设置了此项地址后下面两项将会被忽略
      universal: ws://your_websocket_universal.server
      # 反向WS API 地址
      api: ws://your_websocket_api.server
      # 反向WS Event 地址
      event: ws://your_websocket_event.server
      # 重连间隔 单位毫秒
      reconnect-interval: 3000
      middlewares:
        <<: *default # 引用默认中间件
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
  1. 再次运行go_cqhttp.bat,程序开始登录QQ.
  2. 至此,go-cqhttp配置完成.此时向该QQ发送消息,命令行中会有显示.

# HoshinoBot

# 环境准备

  1. Python,推荐使用Python3.8

    1. 前往Python (opens new window)下载对应系统的Windows installer
    2. 运行安装程序,注意勾选Add Python 3.8 to PATH,点击Install Now开始安装.

    add to path

  2. Git,最新版即可

    1. 前往Git (opens new window)下载32-bit Git for Windows Setup或64-bit Git for Windows Setup
    2. 安装,看不懂的话一路next就好
    3. 复制以下2条命令并用你自己的信息替换引号内的内容,右键开始菜单,选择Windows Powershell,分别运行2条命令.
    git config --global user.name "Your Name"
git config --global user.email "email@example.com"
    1
    2

# hoshino本体

  1. 本体的地址为Hoshino (opens new window),打开后可以看到一个readme页.
  2. 点击绿色的code按键,复制出现的链接.code
  3. 打开bot_floder文件夹,按住shift加鼠标右键,选择在此处打开 Powershell 窗口(S),输入
    git clone [复制的链接]
    1
    回车,等待下载.
下载失败看这里
  • 可以将链接中的"github.com"替换为"gitclone.com/github.com"
  • 或者点击code后选择 Download ZIP下载压缩包.
    zip
  1. 进入~\bot_folder\HoshinoBot\hoshino,复制config_example文件夹并重命名为config
  2. 进入config文件夹,右键单击__bot__.py,选择Edit with IDLE.
  3. 依照注释修改SUPERUSERS字段,其余选项可保持原样.
  4. 回到HoshinoBot文件夹,在此处打开powershell,输入以下命令,等待安装完成
pip install -r requirements.txt
1

提示

安装速度很慢的话,请查看pip换源

  1. 双击运行run.py,或者使用powershell输入python run.py,开启hoshino.尝试向bot私聊发送在?,如果有回复则搭建成功.

# 更进一步

至此,我们已经搭建好了一个具有基础功能的'原型机',接下来可以通过安装插件来扩充它的功能. 以安装Genshin Impact Bot (opens new window)为例:

  1. 打开其github页面 (opens new window).
  2. 先阅读readme,一般会有安装步骤.
  3. 在hoshino/modules文件夹打开powershell,运行命令
    git clone https://github.com/H-K-Y/Genshin_Impact_bot.git
    1
  4. clone完毕后进入Genshin_Impact_bot文件夹,查看是否有requirements.txt文件.若有,使用命令
pip install -r requirements.txt
1

安装依赖.

提示

这个(和其他一些)插件,文件夹中没有requirements.txt,但readme中提及了需要某某模块,则需要使用命令pip install [模块名]来安装依赖

  1. 编辑HoshinoBot\hoshino\config_bot_.py内MODULES_ON，加入此插件的文件夹名字,即Genshin_Impact_bot,重启hoshino就可以生效了.

  1. 图片来自passbya.xyz (opens new window) ↩︎

上次编辑于: 2022年1月6日 20:58
贡献者: chingkingm