Yenai-Plugin

May 3, 2026 · View on GitHub

Tip

如果您觉得我们的项目有帮助，请给我们一个星星（Starred）！您的支持对我们非常重要，将激励我们不断改进和提供更好的内容。谢谢！🙏

Warning

⚠️ 注意，该分支为 yenai-plugin v2 版本配置文件进行重构无法直接从v1进行迁移可能需要重新安装以确保不会发生未知问题

Yenai-Plugin

🐑 Yenai-Plugin 是一个 Yunzai-Bot 的扩展插件，提供对 Bot 的一些便捷操作。

安装教程 💡

请将 Yenai-Plugin 放置在 Yunzai-Bot 的 plugins 目录下，重启 Yunzai-Bot 后即可使用。

推荐使用 git 进行安装，以方便后续升级。在 Yunzai 目录打开终端，运行

使用 github

git clone -b v2 --depth=1 https://github.com/yeyang52/yenai-plugin.git ./plugins/yenai-plugin

使用 gitee

git clone -b v2 --depth=1 https://gitee.com/yeyang52/yenai-plugin.git ./plugins/yenai-plugin

安装依赖

pnpm install

功能介绍 📖

Note

Yenai-Plugin 为您提供以下功能

事件通知

特定通知支持群单独设置、 bot单独设置、 bot群单独设置
例如：#椰奶通知设置群消息单独开启
具体可使用 #椰奶通知设置 查看

功能	通知类型	群单独	Bot 单独	指令
好友消息	消息		✅	#椰奶通知设置好友消息开启
群消息	消息	✅		#椰奶通知设置群消息开启
群临时消息	消息	✅		#椰奶通知设置群临时消息开启
群撤回	消息	✅		#椰奶通知设置群撤回开启
好友撤回	消息		✅	#椰奶通知设置好友撤回开启
好友申请	申请		✅	#椰奶通知设置好友申请开启
加群申请	申请	✅		#椰奶通知设置加群申请开启
群聊邀请	申请		✅	#椰奶通知设置群邀请开启
好友列表变动	列表变动			#椰奶通知设置好友列表变动开启
群聊列表变动	列表变动	✅		#椰奶通知设置群聊列表变动开启
群成员变动	列表变动	✅		#椰奶通知设置群成员变动开启
群管理变动	列表变动	✅		#椰奶通知设置群管理变动开启
Bot 被禁言	其他	✅		#椰奶通知设置禁言开启
通知全部主人	系统设置			#椰奶通知设置全部通知开启
删除缓存时间	系统设置			#椰奶通知设置删除缓存时间 60 秒

助手功能

功能	指令	描述
发送好友消息	#发好友 QQ 号消息	向指定好友发送消息
发送群聊消息	#发群聊群号消息	向指定群聊发送消息
发送多群聊消息	#发群列表 1,2,3 消息	向指定的多个群聊发送消息，使用`,`分割群号
改群头像	#改群头像图片	修改指定群的头像
改昵称	#改昵称昵称	修改 Bot 的昵称
改群昵称	#改群昵称群号昵称	修改指定群的昵称
改状态	#改状态状态	修改 Bot 的在线状态，可选值：我在线上，离开，隐身，忙碌，Q 我吧，请勿打扰
改签名	#改签名签名	修改 Bot 的签名
退群	#退群群号	让 Bot 退出指定的群聊
删好友	#删好友 QQ 号	删除指定的好友
改性别	#改性别性别	修改 Bot 的性别，可选值：男，女，无
改群名片	#改群名片 @用户名片	修改指定用户的群名片
获取好友\|群列表	#获取好友列表或 #获取群列表	获取 Bot 的所有好友或所在的所有群的列表
开/关戳一戳	#开启戳一戳或 #关闭戳一戳	开启或关闭戳一戳功能
撤回消息	#撤回	撤回 Bot 发送的消息
开/关好友添加	#开启好友添加或 #关闭好友添加	开启或关闭好友添加功能
更改好友申请方式	#更改好友申请方式类型问题答案	更改好友申请方式，类型可选值：1（允许所有人），2（需要验证），3（问答验证）
设置机型	#设置机型机型	设置 Bot 的机型显示
拉黑白群/用户	#拉黑 QQ 号或 #拉白 QQ 号	将指定的群或用户加入黑名单或白名单
取图片链接	#取直链图片	获取图片的直链
ocr	#ocr 图片或 #提取文字图片	提取图片中的文字
看群?头像	#查看群头像群号或 #查看头像 QQ 号	查看或获取群或用户的头像
修改日志等级	#设置日志等级等级	修改日志等级，可选值：trace, debug, info, warn, fatal, mark, error, off
查看说说	#获取说说列表	获取 QQ 空间的说说列表
删除说说	#删除说说说说 ID	删除指定的 QQ 空间说说
发说说	#发说说内容	在 QQ 空间发表说说

