agentworkshop 0.2.1

package/scripts/_dbg-full-feature-e2e.mjs

@@ -0,0 +1,219 @@
+/**
+ * 全功能端到端验证(针对运行中的 dev 环境,默认 http://127.0.0.1:3000)。
+ * 覆盖:产线搭建与开跑 → 数采实时 → 产线控制联锁(配方窗口)→ AgentTeam 部署
+ *   → Agent 绑定工业节点 → 工具桥冒烟 → goal 任务派发 → lead 调度 → 真实 omp
+ *   worker 执行(my_industrial_nodes/daq_query/dcw_control)→ HITL 审批 →
+ *   写副作用(设定值变化)→ 任务完成 → 打标抽查 → 清理。
+ * 运行: node scripts/_dbg-full-feature-e2e.mjs
+ */
+const ROOT = process.env.AW_BASE ?? 'http://127.0.0.1:3000'
+let TOKEN = process.env.AW_E2E_TOKEN ?? ''
+const H = () => ({ authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' })
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+let failures = 0
+const check = (name, ok, detail = '') => {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures++
+}
+const fail = (m) => { console.error('FATAL:', m); process.exit(1) }
+
+async function api(method, path, body) {
+  const res = await fetch(ROOT + path, { method, headers: H(), body: body !== undefined ? JSON.stringify(body) : undefined })
+  const json = await res.json().catch(() => ({}))
+  return { status: res.status, ...json }
+}
+const jpost = (u, b) => api('POST', u, b ?? {})
+const jget = (u) => api('GET', u)
+const jdel = (u) => api('DELETE', u)
+const invoke = async (agentId, tool, args) => {
+  const r = await jpost('/api/workshop/agent-tools/invoke', { agentId, tool, args })
+  return r.data?.result ?? { text: JSON.stringify(r).slice(0, 200), isError: true }
+}
+
+const cleanup = []
+const tag = Math.random().toString(36).slice(2, 8)
+
+async function main() {
+  // ===== 0. 用户注册 =====
+  console.log('━━━ 0. 用户注册 ━━━')
+  const reg = await jpost('/api/workshop/users/register', { name: 'ffx-' + tag })
+  TOKEN = reg.data?.token
+  if (!TOKEN) fail('用户注册失败: ' + JSON.stringify(reg).slice(0, 120))
+  check('用户注册并取得 token', !!TOKEN)
+
+  // ===== 1. 产线搭建:1 线 1 产品 2 数采 1 数控 + 配方 + 开跑 =====
+  console.log('\n━━━ 1. 产线搭建与开跑 ━━━')
+  const line = (await jpost('/api/workshop/dcw/lines', { name: '全功能验证线-' + tag })).data.line
+  cleanup.push(['dcw-line', line.id])
+  const prod = (await jpost('/api/workshop/dcw/products', { name: '全功能产品-' + tag, lineId: line.id })).data.product
+  cleanup.push(['dcw-product', prod.id])
+  const dq = (await jpost('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: 'FFX-温度采集', lineId: line.id, intervalMs: 500 })).data.node
+  const dq2 = (await jpost('/api/workshop/daq', { templateRef: 'daq-pressure-tx', name: 'FFX-压力采集', lineId: line.id, intervalMs: 500 })).data.node
+  cleanup.push(['daq', dq.id], ['daq', dq2.id])
+  const dw = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: 'FFX-温度设定', lineId: line.id })).data.node
+  cleanup.push(['dcw', dw.id])
+  check('产线实体创建(2 数采 + 1 数控)', !!dq?.id && !!dq2?.id && !!dw?.id)
+  const rc = (await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: '全功能配方-' + tag,
+    params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 176, max: 188 }],
+    daqWindows: [{ nodeId: dq.id, min: 100, max: 260 }],
+  })).data.recipe
+  cleanup.push(['dcw-recipe', rc.id])
+  check('配方创建(temp-sp@180,窗口 176~188;daq 窗口 100~260)', !!rc?.id)
+  const st = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  check('产线开跑(active)', !!st.data?.line?.active, `active=${st.data?.line?.active}`)
+  await sleep(3000)
+  const daqNodes = (await jget('/api/workshop/daq')).data.nodes
+  const dqLive = daqNodes.find(n => n.id === dq.id)
+  check('数采实时值流动', dqLive?.value != null, `temp=${dqLive?.value}${dqLive?.unit ?? ''} state=${dqLive?.state}`)
+  const dwLive = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+  check('数控设定值已由配方下发(180)', Math.abs((dwLive?.value ?? 0) - 180) < 0.01, `value=${dwLive?.value}`)
+
+  // ===== 2. 产线控制联锁(REST 直写;配方窗口替代全局量程) =====
+  console.log('\n━━━ 2. 产线控制联锁(配方窗口)━━━')
+  const wOk = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 182 })
+  check('窗口内写入 182 成功', wOk.status === 200 && wOk.data?.outcome?.ok === true, `readback=${wOk.data?.outcome?.readback}`)
+  const wLow = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 170 })
+  check('低于工艺下限 176 被拒(400)', wLow.status === 400, `status=${wLow.status} msg=${String(wLow.message ?? '').slice(0, 60)}`)
+  const wHigh = await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 200 })
+  check('高于工艺上限 188 被拒(400)', wHigh.status === 400, `status=${wHigh.status}`)
+  await jpost(`/api/workshop/dcw/${dw.id}/write`, { value: 180 }) // 复位
+
+  // ===== 3. AgentTeam:分析团队(lead mock + worker omp)部署 =====
+  console.log('\n━━━ 3. AgentTeam 部署 ━━━')
+  const chRes = (await jpost('/api/workshop/channels', { name: '全功能团队-' + tag, description: '产线数据分析与工艺优化' })).data
+  const ch = { id: chRes.channelId }
+  cleanup.push(['channel', ch.id])
+  check('channel 创建', !!ch.id)
+  const team = (await jpost('/api/workshop/teams', { name: '全功能分析组-' + tag, description: '数据分析 + 工艺优化' })).data
+  cleanup.push(['team', team.id])
+  check('团队创建', !!team?.id)
+  await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: 'tpl-default-lead', role: 'lead' })
+  const tplWorker = (await jpost('/api/workshop/agents', {
+    name: '数据分析工程师-' + tag, harness: 'omp',
+    config: {
+      intro: '负责从数采时序库获取产线数据、分析趋势,并按分析结论对数控设定下发工艺优化',
+      systemPromptPrefix: '你是产线数据分析工程师。先用 my_industrial_nodes 查看你的授权节点,再用 daq_query 获取最近 5 分钟数据并给出均值。若温度均值与 182℃ 偏差超过 1℃,用 dcw_control 把温度设定调整为 182(你的温度设定节点是手动确认模式,发起后等待用户批准)。结论必须引用具体数值。',
+    },
+  })).data
+  cleanup.push(['agent-tpl', tplWorker.id])
+  await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: tplWorker.id, role: 'worker' })
+  const dep = await jpost(`/api/workshop/teams/${team.id}/deploy`, { channelId: ch.id })
+  const chAgents = (await jget(`/api/workshop/channels/${ch.id}/agents`)).data
+  const leadInst = chAgents.find(a => a.role === 'lead')
+  const workerInst = chAgents.find(a => a.role === 'worker')
+  cleanup.push(['channel-agent', `${ch.id}:${leadInst?.id}`], ['channel-agent', `${ch.id}:${workerInst?.id}`])
+  check('部署 lead+worker 实例进入 channel', !!leadInst && !!workerInst, `harness(lead)=${leadInst?.harness} harness(worker)=${workerInst?.harness}`)
+
+  // ===== 4. Agent 绑定工业节点 =====
+  console.log('\n━━━ 4. Agent 绑定工业节点 ━━━')
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dq.id, kind: 'daq', mode: 'auto' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dq2.id, kind: 'daq', mode: 'auto' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dw.id, kind: 'dcw', mode: 'manual' })
+  const bl = (await jget(`/api/workshop/agent-tools/bindings?agentId=${workerInst.id}`)).data.bindings
+  check('worker 绑定 2 数采(auto)+ 1 数控(manual)', bl.length === 3, `n=${bl.length}`)
+
+  // ===== 5. 工具桥冒烟(与 omp host tools 同一服务层) =====
+  console.log('\n━━━ 5. 工具桥冒烟 ━━━')
+  const mine = await invoke(workerInst.id, 'my_industrial_nodes', {})
+  check('my_industrial_nodes:3 节点物理语义齐备', mine.text?.includes('FFX-温度采集') && mine.text?.includes('FFX-温度设定'), mine.text?.slice(0, 80))
+  const q = await invoke(workerInst.id, 'daq_query', { last_minutes: 5 })
+  check('daq_query:双节点数据 + 统计语义', q.text?.includes('FFX-温度采集'), q.text?.slice(0, 80))
+  const qDenied = await invoke('nonexistent-agent', 'daq_query', {})
+  check('未绑定 Agent 调用被拒', qDenied.isError === true)
+
+  // ===== 6. goal 任务派发:数据分析 → 判断偏差 → 下发修正 =====
+  console.log('\n━━━ 6. goal 任务派发(真实 omp worker 执行)━━━')
+  const goal = `请分析产线当前运行状态:1) 用你的数采工具获取最近 5 分钟温度数据并给出均值;2) 判断温度均值与 182℃ 目标的偏差;3) 偏差超过 1℃ 时,用数控工具把温度设定调整为 182(手动确认模式,发起后等待批准)。完成后汇报数值结论。`
+  const task = (await jpost(`/api/workshop/channels/${ch.id}/tasks`, {
+    title: '产线数据分析与工艺优化-' + tag,
+    parts: [{ text: goal }],
+    mode: 'goal',
+    modeConfig: { goalCriteria: '已产出含具体数值的数据分析结论,且温度设定值已调整为 182℃ 附近(或明确说明未需调整)' },
+  })).data
+  const taskId = task?.task?.id ?? task?.id
+  check('goal 任务已提交', !!taskId, `id=${taskId?.slice(0, 8)}`)
+  cleanup.push(['task', taskId])
+
+  // ===== 7. 观察调度 → 执行 → HITL → 写副作用 → 完成 =====
+  console.log('\n━━━ 7. 观察:调度 → omp 执行 → HITL → 副作用 ━━━')
+  let subTaskSeen = false, hitlSeen = false, workerValueSeen = false, approved = false
+  let subState = '', lastLog = 0
+  const t0 = Date.now()
+  for (let i = 0; i < 200; i++) {
+    await sleep(3000)
+    const tasksRes = (await jget(`/api/workshop/channels/${ch.id}/tasks`)).data
+    const tasks = Array.isArray(tasksRes) ? tasksRes : tasksRes?.tasks ?? []
+    const sub = tasks.find(t => t.id !== taskId)
+    if (sub && !subTaskSeen) {
+      subTaskSeen = true
+      console.log(`[t+${Math.round((Date.now() - t0) / 1000)}s] [调度] lead 已派发子任务 ${sub.id.slice(0, 8)} → ${sub.assigneeId?.slice(0, 8)}`)
+    }
+    if (sub) subState = sub.state
+    // HITL:worker 发起 dcw_control → 审批面板出现 → 批准
+    if (!approved) {
+      const pend = (await jget(`/api/workshop/agent-tools/approvals?agentId=${workerInst.id}`)).data.approvals
+      if (pend.length > 0 && !hitlSeen) {
+        hitlSeen = true
+        console.log(`[t+${Math.round((Date.now() - t0) / 1000)}s] [HITL] Agent 发起下发审批: ${String(pend[0].detail).slice(0, 70)}`)
+        await jpost(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, { approved: true, comment: '分析结论合理,批准执行' })
+        approved = true
+        console.log(`[t+${Math.round((Date.now() - t0) / 1000)}s] [HITL] 用户已批准`)
+      }
+    }
+    // 写副作用:温度设定被 Agent 更新为 182±3
+    const dwNow = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+    if (dwNow?.value != null && Math.abs(dwNow.value - 182) <= 3 && dwNow.value !== 180) workerValueSeen = true
+    if (i % 10 === 0 && i > 0) {
+      const mem = (await jget(`/api/workshop/channels/${ch.id}/queue`)).data
+      const arr = Array.isArray(mem) ? mem : []
+      console.log(`  [t+${i * 3}s] tasks: ${tasks.map(t => t.state).join(',')} | agents: ${arr.map(m => `${m.role}:${m.state}`).join(',')}`)
+    }
+    const parentDone = tasks.find(t => t.id === taskId)?.state === 'COMPLETED'
+    if (workerValueSeen && (parentDone || subState === 'COMPLETED' || i > 90)) break
+  }
+  check('lead 调度:主任务拆解并派发子任务', subTaskSeen)
+  check('HITL:Agent 经工具发起数控下发,用户批准后执行', hitlSeen)
+  const dwFinal = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+  check('写副作用:温度设定被 Agent 更新为 182 附近', workerValueSeen, `value=${dwFinal?.value}℃(目标 182)`)
+  const parentState = (await jget(`/api/workshop/channels/${ch.id}/tasks`)).data
+  const parent = (Array.isArray(parentState) ? parentState : parentState?.tasks ?? []).find(t => t.id === taskId)
+  check('goal 任务最终完成', parent?.state === 'COMPLETED', `state=${parent?.state} sub=${subState}`)
+
+  // ===== 8. 打标/孪生抽查 =====
+  console.log('\n━━━ 8. 打标与数据链路抽查 ━━━')
+  const states = (await jget('/api/workshop/dcw/lines')).data.states
+  const stLine = states.find(s => s.lineId === line.id)
+  check('数据打标:产线窗口内样本带产线标识', stLine?.active && stLine.taggedSamples > 0, `tagged=${stLine?.taggedSamples}`)
+  const qAfter = await invoke(workerInst.id, 'daq_query', { last_minutes: 5 })
+  check('Agent 可持续获取打标数据的物理语义视图', qAfter.text?.includes('均值') || qAfter.text?.includes('FFX-温度采集'))
+}
+
+main()
+  .then(async () => {
+    console.log('\n━━━ 清理 ━━━')
+    for (const [kind, id] of [...cleanup].reverse()) {
+      try {
+        if (kind === 'dcw-line') await jpost(`/api/workshop/dcw/lines/${id}/stop`, {})
+        else if (kind === 'daq') await jdel(`/api/workshop/daq/${id}`)
+        else if (kind === 'dcw') await jdel(`/api/workshop/dcw/${id}`)
+        else if (kind === 'dcw-recipe') await jdel(`/api/workshop/dcw/recipes/${id}`)
+        else if (kind === 'dcw-product') await jdel(`/api/workshop/dcw/products/${id}`)
+        else if (kind === 'task') await jpost(`/api/workshop/channels/unknown/tasks/${id}/cancel`, {}).catch(() => {})
+        else if (kind === 'channel-agent') {
+          const [cid, aid] = String(id).split(':')
+          await jdel(`/api/workshop/channels/${cid}/agents/${aid}`)
+        }
+        else if (kind === 'channel') await jdel(`/api/workshop/channels/${id}`)
+        else if (kind === 'team') await jdel(`/api/workshop/teams/${id}`)
+        else if (kind === 'agent-tpl') await jdel(`/api/workshop/agents/${id}`)
+      }
+      catch { /* 清理尽力而为 */ }
+    }
+    console.log(failures === 0 ? '\nE2E ALL PASS' : `\nE2E ${failures} FAILED`)
+    process.exit(failures === 0 ? 0 : 1)
+  })
+  .catch((err) => {
+    console.error('FATAL:', err.message)
+    process.exit(1)
+  })

