/HoshinoBot

A qqbot for Princess Connect Re:Dive (and other usage :)

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

HoshinoBot

License Python Version Nonebot Version 试用/赞助群 开发交流群

A QQ-bot for Princess Connect Re:Dive based on Nonebot

开发历史
  • 2019.09.20 HoshinoBot诞生
  • ... (待补充)
  • 2020年8月2日0点,qq机器人框架相继停止维护。 感谢 酷Q项目 和 CQHTTP插件 的开发者们!感谢他们让Hoshino得以诞生! Hoshino不再对酷Q进行支持

简介

HoshinoBot: 基于 nonebot 框架,开源、无公害、非转基因的QQ机器人。

功能介绍

HoshinoBot 的功能开发以服务 公主连结☆Re:Dive 玩家为核心。

主要功能
  • 转蛋模拟:单抽、十连、抽一井
  • 竞技场解法查询:支持按服务器过滤,支持反馈点赞点踩
  • 竞技场结算提醒
  • 公会战管理:详细说明见此文档
  • Rank推荐表搬运
  • 常用网址速查
  • 官方推特转发
  • 官方四格推送
  • 角色别称转换
  • 切噜语编解码:切噜~♪
  • 竞技场余矿查询

由于bot的功能会快速迭代开发,使用方式这里不进行具体的说明,请向bot发送"help"或移步此文件查看详细。会战管理功能的详细说明,请点击这里

通用功能
  • 蜜柑计划番剧更新订阅
  • 入群欢迎&退群提醒
  • 复读
  • 掷骰子
  • 精致睡眠套餐
  • 机器翻译
  • 反馈发送:反馈内容将由bot私聊发送给维护组

此外,HoshinoBot 为 艦隊これくしょん 玩家开发了以下功能

点击展开
  • 官推转发:「艦これ」開発/運営 & C2機関
  • 时报
  • 演习时间提醒
  • 月度远征提醒
  • 舰娘信息查询*晓改二
  • 装备信息查询*震电改
  • 战果人事表查询人事表191201

艦これ相关功能由于个人精力实在有限,无法进行更多功能(如海图攻略)的开发/维护。

如果您有新的想法,欢迎联系我!即便您不会编程,您也可以在内容更新上帮到我们!


功能模块控制

HoshinoBot 的功能繁多,各群可根据自己的需要进行开关控制,群管理发送 lssv 即可查看功能模块的启用状态,使用以下命令进行控制:

启用 service-name
禁用 service-name

如何开始使用

QQ群试用/赞助群提供了我们部署的bot,提供Hoshino的原生服务。您可以在这里试用bot功能、赞助开发者,赞助者可邀请bot加入自己的群使用。

如果您具备基本的linux与python能力,并拥有一台服务器(轻量级即可),您可以参阅部署指南自行部署。

开源协议及免责声明

本项目遵守GPL-3.0协议开源,请在协议允许的条件及范围内使用本项目。本项目的开发者不会强制向您索要任何费用,同时也不会提供任何质保,一切因本项目引起的法律、利益纠纷由与本项目的开发者无关。

  • 对于自行搭建、小范围私用的非营利性bot,若遇到任何部署、开发上的疑问,欢迎提交issue或加入开发交流群讨论,我们欢迎有礼貌、描述详尽的提问!
  • 对于以营利为目的部署的bot,由部署者负责,与本项目的开发者无关,本项目的开发者及社区没有义务回答您部署时的任何疑问。
  • 对于HoshinoBot插件的开发者,在您发布插件或利用插件营利时,请遵守GPL-3.0协议将插件代码开源。

最终解释权归HoshinoBot开发组所有。

部署指南

由于酷Q已停止运营,您可以使用go-cqhttpCQHTTP Mirai作为无头QQ客户端。

旧文档已失效(新文档正在编写中...),请参考由 pcrbot 社区提供的部署指南:

(点击查看旧文档)

本bot功能繁多,部分功能需要静态图片资源和带有认证的api key,恕不能公开。本指南将首先带领您搭建具有模拟抽卡(纯文字版)会战管理功能的HoshinoBot。其他功能需额外配置,请参考本章更进一步的对应小节。

部署步骤

