Make production builds bootstrap agent dependencies

docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md

@@ -307,6 +307,7 @@ WASM_SOURCE="${CARGO_TARGET_DIR}/wasm32-unknown-unknown/release/spacetime_module
 并发与清理规则：
 
 - Rust 构建 Job 建议使用 `disableConcurrentBuilds()`，或对共享 `CARGO_TARGET_DIR` 加 Jenkins `lock`，避免多个同包 release 构建同时写入同一最终产物路径。
+- 如果 Linux agent 未安装 `sccache`，Rust 构建流水线必须自动取消 `RUSTC_WRAPPER`，回退到直接使用 `rustc`，不能因为缺少可选缓存工具阻断真实构建。
 - 生产发布流水线只能消费 `build/<version>/` 或 Jenkins 归档产物，不允许从共享 `cargo-target` 目录直接发布。
 - `SCCACHE_CACHE_SIZE` 必须设置上限，避免编译缓存无限增长。
 - 对 `/var/cache/genarrative-build/cargo-target` 或数据盘对应目录配置定期清理，建议保留最近 14 到 30 天。
@@ -366,6 +367,7 @@ WASM_SOURCE="${CARGO_TARGET_DIR}/wasm32-unknown-unknown/release/spacetime_module
 构建：
 
 - 先按 `SOURCE_BRANCH` / `COMMIT_HASH` 解析并 checkout 目标源码，默认构建 `origin/master` 最新 commit。
+- 默认执行 `npm ci` 安装前端依赖，确保 Jenkins 新 workspace 中存在 `vite` 等构建工具。
 - 构建主站静态文件。
 - 构建后台前端，base path 为 `/admin/`。
 - 生成或复制 `maintenance.html`。

jenkins/Jenkinsfile.production-api-build

@@ -63,6 +63,10 @@ pipeline {
           bash -lc '
             set -euo pipefail
             mkdir -p "${CARGO_HOME}" "${CARGO_TARGET_DIR}" "${SCCACHE_DIR}"
+            if ! command -v sccache >/dev/null 2>&1; then
+              echo "[api-build] 未找到 sccache，改用 rustc 直接构建。"
+              unset RUSTC_WRAPPER
+            fi
             SOURCE_BRANCH="${SOURCE_BRANCH}" SOURCE_COMMIT="${SOURCE_COMMIT}" \
             npm run build:production-release -- --component api-server --name "${EFFECTIVE_BUILD_VERSION}"
           '

jenkins/Jenkinsfile.production-full-build-and-deploy

@@ -19,6 +19,7 @@ pipeline {
     string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '源码分支，默认 master 最新提交')
     string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
     string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
+    booleanParam(name: 'RUN_NPM_CI', defaultValue: true, description: 'Web 构建前是否执行 npm ci')
     string(name: 'WEB_BUILD_JOB_NAME', defaultValue: 'Genarrative-Web-Build', description: 'Web 构建流水线作业名')
     string(name: 'API_BUILD_JOB_NAME', defaultValue: 'Genarrative-Api-Build', description: 'API 构建流水线作业名')
     string(name: 'STDB_BUILD_JOB_NAME', defaultValue: 'Genarrative-Stdb-Module-Build', description: 'Stdb 构建流水线作业名')
@@ -76,6 +77,7 @@ pipeline {
                   string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
                   string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
                   string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+                  booleanParam(name: 'RUN_NPM_CI', value: params.RUN_NPM_CI),
                 ]
               env.WEB_BUILD_NUMBER = webRun.number.toString()
             }

jenkins/Jenkinsfile.production-stdb-module-build

@@ -64,6 +64,10 @@ pipeline {
           bash -lc '
             set -euo pipefail
             mkdir -p "${CARGO_HOME}" "${CARGO_TARGET_DIR}" "${SCCACHE_DIR}"
+            if ! command -v sccache >/dev/null 2>&1; then
+              echo "[stdb-build] 未找到 sccache，改用 rustc 直接构建。"
+              unset RUSTC_WRAPPER
+            fi
             SOURCE_BRANCH="${SOURCE_BRANCH}" SOURCE_COMMIT="${SOURCE_COMMIT}" \
             npm run build:production-release -- --component spacetime-module --name "${EFFECTIVE_BUILD_VERSION}"
           '

jenkins/Jenkinsfile.production-web-build

@@ -17,7 +17,7 @@ pipeline {
     string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '源码分支，默认 master 最新提交')
     string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
     string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
-    booleanParam(name: 'RUN_NPM_CI', defaultValue: false, description: '构建前是否执行 npm ci')
+    booleanParam(name: 'RUN_NPM_CI', defaultValue: true, description: '构建前是否执行 npm ci')
     booleanParam(name: 'PUBLISH_AFTER_BUILD', defaultValue: false, description: '构建成功后是否触发 Web 发布')
     string(name: 'DEPLOY_JOB_NAME', defaultValue: 'Genarrative-Web-Deploy', description: 'Web 发布流水线作业名')
     choice(name: 'DEPLOY_TARGET', choices: ['development', 'release'], description: 'PUBLISH_AFTER_BUILD=true 时的逻辑部署目标；development 使用当前 Linux 开发/构建/开发部署 agent')