diff --git a/README.md b/README.md index ad318aecc..2fc8961e5 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,81 @@ +# 关于项目分支调整与贡献指南的重要通知 +
+ + - 📂 致所有为麦麦提交过贡献,以及想要为麦麦提交贡献的朋友们! + +--- + +**📢 关于项目分支调整与贡献指南的重要通知** +**致所有关注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日 + +
+ + + + + # 麦麦!MaiMBot (编辑中)