【Kivibot】轻量便捷且优雅的Kivi机器人部署教程
此项目仅用于学习交流,禁止用于非法用途KiviBot
是一个使用 JavaScript
语言编写,基于 oicq ,并修改和优化于 abot 的轻量、跨平台的 QQ 机器人框架。
注意事项
- 确保系统的相同,是减少麻烦的最有效途径
- 很多操作你很有可能之前从来没有接触过
- 遇到问题不要慌,先检查是不是漏了亿步
- 框架还处于测试阶段,教程可能不会及时更新。
- 遇到问题请先尝试找搜索引擎解决,实在解决不了的可以加入群聊礼貌提问
Windows
必要的环境安装
下载框架文件
还没有加群?点此加入群聊。若链接无效,可手动搜索群号:
296732038
请到框架交流群群文件的
KiviBot 框架与插件
文件夹下载框架文件文件名:
KiviBot 0.8.0.zip
请解压后再进行下面操作
下载安装 node
node
是JavaScript
的一个运行环境,推荐从 官网 下载。下载完后运行安装包,并一直点击下一步直至完成安装。
检查
打开框架文件夹(解压框架压缩包后的文件夹,目录下有
package.json
文件),并在框架文件夹的地址栏
输入cmd
并回车在弹出的黑框(命令行终端)中依次输入
node -v
和npm -v
并回车来测试node
是否安装成功
请务必注意,要在框架文件夹的地址栏中打开 cmd 命令行。
- 如果正确输出了版本号,则说明
node
及附带的npm
包管理工具安装成功,且环境变量自动配置好了
安装框架依赖
- 按上述方式打开命令行终端,输入并执行以下命令,来更换 npm 国内镜像源
npm config set registry https://registry.npmmirror.com/ |
当终端命令行正在执行一些操作时,一般情况下按
Ctrl
+C
组合键可以强制退出当前操作
- 更换完后输入命令
npm i
安装框架依赖文件
全局安装进程管理器 pm2
pm2
是一个进程管理器,可用于部署与管理JavaScript
应用程序这里推荐使用它来部署和管理框架,输入并执行以下命令来全局安装
pm2
npm i -g pm2 |
配置 ffmpeg
(可选)
如果只是想尝试框架,不需要发送语音和视频的功能,可跳过此步骤
到群文件或 点此 下载最新
ffmpeg
压缩包,解压,并将解压后的bin
目录添加到 系统环境变量 的Path
字段里打开终端,并输入 ffmpeg -version 命令测试是否配置成功。如果出现版本提示且未报错,则配置成功
如何打开系统环境变量可参考: Windows 如何配置环境变量,添加 Path - 百度经验,具体操作方式随着操作系统版本的不同而存在差异
验证账号
首次运行框架,请将上述的
命令行终端最大化
后执行以下命令,根据提示完成框架配置和登录验证流程
npm start |
期间可能会要求扫码、短信验证码或者滑块等,因账号而异。如果收到了上线通知,则说明账号验证成功
账号验证成功成功后,按
Ctrl
+C
组合键退出当前账号验证环境
请勿关闭命令行窗口
部署框架
- 上一步完成后,输入并执行以下命令,将框架作为后台进程启动,此时就算关闭了终端窗口,机器人框架依然在运行
npm run deploy |
- 账号信息只需记录一次,除了修改密码、被冻结或者强制下线外,都不需要再次重新验证账号
当命令行输入
npm start
时,只是临时启动框架,仅用于测试和通过首次登录流程,如果这个时候关闭终端窗口,框架也会随之停止
- 下表说明了各个终端命令的用途与异同
命令 | 功能与说明 |
---|---|
npm start |
第一次启动或者临时启动时执行,用于第一次账号信息验证,当终端退出时框架也会退出 |
npm run deploy |
使用 pm2 将最新框架代码部署在后台,当终端退出时框架依然运行在后台 |
npm run log |
查看 pm2 的框架消息日志与调试信息,随时看随时开,也可以一直打开 |
npm run stop |
停止 pm2 已经部署的框架进程(停止并关闭框架) |
npm run delete |
从 pm2 进程列表中删除框架进程,需要先停止进程 |
如果账号由于某些原因被冻结或者强制下线,此时需要按照以下流程重新登录。
- 输入
npm run stop
停止框架。- 输入
npm run start
进入验证流程并重新验证账号。Ctrl
+C
组合键退出账号验证环境- 输入
npm run deploy
重新部署框架。
好啦,便捷优雅的KiviBot已部署完成,快向机器人发送
#帮助
查看所有指令叭