package/scripts/_dbg-fullchain-e2e.mjs

@@ -0,0 +1,178 @@
+/**
+ * 全链条端到端审计:真实 omp Harness Agent 团队 × mock 产线。
+ * 链路:建 channel/团队 → 部署 lead+worker(omp)→ 搭产线(数采/数控/配方/开跑)
+ *   → Agent 绑定工业节点 → 派发分析任务 → lead 调度派发 → worker 用
+ *   my_industrial_nodes/daq_query 读数 → dcw_control 下发 → HITL 批准
+ *   → 任务完成/告警/孪生同步 → 清理。
+ */
+const TOKEN = 'ut-ffc1dfbbc0c1444c87c1ec69a9e8208c'
+const ROOT = process.env.E2E_ROOT ?? 'http://127.0.0.1:3000'
+const H = { authorization: `Bearer ${TOKEN}`, 'content-type': 'application/json' }
+const sleep = (ms) => new Promise(r => setTimeout(r, ms))
+const fail = (m) => { console.error('FAIL:', m); process.exitCode = 1 }
+const jpost = (u, b) => fetch(ROOT + u, { method: 'POST', headers: H, body: JSON.stringify(b ?? {}) }).then(r => r.json())
+const jget = (u) => fetch(ROOT + u, { headers: H }).then(r => r.json())
+const jdel = (u) => fetch(ROOT + u, { method: 'DELETE', headers: H }).then(r => r.json())
+const invoke = (agentId, tool, args) => jpost('/api/workshop/agent-tools/invoke', { agentId, tool, args }).then(r => r.data.result)
+
+const cleanup = []
+async function main() {
+  // ===== 1. mock 产线:1 线 2 数采 2 数控 + 配方 + 开跑 =====
+  const line = (await jpost('/api/workshop/dcw/lines', { name: '全链路审计线' })).data.line
+  cleanup.push(['dcw-line', line.id])
+  const prod = (await jpost('/api/workshop/dcw/products', { name: '全链路审计产品', lineId: line.id })).data.product
+  cleanup.push(['dcw-product', prod.id])
+  const dq = (await jpost('/api/workshop/daq', { templateRef: 'daq-temp-tc', name: 'E2E-温度采集', lineId: line.id, intervalMs: 500 })).data.node
+  const dq2 = (await jpost('/api/workshop/daq', { templateRef: 'daq-pressure-tx', name: 'E2E-压力采集', lineId: line.id, intervalMs: 500 })).data.node
+  const dw = (await jpost('/api/workshop/dcw', { templateRef: 'dcw-temp-sp', name: 'E2E-温度设定', lineId: line.id })).data.node
+  cleanup.push(['daq', dq.id], ['daq', dq2.id], ['dcw', dw.id])
+  const rc = (await jpost('/api/workshop/dcw/recipes', {
+    productId: prod.id, name: '全链路审计配方',
+    params: [{ templateRef: 'dcw-temp-sp', nodeId: dw.id, value: 180, min: 176, max: 188 }],
+    daqWindows: [{ nodeId: dq.id, min: 100, max: 260 }],
+  })).data.recipe
+  cleanup.push(['dcw-recipe', rc.id])
+  const st = await jpost(`/api/workshop/dcw/lines/${line.id}/start`, { recipeId: rc.id })
+  if (!st.data?.line?.active) { fail('产线开跑失败'); process.exit(1) }
+  await sleep(2500)
+  const daqLive = (await jget('/api/workshop/daq')).data.nodes.find(n => n.id === dq.id)
+  console.log(`[产线] ${line.name} 运行中,数采实时 ${daqLive?.value}${daqLive?.unit}(${daqLive?.state})`)
+
+  // ===== 2. AgentTeam:分析团队(lead + 数据工程师,omp harness) =====
+  const chRes = (await jpost('/api/workshop/channels', { name: '产线优化团队(E2E)', description: '全链路审计' })).data
+  const ch = { id: chRes.channelId }
+  cleanup.push(['channel', ch.id])
+  const team = (await jpost('/api/workshop/teams', { name: '产线分析组(E2E)', description: '数据获取分析与工艺优化' })).data
+  if (!team) { fail('团队创建失败'); process.exit(1) }
+  cleanup.push(['team', team.id])
+  console.log(`[团队] ${team.name}(${team.id.slice(0, 8)})`)
+
+  // lead:产线优化主管(omp);worker:数据分析工程师(omp,提示词驱动用工业工具)
+  await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: 'tpl-default-lead', role: 'lead' })
+  const tplWorkerResp = await jpost('/api/workshop/agents', {
+    name: '数据分析工程师(E2E)', harness: 'omp',
+    config: {
+      intro: '负责从数采时序库获取产线数据、分析趋势,并按分析结论对数控设定下发工艺优化',
+      systemPromptPrefix: '你是产线数据分析工程师。用 my_industrial_nodes 查看授权节点,用 daq_query 获取最新数据并分析均值/趋势,如需调整工艺用 dcw_control 下发(目标:温度均值向 182 靠拢)。结论需引用具体数值。',
+    },
+  })
+  const tplWorker = tplWorkerResp.data
+  cleanup.push(['agent-tpl', tplWorker.id])
+  const worker = await jpost(`/api/workshop/teams/${team.id}/members`, { agentId: tplWorker.id, role: 'worker' })
+  console.log(`[团队] lead + worker 成员就绪(${team.members?.length ?? '?'} 人)`)
+
+  // 部署到 channel
+  const dep = await jpost(`/api/workshop/teams/${team.id}/deploy`, { channelId: ch.id })
+  const members = Array.isArray(dep.data) ? dep.data : dep.data?.deployed ?? dep.data?.members ?? []
+  console.log(`[部署] ${members.length} 个 Agent 实例进入 channel(${JSON.stringify(dep).slice(0, 80)}...)`)
+
+  // 部署后的实例 id(worker/lead)
+  const chAgents = (await jget(`/api/workshop/channels/${ch.id}/agents`)).data
+  const leadInst = chAgents.find(a => a.role === 'lead')
+  const workerInst = chAgents.find(a => a.role === 'worker')
+  if (!leadInst || !workerInst) { fail(`部署实例缺失: ${chAgents.length}`); process.exit(1) }
+  for (const a of [leadInst, workerInst]) cleanup.push(['channel-agent', `${ch.id}:${a.id}`])
+  console.log(`[实例] lead ${leadInst.id.slice(0, 8)} / worker ${workerInst.id.slice(0, 8)}(harness=${workerInst.harness})`)
+
+  // ===== 3. 绑定工业节点给 worker 实例 =====
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dq.id, kind: 'daq', mode: 'auto' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dq2.id, kind: 'daq', mode: 'auto' })
+  await jpost('/api/workshop/agent-tools/bindings', { agentId: workerInst.id, nodeId: dw.id, kind: 'dcw', mode: 'manual' })
+  const bl = (await jget(`/api/workshop/agent-tools/bindings?agentId=${workerInst.id}`)).data.bindings
+  if (bl.length === 3) console.log('[绑定] worker 持有 2 数采(auto)+ 1 数控(manual)')
+  else fail(`绑定异常: ${bl.length}`)
+
+  // ===== 4. 工具链路冒烟(worker 实例身份,经 HTTP 桥 = omp 同路径) =====
+  const mine = await invoke(workerInst.id, 'my_industrial_nodes', {})
+  if (!mine.text.includes('E2E-温度采集') || !mine.text.includes('E2E-温度设定')) fail(`节点清单异常: ${mine.text.slice(0, 120)}`)
+  else console.log('[工具] my_industrial_nodes:3 节点物理语义齐备')
+  const q = await invoke(workerInst.id, 'daq_query', { last_minutes: 5 })
+  if (!q.text.includes('E2E-温度采集') || !q.text.includes('最新')) fail(`daq_query 异常: ${q.text.slice(0, 120)}`)
+  else console.log('[工具] daq_query:双节点数据 + 统计语义齐备')
+
+  // ===== 5. 派发真实分析任务(lead 调度 → worker 执行) =====
+  const goal = `请分析产线「${line.name}」当前运行状态:1) 用你的数采工具获取最近 5 分钟温度/压力数据并给出均值与趋势;2) 判断温度均值与目标 182℃ 的偏差;3) 若偏差超过 1℃,用数控工具下发修正(注意你的温度设定为手动确认模式,等待用户批准)。完成后汇报数值结论。`
+  const task = (await jpost(`/api/workshop/channels/${ch.id}/tasks`, {
+    title: '产线数据分析与工艺优化',
+    parts: [{ text: goal }],
+    mode: 'loop',
+  })).data
+  const taskId = task?.task?.id ?? task?.id
+  if (!taskId) { fail(`任务派发失败: ${JSON.stringify(task).slice(0, 150)}`); process.exit(1) }
+  cleanup.push(['task', taskId])
+  console.log(`[任务] 已派发 ${taskId.slice(0, 8)}(loop 模式)`)
+
+  // ===== 6. 观察调度与执行:轮询任务树 + 工具副作用 =====
+  let subTaskSeen = false
+  let workerValueSeen = false
+  let hitlSeen = false
+  for (let i = 0; i < 150; i++) {
+    await sleep(2000)
+    const tasksRes = (await jget(`/api/workshop/channels/${ch.id}/tasks`)).data
+    const tasks = Array.isArray(tasksRes) ? tasksRes : tasksRes?.tasks ?? []
+    const sub = tasks.find(t => t.id !== taskId)
+    if (sub && !subTaskSeen) { subTaskSeen = true; console.log(`[调度] lead 已派发子任务 ${sub.id.slice(0, 8)} → ${sub.assigneeId?.slice(0, 8)}`) }
+    if (i > 0 && i % 10 === 0) {
+      const mem = (await jget(`/api/workshop/channels/${ch.id}/queue`)).data
+      const arr = Array.isArray(mem) ? mem : []
+      console.log(`  [t+${i * 2}s] tasks: ${tasks.map(t => t.state).join(',')} | agents: ${arr.map(m => `${m.role}:${m.state}:${m.currentTaskId?.slice(0, 6) ?? '-'}`).join(',')}`)
+    }
+    // worker 数值写副作用:dcw_control 需 HITL → 审批面板出现
+    const pend = (await jget(`/api/workshop/agent-tools/approvals?agentId=${workerInst.id}`)).data.approvals
+    if (pend.length > 0 && !hitlSeen) {
+      hitlSeen = true
+      console.log(`[HITL] Agent 发起下发审批: ${pend[0].detail.slice(0, 60)}`)
+      await jpost(`/api/workshop/agent-tools/approvals/${pend[0].id}/decide`, { approved: true, comment: '分析结论合理,批准' })
+      console.log('[HITL] 用户批准(备注:分析结论合理,批准)')
+    }
+    // 写副作用:节点 value 被改为 182±(Agent 的优化目标)
+    const dwNow = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+    if (dwNow?.value != null && dwNow.value !== 180 && Math.abs(dwNow.value - 182) <= 3) workerValueSeen = true
+    const subDone = sub && (sub.state === 'COMPLETED')
+    if (workerValueSeen && (subDone || i > 60)) break
+  }
+  if (subTaskSeen) console.log('PASS lead 调度:主任务拆解并派发子任务')
+  else fail('未见 lead 派发子任务')
+  if (hitlSeen) console.log('PASS HITL:Agent 经工具发起数控下发,用户批准后执行')
+  else fail('未见 Agent 的 HITL 审批请求')
+  const dwFinal = (await jget('/api/workshop/dcw')).data.nodes.find(n => n.id === dw.id)
+  if (workerValueSeen) console.log(`PASS 写副作用:温度设定被 Agent 更新为 ${dwFinal?.value}℃(目标 182)`)
+  else fail(`设定值未变: ${dwFinal?.value}`)
+
+  // ===== 7. 孪生/告警/打标链路抽查 =====
+  const states = (await jget('/api/workshop/dcw/lines')).data.states
+  const stLine = states.find(s => s.lineId === line.id)
+  if (stLine?.active && stLine.taggedSamples > 0) console.log(`PASS 数据打标:产线窗口内 ${stLine.taggedSamples} 样本带产线标识`)
+  else fail(`打标异常: ${JSON.stringify(stLine)}`)
+  const qAfter = await invoke(workerInst.id, 'daq_query', { last_minutes: 5 })
+  if (qAfter.text.includes('均值')) console.log('PASS Agent 可持续获取打标数据的物理语义视图')
+  else fail(`查询异常: ${qAfter.text.slice(0, 100)}`)
+}
+
+main()
+  .then(async () => {
+    for (const [kind, id] of [...cleanup].reverse()) {
+      try {
+        if (kind === 'dcw-line') await jpost(`/api/workshop/dcw/lines/${id}/stop`, {})
+        else if (kind === 'daq') await jdel(`/api/workshop/daq/${id}`)
+        else if (kind === 'dcw') await jdel(`/api/workshop/dcw/${id}`)
+        else if (kind === 'dcw-recipe') await jdel(`/api/workshop/dcw/recipes/${id}`)
+        else if (kind === 'dcw-product') await jdel(`/api/workshop/dcw/products/${id}`)
+        else if (kind === 'task') await jpost(`/api/workshop/channels/unknown/tasks/${id}/cancel`, {}).catch(() => {})
+        else if (kind === 'channel-agent') {
+          const [cid, aid] = String(id).split(':')
+          await jdel(`/api/workshop/channels/${cid}/agents/${aid}`)
+        }
+        else if (kind === 'channel') await jdel(`/api/workshop/channels/${id}`)
+        else if (kind === 'team') await jdel(`/api/workshop/teams/${id}`)
+        else if (kind === 'agent-tpl') await jdel(`/api/workshop/agents/${id}`)
+      }
+      catch { /* 清理尽力而为 */ }
+    }
+    console.log(process.exitCode ? 'E2E FAILED' : 'E2E ALL PASS')
+    process.exit(process.exitCode ?? 0)
+  })
+  .catch((err) => {
+    console.error('FATAL:', err.message)
+    process.exit(1)
+  })

