From ce04d8cef4eceb123fb133e49878a4d59168895a Mon Sep 17 00:00:00 2001
From: kdletters <61648117+kdletters@users.noreply.github.com>
Date: Thu, 17 Sep 2026 18:10:41 +0800
Subject: [PATCH] =?UTF-8?q?AGC=20=E5=8F=91=E5=B8=83=E6=B5=81=E6=B0=B4?=
 =?UTF-8?q?=E7=BA=BF=E5=A2=9E=E5=8A=A0=20OSS=20=E6=BC=94=E7=BB=83=E5=BC=80?=
 =?UTF-8?q?=E5=85=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Jenkins 增加布尔参数 AGC_RELEASE_DRY_RUN，勾选后只构建并打印上传命令，不写入 OSS
- 参数转换为脚本读取的 AGC_RELEASE_DRY_RUN 环境变量，完成提示区分演练与真发
---
 jenkins/Jenkinsfile.ai-game-creator-shell-build | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/jenkins/Jenkinsfile.ai-game-creator-shell-build b/jenkins/Jenkinsfile.ai-game-creator-shell-build
index 5bd728af0..8ac2484e2 100644
--- a/jenkins/Jenkinsfile.ai-game-creator-shell-build
+++ b/jenkins/Jenkinsfile.ai-game-creator-shell-build
@@ -23,6 +23,7 @@ pipeline {
     string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
     string(name: 'AGC_RELEASE_VERSION', defaultValue: '', description: '可选，指定三段版本号；留空则按该渠道 OSS 与本地版本自动递增 patch')
     choice(name: 'AGC_UPDATE_CHANNEL', choices: ['dev-win', 'dev-mac'], description: 'AGC 发布渠道；dev-win 在 Windows 节点执行，dev-mac 需在 macOS 构建机本地执行')
+    booleanParam(name: 'AGC_RELEASE_DRY_RUN', defaultValue: false, description: '勾选后只构建并打印将要执行的上传命令，不写入 OSS')
     text(name: 'AGC_UPDATE_RELEASE_NOTES', defaultValue: '', description: '可选，支持多行文本，写入渠道清单的发布说明')
     string(name: 'OSSUTIL_BIN', defaultValue: 'ossutil', description: 'ossutil 或 ossutil.exe 的绝对路径/命令名')
   }
@@ -132,6 +133,7 @@ pipeline {
             "OSSUTIL_BIN=${params.OSSUTIL_BIN}",
             "AGC_RELEASE_VERSION=${params.AGC_RELEASE_VERSION}",
             "AGC_UPDATE_CHANNEL=${params.AGC_UPDATE_CHANNEL}",
+            "AGC_RELEASE_DRY_RUN=${params.AGC_RELEASE_DRY_RUN ? '1' : '0'}",
             "AGC_UPDATE_RELEASE_NOTES=${params.AGC_UPDATE_RELEASE_NOTES}",
           ]) {
             powershell '''
@@ -164,7 +166,9 @@ pipeline {
 
   post {
     success {
-      echo "AGC ${params.AGC_UPDATE_CHANNEL} 渠道安装包、签名与渠道清单已构建并上传 OSS。"
+      echo params.AGC_RELEASE_DRY_RUN
+        ? "AGC ${params.AGC_UPDATE_CHANNEL} 渠道演练完成：已构建并生成清单，未写入 OSS。"
+        : "AGC ${params.AGC_UPDATE_CHANNEL} 渠道安装包、签名与渠道清单已构建并上传 OSS。"
     }
   }
 }