ChoimoeBot 插件使用指南

Posted on 2023-02-28 11:48  Choimoe  阅读(288)  评论(0)  编辑  收藏  举报

目录

置顶内容：

插件管理器

nonebot-plugin-manager：基于 import hook 的插件管理

  • npm ls查看当前会话插件列表
    • -s, --store互斥参数，查看插件商店列表（仅超级用户可用）
    • -u <user_id>, --user <user_id>互斥参数，查看指定用户插件列表（仅超级用户可用）
    • -g <group_id>, --group <group_id>互斥参数，查看指定群插件列表（仅超级用户可用）
    • -a, --all可选参数，查看所有插件（包括不含 Matcher 的插件）
  • npm info <插件名>查询插件信息 （仅超级用户可用）
  • npm chmod <mode> <plugin ...>设置插件权限（仅超级用户可用）
    • mode必选参数，需要设置的权限，参考上文
    • plugin ...必选参数，需要设置的插件名
    • -a, --all可选参数，全选插件
    • -r, --reverse可选参数，反选插件
  • npm block <plugin ...>禁用当前会话插件（需要权限）
    • plugin ...必选参数，需要禁用的插件名
    • -a, --all可选参数，全选插件
    • -r, --reverse可选参数，反选插件
    • -u <user_id ...>, --user <user_id ...>可选参数，管理指定用户设置（仅超级用户可用）
    • -g <group_id ...>, --group <group_id ...>可选参数，管理指定群设置（仅超级用户可用）
  • npm unblock <plugin ...>启用当前会话插件（需要权限）
    • plugin ...必选参数，需要禁用的插件名
    • -a, --all可选参数，全选插件
    • -r, --reverse可选参数，反选插件
    • -u <user_id ...>, --user <user_id ...>可选参数，管理指定用户设置（仅超级用户可用）
    • -g <group_id ...>, --group <group_id ...>可选参数，管理指定群设置（仅超级用户可用）

语句抽象化

nonebot_plugin_abstract：能够将你的语句变得抽象起来~

使用

指令 示例
抽象 [要抽象的语句] nonebot_plugin_abstract

处理好友添加和群邀请

nonebot_plugin_addFriend：一个基于NoneBot2的插件，用于处理被请求加QQ好友和QQ群的请求。

暂无指令，详见 ziru-w/nonebot_plugin_addFriend。

定时任务

nonebot_plugin_apscheduler：APScheduler 定时任务插件。

暂无指令，详见 nonebot/plugin-apscheduler。

ChatGPT

nonebot-plugin-chatgpt：AI 聊天对话。

本插件由于服务器网络原因，大概率无法使用！

配置

配置项 默认值 说明
CHATGPT_CD_TIME 60 冷却时间，单位：秒
CHATGPT_PROXIES None 代理地址，格式为： http://ip:port
CHATGPT_REFRESH_INTERVAL 30 session_token 自动刷新间隔，单位：分钟
CHATGPT_TO_ME True 是否需要@机器人
CHATGPT_TIMEOUT 30 请求服务器的超时时间，单位：秒
CHATGPT_API https://chat.openai.com/ API 地址，可配置反代
CHATGPT_IMAGE False 是否以图片形式发送。 如果无法显示文字，请点击此处查看解决办法
CHATGPT_IMAGE_WIDTH 500 消息图片宽度，单位：像素
CHATGPT_PRIORITY 999 事件响应器优先级
CHATGPT_PRIVATE True 是否允许私聊使用
CHATGPT_SCOPE private 设置公共会话或私有会话 private：私有会话，群内成员会话各自独立 public：公共对话，群内成员共用同一会话

使用

使用chatgpt：@ChoimoeBot gpt 内容，其中 gpt 可以被 ChatGPT、GPT、chatgpt 替换。

其他指令（下列指令均需要@bot） 示例
刷新会话/刷新对话 -
导出会话/导出对话 -
导入会话/导入对话 + 会话ID + 父消息ID(可选) -
保存会话/保存对话 + 会话名称 -
查看会话/查看对话 -
切换会话/切换对话 + 会话名称 -
回滚会话/回滚对话 -

娶群友

nonebot_plugin_groupmate_waifu: 娶群友。

配置

配置在该插件文件夹下 config.py。

# nonebot_plugin_groupmate_waifu
waifu_cd_bye = 3600 # 分手冷却时间，默认1小时。
waifu_save = true # 是否将cp记录保存为文件（避免重启bot丢失数据）。
waifu_reset = true # 是否每日重置cp记录。

