此项目仅用于学习交流,禁止用于非法用途

KiviBot 是一个使用 JavaScript 语言编写,基于 oicq ,并修改和优化于 abot轻量跨平台的 QQ 机器人框架。

注意事项

  1. 确保系统的相同,是减少麻烦的最有效途径
  2. 很多操作你很有可能之前从来没有接触过
  3. 遇到问题不要慌,先检查是不是漏了亿步
  4. 框架还处于测试阶段,教程可能不会及时更新。
  5. 遇到问题请先尝试找搜索引擎解决,实在解决不了的可以加入群聊礼貌提问

Windows

必要的环境安装

下载框架文件

还没有加群?点此加入群聊。若链接无效,可手动搜索群号:296732038

  • 请到框架交流群群文件KiviBot 框架与插件 文件夹下载框架文件

  • 文件名:KiviBot 0.8.0.zip解压后再进行下面操作

下载安装 node

  • nodeJavaScript 的一个运行环境,推荐从 官网 下载。

  • 下载完后运行安装包,并一直点击下一步直至完成安装

检查

  • 打开框架文件夹(解压框架压缩包后的文件夹,目录下有 package.json 文件),并在 框架文件夹的地址栏 输入 cmd 并回车

  • 在弹出的黑框(命令行终端)中依次输入 node -vnpm -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 进程列表中删除框架进程,需要先停止进程

如果账号由于某些原因被冻结或者强制下线,此时需要按照以下流程重新登录。

  1. 输入 npm run stop 停止框架。
  2. 输入 npm run start 进入验证流程并重新验证账号。
  3. Ctrl + C 组合键退出账号验证环境
  4. 输入 npm run deploy 重新部署框架。

好啦,便捷优雅的KiviBot已部署完成,快向机器人发送 #帮助 查看所有指令叭