nonebot-plugin-chat-learning

迁移自 ChatLearning 的群聊词库学习插件：持续学习群友的说话方式，按概率在群聊中回复（NoneBot2 / OneBot v11）。

支持链式学习记录、精确/正则/余弦三级匹配、概率回复与冷却、快速删除（!d）、敏感词过滤与黑名单，以及旧 .cl 词库（WordStock）导入。

功能

• 链式学习记录：记录每条消息，间隔超过阈值时上一条单独成"问"，自动积累问答词库
• 三级匹配回复：精确匹配 → 正则匹配 → 余弦相似度模糊匹配，逐级回退
• 概率回复 / 冷却 / @ 触发：按群配置回复概率，命中后进入冷却；被 @ 时同样按概率回复（匹配前会剥掉 @ 段，回复时带上 @ 前缀）
• 快速删除 !d：任何群成员引用 bot 消息回复 !d 即可删除该条学习内容（可配合 cl_replycache_size 缓存快速生效）
• 词库管理指令：SUPERUSER 单条指令完成开关学习、开关回复、增删问答、词库统计
• 敏感词 / 过滤 / 黑名单：命中敏感词进黑名单，达到容错次数后该问题不再回复
• 旧词库导入：支持私聊指令与 CLI 两种方式导入旧 ChatLearning .cl 词库

安装

使用 nb-cli 安装

nb plugin install nonebot-plugin-chat-learning

使用 pip 安装

pip install nonebot-plugin-chat-learning

使用 poetry 安装

poetry add nonebot-plugin-chat-learning

配置

在 .env 中按需覆盖（所有配置项以 cl_ 前缀开头，全部可选，缺省使用默认值）：

使用方法

词库答案中可使用变量：{me}（bot 自称）、{name}（发言者群名片/昵称）、{segment}（换行）。

旧词库迁移

旧 ChatLearning 的 WordStock 目录可通过以下任一方式导入：

• 私聊指令：!importcl <WordStock目录路径>（仅 SUPERUSER）
• 命令行：python -m nonebot_plugin_chat_learning.migrate <路径> [--db 路径]

注意：

• pickle 有安全风险：.cl 文件是反序列化执行的格式，请只导入自己生成的旧文件，不要导入来源不明的词库
• 旧库中的 time 字段不迁移，created_at 以导入时间为准
• 旧库中的 freq（出现频率）与 same（答案权重）字段完整保留

迁移说明

以下为原 ChatLearning 项目功能在本插件中的对应实现与完成情况：

可选联动

如果同时加载 nonebot-plugin-mantou-affection，机器人实际回复成功后会为触发回复的群友上报 1 点馒头好感度。该联动是软依赖，好感度插件未安装或未加载时不会影响学习和回复功能。

许可证

MIT