MaiBot

<div align="center"> <h1>麦麦 MaiBot _{<small>MaiCore</small>}</h1> <!-- Badges Row --> <p> <img src="https://img.shields.io/badge/Python-3.10+-blue" alt="Python Version"> <img src="https://img.shields.io/github/license/Mai-with-u/MaiBot?label=%E5%8D%8F%E8%AE%AE" alt="License"> <img src="https://img.shields.io/badge/状态-开发中-yellow" alt="Status"> <img src="https://img.shields.io/github/contributors/Mai-with-u/MaiBot.svg?style=flat&label=%E8%B4%A1%E7%8C%AE%E8%80%85" alt="Contributors"> <img src="https://img.shields.io/github/forks/Mai-with-u/MaiBot.svg?style=flat&label=%E5%88%86%E6%94%AF%E6%95%B0" alt="Forks"> <img src="https://img.shields.io/github/stars/Mai-with-u/MaiBot?style=flat&label=%E6%98%9F%E6%A0%87%E6%95%B0" alt="Stars"> <a href="https://deepwiki.com/DrSmoothl/MaiBot"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a> </p> </div> <br> <!-- Mascot on the Right (Float) --> <img src="depends-data/maimai-v2.png" align="right" width="40%" alt="MaiBot Character" style="margin-left: 20px; margin-bottom: 20px;">

🎉 介绍

🍔 MaiCore 是一个基于大语言模型的可交互智能体

MaiBot 不仅仅是一个机器人，她致力于成为一个活跃在 QQ 群聊中的“生命体”。她不追求完美，但追求真实。

• 💭 拟人构建：使用自然语言风格构建 Prompt，回复贴近人类习惯。
• 🎭 行为规划：懂得在合适的时间说话，使用合适的动作。
• 🧠 表达学习：模仿群友的说话风格，学习黑话，不断进化。
• 🔌 插件系统：提供强大的 API 和事件系统，无限扩展可能。
• 💝 情感表达：拥有独立的情绪系统和表情包互动能力。

🚀 快速导航

<p> <a href="https://www.bilibili.com/video/BV1amAneGE3P">🌟 演示视频</a> &nbsp;|&nbsp; <a href="#-更新和安装">📦 快速入门</a> &nbsp;|&nbsp; <a href="#-部署教程">📃 核心文档</a> &nbsp;|&nbsp; <a href="#-讨论与社区">💬 加入社区</a> </p> <!-- Clear float to ensure subsequent content starts below the image area if text is short --> <br clear="both"> <div align="center"> <br> <h3>🎥 精彩演示</h3> <a href="https://www.bilibili.com/video/BV1amAneGE3P" target="_blank"> <picture> <source media="(max-width: 600px)" srcset="depends-data/video.png" width="100%"> <img src="depends-data/video.png" width="60%" alt="麦麦演示视频" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"> </picture> <br> <small>👆 点击观看麦麦演示视频 👆</small> </a> </div>

---

🔥 更新和安装

最新版本: v0.12.2 (📄 更新日志)

• 下载: 前往 Release 页面下载最新版本
• 启动器: Mailauncher (仅支持 MacOS, 早期开发中)

| 分支 | 说明 | | :--- | :--- | | main | ✅ 稳定发布版本 (推荐) | | dev | 🚧 开发测试版本 (不稳定) | | classical | 🛑 经典版本 (停止维护) |

📚 部署教程

👉 🚀 最新版本部署教程
(注意：MaiCore 新版本部署方式与旧版本不兼容)

[!WARNING]

• ⚠️ 项目处于活跃开发阶段，API 可能随时调整。
• ⚠️ QQ 机器人存在风控风险，请谨慎使用。
• ⚠️ AI 模型运行可能消耗较多 Token。

---

💬 讨论与社区

我们欢迎所有对 MaiBot 感兴趣的朋友加入！

| 类别 | 群组 | 说明 | | :--- | :--- | :--- | | 技术交流 | 麦麦脑电图 | 技术交流/答疑 | | 技术交流 | 麦麦大脑磁共振 | 技术交流/答疑 | | 技术交流 | 麦麦要当VTB | 技术交流/答疑 | | 闲聊吹水 | 麦麦之闲聊群 | 仅限闲聊，不答疑 | | 插件开发 | 插件开发群 | 进阶开发与测试 |

---

📚 文档

[!NOTE] 部分内容可能更新不够及时，请注意版本对应。

• 📚 核心 Wiki 文档: 最全面的文档中心，了解麦麦的一切。

🧩 衍生项目

• MaiCraft: 让麦麦陪你玩 Minecraft (早期开发中)。
• MoFox_Bot: 基于 MaiCore 0.10.0 的增强型 Fork，更稳定更有趣。

---

💡 设计理念 (原始时代的火花)

千石可乐说：

• 这个项目最初只是为了给牛牛 bot 添加一点额外的功能，但是功能越写越多，最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的"生命体"。目的并不是为了写一个功能齐全的机器人，而是一个尽可能让人感知到真实的类人存在。
• 程序的功能设计理念基于一个核心的原则："最像而不是好"。
• 如果人类真的需要一个 AI 来陪伴自己，并不是所有人都需要一个完美的，能解决所有问题的"helpful assistant"，而是一个会犯错的，拥有自己感知和想法的"生命形式"。
• 代码会保持开源和开放，但个人希望 MaiMbot 的运行时数据保持封闭，尽量避免以显式命令来对其进行控制和调试。我认为一个你无法完全掌控的个体才更能让你感觉到它的自主性，而视其成为一个对话机器。
• SengokuCola~~纯编程外行，面向 cursor 编程，很多代码写得不好多多包涵~~已得到大脑升级。 Code is open, but the soul is yours.

---

🙋 贡献和致谢

欢迎参与贡献！请先阅读 贡献指南。

🌟 贡献者

<a href="https://github.com/MaiM-with-u/MaiBot/graphs/contributors"> <img alt="contributors" src="https://contrib.rocks/image?repo=MaiM-with-u/MaiBot" /> </a>

❤️ 特别致谢

• 略nd: 🎨 为麦麦绘制精美人设。
• NapCat: 🚀 现代化的基于 NTQQ 的 Bot 协议实现。

---

📊 仓库状态

Star 趋势

---

📌 注意事项 & License

[!IMPORTANT] 使用前请阅读 用户协议 (EULA) 和 隐私协议。AI 生成内容请仔细甄别。

License: GPL-3.0