node-coolq-robot
作者:草梅友仁
本项目基于cq-robot、coolq-http-api、cq-websocket ,按照官方SDK风格重新封装了事件函数和api函数
项目特色
仿官方SDK风格,熟悉易语言版的很快就可以上手。
仿酷Q目录设计,可以像原生酷Q插件那样载入插件,也便于插件的开发
可以使用JavaScript和TypeScript进行开发,具有一定的跨平台性
项目目录
- /src 源代码
- /app 插件存放的位置
- /com.example.demo 应用根目录
- /data 应用数据存放目录
- index.json/index.jsonc 插件配置项
- index.ts/index.ts 插件入口文件
- /com.example.demo 应用根目录
- /conf
- setting.json/setting.jsonc CQWebSocket 连接配置,用于和coolq-http-api建立连接
- /utils 一些工具类
- index.ts 项目运行入口
- /app 插件存放的位置
- /dist 最终需要运行的文件
快速开始
clone本项目
1
git clone https://github.com/CaoMeiYouRen/node-coolq-robot.git
修改src/conf/setting.jsonc中的accessToken【重要】,其他参数可以默认(关于该配置,详见CoolQ HTTP API配置)
酷Q安装coolq-http-api,修改 酷Q Pro\data\app\io.github.richardchien.coolqhttpapi\config 下的相关配置,其中access_token与上方accessToken保持一致(关于该配置,详见CQWebSocketOption)
酷Q启动coolq-http-api,注意,如果修改access_token时插件已启用,请重载应用或重启酷Q
执行 npm run build 生成dist文件
执行dist/index.js,开发环境下可以使用nodemon,生产环境可以使用pm2等
在控制台查看效果(如果出现 [WebSocket] 连接成功 即为成功)
演示效果
安装插件
所有插件放在src/app目录下,新建一个由appId命名的文件夹(下称为应用根目录),入口文件必须为index.js/index.ts(编译后均为index.js),配置项为index.json或index.jsonc【关于jsonc需要特别解释下,就是支持注释的json,即VScode中的JSON with Comments格式】
应用所有数据需存放在 [appId]/data/ 目录下,以免给用户造成困扰
考虑到插件可能会有自己的node_modules依赖,将依赖也装在 项目根目录 下即可(注意,如果安装在项目根目录有问题,也可安装在 应用根目录 ,只不过src和dist目录下均需安装)
注意:最终执行的文件为dist目录下的内容,因此如果有除了json/jsonc格式以外的文件需要从src目录下复制,请修改gulpfile.js文件
插件开发
对于开发者,本人也提供了demo,建议使用TypeScript进行开发,当然也支持用JavaScript开发
以下是一个空的demo示例,更详细内容请查看本项目的src/app/下面的demo
1 | class App extends CQApp { |
关于应用加载:符合以下条件之一的应用不会载入
- AppID与其根文件夹名称不同
- CQ_API版本不为9
- HTTP_API版本不为4
- 应用未启用(isEnable=false)
api权限:在应用根目录的index.json中配置,对于没有权限的api调用不会执行
插件事件优先级:在应用根目录的index.json中配置,数值越低优先级越高,高优先级的可以截断消息。注意:本项目中并未对插件事件优先级做限制,而且也不限制优先级为10000时就不能截断消息,但为了与官方要求一致,建议不要使用10000、20000、30000、40000、50000以外的优先级,并且不得在优先级为10000时截断消息
日志:日志文件会在同级运行目录生成log文件夹。在log文件夹下有app和debug两个文件夹,分别是生产环境和开发环境的日志,会记录下api的调用和应用接收到的事件信息。当插件处于debug模式时,所有日志都在debug文件夹下;生产环境下,所有日志都在app目录下
项目依赖
node-cq-websocket : https://github.com/momocow/node-cq-websocket
coolq-http-api : https://github.com/richardchien/coolq-http-api
项目参考
JCQ-CoolQ : https://github.com/Meowya/JCQ-CoolQ
(本项目在开发中很大程度上借鉴了JCQ的思路,在此表示感谢)
本文作者:草梅友仁
本文地址: https://blog.cmyr.ltd/archives/5e4e9fe0.html
版权声明:转载请注明出处!