From 4044ffd89bfa0fb6eb80f9b651a1d4e221e3f380 Mon Sep 17 00:00:00 2001
From: suzmii <suzmii@qq.com>
Date: Mon, 21 Sep 2026 12:56:34 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=20Mac=20=E5=8F=91=E5=B8=83?=
 =?UTF-8?q?=20Job=20=E6=89=8B=E5=B7=A5=E8=A7=A6=E5=8F=91=E6=97=B6=20Checko?=
 =?UTF-8?q?ut=20=E5=9B=A0=E6=9C=AA=E5=AE=9A=E4=B9=89=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E5=A4=B1=E8=B4=A5=20-=20=E6=89=8B=E5=B7=A5=E3=80=8C=E7=AB=8B?=
 =?UTF-8?q?=E5=8D=B3=E6=9E=84=E5=BB=BA=E3=80=8D=E4=B8=8D=E4=BC=9A=E6=B3=A8?=
 =?UTF-8?q?=E5=85=A5=E5=8F=AF=E9=80=89=E5=8F=82=E6=95=B0=EF=BC=88COMMIT=5F?=
 =?UTF-8?q?HASH=20/=20SKIP=5FIF=5FSUPERSEDED=20=E6=9C=AA=E5=AE=9A=E4=B9=89?=
 =?UTF-8?q?=E8=80=8C=E9=9D=9E=E7=A9=BA=E5=80=BC=EF=BC=89=EF=BC=8Cset=20-u?=
 =?UTF-8?q?=20=E4=B8=8B=20`[=20-n=20"$COMMIT=5FHASH"=20]`=20=E7=9B=B4?=
 =?UTF-8?q?=E6=8E=A5=E4=BB=A5=20unbound=20variable=20=E9=80=80=E5=87=BA?=
 =?UTF-8?q?=EF=BC=8CJob=202026-09-21=2012:54=20=E9=82=A3=E4=B8=80=E8=BD=AE?=
 =?UTF-8?q?=E5=B0=B1=E6=98=AF=E8=BF=99=E6=A0=B7=E5=9C=A8=20Checkout=20?=
 =?UTF-8?q?=E5=A4=B1=E8=B4=A5=E7=9A=84=20-=20=E4=B8=A4=E6=AE=B5=20Checkout?=
 =?UTF-8?q?=20=E8=84=9A=E6=9C=AC=E5=BC=80=E5=A4=B4=E7=BB=9F=E4=B8=80?=
 =?UTF-8?q?=E5=85=9C=E5=BA=95=EF=BC=9ASOURCE=5FBRANCH=20=E9=BB=98=E8=AE=A4?=
 =?UTF-8?q?=20master=E3=80=81COMMIT=5FHASH=20=E9=BB=98=E8=AE=A4=E7=A9=BA?=
 =?UTF-8?q?=E3=80=81SKIP=5FIF=5FSUPERSEDED=20=E9=BB=98=E8=AE=A4=20false?=
 =?UTF-8?q?=EF=BC=8C=E8=B0=83=E5=BA=A6=E5=99=A8=E6=98=BE=E5=BC=8F=E4=BC=A0?=
 =?UTF-8?q?=E5=8F=82=E6=97=B6=E8=A1=8C=E4=B8=BA=E4=B8=8D=E5=8F=98=EF=BC=88?=
 =?UTF-8?q?=E4=BB=8D=E6=8C=89=20pinned=20commit=20=E6=9E=84=E5=BB=BA?=
 =?UTF-8?q?=E5=B9=B6=E5=88=A4=E8=AE=A9=E4=BD=8D=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 jenkins/Jenkinsfile.ai-game-creator-shell-macos-build | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/jenkins/Jenkinsfile.ai-game-creator-shell-macos-build b/jenkins/Jenkinsfile.ai-game-creator-shell-macos-build
index 6e57007b8..71146a824 100644
--- a/jenkins/Jenkinsfile.ai-game-creator-shell-macos-build
+++ b/jenkins/Jenkinsfile.ai-game-creator-shell-macos-build
@@ -43,6 +43,9 @@ pipeline {
         // 目的是防止把开发 checkout 当成 Jenkins workspace。
         sh '''
           set -eu
+          # 手工「立即构建」时可选参数可能根本没定义（不是空值），先统一成空串/默认值，
+          # 否则 set -u 会让 Checkout 直接失败。
+          SOURCE_BRANCH="${SOURCE_BRANCH:-master}"
           if [ -n "${AGC_AGENT_ROOT:-}" ]; then
             case "$WORKSPACE" in "$AGC_AGENT_ROOT"/workspace/*) ;; *) echo "拒绝非专用 Agent 工作区：$WORKSPACE"; exit 1;; esac
           else
@@ -54,6 +57,10 @@ pipeline {
         withCredentials([sshUserPrivateKey(credentialsId: env.GIT_REMOTE_CREDENTIAL_ID, keyFileVariable: 'GIT_SSH_KEY', usernameVariable: 'GIT_SSH_USER')]) {
           sh '''
             set -eu
+            # 同上：可选参数在「立即构建」里可能是未定义变量，统一兜底再使用。
+            SOURCE_BRANCH="${SOURCE_BRANCH:-master}"
+            COMMIT_HASH="${COMMIT_HASH:-}"
+            SKIP_IF_SUPERSEDED="${SKIP_IF_SUPERSEDED:-false}"
             export GIT_SSH_COMMAND="ssh -i \\"$GIT_SSH_KEY\\" -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes"
             if [ ! -d .git ]; then
               git init