agentworkshop 0.7.59 → 0.7.61

package/scripts/_audit/docs-font-probe.mjs

@@ -1,68 +0,0 @@
-/**
- * docs-font-probe.mjs —— 判定"中文渲染重叠"是站点缺陷还是无头环境缺字体的伪影。
- * 方法:在目标浏览器里对同一串中文逐族测量 advance 宽度 + document.fonts.check(),
- * 再渲染一张纯 HTML 对照图(不加载站点 CSS)。若对照图同样重叠 → 环境缺 CJK 字体。
- */
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import puppeteer from 'puppeteer-core'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const REPO = resolve(HERE, '..', '..')
-const OUT = join(REPO, '.e2e-shots', 'docs-font')
-const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
-const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
-const EXEC = existsSync(EDGE) ? EDGE : CHROME
-
-const FAMILIES = [
-  'Punctuation SC', 'Inter', 'sans-serif', 'system-ui', 'ui-sans-serif',
-  'Microsoft YaHei', 'Microsoft YaHei UI', 'SimSun', 'SimHei', 'NSimSun',
-  'PingFang SC', 'Hiragino Sans GB', 'Noto Sans SC', 'Noto Sans CJK SC', 'Source Han Sans SC',
-  'DengXian', 'KaiTi', 'FangSong', 'Arial', 'Segoe UI', 'monospace', 'Consolas', 'Cascadia Mono',
-]
-
-mkdirSync(OUT, { recursive: true })
-const browser = await puppeteer.launch({
-  executablePath: EXEC,
-  headless: 'new',
-  args: ['--no-sandbox', '--disable-dev-shm-usage', '--force-device-scale-factor=1'],
-  defaultViewport: { width: 1200, height: 400 },
-})
-const page = await browser.newPage()
-
-const report = await page.evaluate((fams) => {
-  const SAMPLE = '首次启动时一切初始化进配置根'
-  const cv = document.createElement('canvas').getContext('2d')
-  const rows = []
-  for (const f of fams) {
-    cv.font = `16px "${f}"`
-    const w = cv.measureText(SAMPLE).width
-    const base = (() => { cv.font = '16px monospace'; return cv.measureText(SAMPLE).width })()
-    rows.push({ family: f, width: Number(w.toFixed(2)), sameAsMonospace: Math.abs(w - base) < 0.5, check: document.fonts.check(`16px "${f}"`) })
-  }
-  cv.font = '16px monospace'
-  const monoBase = Number(cv.measureText(SAMPLE).width.toFixed(2))
-  return { sample: SAMPLE, chars: SAMPLE.length, monoBase, rows }
-}, FAMILIES)
-
-console.log(`样本 ${report.chars} 字 · monospace 基准宽 ${report.monoBase}px(每字 ${(report.monoBase / report.chars).toFixed(2)}px)\n`)
-console.log('family'.padEnd(26), 'width'.padStart(9), '  sameAsMono  fonts.check')
-for (const r of report.rows) {
-  console.log(r.family.padEnd(26), String(r.width).padStart(9), '  ' + String(r.sameAsMonospace).padEnd(12) + String(r.check))
-}
-
-// 对照图:完全不使用站点 CSS 的最小 HTML,同一段中文
-const plain = `<!doctype html><meta charset="utf-8"><body style="background:#070b13;color:#e8eef8;margin:0;padding:24px">
-<p style="font:16px/1.8 sans-serif;max-width:640px">${report.sample} —— sans-serif 回退</p>
-<p style="font:16px/1.8 'Microsoft YaHei',sans-serif;max-width:640px">${report.sample} —— Microsoft YaHei 优先</p>
-<p style="font:16px/1.8 monospace;max-width:640px">${report.sample} —— monospace</p>
-</body>`
-const plainFile = join(OUT, 'plain.html')
-writeFileSync(plainFile, plain, 'utf8')
-await page.goto(`file:///${plainFile.replace(/\\/g, '/')}`, { waitUntil: 'load' })
-await new Promise(r => setTimeout(r, 300))
-await page.screenshot({ path: join(OUT, 'plain-contrast.png') })
-console.log(`\n对照图 → ${join(OUT, 'plain-contrast.png')}`)
-
-await browser.close()

