better：更好的心流结构，使用了观察取代外部世界
This commit is contained in:
SengokuCola
101
README.md
101
README.md
@@ -1,82 +1,4 @@
|
||||
# 关于项目分支调整与贡献指南的重要通知
|
||||
<details>
|
||||
<summary>
|
||||
- 📂 致所有为麦麦提交过贡献，以及想要为麦麦提交贡献的朋友们！</summary>
|
||||
|
||||
---
|
||||
|
||||
**📢 关于项目分支调整与贡献指南的重要通知**
|
||||
**致所有关注MaiMBot的开发者与贡献者：**
|
||||
|
||||
首先，我们由衷感谢大家近期的热情参与！感谢大家对MaiMBot的喜欢，项目突然受到广泛关注让我们倍感惊喜，也深深感受到开源社区的温暖力量。为了保障项目长期健康发展，我们不得不对开发流程做出重要调整，恳请理解与支持。
|
||||
|
||||
---
|
||||
|
||||
### **📌 本次调整的核心原因**
|
||||
|
||||
1. **维护团队精力有限**
|
||||
核心成员（包括我本人）均为在校学生/在职开发者，近期涌入的大量PR和意见已远超我们的处理能力。为确保本职工作与项目质量，我们必须优化协作流程。
|
||||
|
||||
2. **重构核心架构的紧迫性**
|
||||
当前我们正与核心团队全力重构项目底层逻辑，这是为未来扩展性、性能提升打下的必要基础，需要高度专注。
|
||||
|
||||
3. **保障现有用户的稳定性**
|
||||
我们深知许多用户已依赖当前版本，因此必须划分清晰的维护边界，确保生产环境可用性。
|
||||
|
||||
---
|
||||
|
||||
### **🌿 全新分支策略与贡献指南**
|
||||
|
||||
为平衡上述目标，即日起启用以下分支结构：
|
||||
|
||||
| 分支 | 定位 | 接受PR类型 | 提交对象 |
|
||||
| ---------- | ---------------------------- | --------------------------------------------- | ---------------- |
|
||||
| `main` | **稳定版**（供下载使用） | 仅接受来自`main-fix`的合并 | 维护团队直接管理 |
|
||||
| `main-fix` | 生产环境紧急修复 | 明确的功能缺陷修复（需附带复现步骤/测试用例） | 所有开发者 |
|
||||
| `refactor` | 重构版（**不兼容当前main**） | 仅重构与相关Bug修复 | 重构小组维护 |
|
||||
|
||||
---
|
||||
|
||||
### **⚠️ 对现有PR的处理说明**
|
||||
|
||||
由于分支结构调整，**GitHub已自动关闭所有未合并的PR**，这并非否定您的贡献价值！如果您认为自己的PR符合以下条件：
|
||||
|
||||
- 属于`main-fix`明确的**功能性缺陷修复**（非功能增强） ，包括非预期行为和严重报错，需要发布issue讨论确定。
|
||||
- 属于`refactor`分支的**重构适配性修复**
|
||||
|
||||
**欢迎您重新提交到对应分支**，并在PR描述中标注`[Re-submit from closed PR]`，我们将优先审查。其他类型PR暂缓受理，但您的创意我们已记录在案，未来重构完成后将重新评估。
|
||||
|
||||
---
|
||||
|
||||
### **🙏 致谢与协作倡议**
|
||||
|
||||
- 感谢每一位提交Issue、PR、参与讨论的开发者！您的每一行代码都是maim吃的
|
||||
- 特别致敬在交流群中积极答疑的社区成员，你们自发维护的氛围令人感动❤️ ，maim哭了
|
||||
- **重构期间的非代码贡献同样珍贵**：文档改进、测试用例补充、用户反馈整理等，欢迎通过Issue认领任务！
|
||||
|
||||
---
|
||||
|
||||
### **📬 高效协作小贴士**
|
||||
|
||||
1. **提交前请先讨论**：创建Issue描述问题，确认是否符合`main-fix`修复范围
|
||||
2. **对重构提出您的想法**：如果您对重构版有自己的想法，欢迎提交讨论issue亟需测试伙伴，欢迎邮件联系`team@xxx.org`报名
|
||||
3. **部分main-fix的功能在issue讨论后，经过严格讨论，一致决定可以添加功能改动或修复的，可以提交pr**
|
||||
|
||||
---
|
||||
|
||||
**谢谢大家谢谢大家谢谢大家谢谢大家谢谢大家谢谢大家！**
|
||||
虽然此刻不得不放缓脚步，但这一切都是为了跳得更高。期待在重构完成后与各位共建更强大的版本！
|
||||
|
||||
千石可乐 敬上
|
||||
2025年3月14日
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
# 麦麦！MaiMBot (编辑中)
|
||||
# 麦麦！MaiMBot-MaiCore (编辑中)
|
||||
|
||||
<div align="center">
|
||||
|
||||
@@ -88,14 +10,13 @@
|
||||
|
||||
## 📝 项目简介
|
||||
|
||||
**🍔麦麦是一个基于大语言模型的智能QQ群聊机器人**
|
||||
**🍔MaiCore是一个基于大语言模型的可交互智能体**
|
||||
|
||||
- 基于 nonebot2 框架开发
|
||||
- LLM 提供对话能力
|
||||
- MongoDB 提供数据持久化支持
|
||||
- NapCat 作为QQ协议端支持
|
||||
- 可扩展
|
||||
|
||||
**最新版本: v0.5.15** ([查看更新日志](changelog.md))
|
||||
**最新版本: v0.6.0-mmc** ([查看更新日志](changelog.md))
|
||||
> [!WARNING]
|
||||
> 该版本更新较大，建议单独开文件夹部署，然后转移/data文件，数据库可能需要删除messages下的内容（不需要删除记忆）
|
||||
|
||||
@@ -115,17 +36,10 @@
|
||||
> - 由于持续迭代，可能存在一些已知或未知的bug
|
||||
> - 由于开发中，可能消耗较多token
|
||||
|
||||
**📚 有热心网友创作的wiki:** https://maimbot.pages.dev/
|
||||
|
||||
**📚 由SLAPQ制作的B站教程:** https://www.bilibili.com/opus/1041609335464001545
|
||||
|
||||
**😊 其他平台版本**
|
||||
|
||||
- (由 [CabLate](https://github.com/cablate) 贡献) [Telegram 与其他平台(未来可能会有)的版本](https://github.com/cablate/MaiMBot/tree/telegram) - [集中讨论串](https://github.com/SengokuCola/MaiMBot/discussions/149)
|
||||
|
||||
## ✍️如何给本项目报告BUG/提交建议/做贡献
|
||||
|
||||
MaiMBot是一个开源项目，我们非常欢迎你的参与。你的贡献，无论是提交bug报告、功能需求还是代码pr，都对项目非常宝贵。我们非常感谢你的支持！🎉 但无序的讨论会降低沟通效率，进而影响问题的解决速度，因此在提交任何贡献前，请务必先阅读本项目的[贡献指南](CONTRIBUTE.md)
|
||||
MaiCore是一个开源项目，我们非常欢迎你的参与。你的贡献，无论是提交bug报告、功能需求还是代码pr，都对项目非常宝贵。我们非常感谢你的支持！🎉 但无序的讨论会降低沟通效率，进而影响问题的解决速度，因此在提交任何贡献前，请务必先阅读本项目的[贡献指南](CONTRIBUTE.md)
|
||||
|
||||
### 💬交流群
|
||||
- [五群](https://qm.qq.com/q/JxvHZnxyec) 1022489779（开发和建议相关讨论）不一定有空回复，会优先写文档和代码
|
||||
@@ -151,10 +65,6 @@ MaiMBot是一个开源项目，我们非常欢迎你的参与。你的贡献，
|
||||
|
||||
- [📦 macOS 手动部署指南 ](docs/manual_deploy_macos.md)
|
||||
|
||||
如果你不知道Docker是什么，建议寻找相关教程或使用手动部署 **（现在不建议使用docker，更新慢，可能不适配）**
|
||||
|
||||
- [🐳 Docker部署指南](docs/docker_deploy.md)
|
||||
|
||||
- [🖥️群晖 NAS 部署指南](docs/synology_deploy.md)
|
||||
|
||||
### 配置说明
|
||||
@@ -170,7 +80,6 @@ MaiMBot是一个开源项目，我们非常欢迎你的参与。你的贡献，
|
||||
<h3>了解麦麦 </h3>
|
||||
</div>
|
||||
|
||||
- [项目架构说明](docs/doc1.md) - 项目结构和核心功能实现细节
|
||||
|
||||
## 🎯 功能介绍
|
||||
|
||||
|
||||
Reference in New Issue
Block a user