From 82eed06ad13f912df56322b69fbe30a2256eefa7 Mon Sep 17 00:00:00 2001
From: Jeffery <jiantw83@yahoo.com>
Date: Mon, 31 Aug 2026 11:19:32 +0800
Subject: [PATCH] =?UTF-8?q?chore(gitea):=20=E8=A3=9C=E4=B8=8A=E5=AF=AB?=
 =?UTF-8?q?=E5=85=A5=E7=A2=BA=E8=AA=8D=E8=85=B3=E6=9C=AC=E7=9A=84=E7=B5=90?=
 =?UTF-8?q?=E6=9D=9F=E7=A2=BC=E5=AE=A3=E5=91=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

檔頭只寫了用法與規則，沒有列結束碼，呼叫端無法逐碼分流，腳本檢查因此不通過。
依實作補上兩碼：0 表示已確認，可以送出寫入；2 表示不要寫入，並列出走這一碼的五種情形。
一併說明用法錯誤與人工拒絕為何共用 2。只加註解，指令行為與輸出都沒有變。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 tools/write-confirm.sh | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tools/write-confirm.sh b/tools/write-confirm.sh
index 38ab911..2349eac 100755
--- a/tools/write-confirm.sh
+++ b/tools/write-confirm.sh
@@ -12,6 +12,12 @@
 #   - JSC_GITEA_CONFIRM=no：直接拒絕。
 #   - 互動式執行：要求輸入「確認」。
 #   - 沒有互動終端：拒絕，避免默默寫出錯資料。
+# 結束碼: 0=已確認，呼叫端接著送出這次寫入。
+#         2=不要寫入，原因印在 stderr：缺動作名稱、缺目標名稱、JSC_GITEA_CONFIRM=no、
+#           輸入的不是「確認」、讀不到輸入，以及沒有互動終端這五種都走這一碼。
+#           呼叫端一律中止這次寫入，不要重試，也不要繞過確認直接呼叫 API。
+#   只有 0 與 2 兩種。用法錯誤與人工拒絕共用 2，因為兩者的處置一樣是「不寫」；
+#   拆成兩碼只會誘使呼叫端把用法錯誤當成可重試，反而寫出沒經過確認的資料。
 set -eu
 
 action="${1:-}"