agentworkshop 0.7.34 → 0.7.37

package/scripts/_audit/docs-shots.mjs

@@ -0,0 +1,171 @@
+/**
+ * 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

@@ -0,0 +1,255 @@
+/**
+ * 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)

package/scripts/_audit/docs-vue-lint.mjs

@@ -0,0 +1,81 @@
+/**
+ * docs-vue-lint.mjs —— 找出 VitePress「Element is missing end tag」的真实来源行
+ * ------------------------------------------------------------
+ * VitePress 报的行列号是**生成代码**里的位置,对不上源文件,人工排查很费时。
+ * 这里改用逐行二分:把 markdown 的正文按行累加交给 @vue/compiler-dom 编译,
+ * 第一次编译失败的那一行就是罪魁。行内代码/围栏代码先剥掉(markdown-it 会转义它们)。
+ *
+ * 用法:node scripts/_audit/docs-vue-lint.mjs docs/site/plugins/guide.md [更多文件...]
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const ROOT = resolve(HERE, '..', '..')
+
+const compilerEntry = join(ROOT, 'docs', 'site', 'node_modules', '@vue', 'compiler-dom', 'dist', 'compiler-dom.cjs.js')
+if (!existsSync(compilerEntry)) {
+  console.error('✖ 未找到 @vue/compiler-dom(需先 cd docs/site && npm i)')
+  process.exit(2)
+}
+const { compile } = await import(pathToFileURL(compilerEntry).href)
+
+/** 粗略还原 markdown-it 的输出:去掉围栏与行内代码,保留其余原样 */
+function toTemplateSource(md) {
+  const noFm = md.replace(/^---\n[\s\S]*?\n---\n/, '')
+  const out = []
+  let inFence = false
+  for (const line of noFm.split('\n')) {
+    if (/^\s*```/.test(line)) {
+      inFence = !inFence
+      out.push('')
+      continue
+    }
+    if (inFence) {
+      out.push('')
+      continue
+    }
+    // 行内代码 → 替换为等长占位,保持列号大致可用
+    out.push(line.replace(/`[^`\n]*`/g, m => 'x'.repeat(m.length)))
+  }
+  return out
+}
+
+const files = process.argv.slice(2)
+if (!files.length) {
+  console.error('用法:node scripts/_audit/docs-vue-lint.mjs <markdown> [更多]')
+  process.exit(2)
+}
+
+let bad = 0
+for (const rel of files) {
+  const p = resolve(ROOT, rel)
+  if (!existsSync(p)) {
+    console.log(`· ${rel} 不存在,跳过`)
+    continue
+  }
+  const lines = toTemplateSource(readFileSync(p, 'utf8'))
+  let firstBad = -1
+  let message = ''
+  for (let i = 1; i <= lines.length; i++) {
+    const chunk = lines.slice(0, i).join('\n')
+    try {
+      compile(chunk, { onError: (e) => { throw e } })
+    }
+    catch (err) {
+      firstBad = i
+      message = err?.message ?? String(err)
+      break
+    }
+  }
+  if (firstBad === -1) {
+    console.log(`✔ ${rel} 模板可编译(${lines.length} 行)`)
+    continue
+  }
+  bad++
+  console.log(`✖ ${rel}:${firstBad} → ${message}`)
+  console.log(`     ${JSON.stringify(lines[firstBad - 1].slice(0, 160))}`)
+}
+
+process.exit(bad ? 1 : 0)

package/scripts/_audit/docs-vue-lint2.mjs