package/scripts/_dbg-gate-debug.mjs

@@ -0,0 +1,37 @@
+/** 一次性:调试编辑模式 tryStartPointerDrag */
+import puppeteer from 'puppeteer-core'
+
+const browser = await puppeteer.launch({
+  executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+  headless: 'new',
+  args: ['--no-sandbox', '--disable-gpu'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: 'ut-bdebd04701084e8ab6a1a4c51f5375e4', domain: '127.0.0.1', path: '/' })
+await page.goto('http://127.0.0.1:3000/town', { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => (window.__town?.scene?.deviceNodes?.size ?? 0) > 0)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 4000))
+const out = await page.evaluate(() => {
+  const s = window.__town.scene
+  const dev = [...s.deviceNodes.values()][0]
+  s.focusTo(dev.root.position.x, dev.root.position.z)
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      const p1 = s.worldToScreen(dev.root.position.x, 100, dev.root.position.z)
+      if (!p1) return resolve({ err: 'worldToScreen null (offscreen)' })
+      const w = s.screenToWorld(p1.x, p1.y)
+      s.setMode('edit')
+      const hit = typeof s.pickAt === 'function' ? s.pickAt(w.x, w.z) : 'no pickAt fn'
+      const gate = s.tryStartPointerDrag(p1.x, p1.y)
+      const giz = s.isGizmoBusy()
+      if (gate) s.endPointerDrag()
+      resolve({ devPos: { x: dev.root.position.x, z: dev.root.position.z }, w, mode: s.getMode(), hit: hit && hit.kind ? hit.kind : hit, gate, giz })
+    }, 1600)
+  })
+})
+console.log(JSON.stringify(out))
+await browser.close()

package/scripts/_dbg-gif-encode.mjs

@@ -0,0 +1,111 @@
+/**
+ * 最小 GIF89a 编码器(逐帧 LZW;无外部依赖,配合 sharp 降采样后的 RAW 像素)。
+ * 用法: node scripts/_dbg-gif-encode.mjs
+ * 输入: data/gif-frames/frame-XX.png (sharp 转 800x450 RAW)
+ * 输出: docs/readme-assets/town-demo.gif
+ */
+import { createRequire } from 'node:module'
+import { readFileSync, writeFileSync } from 'node:fs'
+const require2 = createRequire('C:/Users/87287/AppData/Local/Programs/DSH Desktop/resources/app/node_modules/pngjs/package.json')
+const sharp = require2('sharp')
+
+const W = 640, H = 360, DELAY_MS = 600
+// 全局色板:从首帧量化 256 色(中位切分简化:均匀 RGB 5x5x5 立方体 + 灰阶)
+function buildPalette() {
+  const colors = []
+  for (let r = 0; r < 6; r++) for (let g = 0; g < 6; g++) for (let b = 0; b < 5; b++) {
+    colors.push([Math.round(r * 51), Math.round(g * 51), Math.round(b * 63.75)])
+  }
+  while (colors.length < 256) colors.push([0, 0, 0])
+  return colors
+}
+const PALETTE = buildPalette()
+const PAL_INDEX = new Map(PALETTE.map((c, i) => [c.join(','), i]))
+function quantize(r, g, b) {
+  const key = [Math.round(r / 51) * 51, Math.round(g / 51) * 51, Math.round(b / 63.75) * 63.75].join(',')
+  const hit = PAL_INDEX.get(key)
+  if (hit !== undefined) return hit
+  // 最近邻兜底
+  let best = 0, bestD = Infinity
+  for (let i = 0; i < 256; i++) {
+    const [pr, pg, pb] = PALETTE[i]
+    const d = (pr - r) ** 2 + (pg - g) ** 2 + (pb - b) ** 2
+    if (d < bestD) { bestD = d; best = i }
+  }
+  PAL_INDEX.set(key, best)
+  return best
+}
+
+// ---- LZW 编码(GIF 变体:可变码长,clear=256,EOI=257) ----
+function lzwEncode(indices, minCodeSize) {
+  const CLEAR = 1 << minCodeSize
+  const EOI = CLEAR + 1
+  let codeSize = minCodeSize + 1
+  let dict = new Map()
+  let nextCode = EOI + 1
+  const resetDict = () => { dict = new Map(); nextCode = EOI + 1; codeSize = minCodeSize + 1 }
+  const out = []
+  let cur = 0, curBits = 0
+  const emit = (code) => {
+    cur |= code << curBits
+    curBits += codeSize
+    while (curBits >= 8) { out.push(cur & 0xFF); cur >>= 8; curBits -= 8 }
+  }
+  emit(CLEAR)
+  let prefix = indices[0]
+  for (let i = 1; i < indices.length; i++) {
+    const c = indices[i]
+    const key = prefix * 4096 + c
+    const found = dict.get(key)
+    if (found !== undefined) { prefix = found; continue }
+    emit(prefix)
+    if (nextCode < 4096) {
+      dict.set(key, nextCode++)
+      if (nextCode - 1 === (1 << codeSize) && codeSize < 12) codeSize++
+    }
+    else { emit(CLEAR); resetDict() }
+    prefix = c
+  }
+  emit(prefix)
+  emit(EOI)
+  if (curBits > 0) out.push(cur & 0xFF)
+  return out
+}
+
+// ---- 字节流组装 ----
+const bytes = []
+const push = (...b) => bytes.push(...b)
+const pushStr = (s) => { for (const ch of s) bytes.push(ch.charCodeAt(0)) }
+const pushU16 = (v) => { bytes.push(v & 0xFF, (v >> 8) & 0xFF) }
+
+// Header + LSD
+pushStr('GIF89a'); pushU16(W); pushU16(H)
+push(0xF7, 0, 0) // GCT flag(256 色)+ 背景色 0 + 宽高比 0
+for (const [r, g, b] of PALETTE) push(r, g, b)
+// Netscape 循环扩展
+push(0x21, 0xFF, 11); pushStr('NETSCAPE2.0'); push(3, 1, 0, 0, 0)
+// 每帧
+const frameFiles = []
+for (let i = 0; i < 12; i++) frameFiles.push('data/gif-frames/frame-' + String(i).padStart(2, '0') + '.png')
+for (const file of frameFiles) {
+  const buf = readFileSync(file)
+  const raw = await sharp(buf).resize(W, H, { fit: 'cover' }).removeAlpha().raw().toBuffer()
+  // GCE
+  push(0x21, 0xF9, 4, 0x04, (DELAY_MS / 10) & 0xFF, ((DELAY_MS / 10) >> 8) & 0xFF, 0, 0)
+  // Image Descriptor
+  push(0x2C); pushU16(0); pushU16(0); pushU16(W); pushU16(H); push(0)
+  // LZW
+  const indices = new Uint8Array(W * H)
+  for (let p = 0; p < W * H; p++) indices[p] = quantize(raw[p * 3], raw[p * 3 + 1], raw[p * 3 + 2])
+  const lzw = lzwEncode([...indices], 8)
+  // 子块化(每块 ≤255)
+  push(8) // min code size
+  for (let i = 0; i < lzw.length; i += 255) {
+    const chunk = lzw.slice(i, i + 255)
+    push(chunk.length, ...chunk)
+  }
+  push(0) // block terminator
+}
+push(0x3B) // trailer
+writeFileSync('docs/readme-assets/town-demo.gif', Buffer.from(bytes))
+console.log('GIF written:', bytes.length, 'bytes,', frameFiles.length, 'frames,', W + 'x' + H)

