agentworkshop 0.7.59 → 0.7.61

package/scripts/_audit/dcw-rollback-ledger.ts

@@ -1,156 +0,0 @@
-/**
- * 审计实验 2 —— RecipeRollBackRepo 账本算法/落盘成本(只读审计)。
- *
- * 关键:cwd 切到 scripts/_audit/.tmp,使 repo 的 DATA_DIR 指向临时目录,
- * **绝不触碰 server/data/dcw-rollback.json**(真实数据文件)。
- *
- * 运行:node --experimental-transform-types scripts/_audit/run.mjs scripts/_audit/dcw-rollback-ledger.ts
- */
-import { mkdirSync } from 'node:fs'
-
-const TMP = new URL('./.tmp/', import.meta.url)
-mkdirSync(new URL('server/data/', TMP), { recursive: true })
-process.chdir(new URL('.tmp/', new URL('.', import.meta.url)).pathname.replace(/^\//, ''))
-
-const { RecipeRollBackRepo } = await import('../../server/services/workshop/dcw/recipe-rollback.repo')
-
-const CAP_ANCHORS = 20000
-const CAP_RECORDS = 2000
-
-function anchorOf(i: number, nodeId = `n-${i % 50}`) {
-  return {
-    lineId: 'ln-audit',
-    nodeId,
-    prevValue: i,
-    newValue: i + 1,
-    source: 'manual' as const,
-    actor: 'user',
-    recipeRunId: null,
-  }
-}
-
-/** 贴近真实形状的 windowAgg(实测 server/data/dcw-rollback.json:平均记录 1267 B) */
-function aggOf(nodeId: string) {
-  return {
-    at: new Date().toISOString(),
-    fromMs: Date.now() - 600_000,
-    toMs: Date.now(),
-    channels: Array.from({ length: 8 }, (_, k) => ({
-      daqNodeId: `dq-${k}`,
-      ch: `CH${k}`,
-      unit: 'C',
-      latest: 123.45,
-      avg: 121.11,
-      min: 100.5,
-      max: 140.25,
-      cnt: 120,
-      breaches: 0,
-      nodeIdFallback: nodeId,
-    })),
-  }
-}
-
-function ms(fn: () => void): number {
-  const t0 = performance.now()
-  fn()
-  return performance.now() - t0
-}
-function report(label: string, totalMs: number, iters: number): void {
-  console.log(`  ${label}: total=${totalMs.toFixed(1)}ms  per-op=${(totalMs / iters).toFixed(3)}ms  (iters=${iters})`)
-}
-
-console.log('=== A. anchors 到达上限后的每次 appendAnchor 成本 ===')
-{
-  const repo = new RecipeRollBackRepo()
-  for (let i = 0; i < CAP_ANCHORS; i++) repo.appendAnchor(anchorOf(i))
-  console.log(`  填充后 anchors=${repo.stats().anchors}(cap=${CAP_ANCHORS})`)
-  const iters = 200
-  const t = ms(() => {
-    for (let i = 0; i < iters; i++) repo.appendAnchor(anchorOf(CAP_ANCHORS + i))
-  }, iters)
-  report('appendAnchor(在上限稳态,每次触发 splice+new Set)', t, iters)
-  console.log(`  追加后 anchors=${repo.stats().anchors}(仍为 cap,说明每写都触发淘汰路径)`)
-
-  console.log('\n=== B. 查询方法成本(20000 锚 / 50 节点) ===')
-  const nodeId = 'n-0'
-  let t1 = ms(() => { for (let i = 0; i < 1000; i++) repo.lastStableAnchor(nodeId) }, 1000)
-  report('lastStableAnchor (O(1) 索引)', t1, 1000)
-  t1 = ms(() => { for (let i = 0; i < 1000; i++) repo.lastRollbackAnchor(nodeId) }, 1000)
-  report('lastRollbackAnchor (节点子序列倒扫)', t1, 1000)
-  t1 = ms(() => { for (let i = 0; i < 200; i++) repo.anchorById('anc-nonexistent') }, 200)
-  report('anchorById (全量 find,未命中=最坏)', t1, 200)
-  t1 = ms(() => { for (let i = 0; i < 200; i++) repo.listAnchors({ lineId: 'ln-nope', limit: 100 }) }, 200)
-  report('listAnchors({lineId}) 无命中 → 全量 20000 倒扫', t1, 200)
-  t1 = ms(() => { for (let i = 0; i < 200; i++) repo.listAnchors({ nodeId, limit: 30 }) }, 200)
-  report('listAnchors({nodeId, limit:30}) 走索引', t1, 200)
-}
-
-console.log('\n=== C. records(2000 上限)+ open 索引 ===')
-{
-  const repo = new RecipeRollBackRepo()
-  for (let i = 0; i < CAP_RECORDS; i++) {
-    repo.insertRecord({
-      lineId: 'ln-audit',
-      nodeId: `n-${i % 50}`,
-      nodeName: `node-${i % 50}`,
-      recipeId: null,
-      hypothesis: 'h',
-      params: [{ nodeId: `n-${i % 50}`, templateRef: 'cw-temp', from: i, to: i + 1 }],
-      setAt: new Date().toISOString(),
-      status: 'open',
-      judge: null,
-      anchorId: `anc-${i}`,
-      policy: 'auto_rollback',
-    })
-  }
-  console.log(`  records=${repo.stats().records} open=${repo.stats().open}(每节点仅索引最后一条)`)
-  const t = ms(() => { for (let i = 0; i < 200; i++) repo.listOpenRecords() }, 200)
-  report('listOpenRecords (O(open))', t, 200)
-  const t2 = ms(() => { for (let i = 0; i < 200; i++) repo.chainRollbackCount('n-0') }, 200)
-  report('chainRollbackCount (全量 2000 filter)', t2, 200)
-  const t3 = ms(() => { for (let i = 0; i < 2000; i++) repo.byId('opt-nonexistent') }, 2000)
-  report('byId (全量 find,未命中=最坏)', t3, 2000)
-}
-
-console.log('\n=== D. 同节点第二条 open 记录 → 索引可见性 ===')
-{
-  const repo = new RecipeRollBackRepo()
-  const r1 = repo.insertRecord({ nodeId: 'n-x', status: 'open', policy: 'auto_rollback', setAt: new Date().toISOString(), params: [], lineId: 'l' } as never)
-  const r2 = repo.insertRecord({ nodeId: 'n-x', status: 'open', policy: 'auto_rollback', setAt: new Date().toISOString(), params: [], lineId: 'l' } as never)
-  const open = repo.listOpenRecords()
-  const listed = repo.listRecords({ nodeId: 'n-x', status: 'open', limit: 50 })
-  console.log(`  insertRecord #1=${r1.id} #2=${r2.id}`)
-  console.log(`  listOpenRecords() 返回 ${open.length} 条;listRecords(status=open) 返回 ${listed.length} 条`)
-  console.log(`  → 未被索引的 open 记录是否可达:${open.some(r => r.id === r1.id) ? '可达' : '不可达(永不被 sweep 评估)'}`)
-}
-
-console.log('\n=== E. flushNow(全量序列化)成本 ===')
-{
-  const repo = new RecipeRollBackRepo()
-  for (let i = 0; i < CAP_ANCHORS; i++) repo.appendAnchor(anchorOf(i))
-  for (let i = 0; i < CAP_RECORDS; i++) {
-    repo.insertRecord({
-      lineId: 'ln-audit',
-      nodeId: `n-${i % 50}`,
-      nodeName: `node-${i % 50}`,
-      recipeId: null,
-      hypothesis: 'h',
-      params: [{ nodeId: `n-${i % 50}`, templateRef: 'cw-temp', from: i, to: i + 1 }],
-      setAt: new Date().toISOString(),
-      status: 'closed-line-stop',
-      judge: null,
-      anchorId: `anc-${i}`,
-      policy: 'auto_rollback',
-      windowAgg: aggOf(`n-${i % 50}`),
-    } as never)
-  }
-  const iters = 20
-  const t = ms(() => { for (let i = 0; i < iters; i++) repo.flushNow() }, iters)
-  report(`flushNow(anchors=${CAP_ANCHORS} + records=${CAP_RECORDS} 含聚合)`, t, iters)
-  const { statSync } = await import('node:fs')
-  const { join } = await import('node:path')
-  const { dataDirFor } = await import('../../shared/config/home.mjs')
-  // 落盘位置与 repo 同源解析(env AW_DATA_DIR 优先,cwd 兜底),勿再硬编码 cwd 路径
-  const size = statSync(join(dataDirFor(), 'dcw-rollback.json')).size
-  console.log(`  落盘文件大小=${(size / 1024 / 1024).toFixed(2)} MB(每次 agent/rollback 写后同步全量重写)`)
-}

package/scripts/_audit/dcw-unrecorded-write.ts

@@ -1,171 +0,0 @@
-/**
- * 审计实验 3 —— 「写入落到硬件但未入账」链路(只读审计;全部走本地假 PLC,不触真实数据)。
- *
- * 组成:
- *  A) 假 Modbus TCP PLC(FC16 写 / FC03 读;可切换「回读返回陈旧值」和「永不响应」)
- *  B) 真实 modbus-tcp 写驱动(server/services/workshop/dcw/drivers.ts)
- *  C) 真实 RecipeRollBackRepo(账本;cwd 已切到 scripts/_audit/.tmp,绝不碰 server/data/*)
- *  D) 忠实复刻 dcw-controller.ts:536 的入册闸门 `if (outcome.ok !== false)`
- *
- * 运行:node --experimental-transform-types scripts/_audit/run.mjs scripts/_audit/dcw-unrecorded-write.ts
- */
-import { mkdirSync } from 'node:fs'
-import net from 'node:net'
-
-const TMP_DIR = new URL('./.tmp/server/data/', import.meta.url)
-mkdirSync(TMP_DIR, { recursive: true })
-process.chdir(new URL('./.tmp/', import.meta.url).pathname.replace(/^\//, ''))
-
-const { modbusTcpDcwDriver } = await import('../../server/services/workshop/dcw/drivers')
-const { RecipeRollBackRepo } = await import('../../server/services/workshop/dcw/recipe-rollback.repo')
-const { writeTolerance } = await import('../../server/services/workshop/dcw/dcw-runtime')
-
-let failures = 0
-function check(name: string, cond: boolean, extra = ''): void {
-  if (cond) {
-    console.log(`  PASS  ${name}${extra ? ` (${extra})` : ''}`)
-  }
-  else {
-    failures++
-    console.log(`  FAIL  ${name}${extra ? ` (${extra})` : ''}`)
-  }
-}
-
-interface FakePlc {
-  port: number
-  registers: Map<number, number>
-  writeCount: number
-  mode: 'stale-readback' | 'hang'
-  close: () => void
-}
-
-function startFakePlc(opts: { staleReadback?: number, mode?: 'stale-readback' | 'hang' }): Promise<FakePlc> {
-  const registers = new Map<number, number>()
-  const state = { writeCount: 0, mode: opts.mode ?? 'stale-readback' as 'stale-readback' | 'hang' }
-  const server = net.createServer((sock) => {
-    let buf = Buffer.alloc(0)
-    sock.on('data', (chunk) => {
-      buf = Buffer.concat([buf, chunk])
-      while (buf.length >= 6) {
-        const len = buf.readUInt16BE(4)
-        const total = 6 + len
-        if (buf.length < total) break
-        const unitId = buf.readUInt8(6)
-        const pdu = buf.subarray(7, total)
-        const fc = pdu.readUInt8(0)
-        const tid = buf.readUInt16BE(0)
-        if (state.mode === 'hang') {
-          buf = buf.subarray(total)
-          continue // 收到即吞:模拟半开链路(不响应)
-        }
-        let resp: Buffer
-        if (fc === 0x10) { // write multiple registers
-          const addr = pdu.readUInt16BE(1)
-          const qty = pdu.readUInt16BE(3)
-          for (let i = 0; i < qty; i++) registers.set(addr + i, pdu.readUInt16BE(6 + i * 2))
-          state.writeCount++
-          resp = Buffer.from([0x10, pdu[1]!, pdu[2]!, pdu[3]!, pdu[4]!])
-        }
-        else if (fc === 0x03) { // read holding registers
-          const addr = pdu.readUInt16BE(1)
-          const qty = pdu.readUInt16BE(3)
-          const data: number[] = []
-          for (let i = 0; i < qty; i++) {
-            // 关键:回读一律返回「陈旧值」——模拟 PLC 尚未生效/慢一拍
-            data.push(opts.staleReadback != null ? opts.staleReadback : (registers.get(addr + i) ?? 0))
-          }
-          resp = Buffer.from([0x03, data.length * 2, ...data.flatMap(v => [v >> 8 & 0xFF, v & 0xFF])])
-        }
-        else {
-          resp = Buffer.from([fc | 0x80, 0x01])
-        }
-        const head = Buffer.alloc(6)
-        head.writeUInt16BE(tid, 0)
-        head.writeUInt16BE(0, 2)
-        head.writeUInt16BE(resp.length + 1, 4)
-        sock.write(Buffer.concat([head, Buffer.from([unitId]), resp]))
-        buf = buf.subarray(total)
-      }
-    })
-    sock.on('error', () => {})
-  })
-  return new Promise((resolve) => {
-    server.listen(0, '127.0.0.1', () => {
-      resolve({
-        port: (server.address() as net.AddressInfo).port,
-        registers,
-        get writeCount() { return state.writeCount },
-        mode: state.mode,
-        close: () => server.close(),
-      } as FakePlc)
-    })
-  })
-}
-
-const nodeLike = { decimals: 2, min: 0, max: 100 } as never
-
-console.log('\n=== A. 回读陈旧值:写已落到寄存器,但 ACK 判定失败(ok=false) ===')
-{
-  const plc = await startFakePlc({ staleReadback: 5 })
-  const cfg = { host: '127.0.0.1', port: plc.port, unitId: 1, register: 0, dataType: 'int16', byteOrder: 'big' }
-  const res = await modbusTcpDcwDriver.write({
-    eng: 20,
-    tolerance: writeTolerance(nodeLike),
-    domain: { min: 0, max: 100 },
-    driverConfig: cfg,
-  })
-  console.log(`  驱动返回: ok=${res.ok} raw=${res.raw} readback=${res.readback} message=${res.message}`)
-  check('硬件寄存器已收到写入值 20', plc.registers.get(0) === 20, `reg0=${plc.registers.get(0)}`)
-  check('驱动判定为 ACK 失败(ok=false)', res.ok === false)
-  check('失败原因 = 回读偏差超容差', /回读偏差超容差/.test(res.message), res.message)
-  check('readback 为陈旧值 5', res.readback === 5)
-
-  // 账本语义复刻:dcw-controller.ts:536「仅成功写记锚」→ ok=false 时 afterWrite 不被调用
-  const repo = new RecipeRollBackRepo()
-  repo.appendAnchor({ lineId: 'ln', nodeId: 'dw-1', prevValue: 5, newValue: 10, source: 'manual', actor: 'user', recipeRunId: null })
-  const outcome = res
-  let ledgerAppends = 0
-  if (outcome.ok !== false) { // ← 与 dcw-controller.ts:532-536 同构
-    repo.appendAnchor({ lineId: 'ln', nodeId: 'dw-1', prevValue: 10, newValue: 20, source: 'manual', actor: 'user', recipeRunId: null })
-    ledgerAppends++
-  }
-  check('ok=false 时账本未入册(闸门同构复刻)', ledgerAppends === 0)
-  const stable = repo.lastStableAnchor('dw-1')
-  console.log(`  账本最新稳定锚 = {prev:${stable?.prevValue}, new:${stable?.newValue}};硬件寄存器 = ${plc.registers.get(0)}`)
-  check('入册锚不是本次写入(20 不在册)', stable?.newValue === 10, `new=${stable?.newValue}`)
-  check('硬件实际值(20)≠ 入册锚 newValue(10):账本与硬件漂移', plc.registers.get(0) !== stable?.newValue)
-  check('seeded 锚的 prevValue=5 仍是回退目标:回退将跳过真实的上一设定值 10', stable?.prevValue === 5)
-  plc.close()
-}
-
-console.log('\n=== B. 同理:另一个方向的漂移(node.value = 陈旧回读值 → 保写心跳将重下发陈旧值) ===')
-{
-  const plc = await startFakePlc({ staleReadback: 5 })
-  const cfg = { host: '127.0.0.1', port: plc.port, unitId: 1, register: 0, dataType: 'int16', byteOrder: 'big' }
-  const res = await modbusTcpDcwDriver.write({ eng: 20, tolerance: writeTolerance(nodeLike), domain: { min: 0, max: 100 }, driverConfig: cfg })
-  // dcw-controller.ts:176 等价:node.applyWriteResult(outcome.readback ?? eng, ok, ...)
-  const DcwNodeMod = await import('../../server/services/workshop/dcw/dcw-node')
-  const node = DcwNodeMod.DcwNode.fromRow({ id: 'dw-1', templateRef: 'cw-temp', min: 0, max: 100, decimals: 2, holdIntervalMs: 1000, driver: 'modbus-tcp', driverConfig: cfg })
-  node.value = 10
-  node.applyWriteResult(res.readback ?? 20, res.ok, res.message, new Date().toISOString())
-  console.log(`  写入 20 / 回读 ${res.readback} → node.value=${node.value}(state=${node.state})`)
-  check('node.value 被写成陈旧回读值 5(既非设定值 20 也非真实上一设定 10)', node.value === 5, `value=${node.value}`)
-  plc.close()
-}
-
-console.log('\n=== C. 写超时(假 PLC 收到即吞):是否 bounded、是否误判 ===')
-{
-  const plc = await startFakePlc({ mode: 'hang' })
-  const cfg = { host: '127.0.0.1', port: plc.port, unitId: 1, register: 0, dataType: 'int16', byteOrder: 'big' }
-  const t0 = Date.now()
-  const res = await modbusTcpDcwDriver.write({ eng: 30, tolerance: writeTolerance(nodeLike), domain: { min: 0, max: 100 }, driverConfig: cfg })
-  const dt = Date.now() - t0
-  console.log(`  返回: ok=${res.ok} message=${res.message} elapsed=${dt}ms`)
-  check('写有硬超时(<=4s 返回,实测 withModbusConn 3s)', dt < 4000, `${dt}ms`)
-  check('超时映射为 ACK 失败(ok=false)', res.ok === false)
-  check('超时时 readback=null(账本/节点值无法判定硬件真实状态)', res.readback === null, `readback=${res.readback}`)
-  plc.close()
-}
-
-console.log(`\nresult: ${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
-process.exit(failures === 0 ? 0 : 1)

package/scripts/_audit/dcw-write-mutex.ts

@@ -1,157 +0,0 @@
-/**
- * 审计实验 1 —— DCW 单节点写在飞互斥 + 周期读互斥(只读:不碰任何源码/数据文件)。
- *
- * 驱动真实 DcwNodeRuntime(dcw-runtime.ts),host 全部打桩,统计同一节点的
- * 并发在飞写/读数;断言心跳重下发(tick)与手动 write() 共享同一 writing 闸门。
- *
- * 运行:node --experimental-transform-types scripts/_audit/run.mjs scripts/_audit/dcw-write-mutex.ts
- */
-import { DcwNode } from '../../server/services/workshop/dcw/dcw-node'
-import { DcwNodeRuntime } from '../../server/services/workshop/dcw/dcw-runtime'
-
-let failures = 0
-function check(name: string, cond: boolean, extra = ''): void {
-  if (cond) {
-    console.log(`  PASS  ${name}${extra ? ` (${extra})` : ''}`)
-  }
-  else {
-    failures++
-    console.log(`  FAIL  ${name}${extra ? ` (${extra})` : ''}`)
-  }
-}
-
-const statusOf = (e: unknown): string => {
-  const s = (e as { status?: number }).status
-  return s ? String(s) : `no-status:${(e as Error)?.message ?? String(e)}`
-}
-
-interface Stats {
-  writeCalls: number
-  readCalls: number
-  inFlightWrites: number
-  maxInFlightWrites: number
-  inFlightReads: number
-  maxInFlightReads: number
-  writeEng: number[]
-  concurrentReadPairs: number
-}
-
-function makeNode(): DcwNode {
-  return DcwNode.fromRow({
-    id: 'n-audit-1',
-    templateRef: 'cw-temp',
-    name: 'audit-node',
-    driver: 'mock',
-    min: 0,
-    max: 200,
-    decimals: 2,
-    holdIntervalMs: 10,
-    readIntervalMs: 1000,
-    enabled: true,
-    lineId: 'ln-audit',
-  })
-}
-
-function makeHarness(opts: { writeDelayMs: number, readDelayMs: number }) {
-  const stats: Stats = {
-    writeCalls: 0,
-    readCalls: 0,
-    inFlightWrites: 0,
-    maxInFlightWrites: 0,
-    inFlightReads: 0,
-    maxInFlightReads: 0,
-    writeEng: [],
-    concurrentReadPairs: 0,
-  }
-  const sleep = (ms: number): Promise<void> => new Promise(r => setTimeout(r, ms))
-  const host = {
-    running: () => true,
-    defaults: () => ({ holdIntervalMs: 10, readIntervalMs: 1000 }),
-    async executeWrite(node: DcwNode, eng: number) {
-      stats.writeCalls++
-      stats.writeEng.push(eng)
-      stats.inFlightWrites++
-      stats.maxInFlightWrites = Math.max(stats.maxInFlightWrites, stats.inFlightWrites)
-      await sleep(opts.writeDelayMs)
-      stats.inFlightWrites--
-      node.applyWriteResult(eng, true, 'stub ok', new Date().toISOString())
-      return { ok: true, message: 'stub ok', raw: eng, readback: eng }
-    },
-    async executeRead() {
-      stats.readCalls++
-      stats.inFlightReads++
-      stats.maxInFlightReads = Math.max(stats.maxInFlightReads, stats.inFlightReads)
-      if (stats.inFlightReads > 1)
-        stats.concurrentReadPairs++
-      await sleep(opts.readDelayMs)
-      stats.inFlightReads--
-      return { ok: true, value: 1, raw: 1, message: 'stub read', at: new Date().toISOString() }
-    },
-  }
-  return { host, stats }
-}
-
-async function main(): Promise<void> {
-  // ---------- 场景 A:手动写在飞时,保写心跳必须跳过本拍(不得并发) ----------
-  console.log('\n[A] manual write in flight -> tick keep-alive must skip')
-  {
-    const node = makeNode()
-    const { host, stats } = makeHarness({ writeDelayMs: 120, readDelayMs: 0 })
-    const rt = new DcwNodeRuntime(node, host as never)
-    const p = rt.write(50)
-    let tickAt = 1_000_000
-    for (let i = 0; i < 20; i++) {
-      tickAt += 50 // 远超 holdIntervalMs=10,心跳到点
-      rt.tick(tickAt)
-    }
-    const concurrentSecondWrite = await rt.write(60).then(() => 'resolved', e => `rejected:${statusOf(e)}`)
-    const outcome = await p
-    check('manual write ok', outcome.ok === true)
-    check('heartbeat skipped while manual write in flight (executeWrite called once)', stats.writeCalls === 1, `calls=${stats.writeCalls}`)
-    check('max concurrent in-flight writes == 1', stats.maxInFlightWrites === 1, `max=${stats.maxInFlightWrites}`)
-    check('second concurrent manual write rejected with 409', concurrentSecondWrite === 'rejected:409', concurrentSecondWrite)
-  }
-
-  // ---------- 场景 B:手动写结束后,心跳按节奏重下发且仍与手动写互斥 ----------
-  console.log('\n[B] heartbeat re-write shares the same gate')
-  {
-    const node = makeNode()
-    const { host, stats } = makeHarness({ writeDelayMs: 60, readDelayMs: 0 })
-    const rt = new DcwNodeRuntime(node, host as never)
-    await rt.write(80)
-    const callsAfterManual = stats.writeCalls
-    const t = 2_000_100
-    rt.tick(t) // 到点 -> 心跳下发 node.value
-    rt.tick(t) // 同一拍再次 tick:心跳在飞,必须跳过
-    await new Promise(r => setTimeout(r, 5))
-    const second = await rt.write(90).then(() => 'resolved', e => `rejected:${statusOf(e)}`)
-    await new Promise(r => setTimeout(r, 150))
-    check('heartbeat issued at least one write', stats.writeCalls > callsAfterManual, `calls=${stats.writeCalls}`)
-    check('heartbeat wrote current setpoint 80', stats.writeEng.includes(80), JSON.stringify(stats.writeEng))
-    check('manual write during heartbeat in flight rejected with 409', second === 'rejected:409', second)
-    check('max concurrent in-flight writes == 1 (whole scenario)', stats.maxInFlightWrites === 1, `max=${stats.maxInFlightWrites}`)
-  }
-
-  // ---------- 场景 C:周期读的在飞互斥(readNow 与 tick 读) ----------
-  console.log('\n[C] readNow() while periodic read in flight')
-  {
-    const node = makeNode()
-    const { host, stats } = makeHarness({ writeDelayMs: 0, readDelayMs: 120 })
-    const rt = new DcwNodeRuntime(node, host as never)
-    rt.tick(3_000_000) // 触发周期读(不 await)
-    await new Promise(r => setTimeout(r, 10)) // 让周期读进入在飞
-    const res = await rt.readNow().then(() => 'resolved', e => `rejected:${statusOf(e)}`)
-    await new Promise(r => setTimeout(r, 250))
-    check('periodic read started', stats.readCalls >= 1, `readCalls=${stats.readCalls}`)
-    check(
-      'readNow() rejected (expect rejected:409) while periodic read in flight',
-      res === 'rejected:409',
-      `actual=${res}; concurrent read pairs=${stats.concurrentReadPairs}, maxInFlightReads=${stats.maxInFlightReads}`,
-    )
-  }
-
-  console.log(`\nresult: ${failures === 0 ? 'ALL PASS' : `${failures} FAILED`}`)
-  process.exit(failures === 0 ? 0 : 1)
-}
-
-void main()

package/scripts/_audit/design-shots.mjs

@@ -1,145 +0,0 @@
-/**
- * 视觉走查截图(设计评审用)—— 全站关键页 × 亮/暗双主题。
- *
- * 为什么单独一支:设计验收必须看**生产构建下的真实渲染**(玻璃材质依赖 backdrop-filter
- * 与真实极光层,dev 模式下 HMR 注入的样式顺序会让玻璃层级失真)。
- *
- * 用法:node scripts/_audit/design-shots.mjs [base] [--out=dir]
- * 依赖:puppeteer-core + 本机 Edge/Chrome(无需下载 Chromium)。
- */
-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 BASE = (process.argv[2] ?? process.env.AW_BASE ?? 'http://127.0.0.1:3111').replace(/\/$/, '')
-const OUT = (process.argv.find(a => a.startsWith('--out='))?.slice(6)) ?? join(REPO, '.e2e-shots', 'design')
-const VIEWPORT = { width: 1680, height: 1050 }
-
-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', '数控中心'],
-  ['/aml', '建模平台'],
-  ['/monitor', '监控'],
-  ['/logs', '运维日志'],
-  ['/tokens', '令牌'],
-  ['/settings', '系统设置'],
-  ['/plugins', '插件'],
-  ['/permissions', '权限'],
-]
-
-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', '--disable-dev-shm-usage', '--force-device-scale-factor=1', '--hide-scrollbars'],
-    defaultViewport: VIEWPORT,
-  })
-
-  const errors = []
-  const shots = []
-  try {
-    // 鉴权:优先用显式管理员登录(视觉走查要看**有数据的真实界面**,普通用户会被 403 挡成空壳)
-    const ADMIN_EMAIL = process.env.AW_ADMIN_EMAIL ?? 'admin@awshop.local'
-    const ADMIN_PASS = process.env.AW_ADMIN_PASS ?? 'admin123'
-    const login = await fetch(`${BASE}/api/users/login`, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ email: ADMIN_EMAIL, password: ADMIN_PASS }),
-    }).then(r => r.json()).catch(() => null)
-    let token = login?.data?.token ?? ''
-    let role = login?.data?.user?.role ?? ''
-    if (!token) {
-      const reg = await fetch(`${BASE}/api/workshop/users/register`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ name: `shot-${Date.now().toString(36)}` }),
-      }).then(r => r.json()).catch(() => null)
-      token = reg?.data?.token ?? ''
-      role = 'registered'
-    }
-    console.log(`服务:${BASE}  token:${token ? 'ok' : '无'}  role:${role}`)
-
-    const page = await browser.newPage()
-    page.on('pageerror', e => errors.push(`[pageerror] ${e.message}`))
-    page.on('console', (m) => {
-      if (m.type() === 'error') errors.push(`[console] ${m.text().slice(0, 200)}`)
-    })
-
-    // 鉴权走 cookie `token`(apiClient 从这里取 Bearer),不是 localStorage;
-    // 主题走 pinia persistedstate 的 'app' 键 + aw-theme cookie 镜像。
-    const seed = async (theme) => {
-      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)
-    }
-
-    for (const theme of ['light', 'dark']) {
-      await page.goto(`${BASE}/`, { waitUntil: 'domcontentloaded', timeout: 60_000 })
-      await seed(theme)
-      for (const [path, label] of PAGES) {
-        const url = `${BASE}${path}`
-        try {
-          // 先落地再种 cookie,保证服务端 SSR 首帧就带鉴权与主题
-          await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60_000 })
-          await seed(theme)
-          await page.reload({ waitUntil: 'networkidle2', timeout: 60_000 })
-          await sleep(1100)
-          const name = `${theme}-${(path === '/' ? 'dashboard' : path.replace(/\//g, '_').replace(/^_/, ''))}.png`
-          const file = join(OUT, name)
-          await page.screenshot({ path: file, fullPage: false })
-          shots.push({ theme, path, label, file })
-          console.log(`  ✔ ${theme}  ${label.padEnd(6)} ${path}`)
-        }
-        catch (err) {
-          console.log(`  ✘ ${theme}  ${label} ${path} — ${err.message.slice(0, 90)}`)
-          errors.push(`[nav ${path}] ${err.message.slice(0, 160)}`)
-        }
-      }
-    }
-  }
-  finally {
-    await browser.close()
-  }
-
-  const manifest = join(OUT, 'MANIFEST.md')
-  writeFileSync(manifest, [
-    `# 视觉走查截图(${new Date().toISOString()})`,
-    '',
-    `服务:${BASE}  viewport:${VIEWPORT.width}×${VIEWPORT.height}`,
-    '',
-    '| 主题 | 页面 | 路径 | 文件 |',
-    '| --- | --- | --- | --- |',
-    ...shots.map(s => `| ${s.theme} | ${s.label} | ${s.path} | ${s.file.split(/[\\/]/).pop()} |`),
-    '',
-    `页面错误:${errors.length}`,
-    ...errors.slice(0, 40).map(e => `- ${e}`),
-    '',
-  ].join('\n'), 'utf8')
-
-  console.log(`\n输出:${OUT}`)
-  console.log(`截图 ${shots.length} 张,页面错误 ${errors.length} 条`)
-  if (errors.length) {
-    console.log(errors.slice(0, 12).join('\n'))
-  }
-}
-
-main().catch((err) => {
-  console.error(err)
-  process.exit(1)
-})