agentworkshop 0.7.34 → 0.7.38

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
     }
   }

package/scripts/_audit/fix-settings-count.mjs

@@ -0,0 +1,57 @@
+/**
+ * fix-settings-count.mjs —— 按 schema.json 的实时统计改写文档里的设置项数量断言
+ * 起因:新增一个设置项(workshop.stall_ms)后,README / 首页 / CLI 手册里的"98 个设置项"
+ * 全部过期 —— 这类数字散落在 10 个文件里,手工同步必漏。这里统一改,并由
+ * scripts/check-docs-sync.mjs 的 [7/7] 段做回归守卫。
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const ROOT = resolve(HERE, '..', '..')
+const schema = JSON.parse(readFileSync(join(ROOT, 'shared/config/schema.json'), 'utf8'))
+const all = Array.isArray(schema.settings) ? schema.settings : Object.values(schema.settings)
+const TOTAL = all.length
+const GROUPS = new Set(all.map(s => s.group)).size
+const LIVE = all.filter(s => (s.applies ?? 'live') === 'live').length
+const RESTART = all.filter(s => s.applies === 'restart').length
+console.log(`schema.json:${TOTAL} 项 / ${GROUPS} 组 / live ${LIVE} / restart ${RESTART}`)
+
+const FILES = [
+  'README.md', 'README-zh.md',
+  'docs/site/index.md', 'docs/site/en/index.md',
+  'docs/site/guide/configuration.md', 'docs/site/en/guide/configuration.md',
+  'docs/cli.md', 'docs/cli.en.md',
+  'docs/site/cli/index.md', 'docs/site/en/cli/index.md',
+  'docs/plugins.md', 'docs/plugins.en.md',
+  'docs/sdk.md', 'docs/sdk.en.md',
+  'docs/site/sdk/guide.md', 'docs/site/en/sdk/guide.md',
+  'docs/site/plugins/guide.md', 'docs/site/en/plugins/guide.md',
+]
+
+/** 旧数字 → 新数字:只替换"紧跟设置项/组语义词"的数字,避免误伤版本号与端口 */
+const RULES = [
+  [/\b98\b(?=[^\n]{0,12}(个设置项|个运行时设置项|settings|descriptors|设置项))/g, String(TOTAL)],
+  [/32 live\s*\/\s*66 restart/g, `${LIVE} live / ${RESTART} restart`],
+  [/32 live\s*·\s*66 restart/g, `${LIVE} live · ${RESTART} restart`],
+  [/\b16 组\b/g, `${GROUPS} 组`],
+  [/\b16 groups\b/g, `${GROUPS} groups`],
+]
+
+let changed = 0
+for (const rel of FILES) {
+  const p = join(ROOT, rel)
+  if (!existsSync(p)) continue
+  const before = readFileSync(p, 'utf8')
+  let after = before
+  for (const [re, rep] of RULES) after = after.replace(re, rep)
+  // 只把"98"这一处旧值也覆盖掉(首个规则已处理带语义词的;这里兜底处理 98 个设置项 的中文形态)
+  after = after.replace(new RegExp(`\\b98\\b(?=[^\\n]{0,12}(个设置项|个运行时设置项))`, 'g'), String(TOTAL))
+  if (after !== before) {
+    writeFileSync(p, after)
+    changed++
+    console.log(`  ✔ ${rel}`)
+  }
+}
+console.log(`\n共修改 ${changed} 个文件`)