chore(ci): align node/pnpm versions (#399)

Author: ymkiux

.github/workflows/ci-docker-build.yml

@@ -35,12 +35,12 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version-file: '.node-version'
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: latest
+          package_json_file: web/package.json
 
       - name: Build frontend
         working-directory: web

.github/workflows/ci-wails-build.yml

@@ -31,7 +31,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version-file: ".node-version"
 
       - uses: pnpm/action-setup@v4
         with:
@@ -115,7 +115,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version-file: ".node-version"
 
       - uses: pnpm/action-setup@v4
         with:
@@ -182,7 +182,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version-file: ".node-version"
 
       - name: Install Linux Build Dependencies
         run: |

.github/workflows/e2e-playwright.yml

@@ -17,14 +17,14 @@ jobs:
           go-version-file: go.mod
           cache: true
 
-      - name: Build frontend
-        uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 9
+          node-version-file: '.node-version'
 
-      - uses: actions/setup-node@v4
+      - name: Build frontend
+        uses: pnpm/action-setup@v4
         with:
-          node-version: '22'
+          package_json_file: web/package.json
 
       - name: Install and build web
         working-directory: web

.github/workflows/lint.yml

@@ -15,13 +15,13 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 9
+          node-version-file: '.node-version'
 
-      - uses: actions/setup-node@v4
+      - uses: pnpm/action-setup@v4
         with:
-          node-version: '20'
+          package_json_file: web/package.json
 
       - name: Get pnpm store directory
         shell: bash
@@ -30,7 +30,7 @@ jobs:
       - uses: actions/cache@v4
         with:
           path: ${{ env.STORE_PATH }}
-          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('web/package.json') }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('web/pnpm-lock.yaml') }}
           restore-keys: |
             ${{ runner.os }}-pnpm-store-
 

.node-version

@@ -0,0 +1 @@
+22.11.0

.nvmrc

@@ -0,0 +1 @@
+22.11.0

README.md

@@ -114,6 +114,8 @@ go install github.com/wailsapp/wails/v2/cmd/wails@latest
 wails dev
 ```
 
+**Frontend requirements:** Node.js 22.11.0 (see `.node-version` / `.nvmrc`) and pnpm 10.7.0 (locked via `web/package.json`).
+
 ## Configure AI Coding Tools
 
 ### Claude Code

README_CN.md

@@ -114,6 +114,8 @@ go install github.com/wailsapp/wails/v2/cmd/wails@latest
 wails dev
 ```
 
+**前端开发环境要求：** Node.js 22.11.0（见 `.node-version` / `.nvmrc`）以及 pnpm 10.7.0（在 `web/package.json` 中锁定）。
+
 ## 配置 AI 编程工具
 
 ### Claude Code

web/package.json

@@ -4,6 +4,9 @@
   "version": "0.1.1",
   "type": "module",
   "packageManager": "pnpm@10.7.0",
+  "engines": {
+    "node": ">=22.11.0 <23"
+  },
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",