群管功能

功能	用户所需权限	Bot 所需权限	指令
禁言	管理员	管理员	#禁言 @用户时间
解禁	管理员	管理员	#解禁 @用户
全体禁言	管理员	管理员	#全体禁言
全体解禁	管理员	管理员	#全体解禁
踢出群聊	管理员	管理员	#踢 @用户
踢出群聊并拉黑	管理员	管理员	#踢黑 @用户
设置管理	主人	群主	#设置管理 @用户
取消管理	主人	群主	#取消管理 @用户
修改头衔	主人	群主	#修改头衔 @用户头衔
申请头衔	-	群主	#申请头衔头衔
获取禁言列表	管理员	管理员	#获取禁言列表
解除全部禁言	管理员	管理员	#解除全部禁言
查看从未发言的人	管理员	管理员	#查看从未发言的人
清理从未发言的人	管理员	管理员	#清理从未发言的人
查看不活跃排行榜	管理员	管理员	#查看不活跃排行榜
查看最近入群情况	管理员	管理员	#查看最近入群情况
查看多久没发言的人	管理员	管理员	#查看 X 天没发言的人
清理多久没发言的人	管理员	管理员	#清理 X 天没发言的人
发通知	管理员	管理员	#发通知内容
设置定时禁言	管理员	管理员	#设置定时禁言时间
取消定时禁言	管理员	管理员	#取消定时禁言
设置定时解禁	管理员	管理员	#设置定时解禁时间
取消定时解禁	管理员	管理员	#取消定时解禁
开启加群通知	管理员	管理员	#开启加群通知
关闭加群通知	管理员	管理员	#关闭加群通知
加精	管理员	管理员	#加精 @消息
移精	管理员	管理员	#移精 @消息
我要自闭	-	管理员	#我要自闭时间
发起投票禁言	-	管理员	#发起投票禁言 @用户
发起投票踢人	-	管理员	#发起投票踢人 @用户
支持投票	-	管理员	#支持投票 @用户
反对投票	-	管理员	#反对投票 @用户
启用投票禁言	主人	-	#启用投票禁言
禁用投票禁言	主人	-	#禁用投票禁言
启用投票踢人	主人	-	#启用投票踢人
禁用投票踢人	主人	-	#禁用投票踢人
投票设置超时时间	主人	-	#投票设置超时时间秒数
投票设置最低票数	主人	-	#投票设置最低票数票数
投票设置禁言时间	主人	-	#投票设置禁言时间秒数
新增违禁词	管理员	管理员	#新增违禁词词语
删除违禁词	管理员	管理员	#删除违禁词词语
查看违禁词	管理员	管理员	#查看违禁词词语
违禁词列表	管理员	管理员	#违禁词列表
设置违禁词禁言时间	管理员	管理员	#设置违禁词禁言时间秒数
增加头衔屏蔽词	管理员	管理员	#增加头衔屏蔽词词语
减少头衔屏蔽词	管理员	管理员	#减少头衔屏蔽词词语
查看头衔屏蔽词	管理员	管理员	#查看头衔屏蔽词
切换头衔屏蔽词匹配模式	管理员	管理员	#切换头衔屏蔽词匹配模式
发群公告	管理员	管理员	#发群公告内容
删群公告	管理员	管理员	#删群公告序号
查群公告	管理员	管理员	#查群公告
加白名单	主人	-	#群管加白 @用户
加黑名单	主人	-	#群管加黑 @用户
删白名单	主人	-	#群管删白 @用户
删黑名单	主人	-	#群管删黑 @用户
开启白名单自动解禁	主人	-	#开启白名单自动解禁
关闭白名单自动解禁	主人	-	#关闭白名单自动解禁
查幸运字符列表	管理员	管理员	#查幸运字符列表
抽幸运字符	管理员	管理员	#抽幸运字符
替换幸运字符	管理员	管理员	#替换幸运字符序号
开启幸运字符	管理员	管理员	#开启幸运字符
关闭幸运字符	管理员	管理员	#关闭幸运字符
谁是龙王	-	-	#谁是龙王
群星级	-	-	#群星级
群数据	管理员	管理员	#群数据
今日打卡	-	-	#今日打卡
群发言榜单	管理员	管理员	#群发言榜单
重新验证	管理员	管理员	#重新验证 @用户
绕过验证	管理员	管理员	#绕过验证 @用户
开启验证	管理员	管理员	#开启验证
关闭验证	管理员	管理员	#关闭验证
切换验证模式	主人	-	#切换验证模式
设置验证超时时间	主人	-	#设置验证超时时间秒数