package/scripts/_dbg-gizmo.mjs

@@ -0,0 +1,95 @@
+import puppeteer from 'puppeteer-core'
+
+const BASE = process.env.AW_PAGE_BASE ?? 'http://127.0.0.1:3000'
+const TOKEN = process.env.AW_PAGE_TOKEN ?? ''
+const browser = await puppeteer.launch({
+  executablePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  headless: 'new', args: ['--no-sandbox', '--disable-gpu', '--window-size=1600,1000'],
+})
+const page = await browser.newPage()
+await page.setViewport({ width: 1600, height: 1000 })
+await page.setCookie({ name: 'token', value: TOKEN, domain: '127.0.0.1', path: '/' })
+const errors = []
+page.on('pageerror', e => errors.push(String(e).slice(0, 200)))
+const patches = []
+page.on('response', (r) => {
+  if (r.request().method() === 'PATCH' && r.url().includes('/device-twins/')) patches.push(r.status())
+})
+await page.goto(`${BASE}/town`, { waitUntil: 'domcontentloaded', timeout: 60000 })
+for (let i = 0; i < 30; i++) {
+  if (await page.evaluate(() => !!window.__town?.scene?.agents?.size)) break
+  await new Promise(r => setTimeout(r, 1000))
+}
+await new Promise(r => setTimeout(r, 3500))
+
+// 1) 编辑模式 + 选中设备 → 手柄附身
+// 走真实 UI:点击「编辑」按钮(toggleMode 同步 TownView mode + scene 模式)
+await page.click('.mode-bar .mode-btn')
+await new Promise(r => setTimeout(r, 400))
+const r1 = await page.evaluate(async () => {
+  const s = window.__town.scene
+  const dev = s.getDeviceNodes()[0]
+  if (!dev) return { fail: 'no device' }
+  s.setSelected({ kind: 'device', id: dev.twinId })
+  window.__devId = dev.twinId
+  await new Promise(r => setTimeout(r, 300))
+  const tc = s.tControls
+  return {
+    attached: !!tc?.object,
+    sameObject: tc?.object === s.deviceNodes.get(dev.twinId)?.root,
+    mode: tc?.mode,
+    toolbar: [...document.querySelectorAll('.mode-bar .seg-btn')].map(b => b.textContent.trim()),
+  }
+})
+console.log('attach:', JSON.stringify(r1))
+
+// 2) 键盘 G/R/S → 模式切换 + 轴约束
+const r2 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const out = {}
+  for (const [key, want] of [['g', 'translate'], ['r', 'rotate'], ['s', 'scale']]) {
+    window.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }))
+    const tc = s.tControls
+    out[key] = { mode: tc.mode, showX: tc.showX, showY: tc.showY, showZ: tc.showZ, ok: tc.mode === want }
+  }
+  return out
+})
+console.log('keys:', JSON.stringify(r2))
+
+// 3) 手柄拖拽落库:模拟 dragging-changed + 位移(等价 gizmo 拖 X 轴)
+const r3 = await page.evaluate(() => {
+  const s = window.__town.scene
+  const tc = s.tControls
+  const dev = s.deviceNodes.get(window.__devId)
+  window.__before = { x: Math.round(dev.root.position.x), z: Math.round(dev.root.position.z) }
+  tc.dispatchEvent({ type: 'dragging-changed', value: true })
+  dev.root.position.x += 220
+  dev.root.position.z -= 140
+  tc.dispatchEvent({ type: 'dragging-changed', value: false })
+  const n = s.getDeviceNodes().find(d => d.twinId === window.__devId)
+  return { after: { x: n.x, z: n.z } }
+})
+await new Promise(r => setTimeout(r, 700))
+console.log('gizmo drag:', JSON.stringify({ before: r3.after ? (await Promise.resolve()) : null }))
+console.log('full r3:', JSON.stringify(r3), '| before:', JSON.stringify(await page.evaluate(() => window.__before)), '| PATCH:', patches)
+
+// 4) 无级缩放:dolly 0.002 / 300,相机 near/far 动态,场景不崩
+const r4 = await page.evaluate(async () => {
+  const s = window.__town.scene
+  const out = {}
+  s.zoomBy(-5)
+  await new Promise(r => setTimeout(r, 400))
+  out.close = { dolly: +s.dolly.toFixed(3), near: +s.camera.near.toFixed(3), far: Math.round(s.camera.far) }
+  s.zoomBy(300)
+  await new Promise(r => setTimeout(r, 400))
+  out.far2 = { dolly: +s.dolly.toFixed(1), near: +s.camera.near.toFixed(0), far: Math.round(s.camera.far) }
+  return out
+})
+console.log('unlimited zoom:', JSON.stringify(r4))
+console.log('errors:', errors.slice(0, 5))
+await page.evaluate(() => {
+  window.__town.scene.zoomBy(-298.9)
+})
+await new Promise(r => setTimeout(r, 500))
+await page.screenshot({ path: 'docs/audit/screenshots/gizmo.png' })
+await browser.close()