Windows 部署

  1. 安装下面的软件/工具

  2. 安装 酷Q 及 CQHTTP 插件

    初次部署建议先在本地尝试,酷Q Air版即可,待部署成功后再尝试服务器搭建与酷Q Pro版

  3. 运行 酷Q,启用 CQHTTP插件,修改CQHTTP插件的配置文件,下面的配置可供参考:

    {
        "use_http": false,
        "use_ws": false,
        "use_ws_reverse": true,
        "ws_reverse_use_universal_client": true,
        "ws_reverse_url": "ws://127.0.0.1:8080/ws/",
        "serve_data_files": false
    }

    关于CQHTTP插件的配置说明,详见 CQHTTP 文档 -> 配置

  4. 打开一个合适的文件夹,点击资源管理器左上角的 文件 -> 打开Windows Powershell

  5. 输入以下命令克隆本仓库并安装依赖

    git clone https://github.com/Ice-Cirno/HoshinoBot.git
    cd HoshinoBot
    py -3.8 -m pip install -r requirements.txt

    若此处有报错信息,请务必解决,将错误信息复制到百度搜索一般即可找到解决办法。

    若安装python依赖库时下载速度缓慢,可以尝试使用py -3.8 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

  6. 回到资源管理器,进入hoshino文件夹,将config_example文件夹重命名为config,然后右键使用Notepad++打开其中的__bot__.py,按照其中的注释说明进行编辑。

    如果您不清楚某项设置的作用,请保持默认

  7. 回到powershell,启动 Hoshino

    py -3.8 run.py

    私聊机器人发送在?,若机器人有回复,恭喜您!您已经成功搭建起HoshinoBot了。之后您可以尝试在群内发送!帮助以查看会战管理的相关说明,发送help查看其他一般功能的相关说明,发送pcr速查查看常用网址等。

    注意,此时您的机器人功能还不完全,部分功能可能无法正常工作。若希望您的机器人可以发送图片,或使用其他进阶功能,请参考本章更进一步的对应小节。

Linux 部署

由于 酷Q 仅支持 Windows 环境,我们需要使用 docker 镜像来部署 酷Q 及 CQHTTP 插件。但别担心,相信我,这比 Windows 下部署更简单!您可以在这个文档找到详细的说明。下面将带领您进行部署:

  1. 安装 docker:参考https://docs.docker.com/engine/install/debian/

  2. 部署 docker:下面一条命令仅供参考,请根据实际情况修改参数;详细说明可见 CQHTTP 文档 -> Docker

    sudo docker run -d --name=hoshino \
    -v $(pwd)/coolq:/home/user/coolq \
    -p 9000:9000 \
    -e VNC_PASSWD=MAXchar8 \
    -e COOLQ_ACCOUNT=10000 \
    -e COOLQ_URL=https://dlsec.cqp.me/cqp-full \
    -e CQHTTP_SERVE_DATA_FILES=no \
    -e CQHTTP_USE_HTTP=no \
    -e CQHTTP_USE_WS_REVERSE=yes \
    -e CQHTTP_WS_REVERSE_URL=ws://172.17.0.1:8080/ws/ \
    -e CQHTTP_WS_REVERSE_USE_UNIVERSAL_CLIENT=yes \
    richardchien/cqhttp:latest

    使用这行命令ip addr show docker0 | grep -Po 'inet \K[\d.]+'查看你的docker桥ip,替换CQHTTP_WS_REVERSE_URL中的链接

    然后访问 http://<你的IP>:9000/ 进入 noVNC(默认密码 MAXchar8),登录 酷Q

    注:如果你希望先使用酷Q Air进行尝试,请将COOLQ_URL设置为https://dlsec.cqp.me/cqa-xiaoi;之后可以用CQP.exe替换CQA.exe以升级,或删除容器重新创建。

  3. 回到我们熟悉的命令行,安装 Python 3.8

    # Ubuntu or Debian
    sudo apt install python3.8

    若您的包管理工具(如yum)尚不支持python3.8,你可以尝试从源码安装。

    Google will help you greatly : )

  4. 克隆本仓库并安装依赖包

    git clone https://github.com/Ice-Cirno/HoshinoBot.git
    cd HoshinoBot
    python3.8 -m pip install -r requirements.txt
  5. 编辑配置文件

    mv hoshino/config_example hoshino/config
    nano hoshino/config/__bot__.py

    配置文件内有相应注释,请根据您的实际配置填写,HoshinoBot仅支持反向ws通信

    您也可以使用vim编辑器,若您从未使用过,我推荐您使用 nano : )

  6. 运行bot

    python3.8 run.py

    私聊机器人发送在?,若机器人有回复,恭喜您!您已经成功搭建起HoshinoBot了。之后您可以尝试在群内发送!帮助以查看会战管理的相关说明,发送help查看其他一般功能的相关说明,发送pcr速查查看常用网址等。

    注意,此时您的机器人功能还不完全,部分功能可能无法正常工作。若希望您的机器人可以发送图片,或使用其他进阶功能,请参考本章更进一步的对应小节。