Tip：具体可使用 #椰奶群管帮助 查看

娱乐功能

功能	指令	描述
随机唱鸭	#唱歌
支付宝到账语音	#支付宝到账(金额)
coser	#coser
有道翻译	#((源语言-)?目标语言)?翻译(内容)
Github 略缩图	github.com/用户名/仓库名
acg 搜索	#(类型)?acg(关键词)	类型可选：cos, acg

Pixiv功能

功能	指令	描述
Pixiv 排行榜	#看看(日期)?(类型)(全年龄)?榜(第 n 页)?	类型可选：日, 周, 月等
Tag 搜图	#tag(pro)?搜图(关键词)(第 n 页)?
Pid 搜图	#pid 搜图(插画 ID)
Uid 搜图	#uid 搜图(用户 ID)(第 n 页)?
查看热门 Tag	#查看热门 Tag
查看相关作品	#看相关作品(插画 ID)
随机原创插画	#来(n)张(好康的\| se图)
推荐作品	#来(n)张推荐图
搜索用户	#user 搜索(用户名)(第 n 页)?
P 站单图	#pximg(pro)?
更换代理	#pixiv 更换代理(代理地址)
开启/关闭直连	#pixiv(开启\| 关闭)直连
登录信息	#pixiv 登录信息

搜图搜番

功能	指令	描述
SauceNAO 搜图	#SauceNAO 搜图	使用 SauceNAO 进行搜图
WhatAnime 搜番	#WhatAnime 搜番	使用 WhatAnime 进行搜番
Ascii2D 搜图	#Ascii2D 搜图	使用 Ascii2D 进行搜图
设置 SauceNAO ApiKey	#设置 SauceNAOApiKey (ApiKey)	设置 SauceNAO 的 ApiKey

哔咔功能

功能	指令	描述
哔咔搜索	#哔咔(类别\|作者\| 高级)?搜索(关键词)(第 n 页)?
哔咔看本子	#哔咔 id(本子 ID)(第 n 页)?(第 n 话)?
快速查看	#哔咔看(编号)
下一页	#哔咔下一页
下一话	#哔咔下一话
类别列表	#哔咔类别列表
漫画详情	#哔咔(详情\| 细节)(本子 ID)
修改图片质量	#哔咔修改图片质量(低质量\|中等质量\|高质量\|原图)
开启/关闭直连	#哔咔(开启\| 关闭)直连

图片状态

功能	指令	描述
查看状态	#椰奶状态(pro)?(debug)?	查看当前状态
查看监控	#椰奶监控	查看监控数据
查看原图	#原图	查看原图

Tip

更多信息可以查看我们的文档

特别鸣谢 ❤️

贡献者 ✨

感谢这些了不起的人 (emoji key):

_{时雨◎星空} 💻	_{花海里的秋刀鱼} 💻	_{Georgebillion} 🤔	_小飞 🤔	_liuzj288 💻	_OKKOM2020 📖	_大可鸭 💻
_曉k 💻	_ikechan8370 💻	_fsqhn 💻	_Lain. 💻	_等风来 💻	_Sora 💻	_batvbs 💻
_ifeif 💻	_青青 💻	_Temmie 💻