refactor: restructure CI/CD pipelines with cached dependencies, separate setup job, and multi-browser builds

.github/workflows/release.yml

@@ -9,9 +9,9 @@ permissions:
   contents: write
 
 jobs:
-  # ── Phase 1: 全量 CI 检查 ────────────────────────────────────────────
-  lint:
-    name: Lint
+  # ── Phase 1: 依赖统一前置基础架构（Infrastructure Stage） ───────────────────
+  setup:
+    name: Prepare Dependencies
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -21,90 +21,133 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+
+      - name: Cache Node Modules
+        id: cache-nodemodules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-release-v22-
 
       - name: Install dependencies
+        if: steps.cache-nodemodules.outputs.cache-hit != 'true'
         run: npm ci
 
+  # ── Phase 2: 全量生产级断言检查（秒级瞬时恢复缓存，安全闭环） ──────────────────
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    needs: setup
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Restore Node Modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
       - name: Run ESLint
         run: npm run lint
 
   typecheck:
     name: TypeScript Check
     runs-on: ubuntu-latest
+    needs: setup
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
+      - name: Restore Node Modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
       - name: Run TypeScript type check
         run: npm run compile
 
   test:
     name: Unit Tests
     runs-on: ubuntu-latest
+    needs: setup
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
+      - name: Restore Node Modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
       - name: Run tests
         run: npm run test
 
-  # ── Phase 2: 打包 & 发布 ─────────────────────────────────────────────
-  release:
-    name: Package & Release
+  # ── Phase 3: 多端分布式高精打包（Compile & Upload Artifacts） ───────────────
+  build-extension:
+    name: Package Extension
     runs-on: ubuntu-latest
-    needs: [lint, typecheck, test]
+    needs: [ lint, typecheck, test ]
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm'
+      - name: Restore Node Modules
+        uses: actions/cache@v4
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
 
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Package Chrome extension
-        run: npm run zip
-
-      - name: Package Firefox extension
-        run: npm run zip:firefox
-
-      - name: Find zip artifacts
-        id: find_zips
+      # 执行 WXT 高阶打包压缩指令
+      - name: Build and Zip Extension
         run: |
-          CHROME_ZIP=$(find .output -name "*.zip" | grep -v firefox | head -1)
-          FIREFOX_ZIP=$(find .output -name "*.zip" | grep firefox | head -1)
-          echo "chrome_zip=$CHROME_ZIP" >> "$GITHUB_OUTPUT"
-          echo "firefox_zip=$FIREFOX_ZIP" >> "$GITHUB_OUTPUT"
-          echo "Found Chrome zip: $CHROME_ZIP"
-          echo "Found Firefox zip: $FIREFOX_ZIP"
+          npm run zip
+          npm run zip:firefox
+
+      # 💡 核心自愈补丁：显式将 .output 下打包出的真实生产绝对路径文件，
+      # 稳固地上存至 GitHub 的常驻产物箱中进行安全物理隔离，防范后期发布网络崩溃导致产物蒸发！
+      - name: Upload Extension Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: extension-zips
+          path: |
+            .output/*.zip
+          retention-days: 7
+
+  # ── Phase 4: 独立中央签发发布（Atomic Release Publisher） ───────────────────
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: build-extension
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      # 💡 独立下载打包完好的绝对产物包
+      - name: Download Extension Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: extension-zips
+          path: release-artifacts
 
       - name: Extract version from tag
         id: version
         run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
 
+      # 💡 最终无风险原子级发布大礼包
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
@@ -113,6 +156,6 @@ jobs:
           draft: false
           prerelease: ${{ contains(github.ref_name, '-') }}
           generate_release_notes: true
+          # 百分之百精准指向被下载下来的、毫无路径污染风险的 Zip 包实体
           files: |
-            ${{ steps.find_zips.outputs.chrome_zip }}
-            ${{ steps.find_zips.outputs.firefox_zip }}
+            release-artifacts/*.zip