From 4e8bbc0e5cedd87a2b8723983a5adc2fb7105c5a Mon Sep 17 00:00:00 2001
From: Zhengchen Tao <Zhengchen.Tao@outlook.com>
Date: Sat, 2 May 2026 20:49:17 +0800
Subject: [PATCH] =?UTF-8?q?ci:=20=E6=B3=A8=E9=87=8A=20paths-ignore=20?=
 =?UTF-8?q?=E5=AF=B9=20empty=20commit=20=E7=9A=84=20vacuously-skip=20?=
 =?UTF-8?q?=E8=A1=8C=E4=B8=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

empirical discovery：c6bb0c85 那个 --allow-empty commit 推送后没有
触发 build。证实 Gitea Actions（同 GitHub Actions）对 paths-ignore
+ empty commit 的处理是"vacuously matches ignore list, skip"。

把这个 quirk 直接注释在 workflow 文件里，后续自己或 Claude 看到
build 没触发时不用再怀疑 trigger 配置错了，知道是 empty commit 的
正常行为。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .gitea/workflows/build-image.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.gitea/workflows/build-image.yml b/.gitea/workflows/build-image.yml
index 5e04b739..5b2bf7eb 100644
--- a/.gitea/workflows/build-image.yml
+++ b/.gitea/workflows/build-image.yml
@@ -3,6 +3,10 @@ name: Build Docker Image
 on:
   # 自动触发：push 到 custom 分支时跑（force-push 后的 rebase 也会触发，可接受）
   # paths-ignore：纯文档/配置改动跳过，避免浪费 ~10 分钟构建
+  # ⚠️ 已知 quirk（2026-05-02 验证）：empty commit（git commit --allow-empty）
+  # 不会触发 paths-ignore 过滤的 workflow，Gitea 把 zero-paths-changed 当作
+  # "vacuously matches ignore list" 跳过。要强制触发必须至少改一个非 ignore 路径
+  # 的真实文件（改这个 yml 自己最稳）。
   push:
     branches: [custom]
     paths-ignore: