<div align="center">

  <!-- Language Switcher -->
  <a href="../README.md">双语 / Bilingual</a> | <a href="README_CN.md">简体中文</a> | <a href="README_EN.md">English</a>

  <br>

  <h1>麦麦 MaiBot</h1>

  <!-- Badges Row -->
  <p>
    <img src="https://img.shields.io/badge/Python-3.12+-blue" alt="Python Version">
    <img src="https://img.shields.io/github/license/Mai-with-u/MaiBot?label=License" alt="License">
    <img src="https://img.shields.io/github/contributors/Mai-with-u/MaiBot.svg?style=flat&label=Contributors" alt="Contributors">
    <img src="https://img.shields.io/github/forks/Mai-with-u/MaiBot.svg?style=flat&label=Forks" alt="Forks">
    <img src="https://img.shields.io/github/stars/Mai-with-u/MaiBot?style=flat&label=Stars" alt="Stars">
    <br>
    <a href="https://trendshift.io/repositories/20445" target="_blank"><img src="https://trendshift.io/api/badge/repositories/20445" alt="Mai-with-u%2FMaiBot | Trendshift" width="250" height="55"></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;">

## 介绍

麦麦 MaiSaka 是一个基于大语言模型的可交互智能体。

MaiSaka 不仅仅是一个机器人，不仅仅是一个可以帮你完成任务的“有帮助的助手”，她还是一个致力于了解你，并以真实人类的风格进行交互的数字生命。她不追求完美，不追求高效，但追求亲切和真实。

- 💭 **没有人喜欢 GPT 的语言风格**：麦麦使用了更加自然、贴合人类对话习惯的交互方式，不是长篇大论或者 markdown 格式的分点，而是或长或短的闲谈。
- 🎭 **不再是傻乎乎的一问一答**：懂得在合适的时间说话，把握聊天中的气氛，在合适的时候开口，在合适的时候闭嘴。
- 🧠 **麦麦·成为人类**：在多人对话中，麦麦会模仿其他人的说话风格，还会自主理解新词或者小圈子里的黑话，不断进化。
- ❤️ **永远都在更加了解你**：基于心理学中人格理论，麦麦会不断积累对于你的了解，不论是你的信息、喜恶或是行为风格，她都记在心里。
- 🔌 **插件系统**：提供强大的 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>
  <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>

<div align="center">
  <br>
  <img src="../depends-data/webui-showcase.jpg" width="90%" alt="MaiBot WebUI 界面" style="box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
</div>

---

## 安装

**最新版本: v1.2.3**

- **发布**：[Release](https://github.com/Mai-with-u/MaiBot/releases/) 页面展示了最新发布的正式版。

- **[部署教程](https://docs.mai-mai.org/manual/deployment/)**

- **方便使用的麦麦启动器下载 (Windows/MAC)**：[Maibot-OK](https://github.com/Mai-with-u/MaiBotOneKey/releases/)

| 分支 | 说明 |
| :--- | :--- |
| `main` | **稳定版** |
| `dev` | 开发版，包含开发中的新功能 |

---

## 📚 文档

- **[📚 麦麦文档](https://docs.mai-mai.org)**：最全面的文档中心，了解麦麦的一切。

---

## 💬 讨论与社区

| 群组 | 说明 |
| :--- | :--- |
| 麦麦脑电图:571780722 | 技术交流 / 答疑 |
| 麦麦大脑磁共振:766798517 | 技术交流 / 答疑 |
| [麦麦要当 VTB](https://qm.qq.com/q/wGePTl1UyY) | 技术交流 / 答疑 |
| [麦麦闲聊群](https://qm.qq.com/q/JxvHZnxyec) | 以闲聊为主 |
| 插件开发群:1036092828 | 插件、进阶开发与测试 |

---

## 🧩 衍生项目

- **[Amaidesu](https://github.com/MaiM-with-u/Amaidesu)**：让麦麦在 B 站开播。
- **[MoFox_Bot](https://github.com/MoFox-Studio/MoFox-Core)**：基于 MaiCore 0.10.0 的 Fork。
- **[MaiCraft](https://github.com/MaiM-with-u/Maicraft)**：让麦麦陪你玩 Minecraft（暂时停止维护中）。

---

## 💡 设计理念

> **千石可乐说：**
> - 这个项目最初只是为了给牛牛 bot 添加一点额外的功能，但是功能越写越多，最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的“生命体”。目的并不是为了写一个功能齐全的机器人，而是一个尽可能让人感知到真实的类人存在。
> - 程序的功能设计理念基于一个核心的原则：“最像而不是好”。
> - 如果人类真的需要一个 AI 来陪伴自己，并不是所有人都需要一个完美的，能解决所有问题的“helpful assistant”，而是一个会犯错的，拥有自己感知和想法的“生命形式”。

---

## 🌟 贡献和致谢

欢迎参与贡献！请先阅读 [贡献指南](CONTRIBUTE.md)。

### 🌟 贡献者

<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>

### 🤝 开源项目友链

- **[AstrBot](https://github.com/AstrBotDevs/AstrBot)**：优秀的 LLM Agent 项目。

### ❤️ 特别致谢

- **[萨卡班甲鱼](https://en.wikipedia.org/wiki/Sacabambaspis)**：千石可乐很喜欢的生物。
- **[略nd](https://space.bilibili.com/1344099355)**：为麦麦绘制早期的精美人设。
- **[NapCat](https://github.com/NapNeko/NapCatQQ)**：现代化的基于 NTQQ 的 Bot 协议实现。

---

## 📊 仓库状态

![Alt](../depends-data/repository-metrics.svg "麦麦仓库状态")

### Star History

![Star 趋势](../depends-data/star-history.svg)

---

## 📌 注意事项 & License

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

**License**: GPL-3.0
