From c3fbfeefa8b3bc135cfd9c400357da758c4f2c44 Mon Sep 17 00:00:00 2001
From: chenxing <chenxing@bestsch.com>
Date: Wed, 30 Sep 2026 10:01:10 +0800
Subject: [PATCH] =?UTF-8?q?ci(build):=20=E5=89=8D=E7=AB=AF=E6=9E=84?=
 =?UTF-8?q?=E5=BB=BA=E6=8C=82=E5=AE=BF=E4=B8=BB=20npm=20=E7=BC=93=E5=AD=98?=
 =?UTF-8?q?=E5=8D=B7=20+=20=E5=88=87=E5=9B=BD=E5=86=85=E9=95=9C=E5=83=8F?=
 =?UTF-8?q?=E6=BA=90=EF=BC=8C=E6=B2=BB=20CI=2013=20=E5=88=86=E9=92=9F?=
 =?UTF-8?q?=E6=85=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 实测 build #10 耗时 13分5秒，其中 npm install 占 12分46秒（97.6%，added 754 packages in 13m），
  vite build 仅 16.53s —— 瓶颈唯一且固定在依赖安装
- 根因：① 每次起全新 node:20 容器、装完即 rm -f，node_modules 零缓存；
  ② .npmrc / yarn.lock 均被 .gitignore 忽略 ⇒ CI 走公网 registry.npmjs.org 跨境下载 + 无 lock 全量解析
- 修复（照 notice/service 的 m2 缓存做法）：
  - 挂 -v /opt/docker/projman-npm-cache:/root/.npm，npm 缓存落宿主、跨构建复用
  - npm config set registry https://registry.npmmirror.com，跨境改境内
  - npm install 加 --prefer-offline，优先命中宿主缓存
- 预期 13min → 3~5min；首次构建缓存为空不改善，第二次起见效
---
 .gitea/workflows/build.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml
index 3ff0d92..c8aacd2 100644
--- a/.gitea/workflows/build.yml
+++ b/.gitea/workflows/build.yml
@@ -56,16 +56,23 @@ jobs:
           BUILD_CONTAINER="frontbuild-${GITHUB_RUN_ID:-0}-$(date +%s)"
           echo "BUILD_CONTAINER=${BUILD_CONTAINER}"
           docker rm -f "$BUILD_CONTAINER" 2>/dev/null || true
-          docker run -d --name "$BUILD_CONTAINER" -w /build node:20 sleep 3600
+          # npm 缓存落宿主持久目录，跨构建复用（照 notice/service 的 m2 缓存做法）；无此卷则每次从零下载 754 个包
+          mkdir -p /opt/docker/projman-npm-cache
+          docker run -d --name "$BUILD_CONTAINER" \
+            -v /opt/docker/projman-npm-cache:/root/.npm \
+            -w /build node:20 sleep 3600
           docker cp "${PWD}/." "$BUILD_CONTAINER":/build/
           docker exec "$BUILD_CONTAINER" sh -c '
             set -e
             cd /build
+            # 内网到 registry.npmjs.org 跨境极慢（实测 npm install 12分46秒/754 包），切国内镜像
+            npm config set registry https://registry.npmmirror.com
             if [ -f .npmrc ]; then sed -i "/SASS_BINARY_PATH/d" .npmrc; fi
             # 本仓不提交 lock（.gitignore 忽略 yarn.lock/package-lock 均无），npm ci 无 lock 必 EUSAGE——用 install。
             # --ignore-scripts：依赖里的 node-sass@6 是 webpack 遗留（vite 5 实际走 dart-sass），
             # 其 node-gyp 编译在 node:20 无预编译包必炸；esbuild 二进制走 optionalDependencies 不受影响。
-            npm install --ignore-scripts --no-audit --no-fund --loglevel=error
+            # --prefer-offline：优先用 /root/.npm 缓存，避免重复下载
+            npm install --ignore-scripts --no-audit --no-fund --loglevel=error --prefer-offline
             npm run build
           '
           echo "=== dist 产物 ==="