From c55a4a047e6705f806cac93a8c0c2e241dd844cf Mon Sep 17 00:00:00 2001
From: Senguk <1144120444@qq.com>
Date: Mon, 5 Oct 2026 01:46:34 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AF=B4=E6=98=8E=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=E5=B9=B6=E5=85=A5=E9=97=B8=E9=97=A8=E7=9A=84=E5=88=A4=E5=AE=9A?=
 =?UTF-8?q?=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增 docs/AUTOMATION.md：记录哪些改动会自动并入、哪些必须人工判断，
以及 automerge / needs-human / do-not-merge 三个标签的用途。
---
 docs/AUTOMATION.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 docs/AUTOMATION.md

diff --git a/docs/AUTOMATION.md b/docs/AUTOMATION.md
new file mode 100644
index 0000000..4704de0
--- /dev/null
+++ b/docs/AUTOMATION.md
@@ -0,0 +1,42 @@
+# PR 自动并入规则
+
+main 分支由三重机制保护。本文说明哪些改动会自动并入、哪些必须人工判断。
+
+## 会自动并入
+
+同时满足以下条件的 PR，会在必需检查全绿后自动并入 main：
+
+- 作者在维护者名单内（Senguk520、hmbbjack），或与仓库有 OWNER / MEMBER / COLLABORATOR 关系；
+- 全部改动仅限 Markdown 文档：仓库根目录的 `*.md`，或 `docs/` 下的 `*.md`；
+- 不超过 10 个文件、300 行，且不含二进制文件；
+- PR 非草稿、描述非空、与 main 无冲突、必需检查（三条 `Analyze`）无失败。
+
+文档不进安装包，改错也不影响可执行产物，因此允许自动并入。
+
+## 必须人工判断
+
+以下情况不会自动并入，闸门会打上 `needs-human` 并留言说明原因：
+
+- 任何代码、脚本、配置、工作流改动（`src/`、`src-tauri/`、`scripts/`、`.github/`、`package.json` 等）；
+- 改动 `LICENSE`、图片等二进制文件；
+- 超出规模上限；PR 为草稿、描述为空、有冲突、检查失败；
+- 作者不在维护者名单内；
+- 闸门自身出错（fail-closed：任何异常一律转人工）。
+
+代码改动一律人工：一行代码也可能改变程序行为，机器无法判断「改动是否合理」。
+
+## 三个标签
+
+| 标签 | 含义 |
+| --- | --- |
+| `automerge` | 闸门已放行，等必需检查全绿后自动并入 |
+| `needs-human` | 等你人工判断。修好后摘掉此标签，闸门会重新判定一次 |
+| `do-not-merge` | 人工否决开关：打上即撤销 auto-merge 并转人工 |
+
+## 参与机制
+
+- **闸门**：`.github/workflows/pr-gate.yml`。由 GitHub Actions 以 main 分支的上下文运行，只做客观条件判断（作者、路径、规模、检查状态），不阅读代码内容。
+- **安全检查**：`.github/workflows/codeql.yml`。Go / JavaScript-TypeScript / Rust 三语言静态扫描，其三条 `Analyze` 检查是 main 的必需检查。
+- **版本号**：`.github/workflows/version-bump.yml`。main 出现非文档改动时自动 +1 patch 并推回 main；纯文档改动不触发（本文件即属此类）。
+
+没有 AI 审查层：PR 内容是可被构造的输入，AI 的结论只能作为参考，不能作为合并依据。