nonebot_plugin_naturel_gpt

GitHub
513 55 简单 1 次阅读 4天前Apache-2.0语言模型
AI 解读 由 AI 自动生成，仅供参考

nonebot_plugin_naturel_gpt 是一款基于 NoneBot 框架的智能聊天插件，旨在为机器人赋予更自然、拟人化的交互体验。它对接 OpenAI 接口，核心解决了传统机器人对话生硬、缺乏记忆和个性单一的问题。通过该插件，用户可以轻松自定义并切换多种人格预设，让机器人拥有独特的性格特征；同时具备短期上下文关联与长期记忆总结能力，能记住用户印象，确保持续对话不“出戏”。

这款工具非常适合希望搭建个性化社群机器人的开发者、群管理员以及 AI 爱好者使用。其技术亮点丰富：支持多 API Key 自动切换以保障服务稳定；允许通过自然语言调用扩展功能（如绘图、搜索、定时任务）；内置 PresetHub 共享中心，方便社区交流人格设定；甚至能接入 Minecraft 服务器执行复杂指令。此外，它还具备消息节流、多段回复及内容转图片等实用机制，有效降低风控风险。无论是想打造专属的虚拟伙伴，还是构建高智能的群组助手，nonebot_plugin_naturel_gpt 都能提供灵活且强大的支持。

使用场景

某二次元游戏社群的管理员希望为群组引入一位能长期陪伴玩家、拥有独特性格且能记住群友特征的虚拟助手，以提升社区活跃度。

没有 nonebot_plugin_naturel_gpt 时

  • 人设单一且易“出戏”：传统机器人只能机械回复指令或进行通用对话，无法扮演特定角色（如“傲娇学姐”），一旦聊深就容易暴露 AI 身份，破坏沉浸感。
  • 记忆缺失导致重复互动：机器人没有长期记忆，每次对话都是“初次见面”，无法记住群友的昵称、喜好或之前的聊天梗，导致互动缺乏情感连贯性。
  • 功能扩展困难：若想实现让机器人主动发图、语音播报或定时提醒吃饭等功能，需要编写复杂的独立代码，难以通过自然语言直接调用。
  • 多角色切换繁琐：若想在同一个群里体验不同风格的互动，必须部署多个机器人账号，管理成本极高且容易造成消息混乱。

使用 nonebot_plugin_naturel_gpt 后

  • 人格自定义与无缝切换：管理员可通过预设中心一键加载“毒舌评论家”或“温柔治愈系”等人设，并利用指令随时切换，让机器人在群内像真人一样“精分”互动。
  • 具备长期记忆与印象管理：插件自动总结聊天记录并存储用户印象，机器人能记住老群友的生日或上次提到的攻略，甚至在几天后主动提起，建立真实的情感连接。
  • 自然语言驱动多功能扩展：无需额外编程，只需在对话中提及，机器人即可自主调用扩展模块完成搜索最新资讯、生成 SD 绘画或将回复转为语音，极大丰富互动形式。
  • 智能上下文关联与主动参与：基于短期上下文记忆，机器人能理解多轮对话逻辑，甚至设置触发词让其随机“冒泡”参与闲聊或主动欢迎新人，彻底激活群氛围。

nonebot_plugin_naturel_gpt 通过将大模型的记忆力、人格塑造能力与即时扩展功能深度融合，将冷冰冰的自动化脚本进化为真正有灵魂、可成长的社群伙伴。

运行环境要求

操作系统
  • Linux
  • macOS
  • Windows
GPU
  • 非必需（取决于是否启用 Stable Diffusion 等绘图扩展
  • 若启用需自备绘图 API 及相应显卡资源）
内存

未说明

依赖
notes该插件基于 NoneBot2 框架，主要用于接入 OpenAI API 或兼容接口。默认运行无需本地大模型或 GPU。若使用 Stable Diffusion 绘图扩展，需自行部署 SD 后端或配置 API。推荐使用 Python 3.10 进行开发。数据持久化使用 pickle 或 JSON 文件存储。支持 Docker-Compose 部署（参考其新项目 NekroAgent）。
python3.8+
nonebot2
openai>=0.27,<0.29
tiktoken
htmlrender
poetry
nonebot_plugin_naturel_gpt hero image

快速开始

NoneBotPluginLogo

NoneBotPluginText

