action.yml

@@ -41,6 +41,17 @@ inputs:
     required: false
     # 預設為字串 'false'，代表不啟用建問題模式（主程式只認字串 'true' 才啟用）。
     default: 'false'
+  # 推送用 PAT：推送 findings/exclusions commit 時改以此 token 進行。
+  push-token:
+    # 參數用途說明：以自動 token（gitea.token / GITHUB_TOKEN）推送的 commit 不會再觸發 CI，
+    # 導致新 head 缺檢查而卡合併；改用 PAT 推送會讓 PR 的 synchronize 事件再觸發 CI，
+    # 由主程式步驟 1 快速回報（[success]/[failure]）廉價地把結果蓋到新 head。
+    # 呼叫端以 secrets 傳入（例如 secrets.TOKEN）。留空＝退回以 token 走 origin 推送（不會再觸發）。
+    description: '推送 findings/exclusions commit 用的 PAT（讓 CI 再觸發；呼叫端以 secrets 傳入；留空＝退回 token 推送、不再觸發）'
+    # 選填：未指定時退回以 token 推送。
+    required: false
+    # 預設為空字串，代表不使用專用推送 PAT。
+    default: ''
 # 執行方式區塊：宣告本 action 為 node action 及其進入點。
 runs:
   # 以 Node.js 24 runtime 直接在 runner 上執行（非 Docker 容器、非 composite）。

src/lib/context.js

@@ -20,6 +20,7 @@ const path = require('path');
  *   token: string,
  *   model: string,
  *   createIssue: boolean,
+ *   pushToken: string,
  *   event: Object,
  *   pr: (Object|null),
  *   prNumber: (number|null),
@@ -41,6 +42,8 @@ const path = require('path');
  * - model：action input `model`（INPUT_MODEL，已 trim），指定 AI 模型，缺值時為空字串。
  * - createIssue：action input `create-issue`（INPUT_CREATE-ISSUE），是否將問題建到
  *   存取庫的問題追蹤（建問題模式）；trim + 小寫後與字串 'true' 嚴格比對，預設 false。
+ * - pushToken：action input `push-token`（INPUT_PUSH-TOKEN），推送 findings/exclusions commit 用的 PAT；
+ *   提供時以 PAT 身分推送使 CI 再觸發（配合步驟 1 快速回報）；留空＝退回以 token 走 origin 推送（不會再觸發）。
  * - event：事件 payload 解析後的完整物件；讀取失敗時為空物件。
  * - pr：payload 內的 pull_request 物件；非 PR 事件時為 null。
  * - prNumber：PR 編號，優先取 payload，退而從 GITHUB_REF（refs/pull/N/...）解析；皆無時為 null。
@@ -92,6 +95,8 @@ function loadContext() {
     model: (process.env.INPUT_MODEL || '').trim(),
     // 是否將問題建到存取庫的問題追蹤（input: create-issue，字串 'true' 才啟用，預設否）。
     createIssue: (process.env['INPUT_CREATE-ISSUE'] || '').trim().toLowerCase() === 'true',
+    // 推送 findings/exclusions commit 用的 PAT（input: push-token）；提供時以 PAT 推送讓 CI 再觸發，留空＝退回 token。
+    pushToken: (process.env['INPUT_PUSH-TOKEN'] || '').trim(),
     event,
     pr,
     prNumber,