agentworkshop 0.7.34 → 0.7.37

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} 个文件`)

package/scripts/_audit/glass-verify.mjs

@@ -0,0 +1,155 @@
+/**
+ * 玻璃材质验收 —— 用计算样式 + 像素统计双重取证,判定"毛玻璃是否真的在渲染"。
+ *
+ * 为什么必须实测:变量驱动的 backdrop-filter 曾在产物里只剩 `-webkit-` 前缀版,
+ * 而该前缀在 Chromium 已不受支持 → 计算值恒为 none、侧栏退化成纯色板,
+ * 单看源码完全看不出来(源码里两个属性都写着)。所以这里:
+ *   ① 读 getComputedStyle().backdropFilter(证明属性生效)
+ *   ② 统计侧栏/顶栏空白区的颜色簇数与 RGB 跨度(证明背后极光真的透出来)
+ *
+ * 用法:node scripts/_audit/glass-verify.mjs [base] [--out=dir]
+ */
+import { existsSync, mkdirSync } 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 BASE = (process.argv[2] ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+const OUT = (process.argv.find(a => a.startsWith('--out='))?.slice(6)) ?? join(REPO, '.e2e-shots', 'design')
+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 sleep = ms => new Promise(r => setTimeout(r, ms))
+
+async function main() {
+  mkdirSync(OUT, { recursive: true })
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox', '--hide-scrollbars'], defaultViewport: { width: 1680, height: 1050 } })
+  const page = await browser.newPage()
+
+  // 种鉴权 + 主题(与产品同一持久化键)
+  const lg = await fetch(`${BASE}/api/users/login`, {
+    method: 'POST', headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ email: 'admin@awshop.local', password: 'admin123' }),
+  }).then(r => r.json()).catch(() => null)
+  const token = lg?.data?.token ?? ''
+
+  let bad = 0
+  const say = (name, ok, detail = '') => {
+    console.log(`  ${ok ? '✔' : '✘'} ${name}${detail ? ` — ${detail}` : ''}`)
+    if (!ok) bad++
+  }
+
+  for (const theme of ['light', 'dark']) {
+    await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded' })
+    await page.evaluate((t, tok) => {
+      document.cookie = `token=${encodeURIComponent(tok)}; path=/`
+      document.cookie = `aw-theme=${t}; path=/`
+      localStorage.setItem('app', JSON.stringify({ isDark: t === 'dark', sidebarCollapsed: false, accent: '', themeTouched: true }))
+    }, theme, token)
+    await page.goto(`${BASE}/daq`, { waitUntil: 'networkidle2' })
+    await sleep(1400)
+
+    console.log(`\n=== ${theme} ===`)
+
+    // ① 计算样式:玻璃层是否真的带 blur
+    const computed = await page.evaluate(() => {
+      const grab = (sel) => {
+        const el = document.querySelector(sel)
+        if (!el) return null
+        const cs = getComputedStyle(el)
+        return { sel, backdropFilter: cs.backdropFilter, webkit: cs.webkitBackdropFilter, bg: cs.backgroundColor }
+      }
+      return {
+        sider: grab('.app-sider'),
+        header: grab('.app-header-glass'),
+        footer: grab('.app-footer'),
+        bench: grab('.aw-bench'),
+        supportsStd: CSS.supports('backdrop-filter', 'blur(10px)'),
+        supportsWebkit: CSS.supports('-webkit-backdrop-filter', 'blur(10px)'),
+      }
+    })
+    const blurOf = v => (v && v !== 'none' ? v : '')
+    say('浏览器支持标准 backdrop-filter', computed.supportsStd === true)
+    say('浏览器**不支持** -webkit- 前缀(故产物不能只留前缀版)', computed.supportsWebkit === false,
+      `supports('-webkit-backdrop-filter')=${computed.supportsWebkit}`)
+    say('.app-sider 毛玻璃生效', blurOf(computed.sider?.backdropFilter).includes('blur'),
+      computed.sider?.backdropFilter)
+    say('.app-header-glass 毛玻璃生效', blurOf(computed.header?.backdropFilter).includes('blur'),
+      computed.header?.backdropFilter)
+    say('.app-footer 毛玻璃生效', blurOf(computed.footer?.backdropFilter).includes('blur'),
+      computed.footer?.backdropFilter)
+    // 面板刻意不付 backdrop 成本(靠半透底+折射边),这里断言它确实没有(性能纪律)
+    say('.aw-bench 刻意不使用 backdrop-filter(性能取舍)', blurOf(computed.bench?.backdropFilter) === '',
+      computed.bench?.backdropFilter)
+
+    // ② 像素取证(因果判定):在**同一位置**分别采样"有玻璃"与"临时关掉 backdrop-filter"的渲染,
+    //    两者像素必须不同 —— 这直接证明玻璃在起视觉作用,且不受"该处背景恰好是纯色"的干扰
+    //    (只用"颜色簇数"判定会被极光几何坑到:极光没覆盖到的角落,正常玻璃也是纯色)。
+    const causal = await (async () => {
+      const geo = await page.evaluate((sel) => {
+        const el = document.querySelector(sel)
+        if (!el) return null
+        const r = el.getBoundingClientRect()
+        return { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) }
+      }, '.app-sider')
+      if (!geo) return null
+      // 侧栏中段:靠近极光中心区,且避开菜单文字(取上半段空白)
+      const clip = { x: geo.x + 3, y: geo.y + 70, width: Math.max(10, geo.w - 6), height: 60 }
+      const sample = async () => {
+        const b64 = await page.screenshot({ clip, encoding: 'base64' })
+        return await page.evaluate(async (data) => {
+          const img = new Image()
+          img.src = `data:image/png;base64,${data}`
+          await img.decode()
+          const c = document.createElement('canvas')
+          c.width = img.width
+          c.height = img.height
+          const ctx = c.getContext('2d')
+          ctx.drawImage(img, 0, 0)
+          const px = ctx.getImageData(0, 0, c.width, c.height).data
+          const clusters = new Set()
+          let span = 0
+          for (let i = 0; i < px.length; i += 4) {
+            clusters.add(`${px[i] >> 3}-${px[i + 1] >> 3}-${px[i + 2] >> 3}`)
+            span += px[i] + px[i + 1] + px[i + 2]
+          }
+          return { clusters: clusters.size, sum: span, n: px.length / 4, w: c.width, h: c.height }
+        }, b64)
+      }
+      const withGlass = await sample()
+      // 关掉玻璃(仅本元素,立刻还原)
+      await page.evaluate((sel) => {
+        const el = document.querySelector(sel)
+        el.dataset.awGlassBak = el.style.backdropFilter || ''
+        el.style.backdropFilter = 'none'
+      }, '.app-sider')
+      await sleep(220)
+      const noGlass = await sample()
+      await page.evaluate((sel) => {
+        const el = document.querySelector(sel)
+        el.style.backdropFilter = el.dataset.awGlassBak || ''
+      }, '.app-sider')
+      const meanA = withGlass.sum / withGlass.n
+      const meanB = noGlass.sum / noGlass.n
+      return { withGlass, noGlass, delta: Math.abs(meanA - meanB) }
+    })()
+    if (causal) {
+      // 判据:两者平均亮度必须可辨地不同(>0.5/765 ≈ 肉眼可分辨),即玻璃确实改变了像素
+      say('玻璃对渲染有实际影响(开/关玻璃像素不同)', causal.delta > 0.5,
+        `Δ亮度均值=${causal.delta.toFixed(2)} 有玻璃簇=${causal.withGlass.clusters} 无玻璃簇=${causal.noGlass.clusters}`)
+      await page.screenshot({ path: join(OUT, `glass-${theme}.png`) })
+    }
+    else {
+      say('侧栏可取证', false)
+    }
+  }
+
+  await browser.close()
+  console.log(`\n${bad === 0 ? '玻璃材质验收通过' : `${bad} 项未通过`}`)
+  process.exit(bad === 0 ? 0 : 1)
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/scripts/_audit/hydration-diff.mjs

@@ -0,0 +1,104 @@
+/**
+ * 水合差异定位 —— 把 SSR 产出的 HTML 与"水合前"的客户端 HTML 做结构对照。
+ *
+ * 思路:服务端渲染的 HTML 直接 fetch 得到;客户端 DOM 在 **hydration 之前**读不到
+ * (hydrate 与首帧几乎同拍),所以改为对照"服务端 HTML"与"水合后 DOM",
+ * 并把差异限定在**文本节点**上 —— 水合修复会改文本,结构差异则说明组件树分支不同。
+ * 输出前 N 条差异,足够指认是哪个字段在 SSR/CSR 两侧不一致。
+ *
+ * 用法:node scripts/_audit/hydration-diff.mjs [base] [path]
+ */
+import { existsSync } from 'node:fs'
+import puppeteer from 'puppeteer-core'
+
+const BASE = (process.argv[2] ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+const PATH = process.argv[3] ?? '/dcw'
+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
+
+/** 从整页 HTML 里切出 #__nuxt 容器(与服务端对照必须同一区域,否则会把 <head> 的
+ *  <title> 算成一条 SSR 独有文本节点 → 后续全部错位,得到一整屏假差异) */
+function nuxtContainer(html) {
+  const start = html.indexOf('<div id="__nuxt"')
+  if (start < 0) return html
+  const end = html.lastIndexOf('</div>')
+  return html.slice(start, end > start ? end : undefined)
+}
+
+/** 粗略取文本节点序列(去掉标签与多余空白),用于逐段对照 */
+function textNodes(html) {
+  return html
+    .replace(/<script[\s\S]*?<\/script>/g, ' ')
+    .replace(/<style[\s\S]*?<\/style>/g, ' ')
+    .replace(/<!--[\s\S]*?-->/g, ' ')
+    .replace(/<[^>]+>/g, '\u0001')
+    .split('\u0001')
+    .map(s => s.replace(/\s+/g, ' ').trim())
+    .filter(Boolean)
+}
+
+/** 元素标签流(class 简写),用于定位结构分支差异 */
+function tagStream(html) {
+  const out = []
+  const re = /<([a-zA-Z][\w-]*)((?:"[^"]*"|'[^']*'|[^>])*)>/g
+  let m
+  while ((m = re.exec(html))) {
+    const tag = m[1].toLowerCase()
+    if (tag === 'script' || tag === 'style') continue
+    const cls = /class="([^"]*)"/.exec(m[2] ?? '')?.[1] ?? ''
+    const short = cls.split(/\s+/).filter(c => c && !c.startsWith('data-v-') && !c.startsWith('css-')).slice(0, 3).join('.')
+    out.push(`${tag}${short ? `.${short}` : ''}`)
+  }
+  return out
+}
+
+async function main() {
+  // 服务端 HTML(不带 cookie,模拟全新访客)
+  const ssrRes = await fetch(`${BASE}${PATH}`)
+  const ssr = nuxtContainer(await ssrRes.text())
+  const ssrTexts = textNodes(ssr)
+
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox'], defaultViewport: { width: 1400, height: 900 } })
+  const ctx = await browser.createBrowserContext()
+  const page = await ctx.newPage()
+  await page.goto(`${BASE}${PATH}`, { waitUntil: 'networkidle2' })
+  // 直接取容器 outerHTML(已水合)
+  const dom = await page.evaluate(() => document.querySelector('#__nuxt')?.outerHTML ?? document.body.outerHTML)
+  const domTexts = textNodes(dom)
+  await browser.close()
+
+  // 结构对照优先:结构差异才是"组件树分支不同"的直接证据,文本差异常是其后果
+  const a = tagStream(ssr)
+  const b = tagStream(dom)
+  console.log(`元素数 SSR=${a.length} DOM=${b.length}`)
+  let shownStruct = 0
+  for (let i = 0; i < Math.max(a.length, b.length) && shownStruct < 10; i++) {
+    if (a[i] === b[i]) continue
+    shownStruct++
+    const from = Math.max(0, i - 2)
+    console.log(`\n  [结构首个差异 @${i}]`)
+    console.log(`    SSR: ${a.slice(from, i + 3).join(' > ')}`)
+    console.log(`    DOM: ${b.slice(from, i + 3).join(' > ')}`)
+    break
+  }
+  if (shownStruct === 0) console.log('  标签流完全一致(差异仅在文本/属性)')
+
+  console.log(`SSR 文本节点 ${ssrTexts.length} 个 / 水合后 ${domTexts.length} 个`)
+  const n = Math.max(ssrTexts.length, domTexts.length)
+  let shown = 0
+  for (let i = 0; i < n && shown < 25; i++) {
+    const a = ssrTexts[i]
+    const b = domTexts[i]
+    if (a === b) continue
+    shown++
+    console.log(`  [${i}] SSR=${JSON.stringify(a)?.slice(0, 90)}`)
+    console.log(`      DOM=${JSON.stringify(b)?.slice(0, 90)}`)
+  }
+  if (shown === 0) console.log('  未发现文本差异(不匹配可能来自属性而非文本)')
+}
+
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})

package/scripts/_audit/hydration-head.mjs

@@ -0,0 +1,36 @@
+/**
+ * 水合差异定位(局部)—— 打印 SSR 与水合后 DOM 的同一区域原始片段。
+ * 用法:node scripts/_audit/hydration-head.mjs [base] [path] [start] [len]
+ */
+import { existsSync } from 'node:fs'
+import puppeteer from 'puppeteer-core'
+
+const BASE = (process.argv[2] ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+const PATH = process.argv[3] ?? '/dcw'
+const START = Number(process.argv[4] ?? 0)
+const LEN = Number(process.argv[5] ?? 700)
+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
+
+async function main() {
+  const ssr = await (await fetch(`${BASE}${PATH}`)).text()
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox'], defaultViewport: { width: 1400, height: 900 } })
+  const ctx = await browser.createBrowserContext()
+  const page = await ctx.newPage()
+  await page.goto(`${BASE}${PATH}`, { waitUntil: 'networkidle2' })
+  const dom = await page.evaluate(() => document.querySelector('#__nuxt')?.outerHTML ?? '')
+  await browser.close()
+
+  const find = (html) => {
+    const i = html.indexOf('aw-sidebar')
+    return i >= 0 ? i : 0
+  }
+  for (const [label, html] of [['SSR', ssr], ['DOM', dom]]) {
+    const i = find(html) + START
+    console.log(`\n===== ${label} @${i} =====`)
+    console.log(html.slice(i, i + LEN))
+  }
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/scripts/_audit/hydration-probe.mjs

@@ -0,0 +1,59 @@
+/**
+ * 冷启动水合自检 —— 判断 "Hydration completed but contains mismatches" 是否产品自身问题。
+ * 三种上下文各开一个干净 profile:
+ *   A. 全新访客(无 cookie / 无 localStorage)
+ *   B. 仅主题 cookie(aw-theme=light / dark)
+ *   C. 主题 cookie + pinia 持久化 localStorage
+ * 若 A 也报 → 产品自身问题;仅 B/C 报 → 持久化水合问题。
+ */
+import { existsSync } from 'node:fs'
+import puppeteer from 'puppeteer-core'
+
+const BASE = (process.argv[2] ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
+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 PAGES = ['/', '/daq', '/dcw', '/settings']
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const CASES = [
+  ['A 全新访客', { theme: null, persisted: false }],
+  ['B 仅主题 cookie', { theme: 'light', persisted: false }],
+  ['C cookie + localStorage', { theme: 'light', persisted: true }],
+]
+
+async function main() {
+  const browser = await puppeteer.launch({ executablePath: EXEC, headless: 'new', args: ['--no-sandbox', '--hide-scrollbars'], defaultViewport: { width: 1400, height: 900 } })
+  for (const [label, cfg] of CASES) {
+    const ctx = await browser.createBrowserContext() // 干净 storage
+    const page = await ctx.newPage()
+    const msgs = []
+    page.on('console', (m) => {
+      if (m.type() === 'error') msgs.push(m.text())
+    })
+    // 先访问一次以便写 cookie/storage,再 reload 观察水合
+    await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded' })
+    await page.evaluate((c) => {
+      if (c.theme) document.cookie = `aw-theme=${c.theme}; path=/`
+      if (c.persisted) {
+        localStorage.setItem('app', JSON.stringify({ isDark: false, sidebarCollapsed: false, accent: '', themeTouched: true }))
+      }
+      else {
+        localStorage.clear()
+      }
+    }, cfg)
+    msgs.length = 0
+    const hits = []
+    for (const p of PAGES) {
+      await page.goto(`${BASE}${p}`, { waitUntil: 'domcontentloaded' })
+      await sleep(900)
+      const bad = msgs.filter(m => /[Hh]ydration/.test(m))
+      hits.push(`${p}:${bad.length}`)
+    }
+    console.log(`  ${label.padEnd(24)} 水合告警 ${hits.join('  ')}`)
+    await ctx.close()
+  }
+  await browser.close()
+}
+
+main().catch((e) => { console.error(e); process.exit(1) })

package/scripts/_audit/lead-matrix-test.mjs

@@ -0,0 +1,172 @@
+/**
+ * lead-matrix-test.mjs —— 判定「任务被取消」到底是不是 mock lead 的问题
+ * ------------------------------------------------------------
+ * 同一套任务文案、同一台服务器,只换 lead/worker 的 harness 组合:
+ *   A: lead=omp   + worker=omp     ← 用户的猜想:换成真实 harness lead 是否就正常
+ *   B: lead=mock  + worker=omp     ← 复现上一轮 CANCELED 的组合
+ *   C: lead=mock  + worker=mock    ← 已知可完成的对照组
+ *   D: lead=omp   + worker=mock    ← 隔离出「真实 lead 会不会正确调度一个确定性 worker」
+ *
+ * 每个组合:建 Channel → 建 worker → 入队 → 派任务 → 轮询到终态(带超时),
+ * 并把全过程的时间线打出来,便于定位卡在哪一步。
+ */
+import { writeFileSync } from 'node:fs'
+
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return (i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3112').replace(/\/$/, '')
+})()
+const PER_CASE_MS = Number((() => {
+  const i = process.argv.indexOf('--budget')
+  return i > 0 ? process.argv[i + 1] : 240_000
+})())
+const ONLY = (() => {
+  const i = process.argv.indexOf('--case')
+  return i > 0 ? process.argv[i + 1] : ''
+})()
+/**
+ * --bind:把既有产线的 3 数采 + 3 数控绑到本轮 worker 上。
+ * ⚠️ 不绑定的话,"汇报产线状态"这个任务对真实 LLM 是**无解的** —— 它会正确地
+ * 调用 line_context/my_industrial_nodes 查出"尚未绑定节点"然后拒绝执行
+ * (这本身是正确行为,但会把矩阵结果误读成"omp worker 不可用")。
+ */
+const DO_BIND = process.argv.includes('--bind')
+
+let TOKEN = null
+async function api(method, path, { body } = {}) {
+  const headers = { 'content-type': 'application/json' }
+  if (TOKEN) headers.authorization = `Bearer ${TOKEN}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+const data = r => r?.data ?? {}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+const t0 = Date.now()
+const stamp = () => `+${String(Math.round((Date.now() - t0) / 1000)).padStart(4)}s`
+
+const CASES = [
+  { id: 'A', lead: 'omp', worker: 'omp', label: '真实 harness lead + 真实 worker' },
+  { id: 'B', lead: 'mock', worker: 'omp', label: 'mock lead + 真实 worker(复现失败组合)' },
+  { id: 'C', lead: 'mock', worker: 'mock', label: 'mock lead + mock worker(对照组)' },
+  { id: 'D', lead: 'omp', worker: 'mock', label: '真实 harness lead + mock worker' },
+]
+
+TOKEN = data(await api('POST', '/api/users/login', { body: { email: 'plant@awshop.local', password: 'Plant!2026' } })).token
+if (!TOKEN) { console.error('✖ 登录失败'); process.exitCode = 2; throw new Error('login') }
+
+const results = []
+for (const c of CASES) {
+  if (ONLY && ONLY !== c.id) continue
+  console.log(`\n━━━ 组合 ${c.id}:${c.label}(lead=${c.lead} / worker=${c.worker})━━━`)
+  const tag = `${Date.now().toString(36).slice(-4)}`
+  const timeline = []
+  const mark = (msg) => { timeline.push(`${stamp()} ${msg}`); console.log(`  ${stamp()} ${msg}`) }
+
+  // lead 用 mock 时必须给 config.delayMs,否则 supervise 回合节奏不可控
+  const leadCfg = c.lead === 'mock' ? { delayMs: 40 } : {}
+  const created = await api('POST', '/api/workshop/channels', {
+    body: {
+      name: `矩阵-${c.id}-${tag}`,
+      description: `lead=${c.lead} worker=${c.worker}`,
+      leadAgent: { name: `调度长${c.id}-${tag}`, harness: c.lead, config: leadCfg },
+    },
+  })
+  const channelId = data(created).channelId ?? data(created).id
+  if (!channelId) {
+    mark(`✖ Channel 创建失败:${JSON.stringify(created).slice(0, 200)}`)
+    results.push({ case: c.id, ok: false, reason: 'channel create failed', timeline })
+    continue
+  }
+  mark(`Channel 建好 ${channelId.slice(0, 8)}`)
+
+  const workerCfg = c.worker === 'mock' ? { delayMs: 30 } : {}
+  const worker = data(await api('POST', '/api/workshop/agents', {
+    body: { name: `执行员${c.id}-${tag}`, harness: c.worker, config: workerCfg },
+  }))
+  if (!worker.id) {
+    mark(`✖ worker 创建失败:${JSON.stringify(worker).slice(0, 200)}`)
+    results.push({ case: c.id, ok: false, reason: 'worker create failed', timeline })
+    continue
+  }
+  await api('POST', `/api/workshop/channels/${channelId}/agents`, { body: { agentId: worker.id, role: 'worker' } })
+  mark(`worker 入队 ${worker.id.slice(0, 8)}`)
+
+  // 绑定工业节点:数采 auto(只读)/ 数控 manual(写入需审批)—— 不绑定则任务无数据源。
+  // ⚠️ 绑定主体必须是**频道成员 id**(worker.id 是 Agent 模板 id,会被接口拒绝)
+  let boundAgentId = worker.id
+  if (DO_BIND) {
+    const membersRaw = data(await api('GET', `/api/workshop/channels/${channelId}/agents`))
+    const members = Array.isArray(membersRaw) ? membersRaw : (membersRaw.agents ?? [])
+    const member = members.find(m => m.role === 'worker' && (m.templateId === worker.id || m.id === worker.id))
+    boundAgentId = member?.id ?? worker.id
+    const daqNodes = data(await api('GET', '/api/workshop/daq')).nodes ?? []
+    const dcwNodes = data(await api('GET', '/api/workshop/dcw')).nodes ?? []
+    let n = 0
+    const fails = []
+    for (const nd of daqNodes) {
+      const r = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: boundAgentId, nodeId: nd.id, kind: 'daq', mode: 'auto' } })
+      if (r.code === 0) n++
+      else fails.push(`${nd.name}: ${r.code}`)
+    }
+    for (const nd of dcwNodes) {
+      const r = await api('POST', '/api/workshop/agent-tools/bindings', { body: { agentId: boundAgentId, nodeId: nd.id, kind: 'dcw', mode: 'manual' } })
+      if (r.code === 0) n++
+      else fails.push(`${nd.name}: ${r.code}`)
+    }
+    const visible = data(await api('GET', `/api/workshop/agent-tools/bindings?agentId=${boundAgentId}`))
+    const vList = Array.isArray(visible) ? visible : (visible.bindings ?? [])
+    mark(`绑定工业节点 创建 ${n}/6 · 成员侧可见 ${vList.length}${fails.length ? ' · 失败:' + fails.join(',') : ''}`)
+  }
+
+  // 直发 worker(与上一轮失败的场景完全一致)
+  const taskRes = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
+    body: {
+      title: `巡检-${c.id}-${tag}`,
+      parts: [{
+        text: DO_BIND
+          ? '用 daq_query 读取已绑定的三路数采最近 5 分钟数据,汇总均值与波动并给出稳态判定,然后把结论写进 complete_task。'
+          : '汇报当前产线状态,给出稳态判定。',
+      }],
+      assigneeId: boundAgentId,
+    },
+  })
+  if (taskRes.status !== 200 || taskRes.code !== 0) {
+    mark(`✖ 任务创建失败:${JSON.stringify(taskRes).slice(0, 200)}`)
+    results.push({ case: c.id, ok: false, reason: `task create ${taskRes.status}`, timeline })
+    continue
+  }
+  const taskId = data(taskRes).task?.id ?? data(taskRes).id
+  mark(`任务下发 ${taskId.slice(0, 8)}(直发 worker)`)
+
+  const seen = new Set()
+  let final = null
+  const deadline = Date.now() + PER_CASE_MS
+  while (Date.now() < deadline) {
+    await sleep(2500)
+    const list = data(await api('GET', `/api/workshop/channels/${channelId}/tasks`)) ?? []
+    const me = (Array.isArray(list) ? list : []).find(x => x.id === taskId)
+    if (!me) continue
+    const key = `${me.state}:${me.progress}`
+    if (!seen.has(key)) {
+      seen.add(key)
+      mark(`任务状态 ${me.state} progress=${me.progress}`)
+    }
+    if (['COMPLETED', 'FAILED', 'CANCELED'].includes(me.state)) { final = me; break }
+  }
+  if (!final) {
+    const list = data(await api('GET', `/api/workshop/channels/${channelId}/tasks`)) ?? []
+    final = (Array.isArray(list) ? list : []).find(x => x.id === taskId) ?? { state: '(超时未终态)' }
+    mark(`超时:${final.state} progress=${final.progress ?? '?'}`)
+  }
+  const okDone = final?.state === 'COMPLETED'
+  mark(`${okDone ? '✅' : '✖'} 终态=${final?.state} progress=${final?.progress ?? '?'}`)
+  results.push({ case: c.id, lead: c.lead, worker: c.worker, ok: okDone, final: final?.state, progress: final?.progress, timeline })
+}
+
+console.log('\n━━━ 矩阵汇总 ━━━')
+for (const r of results) {
+  console.log(`  ${r.ok ? '✅' : '✖'}  ${r.case}  lead=${r.lead ?? '?'}/${r.worker ?? '?'}  终态=${r.final ?? r.reason}  progress=${r.progress ?? '?'}`)
+}
+writeFileSync('D:/codes/ABO/aw-plc-clean/lead-matrix.json', JSON.stringify(results, null, 2), 'utf8')
+console.log('\n明细已写入 D:/codes/ABO/aw-plc-clean/lead-matrix.json')
+process.exitCode = results.every(r => r.ok) ? 0 : 1