✨ 更人性化(拟人)的GPT聊天Ai插件! ✨
🧬 支持多个人格自定义 / 切换 | 尽情发挥你的想象力吧！ ⚙️
🧬 预设收集共享表(欢迎分享各种自定义人设) 🧬
🎆 如果喜欢请点个⭐吧！您的支持就是我持续更新的动力 🎉
💬 技术交流/答疑/讨论 -> ：加入插件交流群-636925153 🗨️
👀 Claude 适配分支 By: 238066asxsa 👀
license pypi python python

🆙 新 NG 重构版本发布 NekroAgent 🎉

这是一个全新的基于容器技术的高智能自执行代理 AI 机器人，通过实时代码生成与执行实现方法级别的扩展，更有人设市场、插件市场等丰富的社区共享资源，支持 Docker-Compose 一键部署，支持跨平台适配接入，支持多人交互，支持原生多模态能力识别与通用文件处理，欢迎前往体验 -> NekroAgent

🎏 NG 进化史

🎭 [2023/12/24] v2.2 PresetHub 预设共享中心上线

NG 专用预设共享中心 PresetHub 上线，可通过 交互指令 直接与所有插件用户在线分享人格预设 | PresetHub 后端应用开源地址

🗺️ [2023/5/21] 文档站上线

插件文档站上线，欢迎访问 ng.kro.zone 查看插件文档，感谢 @lgc2333 为文档站 建设/勘误/整理 提供的大力支持

🏠 [2023/4/14] v2.1 Minecraft 服务器接入与游戏指令扩展支持

本次更新后支持将 bot 接入 MC 服务器，并且支持 bot 使用游戏内指令扩展

🎉 [2023/3/16] v2.0 项目重构完成

感谢 @Misaka-Mikoto-Tech 大佬对项目重构提供的大力支持

✏️ [2023/3/2] v1.4 更新: 支持 ChatGPT 模型

本次更新后插件开始支持官方 ChatGPT 模型接口，token 定价仅为 GPT3 的 1/10, 回复质量更高 响应速度更快

🧩 [2023/2/18] v1.3 更新: 自定义扩展支持

本次更新后插件开始支持自定义扩展，您可以直接通过自然语言直接调用多种扩展功能，包括 文本/图片/语音/邮件...

🎁 安装命令

请在 Bot 目录下执行此命令

nb plugin install nonebot-plugin-naturel-gpt

💡 功能列表

以下未勾选功能仅表示未来可能开发的方向，不代表实际规划进度，具体开发事项可能随时变动 勾选: 已实现功能；未勾选: 正在开发 / 计划开发 / 待定设计

  • 自动切换 api_key: 支持同时使用多个 openai_api_key，失效时自动切换
  • 自定义人格预设: 可自定义的人格预设，打造属于你的个性化的 TA
  • 聊天基本上下文关联: 群聊场景短期记忆上下文关联，尽力避免聊天出戏
  • 聊天记录总结记忆: 自动总结聊天记忆，具有一定程度的长期记忆能力
  • 用户印象记忆: 每个人格对每个用户单独记忆印象，让 TA 能够记住你
  • 数据持久化存储: 重启后 TA 也不会忘记你（使用 pickle 保存文件）
  • 人格切换: 可随时切换不同人格，更多不一样的 TA
  • 新增/编辑人格: 使用指令随时编辑 TA 的性格
  • 自定义触发词: 希望 TA 更主动一点？或者更有目标一点？
  • 自定义屏蔽词: 不想让 TA 学坏？需要更安全一点？
  • 随机参与聊天: 希望 TA 主动一些？TA 会偶然在你的群组中冒泡……
  • 异步支持：赋予 TA 更强大的消息处理能力！
  • 可扩展功能: 厌倦了单调的问答 AI？为 TA 解锁超能力吧！TA 能够根据你的语言主动调用扩展模块 (如:发送图片、语音、邮件等) TA 的上限取决于你的想象
  • 多段回复能力: 厌倦了传统一问一答的问答式聊天？TA 能够做得更好！
  • 主动欢迎新群友: 24 小时工作的全自动欢迎姬(?)
  • TTS 文字转语音: 让 TA 开口说话！(通过扩展模块实现)
  • 潜在人格唤醒机制: 当用户呼叫未启用的人格时，可自动切换人格 (可选开关)
  • 定时任务: 可以用自然语言直接定时，让 TA 提醒你该吃饭了！
  • 在线搜索/读链接: GPT3.5 的数据库过时了？通过主动搜索扩展让 TA 可以实时检索到最新的信息 (支持 Google, Bing Copilot 等)
  • 输出内容转图片: 使用 htmlrender 将 TA 的回复转换为图片，降低风控几率 (可选开关，感谢 @HMScygnet 提供 pr)
  • Minecraft 服务器接入，让她在游戏中为你服务，使用 GPT 的能力编写各种复杂的 NBT 指令
  • 消息节流机制，短时间内接受到大量消息时，只对最后一条消息进行回复 (可配置)
  • Stable Diffusion 绘画接入支持 (需自备绘图 API)
  • PresetHub 预设共享中心: 允许在所有使用本插件用户中共享人格预设
  • 主动记忆和记忆管理功能: 让 TA 主动记住点什么吧！hmm 让我康康你记住了什么 (计划重构，为 bot 接入外置记忆库)
  • 图片感知: 拟使用腾讯云提供的识图 api，协助 bot 感知图片内容
  • 主动聊天参与逻辑: 尽力模仿人类的聊天参与逻辑，目标是让 TA 能够真正融入你的群组
  • 回忆录生成: 记录你们之间的点点滴滴，获取你与 TA 的专属回忆

📄 使用文档

> 点击前往 NG 文档站

🧑‍💻 开发指南

通过以下几步操作即可快速开始开发本插件

  1. 克隆本仓库
git clone https://github.com/KroMiose/nonebot_plugin_naturel_gpt.git
  1. 进入目录并安装依赖
cd nonebot_plugin_naturel_gpt
pip install poetry  # 需要提前安装 Python 环境: 推荐 Python 3.10
poetry install
  1. 运行 Bot
nb run

🎢 更新日志

点击展开

[2024/5/23] 更新扩展sing 唱歌

[2023/12/24] v2.2.0 PresetHub 预设共享中心上线

[2023/12/13] v2.1.9 失效依赖修复

  • 锁定 OpenAI 依赖版本为 0.27~0.28 修复安装问题
  • 修改项目结构为可单独运行的 Nonebot 机器人架构，方便功能开发

[2023/11/28] Dall-e-3 绘图支持 | Stable Diffusion 绘图支持

  • 新增 Dall-e-3 绘图扩展，支持使用Dall-e-3绘图（感谢@微量元素 提供 pr）
  • 新增 Stable Diffusion 绘图扩展，支持使用任意 SD 后端由 AI 自主绘图

[2023/7/3] v2.1.8 token 计算优化 | 新增扩展和优化

  • 文转图功能显示锚元素URL (感谢@student_2333 提供 pr)
  • 新增扩展 ext_plaintext, 更新 lolicon_search 并调整扩展相关的 prompt (感谢@student_2333 提供 pr)
  • 更换了 tiktoken 来进行 token 计算

[2023/6/1] v2.1.7 扩展优化 | 新增扩展

  • 新增 makemidi 扩展，允许 bot 进行 midi 创作（感谢@CCYellowStar 提供 pr）
  • 新增 lolicon_search 扩展，搜索图片后会反馈图片信息（感谢@student_2333 提供 pr）
  • 新增扩展 启用/禁用 命令，对于不需要额外配置的扩展，可使用指令安装后直接启用（感谢@student_2333 提供 pr）
  • 新增 OpenAI API 的 base_url 配置，以便接入任何兼容 OpenAI API 格式的第三方接口
  • 修复了一个 prompt 构建错误的问题

[2023/5/24] v2.1.5 扩展优化 | 图片输出优化

强烈建议更新至此版本以上，否则可能会出现部分扩展加载失败的情况

  • 优化聊天转图片输出样式，支持代码块高亮显示（感谢 @student_2333 提供 pr）
  • 部分重构扩展管理和修改现有扩展，以支持异步请求（感谢 @student_2333 提供 pr）
  • 修复读取链接扩展和搜索扩展 api，并为读取链接增加防重复机制（感谢@CCYellowStar 提供 pr）

[2023/5/21] v2.1.4 逻辑优化 | 配置热重载

  • 增加配置文件热重载功能（感谢 @Misaka-Mikoto-Tech 提供 pr）
  • 增加消息丢弃机制，对于响应较慢的模型，如果在回复生成完成前收到了新的生成请求，将会丢弃旧的请求，避免重复响应
  • 修正 bot 发送消息前带上时间和消息头的问题

[2023/4/17] v2.1.3 响应节流功能 | 逻辑优化

  • 增加了 bot 响应节流功能，可配置节流时间范围，短时间内的大量消息只会在最后一条响应一次
  • 消除 pylance 提示的所有类型注解错误提示，进行模块拆分优化 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 优化 MC 指令执行扩展 prompt
  • 为所有 图片/语音 相关扩展指定了生效会话类型，避免在 MC 服务器中执行指令时出现错误
  • 修正 MC 服务器下 bot 错误断句导致发送空消息的问题
  • 修改了进化(ext_evolution)扩展执行逻辑，仅允许 bot 部分更新人设
  • 修正节流逻辑错误，避免 bot 无法响应消息的问题

[2023/4/15] v2.1.1 Minecraft 服务器指令优化

  • 为 rg chats 指令增加了 -show 参数，用于显示完整会话键以便 -target 参数使用
  • 优化 MC 服务器指令执行反馈信息，便于 bot 自主纠错；优化 MC 服务器指令预处理避免 bot 添加多余的转义

[2023/4/15] v2.1.0 Minecraft 服务器支持

  • 增加了 Minecraft 服务器接入支持
  • 增加了 Minecraft 服务器指令执行支持和相关扩展模块
  • 为绘图扩展增加了代理配置项支持 (感谢 @tonato-01 提供 pr)

