AirShelf/core/qa/function-audit
zyc 890cb9ab67
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 2m2s
chore(core/qa): function-audit toolchain + parity/audit reports + pixel-perfect skill
- qa/function-audit: playwright 行为审计工具(audit.mjs/verify-modals.mjs/pages.json)
  + 18 页审计产出(*.audit.md/json、summary、运行日志)
- qa/visual-parity: 调试/测量辅助脚本(_dbg*.mjs/_measure.mjs/_off.mjs)
- core/还原度核对报告.md: 18 页 pixelmatch 核对结果(含 vite 代理陈旧坑记录)
- core/还原与接口待办.md: 逐页还原度/真实数据/交互接入待办总表
- .claude/skills/pixel-perfect-react: 像素级还原 React 的 SKILL 文档
- frontend/public/_devlogin.html: 临时本地登录辅助页(可删)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 09:41:30 +08:00
..

Function Audit · 逐页功能审计

visual-parity像素,这里比行为:把每个页面在真实 React 路由里打开, 逐个真实点击所有可交互元素,报出「点了没反应」的死交互(假按钮)。

完整说明见 skill:.claude/skills/page-function-audit/SKILL.md

快速开始

# 0. 先起前后端(见 skill)。后端必须 .venv/bin/python。
# 1. 装依赖(复用 visual-parity 的 playwright)
cd AirShelf/core/qa/function-audit && npm install
# 2. 跑
node audit.mjs                  # 全量(最准,慢)
node audit.mjs --only account   # 单页(改完复验)
node audit.mjs --mode quick     # 粗扫(快)
# 3. 读报告
open output/summary.md          # 全页一览,看 dead 列
open output/<page>.audit.md     # 单页 DEAD 表

判定口径

  • works — 点了有反应(URL/浮层/自身状态/网络/DOM 五路任一变)
  • dead — 点了五路全无反应 → 真缺陷,优先修(多半没接 onClick)
  • 🛑 error — 点击抛 JS 异常
  • ◷ noop-active — 点的是已选中 tab/chip,本该无反应,忽略
  • ⏭ skipped — 破坏性按钮(删除/充值/生成…)不自动点,人工验
  • 🔍 missing — 设计稿 /exact 有、React 没渲染(启发式,人工过)

参数

参数 默认 说明
--mode isolated isolated=逐元素 reload(准);quick=不 reload(快)
--only (全部) 逗号分隔页名子串,如 --only account,pipeline
--include-pointer off 额外把 cursor:pointer 的 div 当候选
--headed off 看着浏览器跑
--settle 700 点击后观察窗口 ms
--token / --email / --password 演示账号 登录态来源
--base http://127.0.0.1:5173 前端地址