diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a437ec4..4376923 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -34,9 +34,14 @@ jobs:
     steps:
       - uses: actions/checkout@v7
 
-      - uses: actions/setup-node@v4
+      # v7 targets the Node.js 24 runtime; v4 targeted Node.js 20, which GitHub
+      # is deprecating (it was being force-run on Node.js 24 with a warning).
+      # v7 使用 Node.js 24 runtime；v4 面向已弃用的 Node.js 20（会被强制以 Node 24 运行并告警）。
+      - uses: actions/setup-node@v7
         with:
-          node-version: '20'
+          # Node.js 20 has reached end of maintenance; 22 is the LTS used to
+          # build the site. Node.js 20 已结束维护期，改用 LTS 版本 22 构建站点。
+          node-version: '22'
           cache: 'npm'
           cache-dependency-path: website/package-lock.json