agentworkshop 0.2.1

package/app/composables/workshop/useDaqStream.ts

@@ -0,0 +1,379 @@
+/**
+ * useDaqStream —— 服务端数据采集流的前端单一消费口。
+ *
+ * 数据权威在 server:节点列表 REST 快照(GET /api/workshop/daq)+ WS 实时帧增量收敛
+ * (daq.reading 采样 / daq.node.changed 变更 / daq.controller 总控,均经 townBus 旁路)。
+ * 进入数字孪生空间 load() 建立基线后,渲染完全由 server 数据驱动:
+ * 有多少 Node,界面就有多少数采节点;历史环形缓冲(hist)由读数流逐帧填充。
+ */
+import { reactive } from 'vue'
+import { useTownBus } from './useTownBus'
+import { apiFetch } from './apiClient'
+import type { AepEnvelope } from '#shared/workshop-protocol'
+import { DAQ_TEMPLATES, type AepDaqControllerState, type AepDaqReading, type AepDaqNodeChange, type AepDaqTemplateChange, type DaqNodeView, type DaqTemplateDef, type DaqTemplateInput } from '#shared/daq-protocol'
+
+/** 历史缓冲长度(1s 默认周期 ≈ 最近 5 分钟趋势) */
+const HIST_CAP = 60
+
+/** 展示态:本地追加"实时性"字段(view 同构 + 趋势缓冲) */
+export interface DaqNodeLive extends DaqNodeView {
+  hist: number[]
+}
+
+interface DaqControllerState {
+  running: boolean
+  defaultIntervalMs: number
+  /** 全局缺省 WS 下发间隔(节点 null 跟随;0=随采样节拍) */
+  defaultPublishIntervalMs: number
+  nodesTotal: number
+  nodesOnline: number
+  produced?: number
+  consumed?: number
+  dropped?: number
+  samplesStored?: number
+}
+
+/** 后端能力自描述(REST meta;采集管线不可见的部分在这里诚实可见) */
+interface DaqBackendMeta {
+  tsdb: string
+  queue: string
+  drivers: Array<{ kind: string, label: string, status: 'builtin' | 'planned' | 'real' }>
+  produced: number
+  consumed: number
+  dropped: number
+  samplesStored: number
+  /** 协议栈可用性(包缺失 false) */
+  driverAvailable?: Record<string, boolean>
+  infra?: DaqInfraState
+}
+
+export interface DaqDriverTestResult { ok: boolean, message: string, sampleValue?: number, latencyMs?: number }
+
+/** 基础设施状态(MQTT/Timescale 在线;降级 → 横幅 + 重连) */
+export interface DaqInfraState {
+  mqttOnline: boolean
+  tsdbOnline: boolean
+  degraded: boolean
+  warning: string
+  startedBy: 'docker' | 'direct' | 'none'
+  lastCheckAt: string
+  lastError?: string
+}
+
+export interface DaqTsdbPoint { at: number, value?: number, avg?: number, min?: number, max?: number, cnt?: number, state?: string }
+
+/** S5:报警事件(未确认/历史) */
+export interface DaqAlarmRow {
+  id: string
+  nodeId: string
+  nodeName: string
+  metric: string
+  value: number | null
+  rule: string
+  threshold: number | null
+  ackedBy: string
+  ackedAt: string | null
+  escalation: number
+  notifiedJson: string
+  createdAt: string
+}
+
+/** 统一客户端:信封解析/业务码保留/GET 幂等重试(5xx 与网络错误;400ms 起退避) */
+const api = <T>(path: string, init?: RequestInit): Promise<T> =>
+  apiFetch<T>({ base: '/api/workshop/daq', path, init, retries: (init?.method ?? 'GET').toUpperCase() === 'GET' ? 2 : 0 })
+
+const createStore = () => {
+  const nodes = reactive<DaqNodeLive[]>([])
+  const alarms = reactive<DaqAlarmRow[]>([]) // S5:未确认报警(轮询 + ack 后刷新)
+  const controller = reactive<DaqControllerState>({ running: true, defaultIntervalMs: 1000, defaultPublishIntervalMs: 0, nodesTotal: 0, nodesOnline: 0 })
+  const meta = reactive<DaqBackendMeta>({
+    tsdb: '…', queue: '…', drivers: [], driverAvailable: {},
+    infra: undefined,
+    produced: 0, consumed: 0, dropped: 0, samplesStored: 0,
+  })
+  // 模板目录:内置 6 种先行(SEO 首帧即有),REST 快照与 WS 帧收敛为 server 权威
+  const templates = reactive<DaqTemplateDef[]>(DAQ_TEMPLATES.map(t => ({ ...t })))
+
+  function upsert(node: DaqNodeView): void {
+    const i = nodes.findIndex(x => x.id === node.id)
+    if (i >= 0) {
+      // 就地合并:保留客户端 hist(WS 读数连续性优于服务端重建)
+      nodes[i] = Object.assign(nodes[i]!, node)
+    }
+    else {
+      nodes.push({ ...node, hist: [] })
+    }
+  }
+
+  /** 读数帧合批缓冲:采样帧 ≥1s/节点,但逐帧直改响应式会让整表以帧率重渲染;
+   *  500ms 合批把失效频率从「每帧一次」压到「每拍一次」,值延迟 ≤ 半个采样周期(不可感知) */
+  let readingBuf: AepDaqReading[] = []
+  let readingFlushTimer: ReturnType<typeof setTimeout> | null = null
+
+  function flushReadings(): void {
+    readingFlushTimer = null
+    const batch = readingBuf
+    readingBuf = []
+    if (!batch.length) return
+    // hist 逐帧入账(趋势连续性);value/state/lastAt 取每节点最新帧,一次响应式提交
+    const latest = new Map<string, AepDaqReading>()
+    for (const r of batch) {
+      latest.set(r.nodeId, r)
+      const n = nodes.find(x => x.id === r.nodeId)
+      if (!n) continue
+      n.hist.push(r.value)
+      if (n.hist.length > HIST_CAP) n.hist.splice(0, n.hist.length - HIST_CAP)
+    }
+    for (const r of latest.values()) {
+      const n = nodes.find(x => x.id === r.nodeId)
+      if (!n) continue
+      n.value = r.value
+      n.state = r.state
+      n.lastAt = r.at
+    }
+  }
+
+  function applyReading(p: AepDaqReading): void {
+    readingBuf.push(p)
+    if (!readingFlushTimer) readingFlushTimer = setTimeout(flushReadings, 500)
+  }
+
+  function applyChange(p: AepDaqNodeChange): void {
+    if (p.node) {
+      if (p.op === 'removed') {
+        const i = nodes.findIndex(x => x.id === p.node!.id)
+        if (i >= 0) nodes.splice(i, 1)
+        return
+      }
+      upsert(p.node)
+    }
+  }
+
+  function applyTemplates(list: DaqTemplateDef[]): void {
+    templates.splice(0, templates.length, ...list.map(t => ({ ...t })))
+  }
+
+  function applyTemplateChange(p: AepDaqTemplateChange): void {
+    if (!p.template) return
+    const i = templates.findIndex(t => t.key === p.template!.key)
+    if (p.op === 'removed') {
+      if (i >= 0) templates.splice(i, 1)
+      return
+    }
+    if (i >= 0) templates[i] = { ...p.template }
+    else templates.push({ ...p.template })
+  }
+
+  /** 挂 WS 帧(townBus);幂等(globalThis 防重复订阅)。返回退订函数。 */
+  function ensureWsFeed(): () => void {
+    const g = globalThis as typeof globalThis & { __daqBusFed?: boolean }
+    if (g.__daqBusFed) return () => {}
+    g.__daqBusFed = true
+    return useTownBus().subscribe((e: AepEnvelope) => {
+      if (e.type === 'daq.reading') applyReading(e.payload as AepDaqReading)
+      else if (e.type === 'daq.node.changed') applyChange(e.payload as AepDaqNodeChange)
+      else if (e.type === 'daq.controller') Object.assign(controller, e.payload as AepDaqControllerState)
+      else if (e.type === 'daq.template.changed') applyTemplateChange(e.payload as AepDaqTemplateChange)
+      // S5 实时告警:server 权威事件直推(报警进入轨插入;ack 确认后移出未确认列表)
+      else if (e.type === 'daq.alarm') {
+        const p = e.payload as unknown as DaqAlarmRow
+        if (!alarms.some(a => a.id === p.id)) alarms.unshift(p)
+      }
+      else if (e.type === 'daq.alarm.changed') {
+        const p = e.payload as unknown as { id: string, ackedAt?: string, recovered?: boolean }
+        if (p.ackedAt) {
+          const i = alarms.findIndex(a => a.id === p.id)
+          if (i >= 0) alarms.splice(i, 1)
+        }
+      }
+    })
+  }
+
+  async function load(): Promise<void> {
+    try {
+      const data = await api<{ controller: DaqControllerState, nodes: DaqNodeView[], meta: DaqBackendMeta, driverAvailable?: Record<string, boolean>, infra?: DaqInfraState, templates?: DaqTemplateDef[] }>('')
+      // 快照合并:hist 是客户端读数流资产,轮询重载不得清零;
+      // 已有节点就地 assign(保留对象身份 → Vue 只补丁变化字段,不触发整表数组级失效),hist 自然保留
+      const prev = new Map(nodes.map(n => [n.id, n]))
+      const next: DaqNodeLive[] = []
+      for (const raw of data.nodes) {
+        const old = prev.get(raw.id)
+        if (old) {
+          Object.assign(old, raw)
+          next.push(old)
+          prev.delete(raw.id)
+        }
+        else {
+          next.push({ ...raw, hist: [] })
+        }
+      }
+      // 服务端权威:本轮未出现的节点移除(其 hist 随之丢弃,与原语义一致)
+      nodes.splice(0, nodes.length, ...next)
+      Object.assign(controller, data.controller)
+      Object.assign(meta, data.meta ?? {})
+      meta.driverAvailable = data.driverAvailable ?? {}
+      meta.infra = data.infra
+      if (data.templates?.length) applyTemplates(data.templates)
+      store.loaded = true
+      store.error = ''
+    }
+    catch (err) {
+      store.error = err instanceof Error ? err.message : String(err)
+    }
+  }
+
+  async function createFromTemplate(templateRef: string, opts?: Record<string, unknown>): Promise<DaqNodeView> {
+    const data = await api<{ node: DaqNodeView }>('', {
+      method: 'POST',
+      body: JSON.stringify({ templateRef, ...opts }),
+    })
+    upsert(data.node)
+    return data.node
+  }
+
+  async function patchNode(id: string, patch: Record<string, unknown>): Promise<void> {
+    await api(`/${id}`, { method: 'PATCH', body: JSON.stringify(patch) })
+  }
+
+  async function saveTransform(id: string, posX?: number, posZ?: number): Promise<void> {
+    await api(`/${id}`, { method: 'PATCH', body: JSON.stringify({ posX, posZ }) })
+  }
+
+  async function removeNode(id: string): Promise<void> {
+    await api(`/${id}`, { method: 'DELETE' })
+    const i = nodes.findIndex(x => x.id === id)
+    if (i >= 0) nodes.splice(i, 1)
+  }
+
+  async function bindNode(id: string, deviceId: string | null): Promise<void> {
+    const data = await api<{ node: DaqNodeView }>(`/${id}/bind`, {
+      method: 'POST',
+      body: JSON.stringify({ deviceId }),
+    })
+    upsert(data.node)
+  }
+
+  async function testDriver(driver: string, driverConfig: Record<string, string | number | boolean>): Promise<DaqDriverTestResult> {
+    const data = await api<{ test: DaqDriverTestResult }>('/test-driver', {
+      method: 'POST',
+      body: JSON.stringify({ driver, driverConfig }),
+    })
+    return data.test
+  }
+
+  async function testNode(id: string): Promise<DaqDriverTestResult> {
+    const data = await api<{ test: DaqDriverTestResult }>(`/${id}/test`, { method: 'POST' })
+    return data.test
+  }
+
+  // ---------- 报警(S5):未确认报警轮询 + 确认(ack 后 server 广播 changed,其余客户端靠轮询收敛) ----------
+
+  async function fetchAlarms(): Promise<void> {
+    try {
+      const data = await api<{ alarms: DaqAlarmRow[] }>('/alarms?scope=open&limit=50')
+      alarms.splice(0, alarms.length, ...(data.alarms ?? []))
+    }
+    catch {
+      // 报警轮询失败静默(主链路不受影响;下一轮重试)
+    }
+  }
+
+  async function ackAlarm(id: string): Promise<void> {
+    await api(`/alarms/${id}/ack`, { method: 'POST' })
+    await fetchAlarms()
+  }
+
+  /** 手动重连基础设施(探测→Docker 拉起→重建后端→恢复采集);随后刷新基线 */
+  async function reconnectInfra(): Promise<DaqInfraState | null> {
+    const data = await api<{ infra: DaqInfraState }>('/infra/reconnect', { method: 'POST' })
+    meta.infra = data.infra
+    await load()
+    return data.infra
+  }
+
+  async function controllerAction(action: 'start' | 'stop' | 'pause' | 'resume' | 'config', defaultIntervalMs?: number, defaultPublishIntervalMs?: number): Promise<void> {
+    const data = await api<{ controller: DaqControllerState }>('/controller', {
+      method: 'POST',
+      body: JSON.stringify({ action, defaultIntervalMs, defaultPublishIntervalMs }),
+    })
+    Object.assign(controller, data.controller)
+  }
+
+  /** 节点历史(时序库查询;bucketMs 给出则返回桶聚合) */
+  async function samplesOf(id: string, opts: { fromMs?: number, toMs?: number, bucketMs?: number, limit?: number } = {}): Promise<DaqTsdbPoint[]> {
+    const qs = new URLSearchParams()
+    if (opts.fromMs != null) qs.set('from', String(opts.fromMs))
+    if (opts.toMs != null) qs.set('to', String(opts.toMs))
+    if (opts.bucketMs != null) qs.set('bucketMs', String(opts.bucketMs))
+    if (opts.limit != null) qs.set('limit', String(opts.limit))
+    const data = await api<{ points: DaqTsdbPoint[] }>(`/${id}/samples?${qs.toString()}`)
+    return data.points ?? []
+  }
+
+  // ---------- 自定义模板 CRUD(server 权威;WS daq.template.changed 收敛其余客户端) ----------
+
+  async function createTemplate(input: DaqTemplateInput): Promise<DaqTemplateDef> {
+    const data = await api<{ template: DaqTemplateDef }>('/templates', {
+      method: 'POST',
+      body: JSON.stringify(input),
+    })
+    applyTemplateChange({ op: 'added', template: data.template })
+    return data.template
+  }
+
+  async function updateTemplate(key: string, patch: Partial<DaqTemplateInput>): Promise<DaqTemplateDef> {
+    const data = await api<{ template: DaqTemplateDef }>(`/templates/${key}`, {
+      method: 'PATCH',
+      body: JSON.stringify(patch),
+    })
+    applyTemplateChange({ op: 'updated', template: data.template })
+    return data.template
+  }
+
+  async function removeTemplate(key: string): Promise<void> {
+    await api(`/templates/${key}`, { method: 'DELETE' })
+    applyTemplateChange({ op: 'removed', template: { key } as DaqTemplateDef })
+  }
+
+  const store = reactive({
+    nodes,
+    controller,
+    meta,
+    templates,
+    loaded: false,
+    error: '',
+    ensureWsFeed,
+    load,
+    createFromTemplate,
+    createTemplate,
+    updateTemplate,
+    removeTemplate,
+    testDriver,
+    testNode,
+    reconnectInfra,
+    patchNode,
+    saveTransform,
+    removeNode,
+    bindNode,
+    controllerAction,
+    alarms,
+    fetchAlarms,
+    ackAlarm,
+    nodeById: (id: string): DaqNodeLive | undefined => nodes.find(n => n.id === id),
+    samplesOf,
+    ofDevice: (deviceId: string | null): DaqNodeLive[] =>
+      deviceId ? nodes.filter(n => n.deviceBindingId === deviceId) : [],
+  })
+  return store
+}
+
+type DaqStreamStore = ReturnType<typeof createStore>
+
+const GLOBAL_KEY = '__daqStream'
+
+/** 单例(globalThis 挂载;跨组件/跨页面安全) */
+export function useDaqStream(): DaqStreamStore {
+  const g = globalThis as typeof globalThis & Record<string, unknown>
+  if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = createStore()
+  return g[GLOBAL_KEY] as DaqStreamStore
+}

package/app/composables/workshop/useDcwStream.ts

@@ -0,0 +1,300 @@
+/**
+ * useDcwStream —— 写控制(DCW)流的前端单一消费口(与 useDaqStream 对称)。
+ *
+ * 数据权威在 server:REST 快照(GET /api/workshop/dcw)+ WS 实时帧增量收敛
+ * (dcw.written 写 ACK / dcw.node.changed / dcw.controller,均经 townBus 旁路)。
+ */
+import { reactive } from 'vue'
+import { useTownBus } from './useTownBus'
+import { apiFetch } from './apiClient'
+import type { AepEnvelope } from '#shared/workshop-protocol'
+import { DCW_TEMPLATES, type AepDcwControllerState, type AepDcwNodeChange, type AepDcwWritten, type DcwNodeView, type DcwParamLedger, type DcwTemplateDef, type DcwTemplateInput, type LineInput, type LineQueryOpts, type LineQueryResult, type LineRunState, type LineView, type OptimizationRecord, type OptimizationVerdict, type ProductInput, type ProductView, type RecipeInput, type RecipeRunView, type RecipeView, type RecipeRunData } from '#shared/dcw-protocol'
+
+export type { DcwNodeView }
+
+/** 统一客户端:信封解析/业务码保留/GET 幂等重试(5xx 与网络错误;400ms 起退避) */
+const api = <T>(path: string, init?: RequestInit): Promise<T> =>
+  apiFetch<T>({ base: '/api/workshop/dcw', path, init, retries: (init?.method ?? 'GET').toUpperCase() === 'GET' ? 2 : 0 })
+
+export interface DcwWriteOutcomeView { ok: boolean, message: string, raw: number | null, readback: number | null }
+export interface DcwWriteHistoryEntry { id: string, nodeId: string, nodeName: string, param: string, eng: number, raw: number | null, ok: boolean, message: string, recipeRunId: string | null, at: string }
+
+function createStore() {
+  const nodes = reactive<DcwNodeView[]>([])
+  const controller = reactive<AepDcwControllerState>({ running: true, nodesTotal: 0, nodesOnline: 0, writesTotal: 0, writesFailed: 0 })
+  const templates = reactive<DcwTemplateDef[]>(DCW_TEMPLATES.map(t => ({ ...t })))
+  const recipes = reactive<RecipeView[]>([])
+  const runs = reactive<RecipeRunView[]>([])
+  const history = reactive<DcwWriteHistoryEntry[]>([])
+  const products = reactive<ProductView[]>([])
+  const lines = reactive<LineView[]>([])
+  /** 逐产线运行状态(lineId → state) */
+  const lineStates = reactive<Record<string, LineRunState>>({})
+  /** Agent 优化记录(调控闭环;dcw.optimization.changed 实时收敛) */
+  const optimizations = reactive<OptimizationRecord[]>([])
+
+  function upsert(node: DcwNodeView): void {
+    const i = nodes.findIndex(x => x.id === node.id)
+    if (i >= 0) nodes[i] = Object.assign(nodes[i]!, node)
+    else nodes.push(node)
+  }
+
+  function applyChange(p: AepDcwNodeChange): void {
+    if (!p.node) return
+    if (p.op === 'removed') {
+      const i = nodes.findIndex(x => x.id === p.node!.id)
+      if (i >= 0) nodes.splice(i, 1)
+      return
+    }
+    upsert(p.node)
+  }
+
+  function ensureWsFeed(): () => void {
+    const g = globalThis as typeof globalThis & { __dcwBusFed?: boolean }
+    if (g.__dcwBusFed) return () => {}
+    g.__dcwBusFed = true
+    return useTownBus().subscribe((e: AepEnvelope) => {
+      if (e.type === 'dcw.written') {
+        const p = e.payload as AepDcwWritten
+        const n = nodes.find(x => x.id === p.nodeId)
+        if (n) {
+          n.value = p.value
+          n.state = p.ok ? 'ok' : 'error'
+          n.lastWriteAt = p.at
+          if (p.ok) n.lastAckAt = p.at
+        }
+        history.unshift({ id: `${p.nodeId}-${p.at}`, nodeId: p.nodeId, nodeName: n?.name ?? p.nodeId, param: '', eng: p.value, raw: p.raw, ok: p.ok, message: p.message, recipeRunId: p.recipeRunId, at: p.at })
+        if (history.length > 60) history.splice(60)
+      }
+      else if (e.type === 'dcw.node.changed') applyChange(e.payload as AepDcwNodeChange)
+      else if (e.type === 'dcw.controller') Object.assign(controller, e.payload as AepDcwControllerState)
+      else if (e.type === 'dcw.optimization.changed') {
+        const p = (e.payload as { event: string, record: OptimizationRecord }).record
+        const i = optimizations.findIndex(x => x.id === p.id)
+        if (i >= 0) optimizations[i] = p
+        else optimizations.unshift(p)
+      }
+    })
+  }
+
+  async function load(): Promise<void> {
+    try {
+      const data = await api<{ controller: AepDcwControllerState, nodes: DcwNodeView[], templates?: DcwTemplateDef[], recipes?: RecipeView[], runs?: RecipeRunView[], history?: DcwWriteHistoryEntry[], products?: ProductView[], lines?: LineView[], lineStates?: LineRunState[] }>('')
+      nodes.splice(0, nodes.length, ...data.nodes)
+      Object.assign(controller, data.controller)
+      if (data.templates?.length) templates.splice(0, templates.length, ...data.templates.map(t => ({ ...t })))
+      recipes.splice(0, recipes.length, ...(data.recipes ?? []))
+      runs.splice(0, runs.length, ...(data.runs ?? []))
+      history.splice(0, history.length, ...(data.history ?? []))
+      products.splice(0, products.length, ...(data.products ?? []))
+      lines.splice(0, lines.length, ...(data.lines ?? []))
+      for (const k of Object.keys(lineStates)) Reflect.deleteProperty(lineStates, k)
+      for (const st of data.lineStates ?? []) lineStates[st.lineId] = st
+      store.loaded = true
+      store.error = ''
+    }
+    catch (err) {
+      store.error = err instanceof Error ? err.message : String(err)
+    }
+  }
+
+  const store = reactive({
+    nodes,
+    controller,
+    templates,
+    recipes,
+    runs,
+    history,
+    products,
+    lines,
+    lineStates,
+    optimizations,
+    loaded: false,
+    error: '',
+    ensureWsFeed,
+    load,
+    /** Agent 优化记录查询(调控闭环;默认倒序) */
+    loadOptimizations: async (filter?: { lineId?: string, recipeId?: string, nodeId?: string, status?: string, limit?: number }): Promise<void> => {
+      const qs = new URLSearchParams()
+      if (filter?.lineId) qs.set('lineId', filter.lineId)
+      if (filter?.recipeId) qs.set('recipeId', filter.recipeId)
+      if (filter?.nodeId) qs.set('nodeId', filter.nodeId)
+      if (filter?.status) qs.set('status', filter.status)
+      qs.set('limit', String(filter?.limit ?? 100))
+      const data = await api<{ records: OptimizationRecord[] }>(`/optimizations?${qs.toString()}`)
+      optimizations.splice(0, optimizations.length, ...data.records)
+    },
+    /** 节点参数台账(三值对照 + 在册历史) */
+    fetchLedger: async (nodeId: string): Promise<DcwParamLedger> => {
+      const data = await api<{ ledger: DcwParamLedger }>(`/${nodeId}/param-ledger`)
+      return data.ledger
+    },
+    /** 优化记录窗口内数采序列 */
+    optimizationSeries: async (id: string, windowMs?: number): Promise<{ record: OptimizationRecord, from: number, to: number, channels: Array<{ nodeId: string, nodeName: string, ch: string, unit: string, points: Array<{ at: number, value?: number, avg?: number }> }> }> => {
+      return api(`/optimizations/${id}/series${windowMs ? `?windowMs=${windowMs}` : ''}`)
+    },
+    /** 优化记录判定(用户路) */
+    judgeOptimization: async (id: string, verdict: OptimizationVerdict, reason: string): Promise<void> => {
+      await api(`/optimizations/${id}/judge`, { method: 'POST', body: JSON.stringify({ verdict, reason }) })
+    },
+    /** 执行回退(记录级/节点级) */
+    rollbackOptimization: async (id: string): Promise<void> => {
+      await api(`/optimizations/${id}/rollback`, { method: 'POST', body: JSON.stringify({}) })
+    },
+    rollbackNode: async (nodeId: string, to?: string): Promise<void> => {
+      await api(`/journal/node/${nodeId}/rollback`, { method: 'POST', body: JSON.stringify({ to }) })
+    },
+    /** 标记已知良好批次 / 基准恢复 */
+    markGood: async (recipeId: string, runId: string): Promise<void> => {
+      await api(`/recipes/${recipeId}/mark-good`, { method: 'POST', body: JSON.stringify({ runId }) })
+    },
+    rollbackRecipeGood: async (recipeId: string): Promise<void> => {
+      await api(`/recipes/${recipeId}/rollback-good`, { method: 'POST', body: JSON.stringify({}) })
+    },
+    createFromTemplate: async (templateRef: string, opts?: Record<string, unknown>): Promise<DcwNodeView> => {
+      const data = await api<{ node: DcwNodeView }>('', { method: 'POST', body: JSON.stringify({ templateRef, ...opts }) })
+      upsert(data.node)
+      return data.node
+    },
+    patchNode: async (id: string, patch: Record<string, unknown>): Promise<void> => {
+      await api(`/${id}`, { method: 'PATCH', body: JSON.stringify(patch) })
+    },
+    removeNode: async (id: string): Promise<void> => {
+      await api(`/${id}`, { method: 'DELETE' })
+      const i = nodes.findIndex(x => x.id === id)
+      if (i >= 0) nodes.splice(i, 1)
+    },
+    bindNode: async (id: string, deviceId: string | null): Promise<void> => {
+      const data = await api<{ node: DcwNodeView }>(`/${id}/bind`, { method: 'POST', body: JSON.stringify({ deviceId }) })
+      upsert(data.node)
+    },
+    /** 设定值下发(核心写命令;越界 400/在飞 409 由服务端拒绝) */
+    write: async (id: string, value: number): Promise<DcwWriteOutcomeView> => {
+      return api<{ outcome: DcwWriteOutcomeView }>(`/${id}/write`, { method: 'POST', body: JSON.stringify({ value }) }).then(r => r.outcome)
+    },
+    testDriver: async (driver: string, driverConfig: Record<string, unknown>): Promise<{ ok: boolean, message: string }> => {
+      return api<{ test: { ok: boolean, message: string } }>('/test-driver', { method: 'POST', body: JSON.stringify({ driver, driverConfig }) }).then(r => r.test)
+    },
+    testNode: async (id: string): Promise<{ ok: boolean, message: string }> => {
+      return api<{ test: { ok: boolean, message: string } }>(`/${id}/test`, { method: 'POST' }).then(r => r.test)
+    },
+    startStop: async (action: 'start' | 'stop' | 'pause' | 'resume'): Promise<void> => {
+      const data = await api<{ controller: AepDcwControllerState }>('/controller', { method: 'POST', body: JSON.stringify({ action }) })
+      Object.assign(controller, data.controller)
+    },
+    createTemplate: async (input: DcwTemplateInput): Promise<DcwTemplateDef> => {
+      const data = await api<{ template: DcwTemplateDef }>('/templates', { method: 'POST', body: JSON.stringify(input) })
+      templates.push(data.template)
+      return data.template
+    },
+    createRecipe: async (input: RecipeInput): Promise<RecipeView> => {
+      const data = await api<{ recipe: RecipeView }>('/recipes', { method: 'POST', body: JSON.stringify(input) })
+      recipes.push(data.recipe)
+      return data.recipe
+    },
+    updateRecipe: async (id: string, patch: Partial<RecipeInput>): Promise<RecipeView> => {
+      const data = await api<{ recipe: RecipeView }>(`/recipes/${id}`, { method: 'PATCH', body: JSON.stringify(patch) })
+      const i = recipes.findIndex(r => r.id === id)
+      if (i >= 0) recipes[i] = data.recipe
+      return data.recipe
+    },
+    removeRecipe: async (id: string): Promise<void> => {
+      await api(`/recipes/${id}`, { method: 'DELETE' })
+      const i = recipes.findIndex(r => r.id === id)
+      if (i >= 0) recipes.splice(i, 1)
+    },
+    applyRecipe: async (id: string): Promise<RecipeRunView> => {
+      const data = await api<{ run: RecipeRunView }>(`/recipes/${id}/apply`, { method: 'POST' })
+      runs.push(data.run)
+      return data.run
+    },
+    closeRun: async (id: string): Promise<RecipeRunView> => {
+      const data = await api<{ run: RecipeRunView }>(`/runs/${id}/close`, { method: 'POST' })
+      const i = runs.findIndex(r => r.id === id)
+      if (i >= 0) runs[i] = data.run
+      return data.run
+    },
+    runData: (id: string): Promise<RecipeRunData> => api(`/runs/${id}/data`),
+    nodeById: (id: string): DcwNodeView | undefined => nodes.find(n => n.id === id),
+    // ---------- 产品 ----------
+    createProduct: async (input: ProductInput): Promise<ProductView> => {
+      const data = await api<{ product: ProductView }>('/products', { method: 'POST', body: JSON.stringify(input) })
+      products.push(data.product)
+      return data.product
+    },
+    updateProduct: async (id: string, patch: Partial<ProductInput>): Promise<ProductView> => {
+      return api<{ product: ProductView }>(`/products/${id}`, { method: 'PATCH', body: JSON.stringify(patch) }).then((r) => {
+        void r
+        void dcwReloadLight()
+        return r.product
+      })
+    },
+    removeProduct: async (id: string): Promise<void> => {
+      await api(`/products/${id}`, { method: 'DELETE' })
+      const i = products.findIndex(p => p.id === id)
+      if (i >= 0) products.splice(i, 1)
+    },
+    // ---------- 产线(实体 + 逐线运营) ----------
+    createLine: async (input: LineInput): Promise<LineView> => {
+      const data = await api<{ line: LineView }>('/lines', { method: 'POST', body: JSON.stringify(input) })
+      lines.push(data.line)
+      return data.line
+    },
+    updateLine: async (id: string, patch: Partial<LineInput>): Promise<void> => {
+      const data = await api<{ line: LineView }>(`/lines/${id}`, { method: 'PATCH', body: JSON.stringify(patch) })
+      const i = lines.findIndex(l => l.id === id)
+      if (i >= 0) lines[i] = data.line
+    },
+    /** 删除产线;purge=true 连同旗下节点/产品/配方一并清理,否则仅解除挂载 */
+    removeLine: async (id: string, purge = false): Promise<void> => {
+      await api(`/lines/${id}${purge ? '?purge=1' : ''}`, { method: 'DELETE' })
+      const i = lines.findIndex(l => l.id === id)
+      if (i >= 0) lines.splice(i, 1)
+      Reflect.deleteProperty(lineStates, id)
+      await load()
+    },
+    /** 产线开跑:lineStart(lineId, recipeId);状态收敛到 lineStates */
+    startLine: async (lineId: string, recipeId: string): Promise<void> => {
+      const data = await api<{ line: LineRunState }>(`/lines/${lineId}/start`, { method: 'POST', body: JSON.stringify({ recipeId }) })
+      lineStates[lineId] = data.line
+    },
+    stopLine: async (lineId: string): Promise<void> => {
+      const data = await api<{ line: LineRunState }>(`/lines/${lineId}/stop`, { method: 'POST' })
+      lineStates[lineId] = data.line
+    },
+    lineStateOf: (lineId: string): LineRunState =>
+      lineStates[lineId] ?? { lineId, active: false, runId: null, recipeId: null, recipeName: null, productId: null, productName: null, startedAt: null, taggedSamples: 0 },
+    queryLine: (opts: LineQueryOpts): Promise<LineQueryResult> => {
+      const qs = new URLSearchParams()
+      if (opts.lineId) qs.set('lineId', opts.lineId)
+      if (opts.productId) qs.set('productId', opts.productId)
+      if (opts.recipeId) qs.set('recipeId', opts.recipeId)
+      if (opts.paramKey) qs.set('paramKey', opts.paramKey)
+      if (opts.nodeId) qs.set('nodeId', opts.nodeId)
+      if (opts.fromMs != null) qs.set('from', String(opts.fromMs))
+      if (opts.toMs != null) qs.set('to', String(opts.toMs))
+      if (opts.bucketMs != null) qs.set('bucketMs', String(opts.bucketMs))
+      if (opts.limit != null) qs.set('limit', String(opts.limit))
+      return api(`/line/query?${qs.toString()}`)
+    },
+  })
+  async function dcwReloadLight(): Promise<void> {
+    try {
+      const data = await api<{ products?: ProductView[], recipes?: RecipeView[] }>('')
+      products.splice(0, products.length, ...(data.products ?? []))
+      recipes.splice(0, recipes.length, ...(data.recipes ?? []))
+    }
+    catch { /* 忽略:轻量重载失败不阻塞 */ }
+  }
+  return store
+}
+
+type DcwStreamStore = ReturnType<typeof createStore>
+
+const GLOBAL_KEY = '__dcwStream'
+
+export function useDcwStream(): DcwStreamStore {
+  const g = globalThis as typeof globalThis & Record<string, unknown>
+  if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = createStore()
+  return g[GLOBAL_KEY] as DcwStreamStore
+}