Satori 协议

机器人支持对接任何符合Satori 协议open in new window的服务端,以支持更多的平台。

Koishi 是最具代表性的 Satori 服务端之一。下文以通过 Koishi 连接 KOOK 平台为例,展示一下 Satori 协议的用法:

注意

Satori 协议的使用方式,对于不同 Satori 协议的服务端,以及不同的平台适配器,使用方式都不尽相同。且不同的服务端对协议的支持程度不同,可能无法完全支持机器人的所有功能。建议使用者有一定的排错能力。

1. 安装并启动 Koishi 和 server-satori 插件

设置保持默认即可。

2. 启动对应平台适配器

此处以 KOOK 平台为例。在适配器中填入你的机器人的登录信息。

启动适配器后,可以利用 Koishi 自带的 help 指令测试。若可以收到回复,代表 KOOK 与 Koishi 之间的通信正常。

3. 登录跑团机器人

在此处的登录界面,选择 Satori 平台,输入所需的 EndpointToken 信息。

其中,URL 地址可以从 Koishi 的日志中看到:

而地址的后缀 /satoriToken 则来自于第一步中 server-satori 插件的配置。由于我们默认没有填入 token,所以留空即可。

4. 选择子频道,开始使用

点击登录后,会卡在选择子频道的界面。这是因为目前 Koishi 的 KOOK 适配器没有实现 Satori 协议的获取频道列表功能。

所幸这一功能缺失并不阻塞我们的使用。可以按照图中的提示,在频道里发一条消息,就可以看到对应的频道出现。

选择该频道后,即可像正常一样开始使用了。


再次提醒,这里使用 Koishi 和 KOOK 平台仅仅是为了举个例子。实际使用中,基于不同的 Satori 服务端和平台,使用方法也会存在很多区别。也欢迎大家分享自己的使用经验~

Last Updated: