项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1078
使用教程
环境要求
- 已部署的 Miao-Yunzai / Yunzai-Bot 机器人框架
- Node.js ≥ 18
- pnpm ≥ 8
- 宿主环境可用的 sqlite3 驱动(本地记忆功能使用)
- 可选:sqlite-vec(仅用于向量检索增强,不可用时自动回退)
安装与启动步骤
-
1克隆插件代码
进入 Yunzai 根目录下的 plugins 目录,克隆插件仓库,确保插件放在 plugins/chatgpt-plugin 下。
cd plugins git clone https://github.com/ikechan8370/chatgpt-plugin.git -
2安装插件依赖
进入插件目录用 pnpm 安装依赖;sqlite-vec 为可选依赖,平台不支持时记忆功能仍可基础使用。
cd chatgpt-plugin pnpm install -
3启用插件
重启机器人或运行 node app 让插件自动加载,首次启动会生成配置目录与文件。
node app -
4修改配置文件
在 plugins/chatgpt-plugin/config/ 下编辑 config.json 或 config.yaml,设置触发方式、默认模型等,保存后自动热加载。
-
5保持更新
主人账号在 QQ 发送更新指令同步仓库并更新 chaite 依赖;强制更新会丢弃本地修改,谨慎使用。
#chatgpt更新
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
basic.toggleMode | 否 | 触发方式,可选 at(@Bot)或 prefix(前缀) | at |
basic.togglePrefix | 否 | prefix 模式下触发聊天用的前缀词 | #chat |
basic.commandPrefix | 否 | 管理指令前缀 | #chatgpt |
llm.defaultModel | 否 | 默认使用的对话模型 | gpt-4o-mini |
llm.defaultChatPresetId | 否 | 默认聊天预设 ID,需提前在面板或命令中创建 | default |
chaite.cloudApiKey | 否 | 接入 Chaite Cloud 时填写的密钥,留空则本地运行 | sk-xxxxxxxx |
如何确认成功
重启机器人后,检查 plugins/chatgpt-plugin/config/ 是否生成 config.json 与 config.yaml,并可发送 #chatgpt管理面板 获取面板 token 确认插件已加载。
常见问题
Q:安装依赖时 sqlite-vec 报错怎么办?
A:sqlite-vec 只用于向量检索增强,属可选依赖。当前平台不可用时,记忆功能仍保留基础存储、关键词检索与 LIKE 回退,可忽略该报错。
Q:配置文件用 JSON 还是 YAML?
A:默认位于 plugins/chatgpt-plugin/config/config.json,也可改写为 YAML,两种格式都支持,修改保存后插件会自动热加载。
Q:聊天数据保存在哪里?
A:核心配置、聊天历史和操作日志分别保存在插件 data 目录下的 data.db、history.db 与 operation_logs.db,存储默认使用 SQLite。
Q:升级后旧数据会丢失吗?
A:升级时会自动从旧的 data.db 分批复制数据,并保留旧表作为兼容备份,一般不会丢失。
注意事项
- 插件基于 Chaite 内核,v3 处于大幅重构中,遇到问题可提 issue。
- #chatgpt强制更新 会放弃本地修改后重新拉取,请谨慎使用。
- 如接入 Chaite Cloud,需填写 cloudApiKey 并开放 host/port。
核心亮点
- 多模型支持:可接入 OpenAI、Claude、Azure 等多种大模型,灵活切换
- 上下文记忆:支持多轮对话和会话隔离,聊天更自然
- 丰富扩展:集成图片生成、语音回复、角色扮演等玩法
不足之处
- 依赖云崽框架,非云崽用户无法直接使用
- 文档/社区待观察
适用场景
- QQ 群聊中提供智能问答和闲聊陪伴
- 搭建个人 QQ 机器人,实现定制化对话助手
- 社区或粉丝群内提供信息查询、娱乐互动
替代项目
nonebot-plugin-chatgpt、koishi-plugin-chatgpt、wechat-bot-chatgpt
上一篇:gptel
下一篇:OpenGptChat
同类项目推荐
seq2seq_chatbot
开源
用TensorFlow快速搭建带注意力和束搜索的对话机器人
基于seq2seq模型的简单对话系统的tf实现,具有embedding、attention、beam_search等功能,···
txtchat
开源
本地文件秒变 AI 知识库,离线问答更私密
⚡ Local chat assistants with AI superpowers
dual-obsidian-client
开源
在 Obsidian 里直接对话 AI,让笔记秒变智能助手
A skilled virtual assistant for Obsidian.
python-whatsapp-bot
开源
纯 Python 快速搭建 AI 微信机器人,对话即服务
Build AI WhatsApp Bots with Pure Python
dialogflow-web-v2
开源
给网站快速加一个带富文本的 Dialogflow 聊天框
Dialogflow Web Integration. Supports rich components
JARVIS-MARK5
开源
一个助手搞定图像、文档和办公,像 JARVIS 一样指挥 AI
JARVIS - A ASSISTANT WHICH IS NEEDED FOR EVERYONE
HackBot
开源
用聊天方式搞定网络安全问答、代码审计和扫描分析
AI-powered cybersecurity chatbot designed to provide helpful and accurate answers to···
ChatPilot
开源
拖文件、发网址,即刻拥有 Kimi 式智能对话界面
ChatPilot: Chat Agent Web UI,实现Chat对话前端,支持Google搜索、文件网址对话(RAG)、···
dotnetmaui-chatgpt-app-oss
开源
用 .NET MAUI 快速打造跨平台 ChatGPT 聊天应用
ChatGPT is an open-source chat application developed with .NET MAUI, employing OpenA···
