Hexo主题功能测试-自动化测试篇

┌──────────────┐
│  L2 生产 URL  │  发版后：20 页面 HTTP 200 + 功能标记（curl）
│  L9/L10 SW   │  发版前：Vercel 测试域 SW 冒烟（playwright）
├──────────────┤
│  L11 Playwright 集成 │  真实浏览器：特效/词云/懒加载/阅读模式等 14 项
├──────────────┤
│  L13 单测门禁 │  node 直跑：13 个 .test.js + 3 个 shell 单测
├──────────────┤
│  L1 构建验证  │  hexo g Success + 产物完整（index.html > 1000B）
└──────────────┘

# 完整跑（构建 + 生产检查 + SW 冒烟 + playwright 集成）——发版门禁
tools/tests/release-test.sh

# 跳过构建（public/ 已就绪）
tools/tests/release-test.sh --skip-build

# 本地迭代（测 localhost:4000，跳过远程 SW 冒烟 L10 + playwright 集成 L11）
tools/tests/release-test.sh --local

# 仅跳过远程 SW 冒烟（保留 playwright 集成）
tools/tests/release-test.sh --skip-l10

# node 单测（纯单测/静态，无浏览器依赖）
unit-toc.test.js          # TOC 折叠配置（collapseDepth 0||6 falsy 陷阱）
unit-search.test.js       # 搜索三引擎
unit-multilang.test.js    # 多语言配置
unit-encrypt2.test.js     # 加密扩展（片段 + wiki）
unit-wiki-helper.test.js  # wiki helper
lang-fallback.test.js     # 回落链 4 级（13 断言）
echarts-charts.test.js    # ECharts 图表
banner-bg.test.js         # banner 与背景偏好联动
homepage.test.js          # 首页结构
imgsize-unit.test.js      # 图片尺寸
search-integration.test.js
infinite-scroll-aos.test.js
unit-standalone.test.js   # 独立页排除法判定 + 语言前缀豁免（22 断言）

# shell 单测
unit-css-architecture.test.sh   # CSS 架构（编译产物关键选择器）
unit-version.test.sh            # 版本递增进位（防 12.99→12.100）
unit-retry.test.sh              # 退避重试库

unit-encrypt.test.js      # 自研加密体系（AES-GCM + PBKDF2 闭环，9 用例）
unit-fontawesome.test.py  # FontAwesome 精简脚本

source tools/tests/lib/retry.sh

# exit-code 判定：退避重试 3 次（1s/4s/9s + 抖动）
retry_run "L2 搜索" "node tools/tests/search-integration.test.js"

# 输出模式判定（release-test L11 用）
retry_match "L2d 视频" "node .../videobg-integration.test.js" "PASS=.*FAIL=0"

const { interceptThirdParty, collectPageErrors } = require('./lib/browser-env');

const env = collectPageErrors(page, BASE);   // 持续累积 JS 异常 + 同源资源失败
await interceptThirdParty(page);             // 拦截已知污染源
// 断言：env.jsErrors.length === 0 && env.sameOriginFailures.length === 0

# 1. debug 构建（未压缩）
tools/cicd.sh -d
head -c 300 public/css/main.css   # 多行、带缩进、有注释

# 2. 压缩构建（-t 本地编译测试，压缩无 CDN）
tools/cicd.sh -t
head -c 300 public/css/main.css   # 单行、无注释、体积显著变小

console.log(`\n结果: PASS=${pass} FAIL=${fail}`);
process.exit(fail > 0 ? 1 : 0);