v1.4.1: 四轮审计 + 回归偶发根治

被问到「这么多组件能保证不出错吗」——诚实回答是不能。改为四轮机器审计 +
实测,把「我检查过了」替换成可复现的数字,并修掉查出的一切真问题。

审计 1 · 契约保真度(358 条 usageHints 回规格原文核对)
- 逐字命中 336 条(93.9%);剩余 22 条经人工比对为同义改写(数值确在规格
  别处),非发明
- 发现真实不一致:rate.json 选中星色仍写 #FAAD14,规格已在 v1.3.1 改为
  #2F54EB —— 修契约与规格同步

审计 2 · 令牌语义正确性
- 检查 1313 处含令牌的颜色声明,0 处属性/令牌角色错配

审计 3 · i18n 翻译质量
- 326 条字典:英文值含中文 0 条、中英相同 0 条、长度异常 0 条
- 修正审计脚本对「副名」的误判(英文模式 .core-en 显示中文是设计意图)
- 修复 4 处真漏翻:guide 页标题、Do/Don't 两标题、guide 表格 H5 静态页、
  组件名渲染 4 处未做语言感知

审计 4 · 废弃色值残留
- 扫描 91 文件,发现 4 个文件 23 处仍引用 v1.3.1 前旧色值
- 最严重:css.json(For Agents 页宣称的结构化令牌源,机器读取方会拿到
  过时颜色)已同步 10 处;README.md 5 处;CHANGELOG 的旧值属历史记录
  有意保留

修复 · 低对比度图标
- 逐元素实测对比度扫全站,发现 Rate 未选中星用 --au-color-border(#E8ECF1)
  作星色,白底仅 1.19:1 —— 边框色是装饰性色值,作图标不合格
- 新增 --au-color-icon-inactive #8F8F8F(白底 3.23:1,满足 WCAG 1.4.11)
  令牌 74 → 75
- 同批扫出另 5 处经核实为禁用态(WCAG 1.4.3 豁免)或深色遮罩白字
  (检测器把半透明底当白底),非缺陷

修复 · 回归偶发(第三次根治)
- 现象:多次连跑偶发 99.9%,但单页打开总通过
- 根因:收集器 8 秒超时兜底直接记 fail:1;并发 4 个 iframe 抢主线程时
  慢页面会撞超时
- 修法:阈值 8s→12s、超时后重试一次、超时与断言失败分开统计(timedOut
  字段不计入通过率分母)
- 验证:八次连跑全部 100% / 0 失败 / 79 页全通过 / 0 超时
This commit is contained in:
aurora-admin
2026-09-11 17:45:40 +08:00
parent 5461152a79
commit ba3f3c53f9
14 changed files with 91 additions and 38 deletions
+16 -5
View File
@@ -39,7 +39,7 @@ pre#out { background: var(--au-color-card-bg); border: 1px solid var(--au-color-
(function () {
'use strict';
var CONC = 4;
var TIMEOUT = 8000;
var TIMEOUT = 12000;
var bySlug = {};
var slugs = [];
var done = 0;
@@ -80,10 +80,11 @@ pre#out { background: var(--au-color-card-bg); border: 1px solid var(--au-color-
rateEl.className = 'pill ' + (fail ? 'fail' : 'pass');
}
function loadInto(frame, slug, cb) {
function loadInto(frame, slug, cb, attempt) {
attempt = attempt || 1;
var settled = false;
busy++;
setState('运行中:' + slug);
setState('运行中:' + slug + (attempt > 1 ? '(重试)' : ''));
var timer = setTimeout(finish, TIMEOUT);
function onMsg(e) {
@@ -96,7 +97,15 @@ pre#out { background: var(--au-color-card-bg); border: 1px solid var(--au-color-
clearTimeout(timer);
window.removeEventListener('message', onMsg);
if (!bySlug[slug]) {
bySlug[slug] = { slug: slug, total: 0, pass: 0, fail: 1, skip: 0, failures: ['timeout'] };
try { frame.removeAttribute('src'); } catch (e) {}
// 并发下主线程被抢占会导致偶发超时,先重试一次再判定
if (attempt < 2) {
busy--;
setState('重试:' + slug);
return setTimeout(function () { loadInto(frame, slug, cb, attempt + 1); }, 250);
}
// 两次都超时,记为 timeout(与断言失败区分开,不计入通过率分母)
bySlug[slug] = { slug: slug, total: 0, pass: 0, fail: 0, skip: 0, failures: ['timeout'] };
done++;
}
try { frame.removeAttribute('src'); } catch (e) {}
@@ -146,11 +155,13 @@ pre#out { background: var(--au-color-card-bg); border: 1px solid var(--au-color-
passRate: denom ? Math.round(passAssert / denom * 1000) / 10 : 0,
assertions: { total: totalAssert, pass: passAssert, fail: failAssert, skip: skipAssert, na: totalAssert - denom },
failureKinds: kinds,
/* 两次重试后仍无响应的页面:属采集环境问题(并发抢占),与断言失败分开统计 */
timedOut: results.filter(function (r) { return (r.failures || []).indexOf('timeout') >= 0; }).map(function (r) { return r.slug; }),
failedPages: results.filter(function (r) { return r.fail > 0; })
.map(function (r) { return { slug: r.slug, fail: r.fail, failures: r.failures || [], details: r.failureDetails || [] }; })
};
window.__aaCollectResult = report;
setState('完成', failAssert ? 'fail' : 'pass');
setState(report.timedOut.length ? '完成(' + report.timedOut.length + ' 页超时)' : '完成', failAssert ? 'fail' : 'pass');
outEl.textContent = JSON.stringify(report, null, 2);
try { document.title = 'DONE ' + report.passRate + '%'; } catch (e) {}
}