@@ -0,0 +1,91 @@
+/**
+ * docs-vue-lint2.mjs —— 用 VitePress 真实的 markdown 管线定位「Element is missing end tag」
+ * ------------------------------------------------------------
+ * 第一版(docs-vue-lint.mjs)只做逐行近似,漏掉了 markdown-it 才会做的转换
+ * (自动链接、HTML 块、`~` 围栏、属性里的尖括号等)。这里改成:
+ *   md --(vitepress createMarkdownRenderer)--> html --(@vue/compiler-dom)--> 报错
+ * 再从 HTML 片段里回找源文件里对应的那一行。
+ *
+ * 用法:node scripts/_audit/docs-vue-lint2.mjs docs/site/plugins/guide.md
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const ROOT = resolve(HERE, '..', '..')
+const SITE = join(ROOT, 'docs', 'site')
+
+const { createMarkdownRenderer } = await import(pathToFileURL(join(SITE, 'node_modules', 'vitepress', 'dist', 'node', 'index.js')).href)
+const { compile } = await import(pathToFileURL(join(SITE, 'node_modules', '@vue', 'compiler-dom', 'dist', 'compiler-dom.cjs.js')).href)
+
+const md = await createMarkdownRenderer(SITE, {}, '/AgentWorkShop/')
+
+const files = process.argv.slice(2)
+if (!files.length) {
+  console.error('用法:node scripts/_audit/docs-vue-lint2.mjs <markdown> [更多]')
+  process.exit(2)
+}
+
+/** 从 HTML 里摘出「最像未闭合标签」的片段,用于回找源行 */
+function suspects(html) {
+  const out = new Set()
+  const re = /<\/?([a-zA-Z][\w-]*)(\s[^>]*)?\/?>/g
+  const KNOWN = new Set(['div', 'span', 'p', 'a', 'b', 'i', 'em', 'strong', 'code', 'pre', 'br', 'img', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'ul', 'ol', 'li', 'table', 'thead', 'tbody', 'tr', 'th', 'td', 'blockquote', 'hr', 'details', 'summary', 'kbd', 'sub', 'sup', 'figure', 'figcaption', 'input', 'section', 'picture', 'source', 'video', 'small'])
+  let m
+  while ((m = re.exec(html)) !== null) {
+    const tag = m[1]
+    if (KNOWN.has(tag) || tag.includes('-')) continue
+    out.add(m[0])
+  }
+  return [...out]
+}
+
+let failed = 0
+for (const rel of files) {
+  const p = resolve(ROOT, rel)
+  if (!existsSync(p)) {
+    console.log(`· ${rel} 不存在,跳过`)
+    continue
+  }
+  const src = readFileSync(p, 'utf8')
+  const html = md.render(src, { path: rel, relativePath: rel })
+  let err = null
+  try {
+    compile(html, { onError: (e) => { throw e } })
+  }
+  catch (e) {
+    err = e
+  }
+  if (!err) {
+    console.log(`✔ ${rel} 真实管线可编译`)
+    continue
+  }
+  failed++
+  console.log(`✖ ${rel} → ${err.message}`)
+  const list = suspects(html)
+  if (!list.length) {
+    console.log('     HTML 里没找到可疑自定义标签;可能是属性值/注释里的尖括号')
+  }
+  for (const s of list) {
+    // 在源码里搜同一片段(可能被 markdown-it 原样透传)
+    const srcLines = src.split('\n')
+    const hit = srcLines.findIndex(l => l.includes(s))
+    console.log(`     可疑: ${JSON.stringify(s)}  → 源文件第 ${hit === -1 ? '?' : hit + 1} 行`)
+    if (hit >= 0) console.log(`         ${JSON.stringify(srcLines[hit].trim().slice(0, 140))}`)
+  }
+  // 若 HTML 里没有自定义标签,打印错误位置附近的 HTML 片段辅助定位
+  if (!list.length) {
+    const m = /\((\d+):(\d+)\)/.exec(err.message)
+    if (m) {
+      const lines = html.split('\n')
+      const ln = Number(m[1])
+      console.log(`     HTML 第 ${ln} 行附近:`)
+      for (let i = Math.max(0, ln - 2); i < Math.min(lines.length, ln + 1); i++) {
+        console.log(`       ${i + 1}| ${lines[i].slice(0, 160)}`)
+      }
+    }
+  }
+}
+
+process.exit(failed ? 1 : 0)

package/scripts/_audit/exp-cost-scaling.mjs

@@ -44,7 +44,10 @@ const q = []
 let dropped = 0
 const t1 = performance.now()
 for (let i = 0; i < 200_000; i++) {
-  if (q.length >= QUEUE_CAP) { q.shift(); dropped++ } // inproc.adapter.ts:35
+  if (q.length >= QUEUE_CAP) {
+    q.shift()
+    dropped++
+  } // inproc.adapter.ts:35
   q.push({ nodeId: 'n', value: i })
 }
 console.log(`B: 200k publish into cap-${QUEUE_CAP} inproc queue = ${(performance.now() - t1).toFixed(1)}ms (dropped ${dropped})`)

package/scripts/_audit/exp-envelope-and-png.mjs

@@ -24,7 +24,8 @@ try {
 }
 catch (err) {
   console.log('  batch FAILED (whole transaction rolls back):', err.message)
-  try { db.exec('ROLLBACK') } catch {}
+  try { db.exec('ROLLBACK') }
+  catch {}
   console.log('  rows after failure:', db.prepare('SELECT COUNT(*) c FROM daq_samples').get().c)
 }
 

package/scripts/_audit/exp-sweep-fairness.mjs

@@ -9,7 +9,6 @@
  */
 const SWEEP_INTERVAL = 250
 const BUDGET = 8
-const TICK_MS = 250
 
 function simulate({ nodes, intervalMs, budget = BUDGET, seconds = 60, sampleCostMs = 0 }) {
   const lastSampleAt = new Array(nodes).fill(Number.NEGATIVE_INFINITY)
@@ -27,7 +26,10 @@ function simulate({ nodes, intervalMs, budget = BUDGET, seconds = 60, sampleCost
       if (t < lastSampleAt[i] + effectiveInterval) continue
       started++
       counts[i]++
-      if (sampleCostMs > 0) { inFlight++; inFlightUntil.push({ i, doneAt: t + sampleCostMs }) }
+      if (sampleCostMs > 0) {
+        inFlight++
+        inFlightUntil.push({ i, doneAt: t + sampleCostMs })
+      }
       else lastSampleAt[i] = t
     }
   }