package/scripts/_audit/plc-agent-task.mjs

@@ -0,0 +1,74 @@
+/**
+ * plc-agent-task.mjs —— 在既有 Channel 上补一个可确定性完成的 Agent 任务
+ * ------------------------------------------------------------
+ * 背景:上一轮用 `mock` 调度长 + `omp` 工艺员派发巡检任务,任务在 90s 后变成 CANCELED,
+ * 且日志里**没有任何 spawn / dispatch 记录** —— 也就是 omp 根本没被拉起。
+ * 为把「Channel → 任务 → Agent 执行 → 终态」这条路走完并留证,这里:
+ *   ① 先用 mock 工艺员跑一次(确定性,验证链路本身可用)
+ *   ② 再打印 omp 那次的历史,便于如实报告
+ */
+const BASE = (() => {
+  const i = process.argv.indexOf('--base')
+  return (i > 0 ? process.argv[i + 1] : 'http://127.0.0.1:3112').replace(/\/$/, '')
+})()
+const ADMIN = { email: 'plant@awshop.local', password: 'Plant!2026' }
+
+// 记住登录态:helper 自动带上 token —— 之前每个调用点都要手写 token,
+// 漏一个就静默 401(data=undefined),排查成本很高。
+let TOKEN = null
+const api = async (method, path, { body } = {}) => {
+  const headers = { 'content-type': 'application/json' }
+  if (TOKEN) headers.authorization = `Bearer ${TOKEN}`
+  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
+  return { status: res.status, ...(await res.json().catch(() => ({}))) }
+}
+const data = r => r?.data ?? {}
+const sleep = ms => new Promise(r => setTimeout(r, ms))
+
+const login = await api('POST', '/api/users/login', { body: ADMIN })
+TOKEN = data(login).token
+if (!TOKEN) throw new Error('登录失败')
+
+const chRaw = data(await api('GET', '/api/workshop/channels'))
+const chans = Array.isArray(chRaw) ? chRaw : (chRaw.channels ?? [])
+const ch = chans[0]
+if (!ch) throw new Error('没有 Channel')
+console.log(`Channel: ${ch.name} (${ch.id})`)
+
+// ① mock 工艺员:确定性完成,证明 Channel 任务链路可用
+const worker = data(await api('POST', '/api/workshop/agents', {
+  body: { name: `巡检员-mock`, harness: 'mock', config: { delayMs: 30 } },
+}))
+await api('POST', `/api/workshop/channels/${ch.id}/agents`, { body: { agentId: worker.id, role: 'worker' } })
+console.log(`mock worker: ${worker.id}`)
+
+const task = await api('POST', `/api/workshop/channels/${ch.id}/tasks`, {
+  body: {
+    title: '工艺巡检(mock 链路验证)',
+    parts: [{ text: '读取三路数采最近数据并汇报稳态判定。' }],
+    assigneeId: worker.id,
+  },
+})
+const taskId = data(task).task?.id ?? data(task).id
+console.log(`task: ${taskId}`)
+
+let final = null
+for (let i = 0; i < 40; i++) {
+  const list = data(await api('GET', `/api/workshop/channels/${ch.id}/tasks`)) ?? []
+  const me = (Array.isArray(list) ? list : []).find(x => x.id === taskId)
+  if (me && ['COMPLETED', 'FAILED', 'CANCELED'].includes(me.state)) {
+    final = me
+    break
+  }
+  await sleep(1500)
+}
+console.log(`mock 任务终态: ${final?.state ?? '(超时未终态)'}`)
+console.log(final?.state === 'COMPLETED' ? '✅ Channel → 任务 → Agent 执行 → COMPLETED 链路可用' : `✖ 未完成: ${JSON.stringify(final).slice(0, 300)}`)
+
+// ② 如实打印上一轮 omp 任务的历史
+const all = data(await api('GET', `/api/workshop/channels/${ch.id}/tasks`)) ?? []
+console.log('\n全部任务:')
+for (const t of (Array.isArray(all) ? all : [])) {
+  console.log(`  ${t.state.padEnd(10)} ${t.title}  assignee=${String(t.assigneeId ?? '').slice(0, 8)} progress=${t.progress ?? 0}`)
+}
+process.exitCode = final?.state === 'COMPLETED' ? 0 : 1