diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 000000000..19a587960
--- /dev/null
+++ b/.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**:
+- **附加信息**:
diff --git a/.github/workflows/precheck.yml b/.github/workflows/precheck.yml
new file mode 100644
index 000000000..a7524ccb3
--- /dev/null
+++ b/.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: ['🚫冲突需处理']
+ })
diff --git a/.github/workflows/ruff.yml b/.github/workflows/ruff.yml
index 0d1e50c5a..697c47759 100644
--- a/.github/workflows/ruff.yml
+++ b/.github/workflows/ruff.yml
@@ -5,4 +5,5 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- - uses: astral-sh/ruff-action@v3
\ No newline at end of file
+ - uses: astral-sh/ruff-action@v3
+
diff --git a/README.md b/README.md
index 5de6f5dfd..f1c25ea67 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日
+
+