机器人搭建记录 HoshinoBot

清疚 2022-12-20 02:39 302阅读 0赞

# 机器人搭建记录 HoshinoBot #

### 前言 ###

见面介绍的`yobot`群聊机器人主专职会战。还有一个娱乐性和扩展性更强的机器人`HoshinoBot`. 其中可以根据自己的需要扩展和新增功能. 非常不错.

--------------------

### 前置条件 ###

*  python环境
 *  安装且运行go-cqhttp 可看系列前章

### 部署 ###

*  步骤1: 获取代码  
    [https://github.com/Ice-Cirno/HoshinoBot][https_github.com_Ice-Cirno_HoshinoBot]
 *  安装依赖包

pip3 install -r requirements.txt

*  运行

python3 run.py

--------------------

### 相关配置信息 ###

*  图包等资源文件

/HoshinoBot/res/img
    # setu 懂得都懂
    /HoshinoBot/res/img/setu

*  模块开关配置文件 `/HoshinoBot/hoshino/config/__bot__.py`

"""这是一份实例配置文件
    
    将其修改为你需要的配置，并将文件夹config_example重命名为config
    """
    
    # hoshino监听的端口与ip
    PORT = 8080
    HOST = '127.0.0.1'      # 本地部署使用此条配置（QQ客户端和bot端运行在同一台计算机）
    # HOST = '0.0.0.0'      # 开放公网访问使用此条配置（不安全）
    
    DEBUG = False           # 调试模式
    
    SUPERUSERS = [10086]    # 填写超级用户的QQ号，可填多个用半角逗号","隔开
    NICKNAME = 'Peko'           # 机器人的昵称。呼叫昵称等同于@bot，可用元组配置多个昵称
    
    COMMAND_START = {''}    # 命令前缀（空字符串匹配任何消息）
    COMMAND_SEP = set()     # 命令分隔符（hoshino不需要该特性，保持为set()即可）
    
    # 发送图片的协议
    # 可选 http, file, base64
    # 当QQ客户端与bot端不在同一台计算机时，可用http协议
    RES_PROTOCOL = 'file'
    # 资源库文件夹，需可读可写，windows下注意反斜杠转义
    RES_DIR = r'./res/'
    # 使用http协议时需填写，原则上该url应指向RES_DIR目录
    RES_URL = 'http://127.0.0.1:5000/static/'
    
    
    # 启用的模块
    # 初次尝试部署时请先保持默认
    # 如欲启用新模块，请认真阅读部署说明，逐个启用逐个配置
    # 切忌一次性开启多个
    MODULES_ON = {
        'botmanage',
        'dice',
        'groupmaster',
        # 'hourcall',
        # 'kancolle',
        # 'mikan',
        'pcrclanbattle',
        'priconne',
        'setu',
        'portune',
        # 'translate',
        # 'twitter',
    }

其中`MODULES_ON`即为模块开关功能.

*  模块扩展

如果你需要扩展新的模块。需要:`在上述的开关内配置文件夹信息`,并且将扩展的模块拷贝到`HoshinoBot/hoshino/modules/`文件夹下面。

*  相关自带的模块

# QQ机器人核心管理模块
    'botmanage',
    # ROLL骰子  命令为.r
    'dice',
    # 聊天机器人
    'groupmaster',
    # 正点报时
    # 'hourcall',
    # 舰娘相关-未知功能
    # 'kancolle',
    # 蜜柑 主要用来订阅直播开播等信息（一般用不上）
    # 'mikan',
    # PCR 竞技场信息 需要申请pcrfans.com的apikey
    'pcrclanbattle',
    # 公主链接核心模块
    'priconne',
    # setu 基本本地setu 命令setu(中文)
    'setu',
    # 运势（运势/抽猫猫签 2种抽卡）
    'portune',
    # 翻译功能（基本不用）
    # 'translate',
    # 推特功能 (基本不用)
    # 'twitter',

--------------------

### PCR模块即相关命令 ###

localhost:priconne sean$ pwd
    /Users/sean/Documents/Gitrep/HoshinoBot/hoshino/modules/priconne
    localhost:priconne sean$ ls -lrt
    total 144
    drwxr-xr-x@ 7 sean  staff    224 11  3 22:35 gacha
    drwxr-xr-x@ 5 sean  staff    160 11  3 22:35 news
    drwxr-xr-x@ 6 sean  staff    192 11  3 22:35 arena
    drwxr-xr-x@ 7 sean  staff    224 11  3 22:35 query
    drwxr-xr-x@ 6 sean  staff    192 11  3 22:35 games

查看`priconne`模块文件夹. 可以看到有如下几个模块.

*  news

新闻推送. 相关命令`台服日程`/`B服日程`.

*  gacha

抽卡相关. 相关命令`单抽/十连/来一井`和`氪金@<QQ成员>`重置次数.

*  query

角色查询. 相关命令`xxx是谁`.

*  games

小游戏. 相关命令`猜角色/猜头像`.

*  arena

JJC 查询.`xxx怎么拆`.

--------------------

### 相关插件 ###

[(pcrbot)HoshinoBot][pcrbot_HoshinoBot]

[(pcrbot)HoshinoBot 插件合集][pcrbot_HoshinoBot 1]

[(github)HoshinoBot][https_github.com_Ice-Cirno_HoshinoBot]

[setu插件1-plugins-for-Hoshino][setu_1-plugins-for-Hoshino]

[插件合集2-cappuccilo\_plugins][2-cappuccilo_plugins]

[插件合集3-GWYOG-Hoshino-plugins][3-GWYOG-Hoshino-plugins]

### 相关链接 ###

[萌樱-\[缝合怪\] HoshinoBot + yobot 公主连结群聊机器人][-_ HoshinoBot _ yobot]

[https_github.com_Ice-Cirno_HoshinoBot]: https://github.com/Ice-Cirno/HoshinoBot
[pcrbot_HoshinoBot]: https://www.pcrbot.com/hoshinobot/
[pcrbot_HoshinoBot 1]: https://www.pcrbot.com/Hoshino-plugins/
[setu_1-plugins-for-Hoshino]: https://github.com/pcrbot/plugins-for-Hoshino
[2-cappuccilo_plugins]: https://github.com/pcrbot/cappuccilo_plugins
[3-GWYOG-Hoshino-plugins]: https://github.com/GWYOG/GWYOG-Hoshino-plugins
[-_ HoshinoBot _ yobot]: https://moesakura.world/archives/hoshinobot-yobot-pcrbot/