agentworkshop 0.7.39 → 0.7.40

package/nuxt.config.ts

@@ -221,6 +221,37 @@ export default defineNuxtConfig({
     },
   },
 
+  vite: {
+    build: {
+      /**
+       * rolldown 的构建期检查开关。
+       *
+       * pluginTimings 会在"插件钩子占了构建时间大头"时打一条 WARN。本项目装了
+       * unocss / antd / i18n / unplugin-icons 等一堆构建期插件,这条 WARN 每次必现 ——
+       * 它是**构建自身的耗时画像**,不是代码质量问题,也无法通过改我们的代码消除
+       * (unocss 的 renderChunk 调用 93 次、占 ~19%,这是它的工作方式)。
+       *
+       * 只关这一项。其余 checks(命名空间当函数调用、配置冲突、无用的内置特性替代等)
+       * 都是**真的可能在抓 bug** 的检查,保持开启。
+       */
+      rolldownOptions: {
+        checks: { pluginTimings: false },
+      },
+      /**
+       * 客户端单块体积阈值。
+       *
+       * 默认的 500kB 对本项目不适用:three.js(数字孪生,~1.35MB)与
+       * echarts(~650kB)是重型第三方库的固有体积,而且都已经是**路由级动态导入**
+       * ——/town 才加载 three,只有真正进入孪生页的用户才付这份下载。
+       * 继续拆分的收益很小(它们本身就是单个不可再分的库)。
+       *
+       * 阈值提到 1500kB 的用意不是"把告警关掉",而是让这条告警重新变得**有意义**:
+       * 一旦某天我们自己的代码或某个新依赖把这个数字推过 1.5MB,它照样会报。
+       */
+      chunkSizeWarningLimit: 1500,
+    },
+  },
+
   typescript: {
     strict: true,
     typeCheck: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.7.39",
+  "version": "0.7.40",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "PolyForm-Noncommercial-1.0.0",
@@ -80,6 +80,13 @@
     "prepare": "husky",
     "game:test": "tsx scripts/test-agent-brain.ts && tsx scripts/test-game-session.ts",
     "test:api-live": "node scripts/api-live-e2e.mjs",
+    "ui:seed": "node scripts/ui/seed-demo.mjs",
+    "ui:shots": "node scripts/ui/shots.mjs",
+    "ui:audit": "node scripts/ui/audit-layout.mjs",
+    "ui:verify": "node scripts/ui/verify-responsive.mjs",
+    "ui:verify-nav": "node scripts/ui/verify-nav.mjs",
+    "readme:lint": "node scripts/ui/md-lint.mjs README.md README-zh.md",
+    "readme:assets": "node scripts/ui/readme-assets.mjs",
     "game:verify": "node scripts/verify-game.mjs",
     "game:build-assets": "node scripts/build-player-sheet.mjs",
     "game:build-wuwa": "node scripts/build-wuwa-assets.mjs",
@@ -146,6 +153,7 @@
     "@nuxt/eslint": "^1.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^26.2.0",
+    "@types/pg": "^8.23.1",
     "@types/three": "^0.185.4",
     "eslint": "^9.17.0",
     "husky": "^9.1.7",

package/scripts/_dbg-param-map-e2e.ts

@@ -0,0 +1,242 @@
+/**
+ * 工艺参数映射层 E2E(真实 PLC 模拟器连通):
+ * ①节点创建自动生成工艺参数映射 + 参数面不透出 PLC 寻址细节
+ * ②真实 Modbus TCP 从站(dev-plc-simulator,一阶惯性温度回路)参数写→回读 roundtrip
+ * ③参数基准限界联锁(常驻层) ④产品限界 + 配方窗口分层联锁(产线运行期)
+ * ⑤配方下发同样受限(run.results 记失败) ⑥Agent param_control/param_read(绑定/越权/消歧)
+ * ⑦节点删除级联清理映射 ⑧运行中 plc-node-simulator(16040)导出配置连通性交叉验证
+ * 数据目录 AW_HOME 隔离,不触碰检出内 .AgentWorkShop。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/_dbg-param-map-e2e.ts
+ */
+import { mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+// @ts-expect-error 既有验证脚本助手(无类型声明)
+import { startPlcSim } from './_lib-plc-sim-child.mjs'
+
+// 进程级隔离:配置根落在一次性目录(须在业务模块 import 前设置)
+const awHome = mkdtempSync(join(tmpdir(), 'aw-param-map-e2e-'))
+process.env.AW_MODE = 'home'
+process.env.AW_HOME = awHome
+process.env.NO_PROXY = '127.0.0.1,localhost'
+
+let failures = 0
+const check = (name: string, ok: boolean, detail = ''): void => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+// ===== 真实 Modbus 从站(scripts/dev-plc-simulator.mjs:40021 温度SP / 40001 温度PV,float32 大端) =====
+const SIM_PORT = 15040
+const sim = startPlcSim(SIM_PORT)
+const simReady: Promise<boolean> = sim.ready
+
+// ===== 服务层导入(隔离根内) =====
+const { getDcwController } = await import('../server/services/workshop/dcw/dcw-controller')
+const { getDcwParamRepo } = await import('../server/services/workshop/dcw/param-map.repo')
+const { getDcwLineRepo } = await import('../server/services/workshop/dcw/dcw-line.repo')
+const { getDcwProductRepo } = await import('../server/services/workshop/dcw/dcw-product.repo')
+const { getDcwRecipeRepo } = await import('../server/services/workshop/dcw/dcw-recipe.repo')
+const { getAgentNodeBindingRepo } = await import('../server/services/workshop/agents/node-bindings.repo')
+const { toolParamControl, toolParamRead } = await import('../server/services/workshop/agents/industrial-tools')
+
+const ctrl = getDcwController()
+const paramRepo = getDcwParamRepo()
+
+/** 捕获 AppError 的消息与状态码 */
+async function errOf(fn: () => Promise<unknown> | unknown): Promise<{ status: number, message: string }> {
+  try {
+    await fn()
+    return { status: 0, message: '(未抛错)' }
+  }
+  catch (err) {
+    const e = err as { status?: number, statusCode?: number, message?: string }
+    return { status: e.status ?? e.statusCode ?? 500, message: e.message ?? String(err) }
+  }
+}
+
+try {
+  console.log('\n--- ① 节点创建 → 自动工艺参数映射(参数面语义) ---')
+  if (!await simReady) throw new Error(`Modbus 模拟器未就绪(${SIM_PORT},可能端口被占)`)
+  console.log(`  模拟器就绪 @ 127.0.0.1:${SIM_PORT}`)
+  const line = getDcwLineRepo().create({ name: '参数映射验证线' })
+  const node = ctrl.create({
+    templateRef: 'dcw-temp-sp',
+    name: 'PP验证·烘箱温度',
+    driver: 'modbus-tcp',
+    driverConfig: { host: '127.0.0.1', port: SIM_PORT, unitId: 1, register: 40021, dataType: 'float32', byteOrder: 'big' },
+    min: 0,
+    max: 300,
+    readIntervalMs: 0,
+    lineId: line.id,
+  })
+  const prow = paramRepo.byNode(node.id)
+  check('节点创建自动生成工艺参数映射', !!prow && prow.key === 'temp-sp')
+  const pview0 = paramRepo.listViews().find(p => p.nodeId === node.id)
+  check('参数视图为语义面(无 driverConfig/寄存器/数据类型/字节序)', !!pview0
+    && !('driverConfig' in (pview0 ?? {}))
+    && !JSON.stringify(pview0).includes('register')
+    && !JSON.stringify(pview0).includes('float32')
+    && !JSON.stringify(pview0).includes('byteOrder'),
+  JSON.stringify(pview0).slice(0, 120))
+  check('参数视图携带驱动类别(仅类别)与产线归属', pview0?.driver === 'modbus-tcp' && pview0?.lineId === line.id)
+  const pid = pview0!.id
+
+  console.log('\n--- ② 真实 Modbus 参数写→回读 roundtrip(工程量纲直写) ---')
+  const w1 = await ctrl.writeParam(pid, 180, { source: 'manual', actor: 'e2e', actorName: 'E2E' })
+  check('参数写入成功(180℃)', w1.ok, w1.message)
+  check('PLC 同址回读一致(标定后物理值)', w1.readback != null && Math.abs((w1.readback ?? 0) - 180) < 0.5, `readback=${w1.readback}`)
+  check('执行节点设定值回填', ctrl.byId(node.id)?.value != null && Math.abs((ctrl.byId(node.id)!.value ?? 0) - 180) < 0.5)
+  await ctrl.readParam(pid).then((r) => {
+    check('参数读取成功(PLC 当前值)', r.ok && Math.abs((r.value ?? 0) - 180) < 0.5, `value=${r.value}`)
+  })
+
+  console.log('\n--- ③ 工艺参数基准限界(常驻层) ---')
+  paramRepo.update(pid, { min: 100, max: 250 })
+  const eHi = await errOf(() => ctrl.writeParam(pid, 260))
+  check('超出基准限界 260 → 拒绝且点名参数层', eHi.status === 400 && eHi.message.includes('基准限界'), eHi.message.slice(0, 90))
+  const eLo = await errOf(() => ctrl.writeParam(pid, 90))
+  check('低于基准限界 90 → 拒绝', eLo.status === 400 && eLo.message.includes('基准限界'))
+  const w2 = await ctrl.writeParam(pid, 200)
+  check('限界内 200 → 通过', w2.ok)
+  const eNode = await errOf(() => ctrl.write(node.id, 260))
+  check('节点面直写越参数限界 → 同样拒绝(同一咽喉点)', eNode.status === 400 && eNode.message.includes('基准限界'))
+
+  console.log('\n--- ④ 产品限界 + 配方窗口(产线运行期分层联锁) ---')
+  const eBadKey = await errOf(() => ctrl.createProduct({ name: 'PP验证产品·坏键', lineId: line.id, paramLimits: { 'no-such-param': { min: 1, max: 2 } } }))
+  check('产品限界引用不存在的参数键 → 400(防静默失效)', eBadKey.status === 400 && eBadKey.message.includes('no-such-param'))
+  const eBadRange = await errOf(() => ctrl.createProduct({ name: 'PP验证产品·坏区间', lineId: line.id, paramLimits: { 'temp-sp': { min: 200, max: 150 } } }))
+  check('产品限界 min>max → 400', eBadRange.status === 400)
+  const product = ctrl.createProduct({
+    name: 'PP验证产品',
+    lineId: line.id,
+    paramLimits: { 'temp-sp': { min: 150, max: 210 } },
+  })
+  check('产品限界设定成功(150~210)', (product.paramLimits?.['temp-sp']?.max ?? 0) === 210)
+  const recipe = ctrl.createRecipe({
+    productId: product.id,
+    name: 'PP验证配方',
+    params: [{ nodeId: node.id, value: 180, min: 160, max: 220 }],
+  })
+  const run = await ctrl.lineStart(line.id, recipe.id)
+  check('产线开跑(批次激活)', !!run.id)
+  const eProduct = await errOf(() => ctrl.writeParam(pid, 215))
+  check('215 在参数限界内但超产品上限 210 → 拒绝且点名产品层', eProduct.status === 400 && eProduct.message.includes('产品'), eProduct.message.slice(0, 90))
+  const eRecipe = await errOf(() => ctrl.writeParam(pid, 155))
+  check('155 在产品限界内但低于配方下限 160 → 拒绝且点名配方层', eRecipe.status === 400 && eRecipe.message.includes('配方'), eRecipe.message.slice(0, 90))
+  const w3 = await ctrl.writeParam(pid, 170)
+  check('170 四层交集内 → 通过', w3.ok)
+  const eNodeGate = await errOf(() => ctrl.write(node.id, 215))
+  check('节点面直写 215 → 产品层同样拦截', eNodeGate.status === 400 && eNodeGate.message.includes('产品'))
+
+  console.log('\n--- ⑤ 配方下发同样受限(run.results 记失败;产线保持运行) ---')
+  ctrl.updateRecipe(recipe.id, { params: [{ nodeId: node.id, value: 215, min: 160, max: 220 }] }, { by: 'user', actor: 'e2e', actorName: 'E2E', description: '压到产品上限外验证下发拦截' })
+  const run2 = await ctrl.applyRecipe(recipe.id)
+  const r2 = run2.results[0] as { ok: boolean, message: string }
+  check('配方参数 215 超产品上限 210 → 下发失败入档(不阻塞批次)', r2.ok === false && r2.message.includes('产品'), r2.message.slice(0, 90))
+  ctrl.updateRecipe(recipe.id, { params: [{ nodeId: node.id, value: 180, min: 160, max: 220 }] }, { by: 'user', actor: 'e2e', actorName: 'E2E', description: '回退验证值' })
+  const run3 = await ctrl.applyRecipe(recipe.id)
+  check('配方参数 180 限界内 → 下发成功', (run3.results[0] as { ok: boolean }).ok === true)
+  // 跨配方下发不误伤:配方乙自身窗口 [150,210] 值 155,低于活动批次配方甲窗口下限 160
+  // —— 配方下发路径跳过配方层(自身窗口保存时已校验),产品/参数层照常 → 应放行
+  const recipeB = ctrl.createRecipe({ productId: product.id, name: 'PP验证配方·乙', params: [{ nodeId: node.id, value: 155, min: 150, max: 210 }] })
+  const runB = await ctrl.applyRecipe(recipeB.id)
+  const rB = runB.results[0] as { ok: boolean, message: string }
+  check('运行中应用配方乙(155 在甲窗口外、乙窗口内)→ 不被旧批次窗口误伤', rB.ok === true, rB.message.slice(0, 90))
+
+  console.log('\n--- ⑥ Agent 参数面(param_control/param_read;批次运行中) ---')
+  const AGENT = 'agent-pp-verify'
+  getAgentNodeBindingRepo().bind(AGENT, node.id, 'dcw', 'auto')
+  const t1 = await toolParamControl(AGENT, { param: 'temp-sp', value: 175 })
+  check('param_control 按 key 下发成功(语义回包含参数名/有效区间)', !t1.isError && t1.text.includes('工艺参数') && t1.text.includes('有效写入区间'), t1.text.slice(0, 100))
+  const t2 = await toolParamControl(AGENT, { param: 'temp-sp', value: 215 })
+  check('param_control 超产品限界 → 拒绝(文案含产品层)', t2.isError === true && t2.text.includes('产品'), t2.text.slice(0, 100))
+  const t3 = await toolParamControl(AGENT, { param: pid, value: 168 })
+  check('param_control 按 pp-id 下发成功', !t3.isError)
+  const t4 = await toolParamRead(AGENT, { param: 'temp-sp' })
+  check('param_read 返回读数 + 限界区间', !t4.isError && t4.text.includes('PLC 读数'), t4.text.slice(0, 80))
+  const t5 = await toolParamControl('agent-nobody', { param: 'temp-sp', value: 170 })
+  check('未绑定 Agent → 拒绝', t5.isError === true)
+  // 跨产线:第二条线同模板节点,key 产线内唯一
+  const line2 = getDcwLineRepo().create({ name: '参数映射验证线·乙' })
+  const node2 = ctrl.create({ templateRef: 'dcw-speed-sp', name: 'PP验证乙·速度', driver: 'mock', driverConfig: { key: `pp-e2e-2-${Date.now()}` }, readIntervalMs: 0, lineId: line2.id })
+  check('第二产线节点自动映射(speed-sp)', paramRepo.byNode(node2.id)?.key === 'speed-sp')
+  const t6 = await toolParamControl(AGENT, { param: 'speed-sp', value: 300 })
+  check('未绑定节点的参数 → 拒绝(权限沿用节点绑定)', t6.isError === true, t6.text.slice(0, 80))
+
+  console.log('\n--- ⑦ 级联:节点删除 → 参数映射自动清理 ---')
+  ctrl.remove(node2.id)
+  check('执行节点删除后映射移除', paramRepo.byNode(node2.id) == null)
+
+  console.log('\n--- ⑧ 运行中 plc-node-simulator(16040)连通性交叉验证 ---')
+  try {
+    const res = await fetch('http://127.0.0.1:4010/api/nodes', { signal: AbortSignal.timeout(3000) }).then(r => r.json()) as { data?: Array<{ id: string, protocol: string }> }
+    const mbNode = (res.data ?? []).find(n => n.protocol === 'modbus-tcp')
+    if (mbNode) {
+      const exp = await fetch(`http://127.0.0.1:4010/api/nodes/${mbNode.id}/export`, { signal: AbortSignal.timeout(3000) }).then(r => r.json()) as { data?: { items?: Array<{ driver: string, driverConfig: Record<string, unknown> }> } }
+      const cfg = exp.data?.items?.[0]?.driverConfig
+      const test = await ctrl.testDriver('modbus-tcp', cfg as Record<string, unknown>)
+      check('五协议模拟器导出配置 → 网关连通测试通过', test.ok === true, JSON.stringify(cfg))
+    }
+    else {
+      check('五协议模拟器连通性交叉验证', false, '无 modbus-tcp 设备(模拟器未启动或无预设)')
+    }
+  }
+  catch (err) {
+    check('五协议模拟器连通性交叉验证', false, `模拟器不可达:${err instanceof Error ? err.message : String(err)}`)
+  }
+
+  console.log('\n--- ⑨ 标准转换模式:线级双向换算验证(原始寄存器字核对) ---')
+  const ModbusRTU = (await import('modbus-serial')).default
+  const raw = new ModbusRTU()
+  await raw.connectTCP('127.0.0.1', { port: SIM_PORT })
+  raw.setID(1)
+  // float32 直写模式:速度SP 40023(2 寄存器,大端)
+  const f32 = ctrl.createParamMapping({
+    key: 'oven_f32', templateRef: 'dcw-speed-sp', name: '转换验证·float32', lineId: line.id,
+    access: { host: '127.0.0.1', port: SIM_PORT, unitId: 1, register: 40023, conversion: { mode: 'float32' } },
+  })
+  check('access 一键建映射:自动建节点+参数面+float32 模式留存', !!f32.nodeId && f32.conversion?.mode === 'float32', `${f32.id} → ${f32.nodeId}`)
+  check('映射视图仍不透出 driverConfig', !JSON.stringify(f32).includes('driverConfig'))
+  await ctrl.writeParam(f32.id, 320)
+  const w32 = await raw.readHoldingRegisters(40023 - 40001, 2)
+  const buf32 = Buffer.alloc(4)
+  buf32.writeUInt16BE(w32.data[0]!, 0)
+  buf32.writeUInt16BE(w32.data[1]!, 2)
+  check('float32 直写:PLC 寄存器字 = float32BE(320)', Math.abs(buf32.readFloatBE(0) - 320) < 0.01, `words=[${w32.data}]`)
+  // int16 线性标定模式:eng 0~50 ↔ raw 0~500,寄存器 40025(1 寄存器)
+  const i16 = ctrl.createParamMapping({
+    key: 'oven_i16', templateRef: 'dcw-tension-sp', name: '转换验证·int16标定', lineId: line.id,
+    access: { host: '127.0.0.1', port: SIM_PORT, unitId: 1, register: 40025, conversion: { mode: 'int16-scaled', engMin: 0, engMax: 50, rawMin: 0, rawMax: 500 } },
+  })
+  await ctrl.writeParam(i16.id, 22)
+  const w16 = await raw.readHoldingRegisters(40025 - 40001, 1)
+  check('int16 线性标定写:eng 22 → 原始字 220(0.1 分辨率)', w16.data[0] === 220, `word=${w16.data[0]}`)
+  // 读方向:原始字 300 → 工程值 30.0(接收同样自动换算)
+  await raw.writeRegister(40025 - 40001, 300)
+  const rd16 = await ctrl.readParam(i16.id)
+  check('int16 线性标定读:原始字 300 → 工程值 30', rd16.ok && Math.abs((rd16.value ?? 0) - 30) < 0.01, `value=${rd16.value}`)
+  // 非法转换模式在配置期即拒
+  const eBadConv = await errOf(() => ctrl.createParamMapping({
+    key: 'bad-conv', templateRef: 'dcw-temp-sp', lineId: line.id,
+    access: { host: '127.0.0.1', register: 40021, conversion: { mode: 'int16-scaled' } as never },
+  }))
+  check('int16 标定缺量程 → 配置期 400 拒绝', eBadConv.status === 400, eBadConv.message.slice(0, 80))
+  raw.close()
+
+  console.log('\n--- 清理 ---')
+  // removeLine 自带活动批次窗口停止;lineStop 为同步抛错方法,勿在此直调
+  await ctrl.removeLine(line.id, { purge: true })
+  await ctrl.removeLine(line2.id, { purge: true })
+  check('产线 purge 后参数映射全部清理', paramRepo.listViews().filter(p => [line.id, line2.id].includes(p.lineId)).length === 0)
+}
+catch (err) {
+  failures += 1
+  console.error('\nE2E 异常中断:', err)
+}
+finally {
+  sim.kill()
+}
+
+console.log(`\n${failures === 0 ? '✅ 全部通过' : `❌ ${failures} 项失败`}  (AW_HOME=${awHome})`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/_dbg-param-map-rest-smoke.mjs

@@ -0,0 +1,73 @@
+/**
+ * 工艺参数映射 REST 冒烟(真实 dev server):
+ * ①params 列表(登录态 + 产线可见性过滤) ②建节点自动生成参数面(REST 视图无寄存器细节)
+ * ③param 写/读路由 ④param 基准限界 → 越界 400 ⑤产品限界落库 → 运行期产品层拦截
+ * ⑥清理(产线 purge)。mock 驱动,不依赖外部模拟器。
+ * 运行: node scripts/_dbg-param-map-rest-smoke.mjs(ROOT/E2E_USER/E2E_PASS 可覆盖)
+ */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3001'
+let failed = 0
+const check = (name, ok, detail = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!ok) failed++ }
+
+/** 认证:AW_E2E_TOKEN 直用(隔离实例首注册 token);否则 E2E_USER/E2E_PASS 登录(docs/full-test-plan.md 测试账号) */
+let __token = process.env.AW_E2E_TOKEN
+if (!__token) {
+  const login = await fetch(`${ROOT}/api/users/login`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ email: process.env.E2E_USER ?? 'admin@awshop.local', password: process.env.E2E_PASS ?? 'admin123' }) }).then(r => r.json())
+  __token = login.data?.token
+  check('登录', !!__token, login.message ?? '')
+}
+else {
+  check('使用 AW_E2E_TOKEN', true)
+}
+const H = { authorization: `Bearer ${__token}`, 'content-type': 'application/json' }
+const j = (u, m = 'GET', b) => fetch(ROOT + u, { method: m, headers: H, body: b ? JSON.stringify(b) : undefined }).then(r => r.json())
+
+try {
+  // ① 列表路由
+  const list = await j('/api/workshop/dcw/params?limits=1')
+  check('GET /dcw/params 路由可用(含 limits 剖面)', Array.isArray(list.data?.params) && list.data.limits != null, `params=${list.data?.params?.length}`)
+
+  // ② 建线 + 建节点(mock)→ 自动参数面
+  const line = (await j('/api/workshop/dcw/lines', 'POST', { name: `PP冒烟线-${Date.now().toString(36)}` })).data?.line
+  check('创建产线', !!line?.id)
+  const node = (await j('/api/workshop/dcw', 'POST', { templateRef: 'dcw-pressure-sp', name: 'PP冒烟·熔体压力', driver: 'mock', driverConfig: { key: `pp-rest-${Date.now()}` }, readIntervalMs: 0, lineId: line.id })).data?.node
+  check('创建执行节点(mock)', !!node?.id)
+  const after = await j('/api/workshop/dcw/params')
+  const pv = after.data.params.find(p => p.nodeId === node.id)
+  check('节点创建自动生成参数面(pressure-sp)', pv?.key === 'pressure-sp', pv?.id)
+  check('REST 参数视图不含寄存器/数据类型细节', !JSON.stringify(pv).includes('register') && !JSON.stringify(pv).includes('dataType'))
+
+  // ③④ 参数写/读 + 基准限界
+  const w1 = (await j(`/api/workshop/dcw/params/${pv.id}/write`, 'POST', { value: 0.9 })).data?.outcome
+  check('param write 0.9MPa 成功(mock 回读一致)', w1?.ok === true, w1?.message)
+  const rd = (await j(`/api/workshop/dcw/params/${pv.id}/read`, 'POST', {})).data?.read
+  check('param read 返回物理值', rd?.ok === true && Math.abs((rd.value ?? 0) - 0.9) < 0.01, `value=${rd?.value}`)
+  await j(`/api/workshop/dcw/params/${pv.id}`, 'PATCH', { min: 0.7, max: 1.1 })
+  const w2 = await j(`/api/workshop/dcw/params/${pv.id}/write`, 'POST', { value: 1.15 })
+  check('越基准限界 1.15 → 400 点名参数层', w2.code === 'VALIDATION_ERROR' && w2.message?.includes('基准限界'), w2.message?.slice(0, 80))
+
+  // ⑤ 产品限界 → 运行期产品层拦截
+  const product = (await j('/api/workshop/dcw/products', 'POST', { name: 'PP冒烟产品', lineId: line.id, paramLimits: { 'pressure-sp': { min: 0.8, max: 1.0 } } })).data?.product
+  check('产品限界落库(0.8~1.0)', product?.paramLimits?.['pressure-sp']?.max === 1.0)
+  const recipe = (await j('/api/workshop/dcw/recipes', 'POST', { productId: product.id, name: 'PP冒烟配方', params: [{ nodeId: node.id, value: 0.9, min: 0.75, max: 1.05 }] })).data?.recipe
+  const start = await j(`/api/workshop/dcw/lines/${line.id}/start`, 'POST', { recipeId: recipe.id })
+  check('产线开跑', !!start.data?.run?.id, start.message)
+  const w3 = await j(`/api/workshop/dcw/params/${pv.id}/write`, 'POST', { value: 1.05 })
+  check('1.05 超产品上限 1.0 → 400 点名产品层', w3.code === 'VALIDATION_ERROR' && w3.message?.includes('产品'), w3.message?.slice(0, 80))
+  const w4 = (await j(`/api/workshop/dcw/params/${pv.id}/write`, 'POST', { value: 0.95 })).data?.outcome
+  check('0.95 交集内 → 通过', w4?.ok === true)
+  await j(`/api/workshop/dcw/lines/${line.id}/stop`, 'POST', {})
+
+  // ⑥ 清理
+  const del = await j(`/api/workshop/dcw/lines/${line.id}?purge=1`, 'DELETE')
+  check('产线 purge 清理', del.code === 0 || del.removed != null || del.data != null, JSON.stringify(del).slice(0, 80))
+  const afterDel = await j('/api/workshop/dcw/params')
+  check('purge 后参数面同步清理', !afterDel.data.params.some(p => p.id === pv.id))
+}
+catch (err) {
+  failed += 1
+  console.error('冒烟异常中断:', err)
+}
+
+console.log(`\n${failed === 0 ? '✅ REST 冒烟全部通过' : `❌ ${failed} 项失败`}`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/_dbg-param-real-scenario.mjs

@@ -0,0 +1,153 @@
+/**
+ * 真实场景测试:用户/Agent 只管工艺参数(设温度多少度),PLC 细节由标准转换模式封装。
+ *
+ *  前置:隔离 AW 实例(E2E_ROOT,首注册即 admin)+ 运行中的 plc-node-simulator(E2E_SIM_API)。
+ *  ①配置阶段(集成工程师,一次性):取模拟器「对接导出」→ 以标准转换模式(float32)一键建工艺参数映射
+ *  ②运行阶段(用户视角):参数列表(无寄存器细节)→ 设 温度185/210 → 模拟器 API 确认真实收到 →
+ *    参数读回一致 → 越基准限界 400 → 模拟器侧手动改值 → 用户参数读到新值(读方向同样自动换算)
+ *  ③收尾:模拟器信号值复原 + 产线 purge。
+ * 运行: node scripts/_dbg-param-real-scenario.mjs
+ */
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3399'
+const SIM_API = process.env.E2E_SIM_API ?? 'http://127.0.0.1:4010'
+let failed = 0
+const check = (name, ok, detail = '') => { console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`); if (!ok) failed++ }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const j = async (base, u, m = 'GET', b, h = {}) => {
+  const r = await fetch(base + u, { method: m, headers: { 'content-type': 'application/json', ...h }, body: b ? JSON.stringify(b) : undefined }).then(x => x.json())
+  if (r.error) return { ...r, _status: r.statusCode }
+  return r
+}
+
+// ---- 认证:AW_E2E_TOKEN > token 缓存文件(首注册即 admin,复跑复用) > 现场注册 ----
+let token = process.env.AW_E2E_TOKEN
+const tokenFile = process.env.AW_SCENE_TOKEN_FILE ?? '.tmp-scene-home/admin-token.txt'
+if (!token) {
+  try {
+    token = (await import('node:fs')).readFileSync(tokenFile, 'utf8').trim() || null
+  }
+  catch { /* 无缓存 */ }
+  if (token) check('复用已缓存管理员 token', true)
+}
+if (!token) {
+  const reg = await j(ROOT, '/api/workshop/users/register', 'POST', { name: `scene-admin-${Date.now().toString(36)}` })
+  token = reg.data?.token
+  check('注册管理员(隔离实例,首注册即 admin)', !!token)
+  if (token) {
+    try {
+      ;(await import('node:fs')).mkdirSync(tokenFile.replace(/[/\\][^/\\]+$/, ''), { recursive: true })
+      ;(await import('node:fs')).writeFileSync(tokenFile, token)
+    }
+    catch { /* 缓存失败不影响本次 */ }
+  }
+}
+const H = { authorization: `Bearer ${token}` }
+const api = (u, m = 'GET', b) => j(ROOT, u, m, b, H)
+const sim = (u, m = 'GET', b) => j(SIM_API, u, m, b)
+
+try {
+  // ---- ① 配置阶段(一次性;模拟器导出 → 标准转换模式建映射) ----
+  console.log('\n--- ① 配置阶段:模拟器对接导出 → 标准转换模式一键建工艺参数映射 ---')
+  const nodes = await sim('/api/nodes')
+  const dev = (nodes.data ?? []).find(n => n.protocol === 'modbus-tcp')
+  check('发现 plc-node-simulator Modbus TCP 设备', !!dev?.id, `${dev?.id}(${dev?.name})`)
+  const exp = await sim(`/api/nodes/${dev.id}/export`)
+  const items = exp.data?.items ?? []
+  check('导出对接配置(寄存器/数据类型/字节序由模拟器给出)', items.length >= 2, items.map(i => `${i.signal}@${i.driverConfig.register}`).join(', '))
+
+  const line = (await api('/api/workshop/dcw/lines', 'POST', { name: '1号挤出线(参数映射)' })).data?.line
+  check('创建产线', !!line?.id)
+
+  // 两个工艺参数:加热区1/加热区2 温度,float32 直写标准模式,基准限界 160~190(收窄于模板量程 150~200)
+  const mkParam = async (item, key, name) => {
+    const cfg = item.driverConfig
+    const r = await api('/api/workshop/dcw/params', 'POST', {
+      key, name, templateRef: 'dcw-temp-sp', lineId: line.id,
+      min: 160, max: 190,
+      access: {
+        host: cfg.host, port: cfg.port, unitId: cfg.unitId, register: cfg.register,
+        conversion: { mode: 'float32', byteOrder: cfg.byteOrder },
+      },
+    })
+    return r.data?.param
+  }
+  const p1 = await mkParam(items[0], 'zone1_temp', '加热区1温度设定')
+  const p2 = await mkParam(items[1], 'zone2_temp', '加热区2温度设定')
+  check('工艺参数「zone1_temp」建映射成功(自动建执行节点)', !!p1?.id && !!p1.nodeId, `${p1?.id} → ${p1?.nodeId}`)
+  check('转换模式已留存(float32)', p1?.conversion?.mode === 'float32')
+  check('映射视图不含寄存器/数据类型(用户不可见)', !JSON.stringify(p1).includes('register') && !JSON.stringify(p1).includes('dataType'))
+
+  // ---- ② 运行阶段(用户只碰 key + 工程值) ----
+  console.log('\n--- ② 运行阶段:用户设定工艺参数 → 模拟器真实接收 → 参数读回 ---')
+  const list = await api('/api/workshop/dcw/params?lineId=' + line.id)
+  check('用户参数列表(2 条工艺参数)', (list.data?.params ?? []).length === 2, list.data?.params?.map(p => `${p.key}=${p.value}${p.unit}`).join(', '))
+
+  const simValueOf = async (signalName) => {
+    const ns = await sim('/api/nodes')
+    const sg = (ns.data ?? []).find(n => n.id === dev.id)?.signals?.find(s => s.name === signalName || s.id === signalName)
+    return sg?.value
+  }
+  const userSet = async (param, value) => {
+    const w = await api(`/api/workshop/dcw/params/${param.id}/write`, 'POST', { value })
+    return { ok: w.data?.outcome?.ok, msg: w.data?.outcome?.message ?? w.message }
+  }
+  const userRead = async (param) => {
+    const r = await api(`/api/workshop/dcw/params/${param.id}/read`, 'POST', {})
+    return { value: r.data?.read?.value, ok: r.data?.read?.ok, msg: r.data?.read?.message }
+  }
+  // 模拟器 SP 可能带一阶收敛,轮询直至到位
+  const waitSimValue = async (signalName, target, timeoutMs = 8000) => {
+    const t0 = Date.now()
+    for (;;) {
+      const v = await simValueOf(signalName)
+      if (v != null && Math.abs(v - target) <= 0.6) return v
+      if (Date.now() - t0 > timeoutMs) return v
+      await sleep(400)
+    }
+  }
+
+  console.log('  · 用户设定 加热区1温度 = 185℃')
+  const w1 = await userSet(p1, 185)
+  check('用户写入 185℃ 成功(含 PLC 回读确认)', w1.ok === true, w1.msg)
+  const sv1 = await waitSimValue(items[0].signal, 185)
+  check('PLC 模拟器真实收到:zone1 SP = 185', sv1 != null && Math.abs(sv1 - 185) <= 0.6, `sim.value=${sv1}`)
+  const r1 = await userRead(p1)
+  check('用户按参数读回 = 185℃(工程量纲)', r1.ok && Math.abs((r1.value ?? 0) - 185) <= 0.6, `value=${r1.value}`)
+
+  console.log('  · 用户设定 加热区2温度 = 175℃')
+  const w2 = await userSet(p2, 175)
+  check('用户写入 175℃ 成功', w2.ok === true, w2.msg)
+  const sv2 = await waitSimValue(items[1].signal, 175)
+  check('PLC 模拟器真实收到:zone2 SP = 175', sv2 != null && Math.abs(sv2 - 175) <= 0.6, `sim.value=${sv2}`)
+
+  console.log('  · 用户越界尝试 195℃...基准限界上限是 190(节点量程 150~200 之内)')
+  const w3 = await api(`/api/workshop/dcw/params/${p2.id}/write`, 'POST', { value: 195 })
+  check('越基准限界 → 400 点名参数层(用户不可越界)', (w3._status === 400 || w3.code === 'VALIDATION_ERROR') && String(w3.message).includes('基准限界'), String(w3.message).slice(0, 80))
+
+  console.log('  · 现场侧把 zone1 就地改到 172℃(模拟读方向)')
+  // 模拟器 manual 接口按信号 id 寻址(导出的 signal 字段是中文名,先换 id)
+  const simSignals = (await sim('/api/nodes')).data?.find(n => n.id === dev.id)?.signals ?? []
+  const signalIdOf = (name) => simSignals.find(s => s.name === name || s.id === name)?.id
+  await sim(`/api/nodes/${dev.id}/signals/${signalIdOf(items[0].signal)}/manual`, 'POST', { value: 172 })
+  await sleep(600)
+  const r2 = await userRead(p1)
+  check('用户参数读到现场实际值 172℃(接收方向同样自动换算)', r2.ok && Math.abs((r2.value ?? 0) - 172) <= 0.6, `value=${r2.value}`)
+
+  // ---- ③ 收尾 ----
+  console.log('\n--- ③ 收尾:模拟器复原 + 产线清理 ---')
+  for (const item of items.slice(0, 2)) {
+    await sim(`/api/nodes/${dev.id}/signals/${signalIdOf(item.signal)}/manual`, 'POST', { value: 200 })
+  }
+  const back1 = await waitSimValue(items[0].signal, 200, 5000)
+  check('模拟器信号值复原(200)', back1 != null && Math.abs(back1 - 200) <= 0.6, `sim.value=${back1}`)
+  await api(`/api/workshop/dcw/lines/${line.id}?purge=1`, 'DELETE')
+  const after = await api('/api/workshop/dcw/params')
+  check('产线 purge 后工艺参数映射清零', !(after.data?.params ?? []).some(p => [p1.id, p2.id].includes(p.id)))
+}
+catch (err) {
+  failed += 1
+  console.error('场景异常中断:', err)
+}
+
+console.log(`\n${failed === 0 ? '✅ 真实场景全部通过' : `❌ ${failed} 项失败`}`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/api-live-e2e.mjs

@@ -19,6 +19,24 @@
 const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3001'
 const WS_BASE = BASE.replace(/^http/, 'ws')
 
+// 网络层瞬断（本机代理 churn 间歇占满回环临时端口 → fetch failed/EADDRINUSE）
+// 用退避重试吸收；HTTP 语义错误不重试。与 bench/lib 侧瞬断策略一致。
+const rawFetch = globalThis.fetch.bind(globalThis)
+globalThis.fetch = async (input, init = {}) => {
+  let lastErr
+  for (let attempt = 1; attempt <= 8; attempt++) {
+    try {
+      return await rawFetch(input, { ...init, signal: init.signal ?? AbortSignal.timeout(30_000) })
+    }
+    catch (err) {
+      lastErr = err
+      if (init.signal?.aborted) throw err
+      if (attempt < 8) await new Promise(r => setTimeout(r, Math.min(800 * 2 ** (attempt - 1), 8000)))
+    }
+  }
+  throw lastErr
+}
+
 let failures = 0
 let passed = 0
 let step = 0
@@ -109,20 +127,34 @@ async function main() {
   const ch0 = await api('GET', '/api/workshop/channels')
   check('GET /channels 恢复 channel 列表', ch0.code === 0 && Array.isArray(ch0.data), `count=${ch0.data?.length}`)
   const persisted = (ch0.data ?? []).filter(c => c.leadAgentId)
-  check('恢复的 channel 带 lead 实例', persisted.length >= 1, `with-lead=${persisted.length}`)
+  // 该子检查依赖「上一轮遗留的 channel-with-lead」。首次运行/上轮已清理时按项目
+  // 失败语义诚实 skip(bench/PIPELINE.md:环境不具备宁可 skip 并写明原因,绝不伪造通过),
+  // 不计入 fail,也不得因缺前置数据而崩溃。
+  const hasPersisted = persisted.length >= 1
+  if (hasPersisted) {
+    check('恢复的 channel 带 lead 实例', true, `with-lead=${persisted.length}`)
+  }
+  else {
+    console.log('  SKIP  恢复的 channel 带 lead 实例 — 实例无历史 channel-with-lead(首次运行或上轮已清理);跨重启持久化由独立重启演练覆盖')
+  }
 
   const rt0 = await api('GET', '/api/workshop/runtime')
   check('GET /runtime 形状(懒加载状态)', rt0.code === 0 && Array.isArray(rt0.data?.wiredAgents) && Array.isArray(rt0.data?.activeChannels), `wired=${rt0.data?.wiredAgents?.length} active=${rt0.data?.activeChannels?.length}`)
   const rt0Wired = rt0.data?.wiredAgents?.length ?? 0
 
   // 详情请求触发 ensureChannelActive(懒加载恢复)
-  const probeId = persisted[0].id
-  const probe = await api('GET', `/api/workshop/channels/${probeId}`)
-  check('GET /channels/:id 详情(含成员)', probe.code === 0 && Array.isArray(probe.data?.agents) && probe.data.agents.length > 0, `agents=${probe.data?.agents?.length}`)
-  const rt1 = await api('GET', '/api/workshop/runtime')
-  check('详情请求后 lead 运行时装配(懒加载)', rt1.code === 0 && (rt1.data?.wiredAgents?.length ?? 0) >= rt0Wired, `wired=${rt1.data?.wiredAgents?.length} active=${rt1.data?.activeChannels?.length}`)
-  const persistedTasks = await api('GET', `/api/workshop/channels/${probeId}/tasks`)
-  check('GET /channels/:id/tasks 恢复历史任务', persistedTasks.code === 0, `tasks=${persistedTasks.data?.length}`)
+  const probeId = hasPersisted ? persisted[0].id : null
+  if (probeId) {
+    const probe = await api('GET', `/api/workshop/channels/${probeId}`)
+    check('GET /channels/:id 详情(含成员)', probe.code === 0 && Array.isArray(probe.data?.agents) && probe.data.agents.length > 0, `agents=${probe.data?.agents?.length}`)
+    const rt1 = await api('GET', '/api/workshop/runtime')
+    check('详情请求后 lead 运行时装配(懒加载)', rt1.code === 0 && (rt1.data?.wiredAgents?.length ?? 0) >= rt0Wired, `wired=${rt1.data?.wiredAgents?.length} active=${rt1.data?.activeChannels?.length}`)
+    const persistedTasks = await api('GET', `/api/workshop/channels/${probeId}/tasks`)
+    check('GET /channels/:id/tasks 恢复历史任务', persistedTasks.code === 0, `tasks=${persistedTasks.data?.length}`)
+  }
+  else {
+    console.log('  SKIP  详情/懒加载装配/历史任务 — 无持久化 channel 可探')
+  }
 
   // ═══════════ 2. AGENT 模板 CRUD ═══════════
   section('AGENT 模板 CRUD(全局定义)')