/koishi-plugin-kbot

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

KBot

install size Platform FOSSA Status

GitHub forks GitHub Repo stars

License wakatime QQ

NodeJs Version

!

基于 koishi 搭建的高效、多功能 QQ 机器人


功能

  • 基础娱乐功能:

    KBotBasic 基础功能

    一言: 随机一言

    人间: 随机发送散文集《我在人间凑数的日子》句子

    今日新闻: 获取60秒看世界新闻 (来源于: ALAPI)

    天气: 查询国内天气 (来源于: ALAPI)

    自检: 通过图的形式发送机器人的运行状态

    TTS: 语音合成 (来源于: text-to-speech)

    KBotManage 群管功能

    WebUI: 通过网页的形式管理机器人, 可以禁言/解禁, 踢出群聊, 发送消息等

    撤回消息: 批量撤回用户消息, 但需要机器人权限

    黑名单: 全局黑名单, 添加全局黑名单且可以全局检查机器人所在的所有群并踢出黑名单用户

    KBotBilibili b站订阅相关功能

    订阅/删除: 订阅/删除b站up主

    查看最新动态: 查看up主最新动态

    查看订阅列表: 查看订阅的up主列表

    查成分: 查看up主关注的成分(仅供娱乐)

    查弹幕: 查看up主近期进入的直播间以及发送的弹幕(仅供娱乐)

    KBotTwitter 推特订阅相关功能

    订阅/删除: 订阅/删除推特博主

    查看最新动态: 查看推特博主最新动态

    查看订阅列表: 查看订阅的推特博主列表

    KBotTarot 塔罗牌功能

    塔罗牌: 抽取单张塔罗牌或者抽取塔罗牌阵

    KBotMusic 点歌功能

    点歌: 通过关键词点歌(拥有 qq/网易云 平台)

    KBotYoutube 油管视频解析功能

    视频解析: 通过监测到的油管视频链接解析视频信息 (需要API v3)

  • 游戏功能:

    KBotValorant 无畏契约功能(开发中)

    查战绩: 查看玩家的战绩

    查看每日商店: 查看每日商店的商品

安装

  1. 下载插件运行平台 Koishi
  2. 在插件平台的 插件市场 中搜索 kbot 并安装

使用方法

  1. 基础功能:

    • 一言: 一言
    • 人间: 人间
    • 今日新闻: 今日新闻
    • 天气: 天气
    • 自检: 自检
    • TTS: tts <文本> 例如: tts 你好
  2. 群管功能:

    • 撤回消息: guildmanage.recall <用户QQ> [消息数量]
      • 参数说明: 用户QQ 为必填参数, 消息数量 为可选参数, 默认为 1
      • 别名: 批量撤回
      • 例如: guildmanage.recall -c 10 123456 撤回用户 12345610 条消息
    • 黑名单拉黑: guildmanage.blacklist <用户QQ> [拉黑原因]
      • 参数说明: 用户QQ 为必填参数, 拉黑原因 为可选参数, 默认为 无
      • 别名: 全局拉黑
      • 例如: guildmanage.blacklist -r 大笨蛋 123456 拉黑用户 123456, 并且原因为 大笨蛋
    • 黑名单检查: guildmanage.checkblacklist
      • 参数说明: 无
      • 别名: 复核全群黑名单
  3. b站订阅功能:

    • 订阅: bilibili -a <upInfo>
      • 参数说明: upInfo 为必填参数, 为 up主uid 或者 up主 的名称
      • 例如:
        • bilibili -a 123456 订阅 uid123456up主
        • bilibili -a xxx 订阅 名称xxxup主
    • 删除: bilibili -r <upInfo>
      • 参数说明: upInfo 为必填参数, 为 up主uid 或者 up主 的名称
      • 例如:
        • bilibili -r 123456 删除 uid123456up主
        • bilibili -r xxx 删除 名称xxxup主
    • 查看最新动态: bilibili -s <upInfo>
      • 参数说明: upInfo 为必填参数, 为 up主uid 或者 up主 的名称
      • 例如:
        • bilibili -s 123456 查看 uid123456up主 的最新动态
        • bilibili -s xxx 查看 名称xxxup主 的最新动态
    • 查看订阅列表: bilibili -l
      • 参数说明: 无
    • 查成分: bilibili -v <upInfo>
      • 参数说明: upInfo 为必填参数, 为 up主uid 或者 up主 的名称
      • 例如:
        • bilibili -v 123456 查看 uid123456up主 的关注并解析成分
        • bilibili -v xxx 查看 名称xxxup主 的关注并解析成分
    • 查弹幕: bilibili -d <upInfo>
      • 参数说明: upInfo 为必填参数, 为 up主uid 或者 up主 的名称
      • 例如:
        • bilibili -d 123456 查看 uid123456up主 的近期弹幕
        • bilibili -d xxx 查看 名称xxxup主 的近期弹幕
  4. 推特订阅功能

    • 订阅: twitter -a <userId>
      • 参数说明: userId 为必填参数, 为 博主@后的字符串
      • 例如:
        • twitter -a xxx 订阅 twitterId@xxx博主
    • 删除: twitter -r <userId>
      • 参数说明: userId 为必填参数, 为 博主@后的字符串
      • 例如:
        • twitter -r xxx 删除 twitterId@xxx博主
    • 查看最新动态: twitter -s <userId>
      • 参数说明: userId 为必填参数, 为 博主@后的字符串
      • 例如:
        • twitter -s xxx 查看 twitterId@xxx博主 的最新动态
    • 查看订阅列表: twitter -l
      • 参数说明: 无
  5. 点歌功能

    • 点歌: music <name> [点歌平台]
      • 参数说明: name 为必填参数, 为 歌曲名称, 点歌平台 为可选参数, 默认为 qq (可以自行在配置页面配置默认平台)
      • 例如:
        • music xxx 点歌 xxx
        • music -p netease xxx 点歌 xxx (指定为 netease 平台)
  6. 塔罗牌功能

    • 塔罗牌: 抽塔罗牌
      • 参数说明: 无
    • 塔罗牌阵: 塔罗牌
      • 参数说明: 无

注意事项

  • 插件的配置项不是所有都是可选的,具体请查看插件页面中的配置项
  • 在使用插件时, messages 插件依赖与 sqlite 数据库可能会有内存泄漏的问题, 建议使用其他数据库
  • 如果使用带图功能, 需要启用 puppeteer 插件, 那么内存的消耗可能会达到 2G ~ 3G 左右, 请注意

Todo

  • 基础功能
    • 根据权限自动同意邀请进群
    • TTS
  • 群管功能
    • WebUI - 修改头衔
    • WebUI - 修改群名
    • WebUI - 修改群公告
    • WebUI - 修改群简介
    • WebUI - 修改群头像
    • WebUI - 设置监控群消息
    • WebUI - 设置群屏蔽词
    • WebUI - 设置群加群验证
    • 根据屏蔽词监控群聊
    • 对于加群用户进行群验证
    • 撤回消息
    • 添加黑名单
    • 复核全群黑名单
    • 展示黑名单
    • 删除黑名单
  • Valorant
    • 查询战绩
    • 查询赛事
    • 查询商店
  • 彩虹六号
    • 查询战绩
    • 查询赛事

感谢

  • koishijs: 感谢 Koishi 官方提供的插件开发框架, 以及技术指导
  • medicago087: 对于 bug 的反馈

借鉴

赞助

License

FOSSA Status