幻想乡框架 Gensokyo QQ官方机器人Api框架 可接入nb koishi
一念成仙AI
2023年11月06日 13:36

项目主页

https://github.com/Hoshinonyaruko/Gensokyo

喜欢请star我~

大家好~我是小狐狸~

我开发了一个基于q.qq.com

qq开放平台的机器人框架,目标是完美支持onebotv11标准

https://onebot.dev/ecosystem.html

OneBot 实现指的是与机器人平台对接、向上提供符合 OneBot 标准的接口的程序,可简称为实现端;

Gensokyo是一个新的onebot实现端,

Gensokyo是继gocqhhtp之后产生的新框架,

由早苗狐&mnixry开发,具有友好的界面,和全平台运行能力(支持安卓termux)

采用和gocq类似地配置方法和运行方法,完全一样的适配性,

但是基于官方q.qq.com(即将开放群机器人,目前可用频道机器人)的api的一个新框架

介绍完毕,下面开始小白教程~

首先,打开gitee,下载最新发行版 https://gitee.com/sanaefox/Gensokyo/releases 其他系统发行版 (star希望) https://github.com/Hoshinonyaruko/Gensokyo/actions 国内网盘地址(同步更新): https://wwcr.lanzoul.com/gensokyo

第一步,解压运行~

直接双击你会看到,点击确定

再次点击确定

然后找到bat文件(绿色箭头所指)双击它

关掉这个窗口,再双击运行一次gensokyo.bat

两种配置方式,

1,直接打开config.yml配置(注意缩进,空格,格式)遇到问题,196173384这个群问作者

2,再次运行bat,从浏览器配置(简单)(我们教程走这里)

打开图片中第一行的地址(蓝色的),复制下来,到浏览器打开,或者按住ctrl,然后单击这个地址

进入控制台,输入默认用户名,密码

点击默认的12345,箭头这里

点击修改配置

前往qq开发者开放平台,申请机器人 q.qq.com https://q.qq.com/#/ 注册,认证,然后点击开发设置

这里的3个值就是要填写到控制台的

这里的令牌,对应的是token

密钥,对应的是client_secret,都填入

appid,对应的botappid

然后,如果你是"私域"请去掉第17行的#(私域不at信息)

然后在第一行加上#,保证每一行对齐

私域机器人改成这样(去掉注释代表接收该事件)

点击提交修改,然后刷新页面

不出所料~机器人已经正常运行了

就可以看到日志了!

之后,框架如何使用?

框架需要连接ws_address地址来使用应用端,来添加插件~

什么是应用端?

应用端是机器人插件生态平台,有大量开发者基于标准和共识

开发开放海量插件!自由搭配组合

比如koishi,是ts语言机器人应用端,

nonebot,是python语言机器人应用端

trss和yunzai是js语言机器人应用端,

比如还有玲心,miraicq,hoshino,这些都是gensokyo支持的应用端 ....还有很多很多 也可以连接早苗,早苗是应用端api(云上的服务) 或者其他的应用端api,比如獭.net(最终幻想獭獭机器人) 或者,你可以直接填入群内的ws地址,来进行机器人体验, 196173384这个群公告内有公用早苗,云崽地址, 群内有更多机器人的教程和公用地址 一些应用端教程, nonebot2教程:https://www.bilibili.com/read/cv21231223​ koishi教程:https://www.bilibili.com/read/cv21550864​ 请忽略掉这些教程中关于cqhttp部分,其他部分一样 在bilibili搜索koishi nonebot2 trss 你可以看到很多教程~ 除此以外,Gensokyo还支持什么? 支持铃心自定义,支持miraicq插件载入器,支持红色问答 支持hoshino,支持獭.net 獭獭机器人, 支持 https://onebot.dev/ecosystem.html#%E5%BA%94%E7%94%A8%E6%A1%88%E4%BE%8B onebotv11生态页所有通过ws连接的机器人项目!

gensokyo将持续维护,长期更新,绝不跑路,成为机器人的幻想乡~