From 9b966180ca869ee429e4f58d87c678f192e8ab96 Mon Sep 17 00:00:00 2001
From: aomin <aomin@aomin.cn>
Date: Fri, 13 Nov 2026 17:40:33 +0800
Subject: [PATCH] =?UTF-8?q?chore(repo):=20=E5=8A=A0=E6=8F=90=E4=BA=A4?=
 =?UTF-8?q?=E4=BF=A1=E6=81=AF=E6=A8=A1=E6=9D=BF=EF=BC=8Cgit=20commit=20?=
 =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=B8=A6=E5=87=BA=E6=A0=BC=E5=BC=8F=E6=8F=90?=
 =?UTF-8?q?=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

格式与 CONTRIBUTING.md 第二节一致：<类型>(<范围>): <说明>，六种类型、
九个模块范围、四条示例。配 commit.template 后不带 -m 提交即可看到提示。

新克隆的人执行一次 git config commit.template .gitmessage 即可生效。
---
 .gitmessage | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 .gitmessage

diff --git a/.gitmessage b/.gitmessage
new file mode 100644
index 0000000..287cd39
--- /dev/null
+++ b/.gitmessage
@@ -0,0 +1,33 @@
+
+# ─────────────────────────────────────────────────────────────
+# 提交信息格式：<类型>(<范围>): <一句话说明>
+#
+# 类型只有六种：
+#   feat      新增能力
+#   fix       修缺陷
+#   refactor  不改行为的重构
+#   docs      文档与接口契约
+#   chore     构建、依赖、配置、仓库杂务
+#   revert    回退
+#
+# 范围写模块名，不写人名：
+#   internal   /internal/** 五个接入接口
+#   contract  docs/contract 下的接口契约
+#   migration Flyway 迁移脚本
+#   auth      鉴权、权限、加解密
+#   alarm     告警引擎与状态机
+#   command   命令下发与结果回收
+#   demo      演示前端与设备模拟器
+#   repo      仓库级文件（.gitignore、README、规范）
+#
+# 示例：
+#   fix(internal): I-12 原文缺失返回 404 而不是 500
+#   feat(alarm): 解除事件按 dev_id + rule_key 关闭组合规则
+#   docs(contract): J-00 升级 1.8.1，OpenAPI 与正文同步
+#   chore(migration): 新增 V1.0.29 补充 alarm_source_event 索引
+#
+# 正文写"为什么这么改、代价是什么"，不复述代码本身。
+# 一条提交只做一件事；不写"按某人要求修改"。
+#
+# 以 # 开头的行不会进入提交信息。保存退出即完成。
+# ─────────────────────────────────────────────────────────────