更进一步

现在,机器人已经可以使用会战管理模拟抽卡(纯文字版)等基本功能了。但还无法使用竞技场查询番剧订阅推特转发等功能。这是因为,这些功能需要对应的静态图片资源以及相应的api key。相应资源获取有难有易,您可以根据自己的需要去获取。

下面将会分别介绍资源与api key的获取方法:

静态图片资源

发送图片的条件:

  1. 静态图片资源

您可能希望看到更为精致的图片版结果,若希望机器人能够发送图片,首先需要您购买酷Q Pro版,其次需要准备静态图片资源,其中包括:

  • 公主连接角色头像(来自 干炸里脊资源站 的拆包)
  • 公主连接官方四格漫画
  • 公主连接每月rank推荐表
  • 表情包杂图
  • setu库
  • 是谁呼叫舰队舰娘&装备页面截图
  • 艦これ人事表

等资源。自行收集可能较为困难,所以我们准备了一个较为精简的资源包以及下载脚本,可以满足公主连接相关功能的日常使用。如果需要,请加入QQ群 Hoshino的后花园 367501912,下载群文件中的res.zip

pcrdfans授权key

竞技场查询功能的数据来自 公主连结Re: Dive Fan Club - 硬核的竞技场数据分析站 ,查询需要授权key。您可以向pcrdfans的作者索要。(注:由于最近机器人搭建者较多,pcrdfans的作者最近常被打扰,我们不建议您因本项目而去联系他,推荐您前往网站pcrdfans.com进行查询)

若您已有授权key,在文件hoshino/config/priconne.py中填写您的key:

class arena:
    AUTH_KEY = "your_key"

蜜柑番剧 RSS Token

请先在hoshino/config/__bot__.pyMODULES_ON中取消mikan的注释
本功能默认关闭,在群内发送 "启用 bangumi" 即可开启

番剧订阅数据来自蜜柑计划 - Mikan Project,您可以注册一个账号,添加订阅的番剧,之后点击Mikan首页的RSS订阅,复制类似于下面的url地址:

https://mikanani.me/RSS/MyBangumi?token=abcdfegABCFEFG%2b123%3d%3d

保留其中的token参数,在文件hoshino/config/mikan.py中填写您的token:

MIKAN_TOKEN = "abcdfegABCFEFG+123=="

注意:token中可能含有url转义,您需要将%2b替换为+,将%2f替换为/,将%3d替换为=

时报文本

请先在hoshino/config/__bot__.pyMODULES_ON中取消hourcall的注释
本功能默认关闭,在群内发送 "启用 hourcall" 即可开启

报时功能使用/魔改了艦これ中各个艦娘的报时语音,您可以在舰娘百科艦これ 攻略 Wiki找到相应的文本/翻译,当然您也可以自行编写台词。在此,我们向原台词作者田中谦介先生和他杰出的游戏作品表达诚挚的感谢!

若您已获取时报文本,在文件hoshino/config/hourcall.py中填写您的文本。

您可以编入多组报时文本,机器人会按HOUR_CALLS_ON中定义的顺序循环日替。

推特转发

推特转发功能需要推特开发者账号,具体申请方法请自行Google。注:现在推特官方大概率拒绝来自**大陆的新申请,自备海外手机号及大学邮箱可能会帮到您。

若您已有推特开发者账号,在文件hoshino/config/twitter.py中填写您的key:

consumer_key = "your_consumer_key",
consumer_secret = "your_consumer_secret",
access_token_key = "your_access_token_key",
access_token_secret = "your_access_token_secret"

晴乃词库

舰娘及装备查询功能使用了精简版的晴乃词库,如有需要请加 Hoshino的后花园(群号367501912)或联系晴乃维护组。

友情链接

干炸里脊资源站: https://redive.estertion.win/

公主连结Re: Dive Fan Club - 硬核的竞技场数据分析站: https://pcrdfans.com/

yobot: https://yobot.win/