waifu_he = 25 # 在指定娶群友时，成功的概率25%
waifu_be = 25 # 在指定娶群友时，失败的概率25%

## 成功就是娶到了，失败就是单身。如果这两个参数加起来小于100那么剩下的概率是会随机娶一个。

waifu_ntr = 20 # 别人有cp时被指定娶到的概率

yinpa_he = 50 # 在指定透群友时，成功的概率50%
yinpa_be = 0 # 在指定透群友时，失败的概率0%

## 同上，如果这两个参数加起来不等于100那么剩下的概率是会随机透一个。

yinpa_cp = 65 # 当透群友指定的对象是你娶群友的老婆时用这个概率判定。

使用

指令 功能 示例
娶群友 每天刷新一次，两个人会互相抽到对方。 nonebot_plugin_groupmate_waifu_tqy
娶群友@name 有机会娶到at的人。（概率为 waifu_he :int = 25） -
分手 / 离婚 撤销娶群友。（CD为 waifu_cd_bye :int = 3600） -
本群cp 查看当前群内的cp。 nonebot_plugin_groupmate_waifu_bqcp
群友卡池 查看当前群可以娶到的群友列表。 nonebot_plugin_groupmate_waifu_qykc
透群友 随机一位群友。（取最近发言的前35个之一） -
涩涩记录 查看当前群的群友今日透群友次数和被透的次数。记录是跨群的。 nonebot_plugin_groupmate_waifu_ssjl

自动回复插件

nonebot_plugin_kawaii_robot：使用 Kyomotoi/AnimeThesaurus 的nonebot2的回复插件。

词库配置

词库在 data.json 与 leaf.json，每项格式应如：

{
    "key":[
        "value"
        ]
}

回复配置

LEAF_PERMISSION = "ALL"     # 配置回复权限，"ALL"就是全部聊天都会触发回复，"GROUP"就是仅群聊。
LEAF_IGNORE = ()            # 配置忽略词，元素为str。
LEAF_REPLY_TYPE = 1         # 配置at回复
LEAF_POKE_RAND = 20         # 配置戳一戳回复文字概率
LEAF_REPEATER_LIMIT = [2,6] # 配置复读次数
LEAF_INTERRUPT = 20         # 配置打断概率

日麻小工具

nonebot_plugin_mahjong_utils：日麻小工具插件，支持手牌分析、番符点数查询。

使用：

手牌分析

  • 输入手牌代码，根据输入手牌输出向听数（未摸牌状态）、牌理（已摸牌、未和牌状态）、副露分析（未摸牌状态+他家打出的牌）或和牌分析（已摸牌、已和牌状态）。

    1. 向听数分析。

      输入的手牌为3k+1张时。

      计算向听数与进张。一向听的手牌还会计算好型与愚型进张数。

    2. 牌理分析。

      输入的手牌为3k+2张，且未和牌（向听数大于-1）时。

      对每种打法（包括打出与暗杠）计算向听数与进张。一向听的手牌还会计算好型与愚型进张数。

    3. 副露分析。

      格式：手牌代码<上家打出的牌、手牌代码^对家打出的牌或手牌代码>下家打出的牌，其中输入的手牌为3k+1张。

      实际上对家打出和下家打出是一样的（不能吃），这里区分是为了命令的工整性

      对每种打法（包括吃、碰、大明杠与PASS）计算向听数与进张。一向听的手牌还会计算好型与愚型进张数。

    4. 和牌分析。

      输入的手牌为3k+2张，且已和牌（向听数等于-1）时。

      手牌代码的最后一张牌作为所和的牌，手牌代码后可通过空格分割输入副露、自风、场风、dora、额外役。暗杠通过0990m的格式输入。

    5. 番符点数。

      输入x番y符，输出亲家/子家的自摸/荣和得点。

头像表情包

nonebot_plugin_petpet：制作摸头等头像相关沙雕表情包。

配置项 类型 默认 说明
petpet_command_start List[str] [""] 命令起始标记，默认包含空字符串
petpet_resource_url str "https://.../resources" 资源下载链接，默认为使用ghproxy代理的github仓库链接
petpet_disabled_list List[str] [] 禁用的表情包列表，需填写表情名称的列表，表情名称可以在data_source.py文件中查看。若只是临时关闭，可以用下文中的“表情包开关”
petpet_gif_max_size float 10 限制生成的gif的最大体积，单位为Mb。若生成的gif体积过大，则先会尝试缩减帧数，其次尝试缩小图片尺寸
petpet_gif_max_frames int 100 限制生成的gif的最大帧数