[2023/4/6] v2.0.5 重命名指令 | JSON 导出支持

  • 解析消息中的@时保持与用户看到的一致 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 优化日志输出的 DEBUG_LEVEL 限制 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 优化聊天消息 prompt 的换行生成逻辑 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 增加 rg rename 改名指令，用于修改人格名 (感谢 @Misaka-Mikoto-Tech 提供 pr) (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 解析消息中的@时保持与用户看到的一致 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • patch logger 使插件名称显示为中文 (感谢 @chenxuan353 提供 pr)
  • 添加记忆文件(原.pkl)使用 JSON 读取与保存功能 (与原 pickle 兼容) (感谢 @chenxuan353 提供 pr)
  • 优化部分代码类型注解 (感谢 @chenxuan353 提供 pr)
  • 搜索扩展(ext_search.py) 优化，禁止 bot 短时间内反复搜索和搜索重复内容

[2023/3/26] v2.0.4

  • 修复 @全体成员 时解析报错问题
  • 增加扩展更新人格支持，同时增加了一个 evolution 扩展模块，允许 bot 自主更新人格
  • 响应规则中增加一条禁止复读规则

[2023/3/26] v2.0.3 图片输出支持

  • 输出内容转图片: 使用 htmlrender 将 TA 的回复转换为图片，降低风控几率 (可选开关，感谢 @HMScygnet 提供 pr)
  • 等待 OpenAI 响应过程中切换人格预设或响应超时后停止处理消息 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 修正编辑和删除预设判断是否锁定以及是否是默认预设和正在使用的预设的逻辑 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 增加调用扩展时预检支持打断响应，优化搜索扩展执行效果，避免 bot 自行脑补搜索结果的情况
  • 修正一些指令帮助信息的内容错误
  • 修正通过指令安装扩展时的编码问题
  • 修正纯符号过滤判断逻辑

[2023/3/21] v2.0.2 扩展下载指令支持

  • 切换人格时的聊天输出改为非 DEBUG 模式下也会发送
  • 增加了扩展 安装/删除 指令，可直接从 GitHub 上获取到最新扩展
  • 精简了非 DEBUG 模式下的控制台输出

[2023/3/20] v2.0.1 VIOCEVOX 语音扩展

  • 修正 -global 的控制权限和逻辑 (感谢 @Misaka-Mikoto-Tech 提供 pr)
  • 增加了一个新的语音扩展 ext_VOICEVOX 能够更便捷地实现本地部署 (感谢 @恋如雨止 提供技术支持)
  • 修正回复内容首尾的空行问题；修正短纯符号回复内容未正常过滤的问题
  • 修正私聊会话权限设定

[2023/3/18] v2.0.0 项目重构 🎉

❗❗❗ 注意：本次更新需要删除原 bot 记忆文件重新生成(即./data/naturel_gpt 文件夹)，否则可能产生无法预计的错误，同时建议将配置文件一并删除重新生成；此操作会丢失所有编辑过的人格预设，如果你需要在更新后继续使用，请使用 rg query 查询并保存预设，更新后手动导入！

  • 项目完全重构，感谢 @Misaka-Mikoto-Tech 提供的大力支持，几乎重写了所有数据管理和代码逻辑，代码质量提升明显
  • 会话人格预设集完全互相独立，每个会话可单独编辑人格互不影响
  • 指令表重写，多数指令提供了 -global 可选项支持同时编辑所有会话设置和 -target 指定会话远程控制操作，新指令表更具完备性，未来可能作为 api 接口搭配前端页面实现插件管理可视化
  • lock / unlock 指令修改为是否启用人格自动切换，lock 后将不会再自动唤醒不活跃人格
  • 聊天消息记录改完以会话为单位分割，而不是人格，意味着每个人格都可能看到其他人格的发言信息，上下文语境理解能力增强，如果你开启了解锁人格切换，还可以体验到到"主持会议"的感觉
  • 增加聊天所有消息的时间感知
  • bot 对用户昵称从 qq 昵称改为群名片昵称，同时增加新成员入群通知的昵称获取
  • @消息段解析重置成更合理的逻辑，而不是直接移除@消息段
  • 修复 NG_ENABLE_MSG_SPLIT 为 false 的情况下无法正常回复的问题 (感谢 @HyPerP 提供 pr)
  • 优化 debug 输出，改为 debug 分级模式，prompt 输出保存到日志中
  • 大量细节修改和错误修复

[2023/3/9] v1.5.3 定时支持

  • 从 bot 发送的信息中过滤掉纯符号短信息
  • 修复记忆删除指令无法正常工作的 bug
  • 增加了一个定时器扩展，并提供了相关支持

[2023/3/8] v1.5.2 自动切换人格 | 限制解除开关

  • 语音扩展增加接口返回 base64 支持
  • 修复语音扩展默认启用翻译导致报错的问题
  • 为 bot 增加了星期几的时间感知能力
  • 增加了一个可选的内容解锁限制开关
  • 增加了在 提及 时自动切换人格的配置开关

[2023/3/6] v1.5.1 语音合成接入翻译

  • 语音合成扩展提供接入腾讯翻译 api(可选开关) (感谢 @tonato-01 提供 pr)
  • 修复部分情况下 bot 回答时会带上自己的人称问题
  • 修复插件调用次数限制不生效
  • 优化 bot 调用扩展时的分段问题
  • 修复记忆管理的编辑指令错误的问题
  • 优化记忆强化功能的文本匹配规则

[2023/3/5] v1.5.0 记忆模块更新

  • 增加了 bot 记忆管理能力支持和记忆管理相关指令，允许 bot 主动 记忆/遗忘 信息，并且能自动对记忆信息进行增强以尽可能延长记忆有效时间
  • 新增了两个主动记忆管理扩展(记忆和忘却模块，推荐组合使用)
  • 根据 GPT3.5 对话模型的特点重写了 prompt 提示，提高 bot 对扩展指令识别率

[2023/3/3] v1.4.4 邮件扩展

  • 修复了修改配置文件目录后无法读取的问题 (感谢 @he0119 提供 pr)
  • 将获取响应实现将放入线程池，减少请求超时卡死 (感谢 @he0119 提供 pr)
  • 为群聊管理员增加了 bot 的会话管理权限 (感谢 @HMScygnet 提供 pr)
  • 优化多段回复预处理，减少了自动续写出后续无关对话的频率
  • 调整指令生成匹配正则，略微放宽 bot 调用扩展的规范程度
  • 更新代理服务器时将自动补充 http 协议头
  • 优化对话提示 prompt，提高回复质量
  • 新增了一个发送邮件扩展

[2023/3/3] v1.4.3

  • 禁用了 huggingface 的 tokenizer 的分支化，避免死锁问题

[2023/3/3] v1.4.2

  • 修复 ChatGPT 模型请求时间过长不会 timeout 的问题，提供一个配置项，可自行指定超时时间
  • 增加了一个可控制是否记录参考非 bot 相关消息上下文的配置选项
  • 为几种常见报错增加了更直观的提示
  • 修复了一个扩展模块调用出错的问题
  • 调整 prompt，优化 bot 回复质量

[2023/3/2] v1.4.1

  • 修复一个 prompt 描述错误
  • 修复一个对话过长死循环卡死的 bug

[2023/3/2] v1.4.0 ChatGpt 模型更新

本次更新后需要更新 OpenAi SDK 至 0.27.0 版本或以上才能使用 ChatGPT 系列模型

  • 增加了 ChatGPT 系列模型的支持，并针对其特点优化了 prompt 设置
  • 增加自动欢迎新成员可关闭的配置项
  • 优化了聊天内容分段输出的逻辑
  • 修复了一个聊天单条消息过长导致卡死循环的 bug
  • 修复代理服务器配置异常(感谢 @HMScygnet 提供的修复代码)

[2023/3/1] v1.3.7 勤俭持家 | 代理服务更新

  • 优化 prompt 生成，为总结聊天记忆功能增加了可选开关，关闭后可降低约 30%的 token 消耗（经过反馈该功能在较多场景下适用性有限，总体上高成本低回报，故增加了可选关闭，用户印象总结仍然保留开启）
  • 增加了扩展模块传递信息，扩展模块可获得原始请求触发信息、回复信息、bot 预设名，便于实现更复杂的扩展需求
  • 增加了自动欢迎新入群成员的功能
  • 增加代理服务器配置

[2023/2/25] v1.3.6

  • 修复了 rg set 指令出错的问题

[2023/2/24] v1.3.5 黑名单 | 指令更新

  • 修复因唤醒词设置类型不规范问题导致偶发错误的问题
  • 修复第一次启动自动创建数据文件夹目录失败的问题
  • 为更换人格预设增加了批量操作 -all 指令（限管理员可用）
  • 增加了 chats 指令，用于查看所有会话状态
  • 优化 README.md 文档
  • 增加了是否开启消息切分多条发送的配置项（默认开启）
  • 增加了黑名单功能，在黑名单中的用户消息不会被记录和响应

[2023/2/20] v1.3.3 扩展 | 多段发送更新

  • 优化了不启用扩展模块时 bot 的回复质量，减少虚空调用扩展的情况
  • 优化对话生成 prompt，增强了 bot 发送多段聊天的能力
  • 增加了 bot 感知当前时间的能力
  • 从 bot 的发言记录中将错误的调用指令去除，避免 bot 重复学习错误的扩展指令使用
  • 将大多数文本生成的 prompt 改为英文描述，尽量降低部分 tokens 消耗
  • 新增了一个表情包扩展模块

[2023/2/19] v1.3.2

  • 修复了 yaml 配置中设置禁用扩展不生效的问题
  • 持续优化对话生成 prompt，提高 bot 理解使用扩展的能力
  • 为 开启/关闭 会话的指令增加了 -all 选项，可一次性 开启/关闭 所有会话

[2023/2/19] v1.3.1

  • 优化扩展模块的参数传递
  • 修改了一些扩展插件提示，更便于 bot 理解扩展使用方式

[2023/2/18] v1.3.0 扩展模块功能更新

  • *扩展支持：增加了插件扩展支持(插件的插件？)，支持使用自然语言自定义扩展更多功能，提供了两个示例扩展
  • 多处细节优化

[2023/2/16] v1.2.0 异步更新

本次更新增加了异步能力，功能可能尚不稳定，如要继续使用旧版的记忆文件请做好备份

  • 异步更新：bot 的回复生成开始支持异步请求，提高了消息处理速度
  • 移除双回车符的停用词限制，优化了 ai 对长文本的输出能力
  • 优化错误输出，在 api 请求出错时会在控制台显示错误信息以供排查
  • 优化记忆逻辑，bot 在请求文本错误时不会把错误提示信息一并存入记忆

[2023/2/12] v1.1.6

  • 增加切换会话是否启用的开关功能
  • 增加了记忆重置功能，可指定重置当前会话的所有人格或特定人格
  • 消息拦截响应、消息处理优先级支持自定义配置
  • 简化帮助命令输出，分离管理员命令的帮助信息到 rg admin 中

[2023/2/9] v1.1.5 唤醒词 | 屏蔽词功能更新

  • 修复未创建对话前调用 bot 指令报错的问题
  • 增加自定义触发词唤醒的功能
  • 增加自定义屏蔽词拒绝回复的功能
  • 增加 bot 随机参与聊天功能，可选择启用
  • 优化了手动 @bot 时的信息的聊天 prompt 生成逻辑，使 bot 回复更具有指向性
  • 优化配置文件管理逻辑，更新后可继续沿用原配置文件，程序加载后会自动补充更新配置文件字段

[2023/2/6] v1.1.4

注意：本次更新需要删除原 bot 记忆文件重新生成(即./data/naturel_gpt 文件夹)，否则可能产生无法预计的错误

  • 修复了 bot 记忆串线的问题(多个群组同时使用场景下记忆混乱)
  • 优化 bot 生成记忆和印象摘要的逻辑，提高了 bot 回复的速度
  • 优化了控制台输出

[2023/2/5] v1.1.2

  • 新增了人格预设的 锁定/解锁 功能，锁定后非管理员无法编辑该预设
  • 更新 README 文档
  • 优化 rg 命令显示格式
  • 微调了 config.py 中的一些默认参数
  • 修复本插件拦截其它插件响应的问题，降低了本插件的响应优先级
  • 更新了交流群信息(见本文档开头)，欢迎各路大佬加入互相学习、一同探讨更新方向、分享更多玩法等

[2023/2/2] v1.1.1

  • 修复查询人格错误的问题

[2023/2/2] v1.1.0

注意：本次更新需要删除原 bot 记忆文件重新生成(即./data/naturel_gpt 文件夹)，否则可能产生无法预计的错误

  • 新增了预设编辑功能
  • 新增自定义管理员 id 功能，管理员可以删除预设 / 修改锁定的预设
  • 增加 debug 开关控制生成文本时的控制台输出（默认关闭）

🤝 贡献列表

感谢以下开发者对本项目做出的贡献

⭐ Star 历史

Star History Chart

常见问题

相似工具推荐

everything-claude-code

everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上

★ 159.6k|★★☆☆☆|今天
开发框架Agent语言模型

LLMs-from-scratch

LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。 该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。 LLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备

★ 90.1k|★★★☆☆|1周前
语言模型图像Agent

spec-kit

Spec Kit 是一款专为提升软件开发效率而设计的开源工具包，旨在帮助团队快速落地“规格驱动开发”（Spec-Driven Development）模式。传统开发中，需求文档往往与代码实现脱节，导致沟通成本高且结果不可控；而 Spec Kit 通过将规格说明书转化为可执行的指令，让 AI 直接依据明确的业务场景生成高质量代码，从而减少从零开始的随意编码，确保产出结果的可预测性。 该工具特别适合希望利用 AI 辅助编程的开发者、技术负责人及初创团队。无论是启动全新项目还是在现有工程中引入规范化流程，用户只需通过简单的命令行操作，即可初始化项目并集成主流的 AI 编程助手。其核心技术亮点在于“规格即代码”的理念，支持社区扩展与预设模板，允许用户根据特定技术栈定制开发流程。此外，Spec Kit 强调官方维护的安全性，提供稳定的版本管理，帮助开发者在享受 AI 红利的同时，依然牢牢掌握架构设计的主动权，真正实现从“凭感觉写代码”到“按规格建系统”的转变。

★ 88.7k|★★☆☆☆|今天
语言模型图像Agent

NextChat

NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。

★ 87.6k|★★☆☆☆|1周前
开发框架语言模型

ML-For-Beginners

ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。

★ 85.1k|★★☆☆☆|1周前
图像数据工具视频

funNLP

funNLP 是一个专为中文自然语言处理（NLP）打造的超级资源库，被誉为"NLP 民工的乐园”。它并非单一的软件工具，而是一个汇集了海量开源项目、数据集、预训练模型和实用代码的综合性平台。 面对中文 NLP 领域资源分散、入门门槛高以及特定场景数据匮乏的痛点，funNLP 提供了“一站式”解决方案。这里不仅涵盖了分词、命名实体识别、情感分析、文本摘要等基础任务的标准工具，还独特地收录了丰富的垂直领域资源，如法律、医疗、金融行业的专用词库与数据集，甚至包含古诗词生成、歌词创作等趣味应用。其核心亮点在于极高的全面性与实用性，从基础的字典词典到前沿的 BERT、GPT-2 模型代码，再到高质量的标注数据和竞赛方案，应有尽有。 无论是刚刚踏入 NLP 领域的学生、需要快速验证想法的算法工程师，还是从事人工智能研究的学者，都能在这里找到急需的“武器弹药”。对于开发者而言，它能大幅减少寻找数据和复现模型的时间；对于研究者，它提供了丰富的基准测试资源和前沿技术参考。funNLP 以开放共享的精神，极大地降低了中文自然语言处理的开发与研究成本，是中文 AI 社区不可或缺的宝藏仓库。

★ 79.9k|★☆☆☆☆|1周前
语言模型数据工具其他