Satori 协议
机器人支持对接任何符合Satori 协议的服务端,以支持更多的平台。
Koishi 是最具代表性的 Satori 服务端之一。下文以通过 Koishi 连接 KOOK 平台为例,展示一下 Satori 协议的用法:
注意
Satori 协议的使用方式,对于不同 Satori 协议的服务端,以及不同的平台适配器,使用方式都不尽相同。且不同的服务端对协议的支持程度不同,可能无法完全支持机器人的所有功能。建议使用者有一定的排错能力。
1. 安装并启动 Koishi 和 server-satori 插件
设置保持默认即可。
2. 启动对应平台适配器
此处以 KOOK 平台为例。在适配器中填入你的机器人的登录信息。
启动适配器后,可以利用 Koishi 自带的 help
指令测试。若可以收到回复,代表 KOOK 与 Koishi 之间的通信正常。
3. 登录跑团机器人
在此处的登录界面,选择 Satori 平台,输入所需的 Endpoint
和 Token
信息。
其中,URL 地址可以从 Koishi 的日志中看到:
而地址的后缀 /satori
和 Token
则来自于第一步中 server-satori 插件的配置。由于我们默认没有填入 token,所以留空即可。
4. 选择子频道,开始使用
点击登录后,会卡在选择子频道的界面。这是因为目前 Koishi 的 KOOK 适配器没有实现 Satori 协议的获取频道列表功能。
所幸这一功能缺失并不阻塞我们的使用。可以按照图中的提示,在频道里发一条消息,就可以看到对应的频道出现。
选择该频道后,即可像正常一样开始使用了。
再次提醒,这里使用 Koishi 和 KOOK 平台仅仅是为了举个例子。实际使用中,基于不同的 Satori 服务端和平台,使用方法也会存在很多区别。也欢迎大家分享自己的使用经验~