上文url为：https://ghproxy.com/https://raw.githubusercontent.com/noneplugin/nonebot-plugin-petpet/v0.3.x/resources。

使用

图片搜索

nonebot_plugin_picsearcher：从基本上所有你想的出名字的搜图平台找图片。

配置

EX_COOKIE=XXXXX
PROXY=XXXX  # type: str e.g. PROXY=http://127.0.0.1:8889
SEARCH_LIMIT=2  # 搜索限制 防刷屏
RISK_CONTROL=true # 风控模式 启动后会使用合并转发 只有gocq有实现
RECORD_PRIORITY=99 # 记录上一张图片matcher的优先级，与 上一张 命令有关

使用

发送搜图。

PicStatus

nonebot_plugin_picstatus：服务器运行状态图片版。

配置

见 nonebot-plugin-picstatus/.env.example - GitHub。

使用

使用指令：运行状态（或状态 / zt / yxzt / status）

谁艾特我了

nonebot_plugin_who_at_me：看看是谁又在艾特我。

使用

命令 描述
谁艾特我 查看到底是谁艾特了你
clear_db 清理当前用户的消息记录
clear_all 清理全部消息记录

结果将以合并转发形式发送。

网易云无损音乐下载

nonebot-plugin-ncm：网易云 无损音乐 点歌/下载。

使用

快速使用：将链接或者卡片分享到聊天群或机器人，回复分享的消息并输入下载即可进行下载。

（默认下载状态为关闭，使用/ncm t开启,私聊则默认开启）

命令 备注
/ncm 获取命令菜单
/ncm t 开启下载
/ncm f 关闭下载
/ncm search t 开启点歌
/ncm search f 关闭点歌
/点歌 歌名 点歌
/ncm private qq号 t 开启该用户私聊下载
/ncm private qq号 f 关闭该用户私聊下载

扔骰子

nonebot_plugin_roll：掷骰！扔出指定个数的多面骰子🎲。

使用

[rd/roll/掷骰] [x]d[y]：掷出x个y面的骰子，并返回点数。

b站用户信息查询

nonebot_plugin_searchBiliInfo：查询b站用户粉丝数、舰团信息；主播直播收益数据（总收益、礼物、SC、上舰）；用户观看直播信息（观看、弹幕记录）；通过关键词搜昵称、UID等。

下面大部分接口都寄了。

  1. /查

    命令结构：/查 (uid:或UID:或：或:)+用户uid或昵称关键词
    例如：/查 uid:229603775 或 /查 :3461573737712484 或 /查 摸鱼的qiqi

  2. /查直播

    命令结构：/查直播 (uid:或UID:或：或:)+用户uid或昵称关键词 场次数（默认不写为全部）
    例如：/查直播 UID:13771977 1 或 /查直播 鸾鹤不存

  3. /查舰团

    命令结构：/查舰团 (uid:或UID:或：或:)+用户uid或昵称关键词
    例如：/查舰团 ：13771977 或 /查舰团 鸾鹤不存

  4. /查昵称

    命令结构：/查昵称 昵称关键词
    例如：/查昵称 qiqi

  5. /查收益

    命令结构：/查收益 (uid:或UID:或：或:)+用户uid或昵称关键词 收益类型(默认1: 礼物，2: 上舰，3: SC) 倒叙第n场(从0开始)
    例如：/查收益 :229603775 礼物 1 或 /查收益 bishi 2 0

  6. /查观看

    命令结构：/查观看 (uid:或UID:或：或:)+用户uid或昵称关键词
    例如：/查观看 UID:666666 或 /查观看 bishi

  7. /查观看2

    命令结构：/查观看2 (uid:或UID:或：或:)+用户uid或昵称关键词
    例如：/查观看2 UID:666666 或 /查观看2 bishi

  8. /查弹幕2

    命令结构：/查弹幕2 (uid:或UID:或：或:)+用户uid或昵称关键词 页数(可不填，默认0) 条数(可不填，默认3)
    例如：/查弹幕2 uid:229603775 2 2 或 /查弹幕2 uid:229603775 2

  9. /营收

    命令结构：/营收 日/周/月榜 人数（不填默认100）
    例如：/营收 日榜 3 或 /营收 月榜

  10. /涨粉

    命令结构：/涨粉 日/周/月榜 人数（不填默认100）
    例如：/涨粉 日榜 3 或 /涨粉 月榜

二维码识别

nonebot_plugin_qrcode：qq聊天二维码插件。

  • qr
    • 如果指令后有图片，则直接识别图片
    • 如果没有图片，则会询问图片
  • pqr
    • 识别聊天中，上一条图片消息中的二维码