fix(ci): add lighthouse timeout guards to prevent hanging runs

Author: zocs

.github/workflows/ci-quality.yml

@@ -37,10 +37,12 @@ jobs:
         run: npm run ci
 
       - name: Lighthouse Quality Gate
+        timeout-minutes: 8
         env:
           LH_MIN_PERFORMANCE: ${{ github.ref == 'refs/heads/master' && '95' || '90' }}
           LH_MIN_ACCESSIBILITY: "90"
           LH_MIN_BEST_PRACTICES: "90"
           LH_MIN_SEO: "100"
           LH_SKIP_BUILD: "1"
+          LH_TIMEOUT_MS: "120000"
         run: npm run audit:lighthouse

PROGRESS.md

@@ -3,7 +3,7 @@
 > 仓库：`/home/zocs/Devs/catcoding-web`
 > 用途：记录执行复盘、计划更新与下一轮任务
 
-## 当前状态（2026-04-28 01:37 CST）
+## 当前状态（2026-04-28 08:18 CST）
 
 - 站点框架：Astro 6，双语页面（`/` + `/zh/`）
 - 质量门禁：`npm run ci` 通过（`astro check` + `astro build`）
@@ -135,6 +135,15 @@
 - 实施：`ci-quality.yml` 的 `setup-node` 增加 `cache-dependency-path: package-lock.json`
 - 预期收益：runner 缓存命中更稳定，降低安装阶段耗时抖动
 
+## 本轮执行复盘（2026-04-28 上午第 17 轮）
+
+- code review：远端 `CI Quality` 出现长时间卡在 Lighthouse 步骤的风险
+- 实施：
+- `lighthouse-baseline.mjs` 为每次 Lighthouse 调用增加进程超时（默认 `LH_TIMEOUT_MS=120000`）
+- 增加 `--max-wait-for-load=45000`，限制页面加载等待时长
+- workflow 的 `Lighthouse Quality Gate` 步骤增加 `timeout-minutes: 8` 并传入 `LH_TIMEOUT_MS`
+- 验证：本地 `npm run ci:quality` 通过，分数保持 `P100 / A11y92 / BP96 / SEO100`
+
 ## 强制环节（与主仓库对齐）
 
 每轮自动推进必须执行：

scripts/lighthouse-baseline.mjs

@@ -14,8 +14,15 @@ function run(cmd, args, options = {}) {
       shell: false,
       env: process.env,
     });
+    let timer;
+    if (options.timeoutMs && Number.isFinite(options.timeoutMs)) {
+      timer = setTimeout(() => {
+        child.kill('SIGTERM');
+      }, options.timeoutMs);
+    }
     child.on('error', reject);
     child.on('exit', (code) => {
+      if (timer) clearTimeout(timer);
       if (code === 0) resolve();
       else reject(new Error(`${cmd} ${args.join(' ')} failed with code ${code}`));
     });
@@ -37,6 +44,7 @@ const thresholds = {
   bestPractices: Number(process.env.LH_MIN_BEST_PRACTICES ?? 90),
   seo: Number(process.env.LH_MIN_SEO ?? 100),
 };
+const lighthouseTimeoutMs = Number(process.env.LH_TIMEOUT_MS ?? 120000);
 
 function assertThreshold(route, score) {
   const failures = Object.entries(thresholds)
@@ -69,10 +77,11 @@ try {
       '--quiet',
       '--chrome-flags=--headless=new --no-sandbox',
       '--only-categories=performance,accessibility,best-practices,seo',
+      '--max-wait-for-load=45000',
       '--output',
       'json',
       `--output-path=${outputPath}`,
-    ]);
+    ], { timeoutMs: lighthouseTimeoutMs });
   };
 
   await runLighthouse('http://127.0.0.1:4321', reportPaths.home);