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 产物 ==="