Update README.md
This commit is contained in:
175
README.md
175
README.md
@@ -1,12 +1,15 @@
|
|||||||
|
<a id="-双语--bilingual"></a>
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
<!-- Language Switcher -->
|
<!-- Language Switcher -->
|
||||||
<a href="docs/README_CN.md">简体中文</a> | <a href="README.md">English</a>
|
<a href="#-双语--bilingual">双语 / Bilingual</a> | <a href="docs/README_CN.md">中文</a> | <a href="#english">English</a>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
<h1>MaiBot <sub><small>MaiSaka</small></sub></h1>
|
<h1>麦麦 MaiBot <sub><small>MaiSaka</small></sub></h1>
|
||||||
|
<sub><sup>An interactive agent based on large language models.</sup></sub>
|
||||||
|
|
||||||
<!-- Badges Row -->
|
<!-- Badges Row -->
|
||||||
<p>
|
<p>
|
||||||
@@ -25,24 +28,36 @@
|
|||||||
<!-- Mascot on the Right (Float) -->
|
<!-- 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;">
|
<img src="depends-data/maimai-v2.png" align="right" width="40%" alt="MaiBot Character" style="margin-left: 20px; margin-bottom: 20px;">
|
||||||
|
|
||||||
## Introduction
|
<a id="english"></a>
|
||||||
|
|
||||||
MaiSaka is an interactive agent based on large language models.
|
## 介绍
|
||||||
|
<sub><sup>Introduction</sup></sub>
|
||||||
|
|
||||||
MaiSaka is more than just a bot, and more than a "helpful assistant" that completes tasks. She is a digital life form that tries to understand you and interact in a genuinely human style. She does not pursue perfection or efficiency above all else. She pursues warmth and authenticity.
|
麦麦 MaiSaka 是一个基于大语言模型的可交互智能体。
|
||||||
|
<sub><sup>MaiSaka is an interactive agent based on large language models.</sup></sub>
|
||||||
|
|
||||||
- 💭 **No one likes GPT-sounding dialogue**: MaiSaka uses a more natural conversational style. Instead of long-winded markdown-heavy replies, she chats in a way that feels casual, varied, and human.
|
MaiSaka 不仅仅是一个机器人,不仅仅是一个可以帮你完成任务的“有帮助的助手”,她还是一个致力于了解你,并以真实人类的风格进行交互的数字生命。她不追求完美,不追求高效,但追求亲切和真实。
|
||||||
- 🎭 **No longer stuck in rigid Q&A**: She knows when to speak, how to read the room, when to join a conversation, and when to stay quiet.
|
<sub><sup>MaiSaka is more than just a bot, and more than a "helpful assistant" that completes tasks. She is a digital life form that tries to understand you and interact in a genuinely human style. She does not pursue perfection or efficiency above all else. She pursues warmth and authenticity.</sup></sub>
|
||||||
- 🧠 **MaiSaka becoming human**: In group conversations, MaiSaka imitates how people around her speak, learns new slang and in-group language, and keeps evolving.
|
|
||||||
- ❤️ **Always learning more about you**: Inspired by personality theory in psychology, MaiSaka gradually builds an understanding of your preferences, traits, habits, and behavior style.
|
- 💭 **没有人喜欢 GPT 的语言风格**:麦麦使用了更加自然、贴合人类对话习惯的交互方式,不是长篇大论或者 markdown 格式的分点,而是或长或短的闲谈。
|
||||||
- 🔌 **Plugin system**: Provides powerful APIs and an event system with virtually unlimited room for extension.
|
<sub><sup><strong>No one likes GPT-sounding dialogue</strong>: MaiSaka uses a more natural conversational style. Instead of long-winded markdown-heavy replies, she chats in a way that feels casual, varied, and human.</sup></sub>
|
||||||
|
- 🎭 **不再是傻乎乎的一问一答**:懂得在合适的时间说话,把握聊天中的气氛,在合适的时候开口,在合适的时候闭嘴。
|
||||||
|
<sub><sup><strong>No longer stuck in rigid Q&A</strong>: She knows when to speak, how to read the room, when to join a conversation, and when to stay quiet.</sup></sub>
|
||||||
|
- 🧠 **麦麦·成为人类**:在多人对话中,麦麦会模仿其他人的说话风格,还会自主理解新词或者小圈子里的黑话,不断进化。
|
||||||
|
<sub><sup><strong>MaiSaka becoming human</strong>: In group conversations, MaiSaka imitates how people around her speak, learns new slang and in-group language, and keeps evolving.</sup></sub>
|
||||||
|
- ❤️ **永远都在更加了解你**:基于心理学中人格理论,麦麦会不断积累对于你的了解,不论是你的信息、喜恶或是行为风格,她都记在心里。
|
||||||
|
<sub><sup><strong>Always learning more about you</strong>: Inspired by personality theory in psychology, MaiSaka gradually builds an understanding of your preferences, traits, habits, and behavior style.</sup></sub>
|
||||||
|
- 🔌 **插件系统**:提供强大的 API 和事件系统,拥有无限扩展可能。
|
||||||
|
<sub><sup><strong>Plugin system</strong>: Provides powerful APIs and an event system with virtually unlimited room for extension.</sup></sub>
|
||||||
|
|
||||||
|
### 快速导航
|
||||||
|
<sub><sup>Quick Navigation</sup></sub>
|
||||||
|
|
||||||
### Quick Navigation
|
|
||||||
<p>
|
<p>
|
||||||
<a href="https://www.bilibili.com/video/BV1amAneGE3P">🌟 Demo Video</a> |
|
<a href="https://www.bilibili.com/video/BV1amAneGE3P">🌟 演示视频 <sub>Demo Video</sub></a> |
|
||||||
<a href="#-updates-and-installation">📦 Quick Start</a> |
|
<a href="#-更新和安装--updates-and-installation">📦 快速入门 <sub>Quick Start</sub></a> |
|
||||||
<a href="#-deployment-guide">📃 Core Documentation</a> |
|
<a href="#-部署教程--deployment-guide">📃 核心文档 <sub>Core Documentation</sub></a> |
|
||||||
<a href="#-discussion-and-community">💬 Join Community</a>
|
<a href="#-讨论与社区--discussion-and-community">💬 加入社区 <sub>Join Community</sub></a>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<!-- Clear float to ensure subsequent content starts below the image area if text is short -->
|
<!-- Clear float to ensure subsequent content starts below the image area if text is short -->
|
||||||
@@ -53,103 +68,143 @@ MaiSaka is more than just a bot, and more than a "helpful assistant" that comple
|
|||||||
<a href="https://www.bilibili.com/video/BV1amAneGE3P" target="_blank">
|
<a href="https://www.bilibili.com/video/BV1amAneGE3P" target="_blank">
|
||||||
<picture>
|
<picture>
|
||||||
<source media="(max-width: 600px)" srcset="depends-data/video.png" width="100%">
|
<source media="(max-width: 600px)" srcset="depends-data/video.png" width="100%">
|
||||||
<img src="depends-data/video.png" width="60%" alt="MaiSaka Demo Video" style="border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);">
|
<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>
|
</picture>
|
||||||
<br>
|
<br>
|
||||||
<small>Watch the MaiSaka demo video</small>
|
<small>前往观看麦麦演示视频 / Watch the MaiSaka demo video</small>
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔥 Updates and Installation
|
<a id="-更新和安装--updates-and-installation"></a>
|
||||||
|
|
||||||
> **Latest Version: v1.0.0** ([📄 Changelog](changelogs/changelog.md))
|
## 🔥 更新和安装
|
||||||
|
<sub><sup>Updates and Installation</sup></sub>
|
||||||
|
|
||||||
- **Download**: Visit the [Release](https://github.com/MaiM-with-u/MaiBot/releases/) page to get the latest version.
|
> **最新版本: v1.0.0** ([📄 更新日志](changelogs/changelog.md))
|
||||||
- **Launcher**: [Mailauncher](https://github.com/MaiM-with-u/mailauncher/releases/) (MacOS only, still in early development).
|
> <sub><sup><strong>Latest Version: v1.0.0</strong> (<a href="changelogs/changelog.md">📄 Changelog</a>)</sup></sub>
|
||||||
|
|
||||||
| Branch | Description |
|
- **下载**:前往 [Release](https://github.com/MaiM-with-u/MaiBot/releases/) 页面下载最新版本。
|
||||||
|
<sub><sup><strong>Download</strong>: Visit the <a href="https://github.com/MaiM-with-u/MaiBot/releases/">Release</a> page to get the latest version.</sup></sub>
|
||||||
|
- **启动器**:[Mailauncher](https://github.com/MaiM-with-u/mailauncher/releases/)(仅支持 MacOS,早期开发中)。
|
||||||
|
<sub><sup><strong>Launcher</strong>: <a href="https://github.com/MaiM-with-u/mailauncher/releases/">Mailauncher</a> (MacOS only, still in early development).</sup></sub>
|
||||||
|
|
||||||
|
| 分支 / Branch | 说明 / Description |
|
||||||
| :--- | :--- |
|
| :--- | :--- |
|
||||||
| `main` | ✅ **Stable release (recommended)** |
|
| `main` | ✅ **稳定发布版本(推荐)**<br><sub><sup>Stable release (recommended)</sup></sub> |
|
||||||
| `dev` | 🚧 Development testing branch with new features, may be unstable |
|
| `dev` | 🚧 开发测试版本,包含新功能,可能不稳定<br><sub><sup>Development testing branch with new features, may be unstable</sup></sub> |
|
||||||
|
|
||||||
### 📚 Deployment Guide
|
<a id="-部署教程--deployment-guide"></a>
|
||||||
👉 **[🚀 Latest Deployment Guide](https://docs.mai-mai.org/manual/deployment/mmc_deploy_windows.html)**
|
|
||||||
|
### 📚 部署教程
|
||||||
|
<sub><sup>Deployment Guide</sup></sub>
|
||||||
|
|
||||||
|
👉 **[🚀 最新版本部署教程](https://docs.mai-mai.org/manual/deployment/mmc_deploy_windows.html)**
|
||||||
|
<sub><sup>Latest Deployment Guide</sup></sub>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 💬 Discussion and Community
|
<a id="-讨论与社区--discussion-and-community"></a>
|
||||||
|
|
||||||
We welcome everyone interested in MaiBot to join us.
|
## 💬 讨论与社区
|
||||||
|
<sub><sup>Discussion and Community</sup></sub>
|
||||||
|
|
||||||
| Category | Group | Description |
|
我们欢迎所有对 MaiBot 感兴趣的朋友加入!
|
||||||
|
<sub><sup>We welcome everyone interested in MaiBot to join us.</sup></sub>
|
||||||
|
|
||||||
|
| 类别 / Category | 群组 / Group | 说明 / Description |
|
||||||
| :--- | :--- | :--- |
|
| :--- | :--- | :--- |
|
||||||
| **Technical** | [MaiBrain EEG](https://qm.qq.com/q/RzmCiRtHEW) | Technical discussion / Q&A |
|
| **技术交流**<br><sub><sup>Technical</sup></sub> | [麦麦脑电图](https://qm.qq.com/q/RzmCiRtHEW)<br><sub><sup>MaiBrain EEG</sup></sub> | 技术交流 / 答疑<br><sub><sup>Technical discussion / Q&A</sup></sub> |
|
||||||
| **Technical** | [MaiBrain MRI](https://qm.qq.com/q/VQ3XZrWgMs) | Technical discussion / Q&A |
|
| **技术交流**<br><sub><sup>Technical</sup></sub> | [麦麦大脑磁共振](https://qm.qq.com/q/VQ3XZrWgMs)<br><sub><sup>MaiBrain MRI</sup></sub> | 技术交流 / 答疑<br><sub><sup>Technical discussion / Q&A</sup></sub> |
|
||||||
| **Technical** | [Mai Wants to Be a VTuber](https://qm.qq.com/q/wGePTl1UyY) | Technical discussion / Q&A |
|
| **技术交流**<br><sub><sup>Technical</sup></sub> | [麦麦要当 VTB](https://qm.qq.com/q/wGePTl1UyY)<br><sub><sup>Mai Wants to Be a VTuber</sup></sub> | 技术交流 / 答疑<br><sub><sup>Technical discussion / Q&A</sup></sub> |
|
||||||
| **Casual Chat** | [Mai Casual Chat Group](https://qm.qq.com/q/JxvHZnxyec) | Casual chat only, no support |
|
| **闲聊吹水**<br><sub><sup>Casual Chat</sup></sub> | [麦麦之闲聊群](https://qm.qq.com/q/JxvHZnxyec)<br><sub><sup>Mai Casual Chat Group</sup></sub> | 仅限闲聊,不答疑<br><sub><sup>Casual chat only, no support</sup></sub> |
|
||||||
| **Plugin Development** | [Plugin Dev Group](https://qm.qq.com/q/1036092828) | Advanced development and testing |
|
| **插件开发**<br><sub><sup>Plugin Development</sup></sub> | [插件开发群](https://qm.qq.com/q/1036092828)<br><sub><sup>Plugin Dev Group</sup></sub> | 进阶开发与测试<br><sub><sup>Advanced development and testing</sup></sub> |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📚 Documentation
|
## 📚 文档
|
||||||
|
<sub><sup>Documentation</sup></sub>
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> Some content may not be updated promptly, so please pay attention to version compatibility.
|
> 部分内容可能更新不够及时,请注意版本对应。
|
||||||
|
> <sub><sup>Some content may not be updated promptly, so please pay attention to version compatibility.</sup></sub>
|
||||||
|
|
||||||
- **[📚 Core Wiki Documentation](https://docs.mai-mai.org)**: The most comprehensive documentation hub for everything about MaiSaka.
|
- **[📚 核心 Wiki 文档](https://docs.mai-mai.org)**:最全面的文档中心,了解麦麦的一切。
|
||||||
|
<sub><sup><strong><a href="https://docs.mai-mai.org">📚 Core Wiki Documentation</a></strong>: The most comprehensive documentation hub for everything about MaiSaka.</sup></sub>
|
||||||
|
|
||||||
### 🧩 Related Projects
|
### 🧩 衍生项目
|
||||||
|
<sub><sup>Related Projects</sup></sub>
|
||||||
|
|
||||||
- **[Amaidesu](https://github.com/MaiM-with-u/Amaidesu)**: Let MaiSaka stream on Bilibili.
|
- **[Amaidesu](https://github.com/MaiM-with-u/Amaidesu)**:让麦麦在 B 站开播。
|
||||||
- **[MoFox_Bot](https://github.com/MoFox-Studio/MoFox-Core)**: An enhanced fork based on MaiCore 0.10.0, with improved stability and more fun features.
|
<sub><sup>Let MaiSaka stream on Bilibili.</sup></sub>
|
||||||
- **[MaiCraft](https://github.com/MaiM-with-u/Maicraft)**: Let MaiSaka accompany you in Minecraft (currently paused).
|
- **[MoFox_Bot](https://github.com/MoFox-Studio/MoFox-Core)**:基于 MaiCore 0.10.0 的增强型 Fork,更稳定更有趣。
|
||||||
|
<sub><sup>An enhanced fork based on MaiCore 0.10.0, with improved stability and more fun features.</sup></sub>
|
||||||
|
- **[MaiCraft](https://github.com/MaiM-with-u/Maicraft)**:让麦麦陪你玩 Minecraft(暂时停止维护中)。
|
||||||
|
<sub><sup>Let MaiSaka accompany you in Minecraft (currently paused).</sup></sub>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 💡 Design Philosophy
|
## 💡 设计理念
|
||||||
|
<sub><sup>Design Philosophy</sup></sub>
|
||||||
|
|
||||||
> **SengokuCola says:**
|
> **千石可乐说:**
|
||||||
> - This project originally started as a few extra features for the NiuNiu bot, but it kept growing until a full rewrite became inevitable. The goal was to create a "life form" active in QQ group chats, not a feature-complete bot, but something as human-like and real-feeling as possible.
|
> <sub><sup><strong>SengokuCola says:</strong></sup></sub>
|
||||||
> - The core design principle is: "more lifelike, not merely better."
|
> - 这个项目最初只是为了给牛牛 bot 添加一点额外的功能,但是功能越写越多,最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的“生命体”。目的并不是为了写一个功能齐全的机器人,而是一个尽可能让人感知到真实的类人存在。
|
||||||
> - If people truly want AI companionship, not everyone needs a perfect "helpful assistant" that solves every problem. Some people may want a life form that can make mistakes and has its own perceptions and thoughts.
|
> <sub><sup>This project originally started as a few extra features for the NiuNiu bot, but it kept growing until a full rewrite became inevitable. The goal was to create a "life form" active in QQ group chats, not a feature-complete bot, but something as human-like and real-feeling as possible.</sup></sub>
|
||||||
|
> - 程序的功能设计理念基于一个核心的原则:“最像而不是好”。
|
||||||
|
> <sub><sup>The core design principle is: "more lifelike, not merely better."</sup></sub>
|
||||||
|
> - 如果人类真的需要一个 AI 来陪伴自己,并不是所有人都需要一个完美的,能解决所有问题的“helpful assistant”,而是一个会犯错的,拥有自己感知和想法的“生命形式”。
|
||||||
|
> <sub><sup>If people truly want AI companionship, not everyone needs a perfect "helpful assistant" that solves every problem. Some people may want a life form that can make mistakes and has its own perceptions and thoughts.</sup></sub>
|
||||||
|
|
||||||
> **xxxxx says:**
|
> **xxxxx 说:**
|
||||||
|
> <sub><sup><strong>xxxxx says:</strong></sup></sub>
|
||||||
> *Code is open, but the soul is yours.*
|
> *Code is open, but the soul is yours.*
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🙋 Contributing and Acknowledgments
|
## 🙋 贡献和致谢
|
||||||
|
<sub><sup>Contributing and Acknowledgments</sup></sub>
|
||||||
|
|
||||||
Contributions are welcome. Please read the [Contribution Guide](docs-src/CONTRIBUTE.md) first.
|
欢迎参与贡献!请先阅读 [贡献指南](docs-src/CONTRIBUTE.md)。
|
||||||
|
<sub><sup>Contributions are welcome. Please read the <a href="docs-src/CONTRIBUTE.md">Contribution Guide</a> first.</sup></sub>
|
||||||
|
|
||||||
### 🌟 Contributors
|
### 🌟 贡献者
|
||||||
|
<sub><sup>Contributors</sup></sub>
|
||||||
|
|
||||||
<a href="https://github.com/MaiM-with-u/MaiBot/graphs/contributors">
|
<a href="https://github.com/MaiM-with-u/MaiBot/graphs/contributors">
|
||||||
<img alt="contributors" src="https://contrib.rocks/image?repo=MaiM-with-u/MaiBot" />
|
<img alt="contributors" src="https://contrib.rocks/image?repo=MaiM-with-u/MaiBot" />
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
### ❤️ Special Thanks
|
### ❤️ 特别致谢
|
||||||
|
<sub><sup>Special Thanks</sup></sub>
|
||||||
|
|
||||||
- **[Sacabambaspis](https://en.wikipedia.org/wiki/Sacabambaspis)**: SengokuCola's favorite creature.
|
- **[萨卡班甲鱼](https://en.wikipedia.org/wiki/Sacabambaspis)**:千石可乐很喜欢的生物。
|
||||||
- **[略nd](https://space.bilibili.com/1344099355)**: Drew MaiSaka's beautiful early character design.
|
<sub><sup><strong><a href="https://en.wikipedia.org/wiki/Sacabambaspis">Sacabambaspis</a></strong>: SengokuCola's favorite creature.</sup></sub>
|
||||||
- **[NapCat](https://github.com/NapNeko/NapCatQQ)**: A modern NTQQ-based bot protocol implementation.
|
- **[略nd](https://space.bilibili.com/1344099355)**:为麦麦绘制早期的精美人设。
|
||||||
|
<sub><sup>Drew MaiSaka's beautiful early character design.</sup></sub>
|
||||||
|
- **[NapCat](https://github.com/NapNeko/NapCatQQ)**:现代化的基于 NTQQ 的 Bot 协议实现。
|
||||||
|
<sub><sup>A modern NTQQ-based bot protocol implementation.</sup></sub>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📊 Repository Status
|
## 📊 仓库状态
|
||||||
|
<sub><sup>Repository Status</sup></sub>
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
### Star History
|
### Star 趋势
|
||||||
[](https://starchart.cc/MaiM-with-u/MaiBot)
|
<sub><sup>Star History</sup></sub>
|
||||||
|
|
||||||
|
[](https://starchart.cc/MaiM-with-u/MaiBot)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📌 Notice & License
|
## 📌 注意事项 & License
|
||||||
|
<sub><sup>Notice & License</sup></sub>
|
||||||
|
|
||||||
> [!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
> Please read the [End User License Agreement (EULA)](EULA.md) and [Privacy Policy](PRIVACY.md) before use. Please evaluate AI-generated content carefully.
|
> 使用前请阅读 [用户协议 (EULA)](EULA.md) 和 [隐私协议](PRIVACY.md)。AI 生成内容请仔细甄别。
|
||||||
|
> <sub><sup>Please read the <a href="EULA.md">End User License Agreement (EULA)</a> and <a href="PRIVACY.md">Privacy Policy</a> before use. Please evaluate AI-generated content carefully.</sup></sub>
|
||||||
|
|
||||||
**License**: GPL-3.0
|
**License**: GPL-3.0
|
||||||
|
|||||||
Reference in New Issue
Block a user