Windows 安装 WFBot
部署 FAQ (常见问题解答)
第一步: 配置WFBot
安装 .NET Core 3.1 官方链接 (Windows 请下载 Desktop Runtime) 
创建并且进入一个叫做 WFBot 的文件夹
下载并且解压 WFBot: 链接. 你需要下载下面这个东西: TODO
启动 WFBot.exe, 你将看到以下内容:
(也有可能会直接闪退, 在这步这是正常现象)
请在 WFBot 文件夹下找到 WFConfig.json, 修改以下的内容
将后面的数字 5 修改为你想使用的聊天平台的对应数字序号, 对应表如下
数字序号 | 通讯协议 | 支持平台 |
0 | OneBot | Mirai等 |
1 | 开黑啦 | 开黑啦(WIP) |
2 | QQ频道 | QQ频道(WIP) |
3 | MiraiHTTPv2 | Mirai |
再次双击 WFBot.exe 生成平台对应的配置文件
请按照你选择的平台进入下一步配置
—
如果你想自己编译…
clone 这个库, 运行 build-wfbot.bat
, 编译的结果在 out 文件夹内. 如果你是直接下载的这个库, 在 vs 内右键 WFBot, 转到 Build -> Conditional conpliation symbols, 填入 NoGitVersion
, 编译时使用 build-wfbot-nogitversion.bat
来正常编译.
- 针对改代码(如文字提示)又想享受官方编译最新或者自动更新的客户 你可以写一个 WFBot 的 插件
如果你不需要修改代码, 我们强烈建议你从上面下载.
如果你修改了代码并应用到机器人上, 建议你在 GitHub 上开源其最新版本.
如果你使用非官方版 我们将不保证运行安全与稳定.
—
第二步: 配置 OneBot 协议
- 安装 Mirai
Mirai 配置教程
在https://github.com/yyuueexxiinngg/onebot-kotlin/releases下载最新的 OneBot Mirai 插件
拖入 ./plugins 文件夹下
双击 mirai.cmd 等待输出

- 配置 OneBot 正向 WebSocket
OneBotConnector 基于的是 OneBot 协议给出的正向 WebSocket 通讯方案
你需要配置三样东西: AccessToken, 地址, 端口
AccessToken 类似密码, 是你的 OneBot 机器人和 WFBot 通信时鉴权需要, 可随意选取.
地址和端口是 OneBot 机器人所提供 WebSocket 连接的地址, 如无特殊需求基本上可以保持默认.
具体每种 OneBot 机器人如何修改这三样东西可以查询它们给出的教程, 这里简单举个例子.
以 OneBot Mirai 插件的配置文件作为例子, 修改这几行配置文件


改好后重启 Mirai, 等待那堆绿绿的输出.

配置 WFBot 的配置文件
打开 WFBot 文件夹下的 OneBotConfig.json
更改以下内容:

自定义 WFBot 的功能
—
第二步: 配置 MiraiHTTPv2 协议
安装 Mirai
Mirai配置教程
安装 Mirai-HTTP 插件
从 mirai-api-http GitHub Release 下载插件 (中国下载可能较慢)
下载后将 .jar 文件拖入 mirai 文件夹下的 plugins 文件夹内
双击 mirai.cmd 等待以下输出: 
配置 Mirai-HTTP 插件
打开 mirai\config\net.mamoe.mirai-api-http\settings.yml
将下面的内容复制粘贴覆盖到文件内, 按照注释修改.
adapters:
- http
- ws
debug: false
enableVerify: true
verifyKey: INITKEYIxzgOFzT ## 建议修改为一个!!!与下文一样!!!的Token
singleMode: false
cacheSize: 4096
adapterSettings:
ws:
## websocket server 监听的本地地址
## 一般为 localhost 即可, 如果多网卡等情况,自定设置
host: localhost
## websocket server 监听的端口
## 与 http server 可以重复, 由于协议与路径不同, 不会产生冲突
port: 8080
reservedSyncId: -1
http:
## http server 监听的本地地址
## 一般为 localhost 即可, 如果多网卡等情况,自定设置
host: localhost
## http server 监听的端口
## 与 websocket server 可以重复, 由于协议与路径不同, 不会产生冲突
port: 8080
## 配置跨域, 默认允许来自所有域名
cors: [*]
配置 Mirai
打开 WFBot 文件夹下的 Miraiv2Config.json, 按照说明修改配置文件
自定义 WFBot 的功能
—
第三步(可选): 自定义
WFBot 控制台内输入 ui 可以打开设置窗口 (仅 Windows) (以后可能会适配全平台) 
可自定义的内容如下:
修改群通知功能所用的口令 (默认为 7 个 *)
是否需要前导/
来使用命令 (默认需要)
包含 哪些奖励的入侵任务 需要通知到群内 (默认参见设置)
用于管理机器人的 QQ 号 (填你自己的, 用来修改敏感信息和接收报错)
是否自动同意 别人邀请机器人入群 (无需群内管理) 和 自主申请入群 (需群内管理)
WFA 授权的 ClientId
和 ClientSecret
(非必须, 见下)
WM 商品和紫卡查询单次发送的条数
每分钟机器人调用次数限制
是否使用中转后的 WarframeMarket 接口 (需 WFA 授权)
GithubToken (非必须)
可以使用的功能如下:
启用 WFA 授权 (非必须)
设置内填入从云之幻处授权的 ClientId
和 ClientSecret
即可启用
如果你不知道这俩是干嘛的, 就别瞎填, 因为我的用户创造力都好强啊
不启用授权不影响基本功能
WM 查询 可使用中转过后的服务器 速度大概更高
紫卡市场 使用 必须 启用 WFA 授权
授权获取 请查看 云之幻的 API 文档
—
附加教程: 配置 mirai
mirai 安装教程可能较旧. 总体上来说你需要的只有登录上 mirai 和 mirai-api-http 插件. 我们将在等会(鸽了)更新这个教程.
创建并进入一个叫做 mirai 的文件夹.
前往 https://github.com/iTXTech/mcl-installer 安装.