github.com/Big-Sh0t114/NachoBot @v0.10.0

一个具备长时记忆与多模态感知能力的多平台 AI 虚拟生命

<img src="https://img.shields.io/badge/Platform-QQ%20%7C%20Discord%20%7C%20Bilibili-orange.svg?style=flat-square" alt="Platforms" />
<img src="https://img.shields.io/badge/Framework-NapCat%20%7C%20Koishi-green.svg?style=flat-square" alt="Frameworks" />
<img src="https://img.shields.io/badge/Language-Python_3.11%2B-yellow.svg?style=flat-square" alt="Language" />

✨ 这是什么？

NachoBot 赋予了 AI 大语言模型一个完整的虚拟灵魂。

采用“核心+多适配器”的设计理念，它可以化身为 Bilibili 直播间的虚拟主播、Discord 语音频道的陪玩伙伴，或是活跃在 QQ 群里的赛博老婆。

🧠 进化版长时记忆与誓约系统：能够跨越时间和会话记住你们的约定，甚至通过历史摘要持续迭代角色记忆

👁️ 全本地多模态感知 (ASR & VLM)：内置本地视觉大模型和语音识别，它能看懂你发的图片，听懂 Discord 里的语音

🎭 伪 Agent 沙盒环境：赋予 Bot 极高的自由度，支持自主阅读、编辑文件并下发任务，且配备了防注入系统守护人设

✉️ 信使/预约插件：允许 AI 大语言模型通过分析用户需求自主决定向其他用户传话或定时提醒用户的功能

🌐 多平台无缝并行：同时兼容 Bilibili 直播/评论区、Discord 语音/频道 以及基于 Napcat 的 QQ 生态

🎙️ 深度集成 GPT-SoVITS：支持双语种指令无缝切换，带来极致自然的角色专属语音体验

🎨 B 站直播间专属定制：支持弹幕互动、屏幕捕捉，甚至联动 Live2D 模型进行虚拟直播

🗺️ 项目架构与导航

这是一个由“核心大脑”和多个“感官/平台适配器”组成的复杂系统

🧠 1. 核心引擎

负责大语言模型接入、记忆管理、指令解析与全局配置

👉 NachoBot 核心模块详解与基础安装

🔌 2. 平台通讯适配器

📺 Bilibili 适配器：直播间弹幕互动、扫码登录、Live2D 联动配置

🎮 Discord 适配器：Slash 指令、语音频道发言

🐱 NapCat (QQ) 适配器：QQ 消息收发与心跳重连机制

🌐 Koishi 框架：Discord 接入的底层依赖与插件管理

🗣️ 3. 感知与表现层

🎵 TTS 适配器：文本转语音服务配置与多模态（VLM/ASR）本地服务启动

🚀 一键启动

当你已经在各个子目录中完成了繁琐的配置文件填写，并准备好 GPT-SoVITS、Node.js、Python 3.11+ 等环境后，本项目提供了一套极为优雅的启动方案。

在根目录双击运行以下脚本，即可全自动安装依赖并拉起所需的所有服务窗口：

🟢 launchbot.bat —— 完全体启动 (包含本地 VLM/ASR 多模态服务，需较高配置)

🟡 launchbot_lite.bat —— 轻量化启动 (关闭本地多模态服务，适合低配电脑或纯文本调试)

🔵 launch_bilibili.bat —— Bilibili 侧服务启动

🟣 launch_discord.bat —— Discord 侧服务启动

⚠️ 注意： 在全平台完全体运行的状态下，你将会看到多达 10 个（6+3+1）终端窗口同时工作。请保持它们在后台运行！

📜 致谢与许可

本项目基于 GPLv3 许可证开源。特别鸣谢 MaiBot 项目团队、Napcat、GPT-SoVITS、 VoxCPM 以及 Koishi 团队为开源社区做出的杰出贡献！