插件v3大幅重构中，基本可用，持续完善中。遇到问题请提issue，欢迎PR。 todo列表：

• 插件v3重构完成，插件基本功能可用，持续完善中。
• RAG知识库
• 预设更详细的配置
• 自定义触发器
• 自定义插件
• 兼容mcp

插件简介

ChatGPT-Plugin 以 Chaite 为内核，将多模型渠道、工具、处理器、触发器、RAG 和管控面板封装成一套适配 Miao-Yunzai / Yunzai-Bot 的插件方案。通过 Chaite 的 API 服务器与可插拔的存储层（默认 SQLite），插件可以在本地完成高并发对话、知识库检索、伪人陪聊以及记忆管理，亦可接入 Chaite Cloud 复用在线渠道与工具。

核心特性

• 多渠道与预设体系：依托 Chaite 的 ChannelsManager 与 ChatPresetManager，支持为不同模型配置流量、负载均衡与个性化 prompt，群友也可在授权后自助切换预设。
• 高级消息适配：前后文触发方式支持 @Bot 与前缀；自动处理引用、图片、语音等多模态输入，并在工具调用或推理阶段通过转发消息回显。
• 群上下文与伪人模式：可按配置注入指定条数的群聊记录；BYM 伪人模式支持概率触发、关键词命中、预设覆盖及限时撤回，营造更拟人的陪聊体验。
• 记忆与 RAG：内置 memoryService + vectra 向量索引，提供群记忆、私人记忆与外部知识库（RAGManager）注入能力，支持混合检索与手动管理。
• 可视化与指令双管控：#chatgpt管理面板 一键获取面板 token，Web 端即可操作渠道、工具、触发器；同时保留完整的命令行 CRUD 指令。
• 自动更新与依赖管理：#chatgpt更新 / #chatgpt强制更新 调用 git 同步仓库并自动更新 chaite 依赖，减少手动维护成本。

快速安装

1. 克隆代码

   cd plugins
   git clone https://github.com/ikechan8370/chatgpt-plugin.git
   

2. 安装依赖（推荐 Node.js ≥ 18 + pnpm ≥ 8）

   cd chatgpt-plugin
   pnpm install
   

   若安装日志出现 Ignored build scripts: better-sqlite3 或运行时报错找不到 better-sqlite3 bindings，可执行 pnpm approve-builds，在交互列表中勾选全部或仅 better-sqlite3 以允许编译。然后再次 pnpm install
3. 在 Yunzai 中启用插件
   • 重启机器人或运行 node app 让插件自动加载。
   • 首次启动会在 plugins/chatgpt-plugin/config/ 下生成 config.json / config.yaml。
4. 保持更新
   • 主人账号发送 #chatgpt更新 获取最新版本。
   • #chatgpt强制更新 会放弃本地修改后重新拉取，请谨慎使用。

配置指引

配置文件默认位于 plugins/chatgpt-plugin/config/config.json，也可改写为 YAML。常用字段示例：

basic:
  toggleMode: at            # at / prefix
  togglePrefix: "#chat"     # prefix 模式下的触发词
  commandPrefix: "#chatgpt" # 管理指令前缀
llm:
  defaultModel: "gpt-4o-mini"
  defaultChatPresetId: "default"
  enableGroupContext: true
  groupContextLength: 20
bym:
  enable: false
  probability: 0.02
  defaultPreset: "bym_default"
chaite:
  cloudApiKey: ""           # 可选，接入 Chaite Cloud
  host: "0.0.0.0"
  port: 48370
memory:
  group:
    enable: false
    enabledGroups: ["123456"]
  user:
    enable: false
    whitelist: ["123456789"]

• basic：控制触发方式、调试与命令前缀。
• llm：定义默认模型、嵌入模型、群上下文等。defaultChatPresetId 需在面板或命令中提前创建。
• chaite：storage 默认 SQLite，会在 plugins/chatgpt-plugin/data/data.db 生成数据文件；如接入 Chaite Cloud，请填入 cloudApiKey 并开放 host/port。
• bym：配置伪人触发概率、关键词映射、撤回与思考内容开关。
• memory：为群记忆或私人记忆开启检索、模型与提示词，可按需启用 extensions.simple 以加载自定义词典。

修改后保存文件，插件会自动热加载；在 Chaite 面板修改配置时也会反向写回本地文件。

使用方式

基础对话

• @Bot 你好 或 #chat 今天天气如何 触发默认预设，插件会保持用户 conversationId 与 messageId，自动续写多轮对话。
• 回复图片/文本可作为上下文输入，模型返回的图片、语音与思考内容会自动转换为 QQ 消息或转发记录。
• #结束对话 仅清空自己的会话；#结束全部对话 需主人权限。

管理命令 & 面板

