Merge branch 'main' into main-fix

.github/pull_request_template.md

@@ -0,0 +1,17 @@
+<!-- 提交前必读 -->
+- 🔴**当前项目处于重构阶段（2025.3.14-）**
+- ✅ 接受：与main直接相关的Bug修复：提交到main-fix分支
+- ⚠️ 冻结：所有新功能开发和非紧急重构
+
+# 请填写以下内容
+（删除掉中括号内的空格，并替换为**小写的x**）
+1. - [ ] `main` 分支 **禁止修改**，请确认本次提交的分支 **不是 `main` 分支**
+2. - [ ] 本次更新 **包含破坏性变更**（如数据库结构变更、配置文件修改等）
+3. - [ ] 本次更新是否经过测试
+4. - [ ] 请**不要**在数据库中添加group_id字段，这会影响本项目对其他平台的兼容
+5. 请填写破坏性更新的具体内容（如有）:
+6. 请简要说明本次更新的内容和目的：
+# 其他信息
+- **关联 Issue**：Close #
+- **截图/GIF**：
+- **附加信息**:

.github/workflows/precheck.yml

@@ -0,0 +1,29 @@
+# .github/workflows/precheck.yml
+name: PR Precheck
+on: [pull_request]
+
+jobs:
+  conflict-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Check Conflicts
+        run: |
+          git fetch origin main
+          if git diff --name-only --diff-filter=U origin/main...HEAD | grep .; then
+            echo "CONFLICT=true" >> $GITHUB_ENV
+          fi
+  labeler:
+    runs-on: ubuntu-latest
+    needs: conflict-check
+    steps:
+      - uses: actions/github-script@v6
+        if: env.CONFLICT == 'true'
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['🚫冲突需处理']
+            })

.github/workflows/ruff.yml

@@ -6,3 +6,4 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: astral-sh/ruff-action@v3
+

README.md

@@ -1,3 +1,81 @@
+# 关于项目分支调整与贡献指南的重要通知
+<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 (编辑中)
 
 <div align="center">