如何轻松上手使用 ChoimoeBot 插件的简易教程

置顶内容：

插件管理器

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_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 # 当透群友指定的对象是你娶群友的老婆时用这个概率判定。

使用

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

自动回复插件

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
  • 识别聊天中，上一条图片消息中的二维码