• #chatgpt管理面板：生成一次性 token，访问 http://<host>:<port> 即可使用 Chaite Web 面板。
• CRUD 命令示例（均支持 列表 / 添加 / 查看 / 删除）：

  #chatgpt渠道列表
  #chatgpt预设添加 角色扮演 {...}
  #chatgpt工具删除 web-search
  #chatgpt处理器查看 markdown
  

• #chatgpt调试模式开关、#chatgpt伪人开关 等指令可快速切换全局开关。

伪人（BYM）模式

1. 在配置中启用 bym.enable 并指定 defaultPreset 或 presetMap。
2. 伪人会在命中关键词或达到概率阈值时主动发言，可通过 presetPrefix 调整统一人设，temperature/maxTokens 控制语气与长度。
3. 支持为不同关键词配置 recall 秒数，实现“发完撤回”效果。

记忆系统

• 群记忆指令

  #群记忆          #仅群聊
  #删除群记忆 1    #主人或群管
  #记忆列表        #主人查看全局开关
  

• 私人记忆指令

  #记忆 / 我的记忆
  #他的记忆 @xxx   #群聊内查看他人（需其授权）
  #删除记忆 1
  

• 记忆抽取依赖配置中的 memory.group / memory.user 模型与预设，collector 会定期读取群聊历史，必要时可在 enabledGroups 中按群号白名单控制。

更新与维护

• #chatgpt更新：git pull 插件仓库并使用 pnpm/npm 更新 chaite 依赖。
• #chatgpt强制更新：在更新前执行 git checkout .，用于舍弃本地改动。
• 日志会通过转发消息发送最近 20 条 commit，方便追踪版本变化。

赞助

如果觉得本项目好玩或者对你有帮助，愿意的话可以赞助我一口快乐水：

https://afdian.net/a/ikechan8370

贡献者

感谢以下贡献者

Star History

ChatGPT-Plugin 快速上手指南

本指南帮助开发者在 Miao-Yunzai / Yunzai-Bot 机器人框架中快速部署并运行 ChatGPT-Plugin 插件。

环境准备

在开始之前，请确保您的服务器满足以下要求：

• 操作系统：Linux / macOS / Windows (推荐 Linux)
• Node.js：版本 ≥ 18
• 包管理器：pnpm (版本 ≥ 8，强烈推荐)
• 前置依赖：已正常运行的 Yunzai-Bot 或 Miao-Yunzai 项目

提示：若在国内网络环境下安装依赖较慢，可配置 npm 镜像源：

pnpm config set registry https://registry.npmmirror.com

安装步骤

1. 克隆插件代码

进入 Yunzai 项目的 plugins 目录，克隆本仓库：

cd plugins
git clone https://github.com/ikechan8370/chatgpt-plugin.git

2. 安装依赖

进入插件目录并安装依赖：

cd chatgpt-plugin
pnpm install

重要注意： 如果安装日志中出现 Ignored build scripts: better-sqlite3 或运行时提示找不到 better-sqlite3 绑定，请执行以下命令允许编译原生模块：

pnpm approve-builds

在交互列表中选择 better-sqlite3（或全选），确认后再次运行 pnpm install。

3. 启用插件

重启机器人或重新运行启动脚本以加载插件：

# 示例：回到项目根目录重启
cd ../..
node app

首次启动后，插件会自动在 plugins/chatgpt-plugin/config/ 目录下生成配置文件 (config.json 或 config.yaml)。

基本使用

1. 基础对话

插件默认支持 @机器人 或指定前缀触发。

• 触发方式 A (@Bot)：

  @Bot 你好，介绍一下你自己
  

• 触发方式 B (前缀)： （需在配置文件中设置 toggleMode: prefix 和 togglePrefix，默认为 #chat）

  #chat 今天天气如何？
  

插件会自动维护多轮对话上下文。发送图片、语音或引用消息也可作为输入内容。

2. 管理面板配置

为了配置模型密钥、预设及高级功能，推荐使用 Web 管理面板：

1. 在机器人聊天窗口发送指令（需主人权限）：

   #chatgpt 管理面板
   

2. 系统将返回一个一次性 Token 和访问地址（通常为 http://<IP>:48370）。
3. 在浏览器打开该地址，输入 Token 登录。
4. 在面板中配置 渠道 (Channels)（填入 API Key）、预设 (Presets) 及 触发器。

3. 常用指令

• 更新插件：

  #chatgpt 更新
  

• 结束当前对话（清空上下文）：

  #结束对话
  

• 查看帮助：

  #chatgpt 帮助
  

完成上述步骤后，即可享受基于多模型、支持记忆与伪人模式的智能对话体验。详细高级功能（如 RAG 知识库、BYM 伪人模式）请参考完整文档或在管理面板中探索。