将文件全部归进docs
This commit is contained in:
146
README.md
146
README.md
@@ -1,6 +1,8 @@
|
|||||||
# 麦麦!MaiCore-MaiMBot (编辑中)
|
# 麦麦!MaiCore-MaiBot (编辑中)
|
||||||
<br />
|
|
||||||
<div align="center">
|
<picture>
|
||||||
|
<img alt="MaiBot" src="depends-data/maimai.png" alt="NapCat" align=right width=30%/>
|
||||||
|
</picture>
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||
@@ -10,40 +12,14 @@
|
|||||||

|

|
||||||

|

|
||||||
[](https://deepwiki.com/DrSmoothl/MaiBot)
|
[](https://deepwiki.com/DrSmoothl/MaiBot)
|
||||||
|
|
||||||
|
<strong><a href="#show-cases">🌟 案例展示</a> | <a href="[#quick-start](https://docs.mai-mai.org/manual/deployment/)">🚀 快速入门</a> | <a href="https://docs.mai-mai.org/">📃 教程</a> | <a href="https://github.com/kvcache-ai/ktransformers/discussions">💬 讨论</a> | <a href="#FAQ">🙋 常见问题</a> </strong>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<a href="https://github.com/MaiM-with-u/MaiBot/">
|
|
||||||
<img src="depends-data/maimai.png" alt="Logo" style="width: 200px">
|
|
||||||
</a>
|
|
||||||
<br />
|
|
||||||
<a href="https://space.bilibili.com/1344099355">
|
|
||||||
画师:略nd
|
|
||||||
</a>
|
|
||||||
|
|
||||||
<h3 align="center">MaiBot(麦麦)</h3>
|
|
||||||
<p align="center">
|
|
||||||
一款专注于<strong> 群组聊天 </strong>的赛博网友
|
|
||||||
<br />
|
|
||||||
<a href="https://docs.mai-mai.org"><strong>探索本项目的文档 »</strong></a>
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<!-- <a href="https://github.com/shaojintian/Best_README_template">查看Demo</a>
|
|
||||||
· -->
|
|
||||||
<a href="https://github.com/MaiM-with-u/MaiBot/issues">报告Bug</a>
|
|
||||||
·
|
|
||||||
<a href="https://github.com/MaiM-with-u/MaiBot/issues">提出新特性</a>
|
|
||||||
</p>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## 新版0.6.x部署前先阅读:https://docs.mai-mai.org/faq/maibot/backup_update.html
|
|
||||||
|
|
||||||
|
|
||||||
## 📝 项目简介
|
## 📝 项目简介
|
||||||
|
|
||||||
**🍔MaiCore是一个基于大语言模型的可交互智能体**
|
**🍔MaiCore是一个基于大语言模型的可交互智能体**
|
||||||
|
|
||||||
|
|
||||||
- 💭 **智能对话系统**:基于LLM的自然语言交互
|
- 💭 **智能对话系统**:基于LLM的自然语言交互
|
||||||
- 🤔 **实时思维系统**:模拟人类思考过程
|
- 🤔 **实时思维系统**:模拟人类思考过程
|
||||||
- 💝 **情感表达系统**:丰富的表情包和情绪表达
|
- 💝 **情感表达系统**:丰富的表情包和情绪表达
|
||||||
@@ -58,49 +34,29 @@
|
|||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
||||||
### 📢 版本信息
|
### 📢 版本信息
|
||||||
|
|
||||||
**最新版本: v0.6.3** ([查看更新日志](changelogs/changelog.md))
|
**最新版本: v0.6.3** ([更新日志](changelogs/changelog.md))
|
||||||
> [!WARNING]
|
|
||||||
> 请阅读教程后更新!!!!!!!
|
|
||||||
> 请阅读教程后更新!!!!!!!
|
|
||||||
> 请阅读教程后更新!!!!!!!
|
|
||||||
> 次版本MaiBot将基于MaiCore运行,不再依赖于nonebot相关组件运行。
|
|
||||||
> MaiBot将通过nonebot的插件与nonebot建立联系,然后nonebot与QQ建立联系,实现MaiBot与QQ的交互
|
|
||||||
|
|
||||||
**分支说明:**
|
**GitHub分支说明:**
|
||||||
- `main`: 稳定发布版本
|
- `main`: 稳定发布版本
|
||||||
- `dev`: 开发测试版本(不知道什么意思就别下)
|
- `dev`: 开发测试版本(不稳定)
|
||||||
- `classical`: 0.6.0之前的版本
|
- `classical`: 0.6.0之前的版本(停止维护)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> - 项目处于活跃开发阶段,代码可能随时更改
|
|
||||||
> - 文档未完善,有问题可以提交 Issue 或者 Discussion
|
|
||||||
> - QQ机器人存在被限制风险,请自行了解,谨慎使用
|
|
||||||
> - 由于持续迭代,可能存在一些已知或未知的bug
|
|
||||||
> - 由于开发中,可能消耗较多token
|
|
||||||
|
|
||||||
### ⚠️ 重要提示
|
### ⚠️ 重要提示
|
||||||
|
|
||||||
- 升级到v0.6.x版本前请务必阅读:[升级指南](https://docs.mai-mai.org/faq/maibot/backup_update.html)
|
- 从0.5.x旧版本升级前请请务必阅读:[升级指南](https://docs.mai-mai.org/faq/maibot/backup_update.html)
|
||||||
- 本版本基于MaiCore重构,通过nonebot插件与QQ平台交互
|
- 项目处于活跃开发阶段,功能和API可能随时调整。
|
||||||
- 项目处于活跃开发阶段,功能和API可能随时调整
|
- 文档未完善,有问题可以提交 Issue 或者 Discussion。
|
||||||
|
- QQ机器人存在被限制风险,请自行了解,谨慎使用。
|
||||||
### 💬交流群(开发和建议相关讨论)不一定有空回复,会优先写文档和代码
|
- 由于持续迭代,可能存在一些已知或未知的bug。
|
||||||
- [一群](https://qm.qq.com/q/VQ3XZrWgMs) 766798517
|
- 由于程序处于开发中,可能消耗较多token。
|
||||||
- [二群](https://qm.qq.com/q/RzmCiRtHEW) 571780722
|
|
||||||
- [五群](https://qm.qq.com/q/JxvHZnxyec) 1022489779
|
|
||||||
- [三群](https://qm.qq.com/q/wlH5eT8OmQ) 1035228475【已满】
|
|
||||||
- [四群](https://qm.qq.com/q/wGePTl1UyY) 729957033【已满】
|
|
||||||
|
|
||||||
|
|
||||||
|
### 💬交流群
|
||||||
|
- [一群](https://qm.qq.com/q/VQ3XZrWgMs) | [二群](https://qm.qq.com/q/RzmCiRtHEW) | [五群](https://qm.qq.com/q/JxvHZnxyec) | [三群](https://qm.qq.com/q/wlH5eT8OmQ)(已满)| [四群](https://qm.qq.com/q/wGePTl1UyY)(已满)
|
||||||
|
|
||||||
## 📚 文档
|
## 📚 文档
|
||||||
|
|
||||||
|
|
||||||
### (部分内容可能过时,请注意版本对应)
|
### (部分内容可能过时,请注意版本对应)
|
||||||
|
|
||||||
### 核心文档
|
### 核心文档
|
||||||
@@ -109,45 +65,9 @@
|
|||||||
### 最新版本部署教程(MaiCore版本)
|
### 最新版本部署教程(MaiCore版本)
|
||||||
- [🚀 最新版本部署教程](https://docs.mai-mai.org/manual/deployment/mmc_deploy_windows.html) - 基于MaiCore的新版本部署方式(与旧版本不兼容)
|
- [🚀 最新版本部署教程](https://docs.mai-mai.org/manual/deployment/mmc_deploy_windows.html) - 基于MaiCore的新版本部署方式(与旧版本不兼容)
|
||||||
|
|
||||||
|
|
||||||
## 🎯 0.6.3 功能介绍
|
|
||||||
|
|
||||||
| 模块 | 主要功能 | 特点 |
|
|
||||||
|----------|------------------------------------------------------------------|-------|
|
|
||||||
| 💬 聊天系统 | • **统一调控不同回复逻辑**<br>• 智能交互模式 (普通聊天/专注聊天)<br>• 关键词主动发言<br>• 多模型支持<br>• 动态prompt构建<br>• 私聊功能(PFC)增强 | 拟人化交互 |
|
|
||||||
| 🧠 心流系统 | • 实时思考生成<br>• **智能状态管理**<br>• **概率回复机制**<br>• 自动启停机制<br>• 日程系统联动<br>• **上下文感知工具调用** | 智能化决策 |
|
|
||||||
| 🧠 记忆系统 | • **记忆整合与提取**<br>• 海马体记忆机制<br>• 聊天记录概括 | 持久化记忆 |
|
|
||||||
| 😊 表情系统 | • **全新表情包系统**<br>• **优化选择逻辑**<br>• 情绪匹配发送<br>• GIF支持<br>• 自动收集与审查 | 丰富表达 |
|
|
||||||
| 📅 日程系统 | • 动态日程生成<br>• 自定义想象力<br>• 思维流联动 | 智能规划 |
|
|
||||||
| 👥 关系系统 | • **工具调用动态更新**<br>• 关系管理优化<br>• 丰富接口支持<br>• 个性化交互 | 深度社交 |
|
|
||||||
| 📊 统计系统 | • 使用数据统计<br>• LLM调用记录<br>• 实时控制台显示 | 数据可视 |
|
|
||||||
| 🛠️ 工具系统 | • **LPMM知识库集成**<br>• **上下文感知调用**<br>• 知识获取工具<br>• 自动注册机制<br>• 多工具支持 | 扩展功能 |
|
|
||||||
| 📚 **知识库(LPMM)** | • **全新LPMM系统**<br>• **强大的信息检索能力** | 知识增强 |
|
|
||||||
| ✨ **昵称系统** | • **自动为群友取昵称**<br>• **降低认错人概率** (早期阶段) | 身份识别 |
|
|
||||||
|
|
||||||
## 📐 项目架构
|
|
||||||
|
|
||||||
```mermaid
|
|
||||||
graph TD
|
|
||||||
A[MaiCore] --> B[对话系统]
|
|
||||||
A --> C[心流系统]
|
|
||||||
A --> D[记忆系统]
|
|
||||||
A --> E[情感系统]
|
|
||||||
B --> F[多模型支持]
|
|
||||||
B --> G[动态Prompt]
|
|
||||||
C --> H[实时思考]
|
|
||||||
C --> I[日程联动]
|
|
||||||
D --> J[记忆存储]
|
|
||||||
D --> K[记忆检索]
|
|
||||||
E --> L[表情管理]
|
|
||||||
E --> M[情绪识别]
|
|
||||||
```
|
|
||||||
|
|
||||||
## ✍️如何给本项目报告BUG/提交建议/做贡献
|
## ✍️如何给本项目报告BUG/提交建议/做贡献
|
||||||
|
|
||||||
MaiCore是一个开源项目,我们非常欢迎你的参与。你的贡献,无论是提交bug报告、功能需求还是代码pr,都对项目非常宝贵。我们非常感谢你的支持!🎉 但无序的讨论会降低沟通效率,进而影响问题的解决速度,因此在提交任何贡献前,请务必先阅读本项目的[贡献指南](depends-data/CONTRIBUTE.md)(待补完)
|
MaiCore是一个开源项目,我们非常欢迎你的参与。你的贡献,无论是提交bug报告、功能需求还是代码pr,都对项目非常宝贵。我们非常感谢你的支持!🎉 但无序的讨论会降低沟通效率,进而影响问题的解决速度,因此在提交任何贡献前,请务必先阅读本项目的[贡献指南](docs/CONTRIBUTE.md)(待补完)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 设计理念(原始时代的火花)
|
## 设计理念(原始时代的火花)
|
||||||
|
|
||||||
@@ -162,27 +82,29 @@ MaiCore是一个开源项目,我们非常欢迎你的参与。你的贡献,
|
|||||||
## 📌 注意事项
|
## 📌 注意事项
|
||||||
|
|
||||||
> [!WARNING]
|
> [!WARNING]
|
||||||
> 使用本项目前必须阅读和同意用户协议和隐私协议
|
> 使用本项目前必须阅读和同意[用户协议](https://docs.mai-mai.org/manual/other/EULA.html)和隐私协议。
|
||||||
> 本应用生成内容来自人工智能模型,由 AI 生成,请仔细甄别,请勿用于违反法律的用途,AI生成内容不代表本人观点和立场。
|
> 本应用生成内容来自人工智能模型,由 AI 生成,请仔细甄别,请勿用于违反法律的用途,AI生成内容不代表本人观点和立场。
|
||||||
|
|
||||||
## 致谢
|
## 贡献者
|
||||||
|
|
||||||
- [NapCat](https://github.com/NapNeko/NapCatQQ): 现代化的基于 NTQQ 的 Bot 协议端实现
|
|
||||||
|
|
||||||
## 麦麦仓库状态
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
### 贡献者
|
|
||||||
|
|
||||||
感谢各位大佬!
|
感谢各位大佬!
|
||||||
|
|
||||||
<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>
|
||||||
|
<a href="https://space.bilibili.com/1344099355" align=right>
|
||||||
|
画师:略nd
|
||||||
|
</a>
|
||||||
|
### 致谢
|
||||||
|
|
||||||
|
- [NapCat](https://github.com/NapNeko/NapCatQQ): 现代化的基于 NTQQ 的 Bot 协议端实现
|
||||||
|
|
||||||
**也感谢每一位给麦麦发展提出宝贵意见与建议的用户,感谢陪伴麦麦走到现在的你们**
|
**也感谢每一位给麦麦发展提出宝贵意见与建议的用户,感谢陪伴麦麦走到现在的你们**
|
||||||
|
|
||||||
## Stargazers over time
|
## 麦麦仓库状态
|
||||||
|
|
||||||
[](https://starchart.cc/MaiM-with-u/MaiBot)
|

|
||||||
|
|
||||||
|
## Star 趋势
|
||||||
|
|
||||||
|
[](https://starchart.cc/MaiM-with-u/MaiBot)
|
||||||
|
|||||||
@@ -1,27 +0,0 @@
|
|||||||
这里放置了测试版本的细节更新
|
|
||||||
|
|
||||||
## [test-0.6.1-snapshot-1] - 2025-4-5
|
|
||||||
- 修复pfc回复出错bug
|
|
||||||
- 修复表情包打字时间,不会卡表情包
|
|
||||||
- 改进了知识库的提取
|
|
||||||
- 提供了新的数据库连接方式
|
|
||||||
- 修复了ban_user无效的问题
|
|
||||||
|
|
||||||
## [test-0.6.0-snapshot-9] - 2025-4-4
|
|
||||||
- 可以识别gif表情包
|
|
||||||
|
|
||||||
## [test-0.6.0-snapshot-8] - 2025-4-3
|
|
||||||
- 修复了表情包的注册,获取和发送逻辑
|
|
||||||
- 表情包增加存储上限
|
|
||||||
- 更改了回复引用的逻辑,从基于时间改为基于新消息
|
|
||||||
- 增加了调试信息
|
|
||||||
- 自动清理缓存图片
|
|
||||||
- 修复并重启了关系系统
|
|
||||||
|
|
||||||
## [test-0.6.0-snapshot-7] - 2025-4-2
|
|
||||||
- 修改版本号命名:test-前缀为测试版,无前缀为正式版
|
|
||||||
- 提供私聊的PFC模式,可以进行有目的,自由多轮对话
|
|
||||||
|
|
||||||
## [0.6.0-mmc-4] - 2025-4-1
|
|
||||||
- 提供两种聊天逻辑,思维流聊天(ThinkFlowChat 和 推理聊天(ReasoningChat)
|
|
||||||
- 从结构上可支持多种回复消息逻辑
|
|
||||||
Reference in New Issue
Block a user