package/scripts/_audit/docs-probe.mjs

@@ -1,107 +0,0 @@
-/**
- * docs-probe.mjs —— 文档站渲染诊断:正文段落计算样式 + 字体加载 + 首屏动画
- * 用于判定"文字发暗/重叠"是真实缺陷还是无头截图伪影。
- * 用法:node scripts/_audit/docs-probe.mjs [route]
- */
-import { createServer } from 'node:http'
-import { existsSync, mkdirSync, readFileSync, statSync } from 'node:fs'
-import { dirname, extname, join, normalize, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import puppeteer from 'puppeteer-core'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const REPO = resolve(HERE, '..', '..')
-const DIST = join(REPO, 'docs', 'site', '.vitepress', 'dist')
-const BASE_PATH = '/AgentWorkShop'
-const PORT = 3223
-const ROUTE = process.argv[2] ?? '/guide/getting-started'
-const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
-const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
-const EXEC = existsSync(EDGE) ? EDGE : CHROME
-
-const MIME = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8', '.json': 'application/json', '.svg': 'image/svg+xml', '.png': 'image/png', '.woff2': 'font/woff2', '.gif': 'image/gif', '.map': 'application/json' }
-
-function serve() {
-  return new Promise((ok) => {
-    const s = createServer((req, res) => {
-      let p = decodeURIComponent(new URL(req.url, 'http://x').pathname)
-      if (!p.startsWith(BASE_PATH)) { res.writeHead(404); res.end(); return }
-      p = p.slice(BASE_PATH.length) || '/'
-      let f = join(DIST, normalize(p).replace(/^(\.\.[/\\])+/, ''))
-      if (existsSync(f) && statSync(f).isDirectory()) f = join(f, 'index.html')
-      if (!existsSync(f) && !extname(f)) f = `${f}.html`
-      if (!existsSync(f)) { res.writeHead(404); res.end('nf'); return }
-      res.writeHead(200, { 'content-type': MIME[extname(f)] ?? 'application/octet-stream' })
-      res.end(readFileSync(f))
-    })
-    s.listen(PORT, '127.0.0.1', () => ok(s))
-  })
-}
-
-const server = await serve()
-const browser = await puppeteer.launch({
-  executablePath: EXEC,
-  headless: 'new',
-  args: ['--no-sandbox', '--disable-dev-shm-usage', '--force-device-scale-factor=1', '--hide-scrollbars'],
-  defaultViewport: { width: 1680, height: 1000 },
-})
-const page = await browser.newPage()
-const failed = []
-page.on('requestfailed', r => failed.push(`${r.url()} :: ${r.failure()?.errorText}`))
-page.on('response', (r) => { if (r.status() >= 400) failed.push(`HTTP ${r.status()} ${r.url()}`) })
-await page.goto(`http://127.0.0.1:${PORT}${BASE_PATH}${ROUTE}`, { waitUntil: 'networkidle2' })
-await page.evaluate(() => document.fonts?.ready).catch(() => {})
-await new Promise(r => setTimeout(r, 1500))
-
-const out = await page.evaluate(() => {
-  const pick = (el, props) => {
-    if (!el) return null
-    const cs = getComputedStyle(el)
-    const o = {}
-    for (const p of props) o[p] = cs.getPropertyValue(p)
-    const r = el.getBoundingClientRect()
-    o._rect = `${Math.round(r.width)}x${Math.round(r.height)} @${Math.round(r.x)},${Math.round(r.y)}`
-    o._text = (el.textContent ?? '').slice(0, 30)
-    return o
-  }
-  const props = ['color', 'font-family', 'font-size', 'font-weight', 'line-height', 'letter-spacing', 'opacity', 'transform', 'filter', 'animation-name', 'text-rendering', 'font-variant-ligatures', 'visibility', 'mix-blend-mode', 'background-color', 'writing-mode']
-  const ps = [...document.querySelectorAll('.vp-doc p')]
-  return {
-    bodyBg: getComputedStyle(document.body).backgroundColor,
-    pCount: ps.length,
-    samples: ps.slice(0, 3).map(p => pick(p, props)),
-    h2: pick(document.querySelector('.vp-doc h2'), props),
-    code: pick(document.querySelector('.vp-doc div[class*="language-"] code'), props),
-    customBlock: pick(document.querySelector('.vp-doc .custom-block p'), props),
-    fonts: [...document.fonts].map(f => `${f.family} ${f.weight} ${f.status}`),
-    animations: document.getAnimations().map(a => `${a.animationName ?? a.constructor.name} @${a.playState}`),
-  }
-})
-
-console.log(JSON.stringify(out, null, 2))
-console.log('\n=== 失败请求 ===')
-console.log(failed.length ? failed.join('\n') : '(无)')
-
-// 1:1 元素截图:整体截图会被预览缩放,16px 中文在缩放后会被误判为"重叠不可读"。
-// 这里对正文段落按 deviceScaleFactor=2 单独出图,作为可读性的判据。
-await page.setViewport({ width: 1680, height: 1000, deviceScaleFactor: 2 })
-await page.reload({ waitUntil: 'networkidle2' })
-await page.evaluate(() => document.fonts?.ready).catch(() => {})
-await new Promise(r => setTimeout(r, 800))
-const cropDir = resolve(HERE, '..', '..', '.e2e-shots', 'docs-font')
-mkdirSync(cropDir, { recursive: true })
-const p = await page.$('.vp-doc p')
-if (p) {
-  const file = join(cropDir, `crop${ROUTE.replace(/\W+/g, '_')}.png`)
-  await p.screenshot({ path: file })
-  console.log(`\n正文段落 1:1 ×2 → ${file}`)
-}
-const h2 = await page.$('.vp-doc h2')
-if (h2) {
-  const file = join(cropDir, `crop-h2${ROUTE.replace(/\W+/g, '_')}.png`)
-  await h2.screenshot({ path: file })
-  console.log(`二级标题 1:1 ×2 → ${file}`)
-}
-
-await browser.close()
-server.close()

package/scripts/_audit/docs-shots.mjs

@@ -1,171 +0,0 @@
-/**
- * docs-shots.mjs —— VitePress 文档站视觉走查截图(独立审计用)
- * ------------------------------------------------------------
- * 站点 base = '/AgentWorkShop/'(见 docs/site/.vitepress/config.mts),
- * 故这里起一个最小静态服务器把 dist 挂到该前缀下,再用本机 Edge/Chrome 截图。
- * 依赖:puppeteer-core + 本机浏览器(与 scripts/_audit/design-shots.mjs 同方案)。
- *
- * 用法:
- *   node scripts/_audit/docs-shots.mjs                       # 构建产物 → 默认 .e2e-shots/docs
- *   node scripts/_audit/docs-shots.mjs --out=D:\x\y           # 指定输出目录
- *   node scripts/_audit/docs-shots.mjs --port=3222            # 指定端口
- *   node scripts/_audit/docs-shots.mjs --width=1440           # 桌面宽度(默认 1680)
- */
-import { createServer } from 'node:http'
-import { existsSync, mkdirSync, readFileSync, statSync } from 'node:fs'
-import { dirname, extname, join, normalize, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import puppeteer from 'puppeteer-core'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const REPO = resolve(HERE, '..', '..')
-const DIST = join(REPO, 'docs', 'site', '.vitepress', 'dist')
-const BASE_PATH = '/AgentWorkShop'
-const OUT = (process.argv.find(a => a.startsWith('--out='))?.slice(6)) ?? join(REPO, '.e2e-shots', 'docs')
-const PORT = Number(process.argv.find(a => a.startsWith('--port='))?.slice(7) ?? 3222)
-const WIDTH = Number(process.argv.find(a => a.startsWith('--width='))?.slice(8) ?? 1680)
-
-const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
-const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
-const EXEC = existsSync(EDGE) ? EDGE : CHROME
-
-/** 走查页:首页(整页) + 各内容形态的代表页(折叠以下也要看,故 fullPage) */
-const PAGES = [
-  ['/', 'home', true],
-  ['/guide/getting-started', 'guide-getting-started', false],
-  ['/guide/daq-protocols', 'guide-daq-protocols', false],
-  ['/sdk/', 'sdk-index', false],
-  ['/sdk/context', 'sdk-context', false],
-  ['/plugins/', 'plugins-index', false],
-  ['/plugins/guide', 'plugins-guide', false],
-  ['/cli/', 'cli', false],
-  ['/guide/aml', 'guide-aml', false],
-  ['/en/', 'en-home', true],
-  ['/en/plugins/guide', 'en-plugins-guide', false],
-]
-
-const MIME = {
-  '.html': 'text/html; charset=utf-8',
-  '.js': 'text/javascript; charset=utf-8',
-  '.mjs': 'text/javascript; charset=utf-8',
-  '.css': 'text/css; charset=utf-8',
-  '.json': 'application/json; charset=utf-8',
-  '.svg': 'image/svg+xml',
-  '.png': 'image/png',
-  '.jpg': 'image/jpeg',
-  '.jpeg': 'image/jpeg',
-  '.gif': 'image/gif',
-  '.webp': 'image/webp',
-  '.woff2': 'font/woff2',
-  '.ico': 'image/x-icon',
-  '.map': 'application/json; charset=utf-8',
-}
-
-/** 把 dist 挂到 base 前缀下;未知路径回落到目录 index.html / 然后 404 */
-function serve() {
-  return new Promise((ok) => {
-    const server = createServer((req, res) => {
-      const url = new URL(req.url, `http://127.0.0.1:${PORT}`)
-      let p = decodeURIComponent(url.pathname)
-      if (!p.startsWith(BASE_PATH)) {
-        res.writeHead(404, { 'content-type': 'text/plain' })
-        res.end('outside base')
-        return
-      }
-      p = p.slice(BASE_PATH.length) || '/'
-      let file = join(DIST, normalize(p).replace(/^(\.\.[/\\])+/, ''))
-      try {
-        if (existsSync(file) && statSync(file).isDirectory()) file = join(file, 'index.html')
-        if (!existsSync(file) && !extname(file)) file = `${file}.html`
-        if (!existsSync(file)) {
-          res.writeHead(404, { 'content-type': 'text/plain' })
-          res.end('not found')
-          return
-        }
-        res.writeHead(200, { 'content-type': MIME[extname(file)] ?? 'application/octet-stream' })
-        res.end(readFileSync(file))
-      }
-      catch (err) {
-        res.writeHead(500, { 'content-type': 'text/plain' })
-        res.end(String(err?.message ?? err))
-      }
-    })
-    server.listen(PORT, '127.0.0.1', () => ok(server))
-  })
-}
-
-const sleep = ms => new Promise(r => setTimeout(r, ms))
-
-async function main() {
-  if (!existsSync(DIST)) {
-    console.error(`✖ 未找到构建产物:${DIST}\n  先执行:cd docs/site && npx vitepress build`)
-    process.exit(2)
-  }
-  if (!EXEC || !existsSync(EXEC)) {
-    console.error('✖ 未找到本机 Edge/Chrome')
-    process.exit(2)
-  }
-  mkdirSync(OUT, { recursive: true })
-  const server = await serve()
-  const base = `http://127.0.0.1:${PORT}${BASE_PATH}`
-  const browser = await puppeteer.launch({
-    executablePath: EXEC,
-    headless: 'new',
-    args: ['--no-sandbox', '--disable-dev-shm-usage', '--force-device-scale-factor=1', '--hide-scrollbars'],
-    defaultViewport: { width: WIDTH, height: 1000 },
-  })
-
-  const problems = []
-  let n = 0
-  try {
-    for (const [route, name, fullPage] of PAGES) {
-      const page = await browser.newPage()
-      const pageErrors = []
-      page.on('pageerror', e => pageErrors.push(String(e?.message ?? e)))
-      // 站点只声明 favicon.svg,浏览器仍会自动请求 /favicon.ico;这不是站点缺陷。
-      // 用带 URL 的 HTTP 失败事件判定,而不是靠 console 文案(它不含 URL)。
-      page.on('response', (r) => {
-        if (r.status() >= 400 && !r.url().endsWith('/favicon.ico')) pageErrors.push(`HTTP ${r.status()} ${r.url()}`)
-      })
-      page.on('requestfailed', (r) => {
-        if (!r.url().endsWith('/favicon.ico')) pageErrors.push(`REQUEST FAILED ${r.url()}`)
-      })
-      const resp = await page.goto(`${base}${route}`, { waitUntil: 'networkidle2', timeout: 45_000 })
-      if (!resp || resp.status() >= 400) problems.push(`${route} → HTTP ${resp?.status()}`)
-      // 等字体与首屏动画落定(站点有入场动画;截到中途会误判为"元素缺失")
-      await page.evaluate(() => document.fonts?.ready).catch(() => {})
-      await sleep(700)
-      const file = join(OUT, `${String(++n).padStart(2, '0')}-${name}.png`)
-      await page.screenshot({ path: file, fullPage })
-      const title = await page.title()
-      const h1 = await page.$eval('h1', el => el.textContent?.trim() ?? '').catch(() => '(no h1)')
-      // 首页是自定义布局(无 <main>),故取 <main> 缺省回落到 body
-      const bodyLen = await page.evaluate(() => {
-        const root = document.querySelector('main') ?? document.querySelector('.hw-wrap') ?? document.body
-        return (root?.innerText ?? '').replace(/\s+/g, ' ').trim().length
-      })
-      console.log(`✔ ${route.padEnd(26)} h1=${JSON.stringify(h1).slice(0, 40).padEnd(42)} text=${bodyLen}`)
-      if (bodyLen < 200) problems.push(`${route} → 正文过短(${bodyLen} 字),疑似渲染失败`)
-      if (!title) problems.push(`${route} → 无 <title>`)
-      if (pageErrors.length) problems.push(`${route} → ${pageErrors.length} 个前端/请求错误: ${pageErrors.slice(0, 2).join(' | ')}`)
-      await page.close()
-    }
-  }
-  finally {
-    await browser.close()
-    server.close()
-  }
-
-  console.log(`\n截图 ${n} 张 → ${OUT}`)
-  if (problems.length) {
-    console.log(`\n✖ 发现 ${problems.length} 个问题:`)
-    for (const p of problems) console.log(`  · ${p}`)
-    process.exit(1)
-  }
-  console.log('✔ 全部页面渲染正常(有 h1 / 正文非空 / 无前端错误)')
-}
-
-main().catch((err) => {
-  console.error(err)
-  process.exit(1)
-})

package/scripts/_audit/docs-v3-verify.mjs

@@ -1,255 +0,0 @@
-/**
- * docs-v3-verify.mjs —— 逐条复验视觉评审提出的缺陷是否真的修好了
- * 每条断言都取自评审给出的**可测判据**,不做肉眼判断。
- * 用法:node scripts/_audit/docs-v3-verify.mjs
- */
-import { createServer } from 'node:http'
-import { existsSync, mkdirSync, readFileSync, statSync } from 'node:fs'
-import { dirname, extname, join, normalize, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import puppeteer from 'puppeteer-core'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const REPO = resolve(HERE, '..', '..')
-const DIST = join(REPO, 'docs', 'site', '.vitepress', 'dist')
-const BASE_PATH = '/AgentWorkShop'
-const PORT = 3225
-const OUT = join(REPO, '.e2e-shots', 'v3-verify')
-const EDGE = 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe'
-const CHROME = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
-const EXEC = existsSync(EDGE) ? EDGE : CHROME
-
-const MIME = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8', '.json': 'application/json', '.svg': 'image/svg+xml', '.png': 'image/png', '.woff2': 'font/woff2', '.gif': 'image/gif', '.map': 'application/json' }
-
-let pass = 0
-let fail = 0
-const check = (name, ok, detail = '') => {
-  if (ok) {
-    pass++
-    console.log(`  PASS  ${name}${detail ? '  — ' + detail : ''}`)
-    return
-  }
-  fail++
-  console.log(`  FAIL  ${name}${detail ? '  — ' + detail : ''}`)
-}
-
-function serve() {
-  return new Promise((ok) => {
-    const s = createServer((req, res) => {
-      let p = decodeURIComponent(new URL(req.url, 'http://x').pathname)
-      if (!p.startsWith(BASE_PATH)) {
-        res.writeHead(404)
-        res.end()
-        return
-      }
-      p = p.slice(BASE_PATH.length) || '/'
-      let f = join(DIST, normalize(p).replace(/^(\.\.[/\\])+/, ''))
-      if (existsSync(f) && statSync(f).isDirectory()) f = join(f, 'index.html')
-      if (!existsSync(f) && !extname(f)) f = `${f}.html`
-      if (!existsSync(f)) {
-        res.writeHead(404)
-        res.end('nf')
-        return
-      }
-      res.writeHead(200, { 'content-type': MIME[extname(f)] ?? 'application/octet-stream' })
-      res.end(readFileSync(f))
-    })
-    s.listen(PORT, '127.0.0.1', () => ok(s))
-  })
-}
-
-const relLum = ([r, g, b]) => {
-  const f = (c) => {
-    const v = c / 255
-    return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4
-  }
-  return 0.2126 * f(r) + 0.7152 * f(g) + 0.0722 * f(b)
-}
-const parseRgb = s => (s.match(/\d+(\.\d+)?/g) ?? []).slice(0, 3).map(Number)
-const contrast = (a, b) => {
-  const [l1, l2] = [relLum(a), relLum(b)].sort((x, y) => y - x)
-  return (l1 + 0.05) / (l2 + 0.05)
-}
-
-mkdirSync(OUT, { recursive: true })
-const server = await serve()
-const browser = await puppeteer.launch({
-  executablePath: EXEC,
-  headless: 'new',
-  args: ['--no-sandbox', '--disable-dev-shm-usage', '--force-device-scale-factor=1', '--hide-scrollbars'],
-  defaultViewport: { width: 1440, height: 900 },
-})
-const base = `http://127.0.0.1:${PORT}${BASE_PATH}`
-const open = async (route) => {
-  const page = await browser.newPage()
-  await page.goto(`${base}${route}`, { waitUntil: 'networkidle2' })
-  await page.evaluate(() => document.fonts?.ready).catch(() => {})
-  await new Promise(r => setTimeout(r, 700))
-  return page
-}
-
-try {
-  console.log('\n━━━ B1 代码高亮必须是暗色主题(每个 token ≥4.5:1)━━━')
-  {
-    const page = await open('/guide/getting-started')
-    const r = await page.evaluate(() => {
-      const pre = document.querySelector('.vp-doc div[class*="language-"]')
-      const bg = getComputedStyle(pre).backgroundColor
-      const seen = new Map()
-      for (const el of pre.querySelectorAll('span[style*="color"], span[class*="shiki"]')) {
-        const c = getComputedStyle(el).color
-        const txt = (el.textContent ?? '').trim()
-        if (!txt) continue
-        if (!seen.has(c)) seen.set(c, txt.slice(0, 16))
-      }
-      return { bg, colors: [...seen].map(([c, t]) => ({ c, t })) }
-    })
-    const bg = parseRgb(r.bg)
-    const bad = []
-    for (const { c, t } of r.colors) {
-      const ratio = contrast(parseRgb(c), bg)
-      if (ratio < 4.5) bad.push(`${c} (${ratio.toFixed(2)}:1) "${t}"`)
-    }
-    check(`代码 token 全部 ≥4.5:1(检查 ${r.colors.length} 色)`, bad.length === 0, bad.join('  '))
-    const strings = r.colors.find(x => x.c.replace(/\s/g, '') === 'rgb(3,47,98)')
-    check('浅色主题的 #032f62 已消失', !strings)
-    await page.close()
-  }
-
-  console.log('\n━━━ B2 入场动画必须真正命中元素 ━━━')
-  {
-    const page = await open('/guide/aml')
-    const r = await page.evaluate(() => {
-      const all = [...document.querySelectorAll('.vp-doc *')]
-      const anim = all.filter(e => getComputedStyle(e).animationName.includes('aw-rise'))
-      return { matched: anim.length, firstTag: anim[0]?.tagName ?? null, docChildren: document.querySelector('.vp-doc')?.children.length }
-    })
-    check('存在带 aw-rise 的元素', r.matched > 0, `matched=${r.matched} first=${r.firstTag} vpDocChildren=${r.docChildren}`)
-    await page.close()
-  }
-
-  console.log('\n━━━ B3 reduce 模式不得点亮全部侧栏刻度 ━━━')
-  {
-    const visible = async (reduce) => {
-      const page = await browser.newPage()
-      await page.emulateMediaFeatures([{ name: 'prefers-reduced-motion', value: reduce ? 'reduce' : 'no-preference' }])
-      await page.goto(`${base}/guide/aml`, { waitUntil: 'networkidle2' })
-      await new Promise(r => setTimeout(r, 500))
-      const n = await page.evaluate(() => {
-        let c = 0
-        for (const el of document.querySelectorAll('.VPSidebarItem.level-1')) {
-          const st = getComputedStyle(el.querySelector('.item'), '::before')
-          if (st.content && st.content !== 'none' && !/matrix\(\s*0[,)]/.test(st.transform) && st.transform !== 'none') c++
-          else if (st.content && st.content !== 'none' && st.transform.startsWith('matrix(1')) c++
-        }
-        return c
-      })
-      const total = await page.evaluate(() => document.querySelectorAll('.VPSidebarItem.level-1').length)
-      await page.close()
-      return { n, total }
-    }
-    const off = await visible(false)
-    const on = await visible(true)
-    check('no-preference 下恰好 1 个刻度可见', off.n === 1, `${off.n}/${off.total}`)
-    check('reduce 下同样只有 1 个刻度可见(未被反转)', on.n === off.n, `reduce=${on.n} vs normal=${off.n}`)
-  }
-
-  console.log('\n━━━ B5 / P1 焦点环不得改变圆角;CTA 不得被画绿线 ━━━')
-  {
-    const page = await open('/')
-    const r = await page.evaluate(() => {
-      const btn = document.querySelector('.hw-btn')
-      const before = getComputedStyle(btn).borderRadius
-      btn.focus()
-      const after = getComputedStyle(btn).borderRadius
-      const focusVisible = btn.matches(':focus-visible')
-      const bgImage = getComputedStyle(document.querySelector('.hw-btn.primary') ?? btn).backgroundImage
-      return { before, after, focusVisible, bgImage }
-    })
-    check('聚焦前后 border-radius 不变', r.before === r.after, `${r.before} → ${r.after}(focus-visible=${r.focusVisible})`)
-    check('CTA 上没有下划线渐变(绿色 1px 横线)', !/linear-gradient/.test(r.bgImage), r.bgImage.slice(0, 60))
-    await page.close()
-  }
-
-  console.log('\n━━━ P2 --aw-ghost 不得用作文字颜色 ━━━')
-  {
-    const page = await open('/cli/')
-    const r = await page.evaluate(() => {
-      const lang = document.querySelector('.vp-doc div[class*="language-"] > span.lang')
-      const pre = document.querySelector('.vp-doc div[class*="language-"]')
-      return lang ? { color: getComputedStyle(lang).color, bg: getComputedStyle(pre).backgroundColor } : null
-    })
-    if (!r) check('找到语言标签', false)
-    else {
-      const ratio = contrast(parseRgb(r.color), parseRgb(r.bg))
-      check(`语言标签对比度 ≥4.5:1`, ratio >= 4.5, `${r.color} on ${r.bg} = ${ratio.toFixed(2)}:1`)
-    }
-    await page.close()
-  }
-
-  console.log('\n━━━ P4 / P5 无内容可折射的表面不得使用 backdrop-filter ━━━')
-  {
-    const page = await open('/guide/getting-started')
-    const r = await page.evaluate(() => {
-      const bd = (sel) => {
-        const el = document.querySelector(sel)
-        return el ? getComputedStyle(el).backdropFilter : '(no element)'
-      }
-      return { sidebar: bd('.VPSidebar'), console: bd('.aw-console') }
-    })
-    check('桌面侧栏无 backdrop-filter', r.sidebar === 'none', r.sidebar)
-    const home = await open('/')
-    const c = await home.evaluate(() => {
-      const el = document.querySelector('.aw-console')
-      return el ? getComputedStyle(el).backdropFilter : '(no element)'
-    })
-    check('.aw-console 无 backdrop-filter', c === 'none', c)
-    await home.close()
-    await page.close()
-  }
-
-  console.log('\n━━━ P6 进度条不得压住导航顶缘高光 ━━━')
-  {
-    const page = await open('/guide/aml')
-    const r = await page.evaluate(() => getComputedStyle(document.querySelector('.VPNavBar')).boxShadow)
-    check('导航不再有顶缘 inset 高光(与进度条抢同两行)', !/inset/.test(r), r)
-    const bar = await page.evaluate(() => {
-      const st = getComputedStyle(document.body, '::before')
-      return { content: st.content, z: st.zIndex }
-    })
-    check('阅读进度条仍存在', bar.content !== 'none' && bar.content !== '', JSON.stringify(bar))
-    await page.close()
-  }
-
-  console.log('\n━━━ P8 / B4 390px 下中文标题不拆词、控制台标题不塌缩 ━━━')
-  {
-    const page = await browser.newPage()
-    await page.setViewport({ width: 390, height: 844 })
-    await page.goto(`${base}/`, { waitUntil: 'networkidle2' })
-    await new Promise(r => setTimeout(r, 700))
-    const r = await page.evaluate(() => {
-      const meta = document.querySelector('.aw-console-meta')
-      const title = document.querySelector('.aw-console-title')
-      const h1 = document.querySelector('.hw-title')
-      return {
-        metaDisplay: meta ? getComputedStyle(meta).display : '(none)',
-        titleClient: title?.clientWidth ?? 0,
-        titleScroll: title?.scrollWidth ?? 0,
-        h1WordBreak: h1 ? getComputedStyle(h1).wordBreak : '',
-        docScrollW: document.documentElement.scrollWidth,
-        winW: window.innerWidth,
-      }
-    })
-    check('390px 无横向滚动', r.docScrollW <= r.winW + 1, `scrollW=${r.docScrollW} win=${r.winW}`)
-    check('控制台标题获得足够宽度(不再只剩省略号)', r.titleClient >= 120, `client=${r.titleClient} scroll=${r.titleScroll} meta=${r.metaDisplay}`)
-    check('hero 标题 word-break: keep-all', r.h1WordBreak === 'keep-all', r.h1WordBreak)
-    await page.close()
-  }
-}
-finally {
-  await browser.close()
-  server.close()
-}
-
-console.log(`\n${fail ? '✖' : '✅'} v3 视觉复验:${pass} 通过 / ${fail} 失败`)
-process.exit(fail ? 1 : 0)