chore: update Jenkins deploy pipeline controls

jenkins/Jenkinsfile.build

@@ -30,6 +30,16 @@ pipeline {
         dir("${env.WORKSPACE_ROOT}") {
           checkout scm
 
+          sh '''
+            bash -lc '
+              set -euo pipefail
+              # 构建前清理工作区内的 Git 变更和未跟踪文件，避免复用固定源码目录时受到上次构建残留影响。
+              # 这里不使用 -x，避免删除 node_modules 等忽略目录后与 RUN_NPM_CI=false 的配置冲突。
+              git reset --hard HEAD
+              git clean -fd
+            '
+          '''
+
           script {
             // 是否重装依赖交给流水线参数决定，避免每次构建都重复执行 npm ci。
             if (params.RUN_NPM_CI) {

jenkins/Jenkinsfile.build-and-deploy

@@ -37,6 +37,16 @@ pipeline {
         dir("${env.WORKSPACE_ROOT}") {
           checkout scm
 
+          sh '''
+            bash -lc '
+              set -euo pipefail
+              # 构建前清理工作区内的 Git 变更和未跟踪文件，避免复用固定源码目录时受到上次构建残留影响。
+              # 这里不使用 -x，避免删除 node_modules 等忽略目录后与 RUN_NPM_CI=false 的配置冲突。
+              git reset --hard HEAD
+              git clean -fd
+            '
+          '''
+
           script {
             // 是否重装依赖交给流水线参数决定，避免每次构建都重复执行 npm ci。
             if (params.RUN_NPM_CI) {

jenkins/Jenkinsfile.deploy

@@ -24,6 +24,7 @@ pipeline {
 
       steps {
         script {
+          // 部署流水线允许手动启动；如存在上游触发原因，则继续执行上游作业名门禁。
           // Pipeline 的 build 步骤通常会把下游触发原因记录成 BuildUpstreamCause，
           // 直接只查经典 UpstreamCause 会把真实的上游触发误判成“人工执行”。
           def pipelineUpstreamCauses = currentBuild.getBuildCauses('org.jenkinsci.plugins.workflow.support.steps.build.BuildUpstreamCause')
@@ -36,10 +37,6 @@ pipeline {
             upstreamCause = classicUpstreamCauses[0]
           }
 
-          if (!upstreamCause) {
-            error('部署流水线禁止人工直接执行，只允许由上游构建并部署流水线触发。')
-          }
-
           def actualUpstreamJob = upstreamCause?.upstreamProject ?: ''
           def expectedUpstreamJob = params.EXPECTED_UPSTREAM_JOB?.trim()
           def allowedUpstreamJob = env.GENARRATIVE_ALLOWED_UPSTREAM_JOB?.trim()
@@ -56,19 +53,19 @@ pipeline {
             error('SOURCE_NODE_NAME 不能为空。')
           }
 
-          if (!actualUpstreamJob?.trim()) {
+          if (upstreamCause && !actualUpstreamJob?.trim()) {
             error('无法从上游触发原因中解析作业名，请检查 Jenkins Pipeline Build Step 插件版本与触发链。')
           }
 
-          if (expectedUpstreamJob && actualUpstreamJob != expectedUpstreamJob) {
+          if (actualUpstreamJob && expectedUpstreamJob && actualUpstreamJob != expectedUpstreamJob) {
             error("上游作业校验失败，期望 ${expectedUpstreamJob}，实际 ${actualUpstreamJob}")
           }
 
-          if (allowedUpstreamJob && actualUpstreamJob != allowedUpstreamJob) {
+          if (actualUpstreamJob && allowedUpstreamJob && actualUpstreamJob != allowedUpstreamJob) {
             error("环境门禁校验失败，仅允许 ${allowedUpstreamJob} 触发，实际 ${actualUpstreamJob}")
           }
 
-          env.UPSTREAM_JOB_NAME = actualUpstreamJob
+          env.UPSTREAM_JOB_NAME = actualUpstreamJob ?: 'MANUAL'
         }
       }
     }