nonebot-plugin-crystelf

✨ 移植自 crystelf-plugin 的 NoneBot2 多功能群娱乐插件 ✨

功能

• 60s 早报：发送 60s 或 早报，获取每日早报图片
• 新人入群验证：支持数字验证（100 以内加减法）与手性碳验证两种模式，超时 / 超限自动踢出，错误答案自动撤回
• 自定义入群欢迎：按群设置欢迎文案与欢迎图片，可与入群验证联动（验证通过后发送）
• 表情回应：自动给群消息中的 QQ 表情 / emoji 贴上表情回应（需 NapCat 等支持扩展 API 的协议端）
• 戳一戳：戳 bot 随机回复并按概率回戳；戳主人会被警告并回戳；主人戳人时 bot 跟着戳
• 早晚安：早晚安关键词按时段随机回复，主人有专属词库

移植范围说明：原项目的「晶灵智能 AI 对话」「点歌」「RSS 订阅」功能不在本插件范围内。

安装

使用 nb-cli 安装

nb plugin install nonebot-plugin-crystelf

使用 pip 安装

pip install nonebot-plugin-crystelf

使用 poetry 安装

poetry add nonebot-plugin-crystelf

配置

在 NoneBot 项目的 .env 文件中添加（均有默认值，可零配置使用）：

# 机器人昵称（用于戳一戳等文案中的名字替换）
CRYSTELF_NICKNAME=馒头
# 数据存储路径
CRYSTELF_DATA_PATH=data/crystelf

# 功能开关
CRYSTELF_60S=true
CRYSTELF_AUTH=true
CRYSTELF_WELCOME=true
CRYSTELF_FACE_REPLY=true
CRYSTELF_POKE=true
CRYSTELF_ZWA=true

# 60s 早报 API
CRYSTELF_60S_URL=https://60s.crystelf.top
# 手性碳验证 API
CRYSTELF_AUTH_URL=https://carbon.crystelf.top
# 戳一戳回戳概率（0~1）
CRYSTELF_REPLY_POKE=0.4
# 戳一戳惹馒头不高兴（倒扣 1 点好感）的概率（0~1），仅没有 poke 接口的旧版好感插件生效
CRYSTELF_POKE_NEGATIVE_CHANCE=0.1

「主人」使用 NoneBot 的 SUPERUSERS 配置。

使用方法

60s 早报

新人入群验证

bot 需要为群管理及以上，操作者需为主人或群管理员

自定义入群欢迎

表情回应

早晚安

示例

用户：早报
机器人：[早报图片]

新人加入群聊
机器人：@新人 请在180秒内发送 42 + 37 的计算结果..
新人：79
机器人：@新人 验证通过,欢迎加入本群~

用户：戳一戳 bot
机器人：被戳晕了……轻一点啦！

馒头好感度联动（可选）

同时加载 nonebot-plugin-mantou-affection 后，群友戳 bot 的判定交给好感插件：好感加多少、回哪句文案、 要不要戳出一道限时答题都由它决定，本插件只负责把 poke() 返回的文案发出去。戳一戳不再有扣分机制， 固定 +1（仍受好感插件的每日获取上限约束）；另有约 1% 概率戳出一次限时答题事件，答错 -4、超时 -10， 是普通答题的两倍。事件消息由好感插件返回、本插件转发到本群，同时把 poke_notice.send 一并交给 poke()， 让好感插件在有人作答或超时后自己发送结算消息。文案来自好感插件文案库的 crystelf.poke / crystelf.poke.negative 场景，可通过 MANTOU_AFFECTION_TEXT_PATH 扩充到大量文案。

调用链逐级回退：带 send 的 poke() → 没有 send 参数的老版 poke() → 旧版好感插件接口 → 本地戳一戳词库。 任何一层失败（接口不存在、调用报错、文案为空）都会 logger.debug 后落到下一层，不影响戳一戳主流程； 完全没加载好感插件时一切照旧。

CRYSTELF_POKE_NEGATIVE_CHANCE（默认 0.1，即约 10%，0~1）只对没有 poke() 接口的旧版好感插件生效： 由本插件 roll 出负面分支，倒扣 1 点好感并改用 crystelf.poke.negative 场景的文案， 取不到文案时只回退本地词库，不会退回正面场景。

与原项目的对应关系

许可证

MIT