feat: P2 分发 + P3 CI(含三个实测发现的缺陷修复)

执行 ROADMAP 的 S1-P2(npm 分发)与 S1-P3(CI 回归)。

P3 · CI 回归流水线
- .github/workflows/regression.yml:push/PR 自动跑回归,失败阻断
  含 playwright 浏览器缓存、零依赖自检、服务就绪轮询、报告上传、
  GitHub Step Summary 输出
- tools/run-regression.mjs 重构:
  · 路径基于脚本位置(不再依赖 cwd,CI 更稳)
  · 环境自检:服务未起退出码 2、playwright 缺失退出码 2
  · 断言超时后重试一次(吸取 _collect.html 的偶发教训)
  · 超时与断言失败分开统计(timedOut 字段)
  · 失败时打印明细并 exit 1,全部通过 exit 0

P2 · npm 分发
- package.json:aurora-admin-design,dependencies 为空(零运行时依赖铁律)
  playwright 放 devDependencies(CI 专用)
- tools/build-dist.mjs:零依赖构建脚本,产出 dist/
  tokens/{tokens.css,tokens.json(DTCG),figma.json}
  components/{<slug>.css ×79, index.css 聚合, <slug>.html ×79}
  manifest.json(含 SHA 校验和) + README.md
- .npmignore / .gitignore 更新(dist/ node_modules/ 不入库)
- npm pack 实测:115.9 KB 压缩 / 566 KB 解压 / 167 文件 / 无 site|tests 泄漏

实测发现的三个缺陷(全部修复)
1. package.json 加 "type": "module" 会让 site/dev-server.js(CJS)崩溃
   —— 移除该字段,靠 .mjs 扩展名区分模块系统
2. dist 里 HTML 引用 ../tokens/colors_and_type.css 但产物是 tokens.css
   —— 路径对但文件不存在,产物是坏的。重写全部引用规则
   (含 index.css 的 @import 从 ./tokens/ 改为 ../tokens/)
3. 断言总数不确定:icon-contrast 是条件性推入(依赖渲染时机),
   导致同一页不同次运行总数不同(960 vs 961)
   —— 改为恒定输出一条(无问题=pass,有问题=skip),
   断言数从 960 稳定为 1038,连跑两次完全一致
4. 顺带修 na 与 skip 重复计算(na = total - denom,但 skip 已是同一批)
   —— 统一为 na = skip,算术自洽:pass+fail+skip = total

验证
- runner:passRate 100% | 79 页全通过 | 1003/1003 | N/A 35 | exit 0
- collector:完全同口径(total 1038 / pass 1003 / fail 0 / skip 35)
- dist:79/79 页面浏览器实测正常(令牌解析、无加载失败)
- 连跑两次数字完全一致(可复现)
This commit is contained in:
aurora-admin
2026-09-11 23:13:25 +08:00
parent f0e0d7ad1a
commit 8934ebb440
14 changed files with 796 additions and 62 deletions
+102
View File
@@ -0,0 +1,102 @@
name: Regression
# 每次 push / PR 自动跑回归。
# 目标:让质量不再依赖「人工记得跑」—— 这是 ROADMAP S1-P3 的核心价值。
#
# 说明:
# - playwright 是 devDependency(CI 专用工具),运行时依然零依赖。
# - dev-server 在 Ubuntu 上可正常跑(Node 脚本,跨平台)。
# - 失败时仍上传报告,便于排查。
on:
push:
branches: [main]
pull_request:
branches: [main]
workflow_dispatch:
jobs:
regression:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Cache playwright browsers
uses: actions/cache@v4
with:
path: ~/.cache/ms-playwright
key: ${{ runner.os }}-playwright-${{ hashFiles('package.json') }}
restore-keys: |
${{ runner.os }}-playwright-
- name: Install dependencies
run: npm ci || npm install
- name: Install playwright chromium
run: npx playwright install --with-deps chromium
- name: Verify zero runtime dependencies
run: |
node -e "
const p = require('./package.json');
const deps = Object.keys(p.dependencies || {});
if (deps.length) {
console.error('FAIL: 运行时依赖必须为空,实际: ' + deps.join(', '));
process.exit(1);
}
console.log('zero-dep OK');
"
- name: Start dev server
run: |
node site/dev-server.js &
# 等服务就绪(最多 15 秒)
for i in $(seq 1 30); do
if curl -sf http://127.0.0.1:3311/site/data.json > /dev/null; then
echo "server ready after ${i} attempt(s)"
exit 0
fi
sleep 0.5
done
echo "FAIL: dev-server 未在 15 秒内就绪"
exit 1
- name: Run regression
run: node tools/run-regression.mjs
- name: Upload report
uses: actions/upload-artifact@v4
if: always()
with:
name: regression-report
path: |
tests/report.json
tests/report-junit.xml
retention-days: 30
- name: Publish test summary
if: always()
run: |
if [ -f tests/report.json ]; then
node -e "
const r = require('./tests/report.json');
const a = r.assertions;
console.log('## 回归结果');
console.log('');
console.log('| 项 | 值 |');
console.log('|---|---|');
console.log('| 通过率 | ' + r.passRate + '% |');
console.log('| 断言 | ' + a.pass + '/' + (a.pass + a.fail) + ' |');
console.log('| N/A | ' + (a.na || 0) + ' |');
console.log('| 页面全通过 | ' + r.pagesAllPass + '/' + r.pages + ' |');
console.log('| 超时 | ' + ((r.timedOut || []).length) + ' |');
" >> \$GITHUB_STEP_SUMMARY
fi