agentworkshop 0.2.1

package/server/api/workshop/channels/[id]/tasks/index.post.ts

@@ -0,0 +1,79 @@
+/**
+ * POST /api/workshop/channels/:id/tasks —— 向 channel 发任务 → 自动路由 lead(设计文档 §6.2)。
+ * - channel 不存在 → 404 NOT_FOUND
+ * - channel 无 lead → 400 NO_LEAD_AGENT(manager 校验)
+ * 支持 mode 参数:goal / loop / pipeline
+ */
+import { z } from 'zod'
+import { resolveUser } from '../../../caller'
+import { getRouterParam, readValidatedBody } from 'h3'
+import { zValidator } from '../../../../../utils/validate'
+import { defineApiHandler } from '../../../../../utils/response'
+import { getWorkshopManager } from '../../../../../plugins/workshop'
+import type { Part } from '../../../../../services/workshop/types/a2a'
+
+/** A2A 消息片段(Part):四种变体(text/data/url/raw) */
+const partSchema = z.union([
+  z.object({
+    text: z.string(),
+    mediaType: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+  }),
+  z.object({
+    data: z.unknown(),
+    mediaType: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+  }),
+  z.object({
+    url: z.string(),
+    mediaType: z.string().optional(),
+    filename: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+  }),
+  z.object({
+    raw: z.string(),
+    mediaType: z.string().optional(),
+    filename: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+  }),
+]) as z.ZodType<Part>
+
+const submitTaskSchema = z.object({
+  title: z.string().min(1, 'title 必填'),
+  description: z.string().optional(),
+  parts: z.array(partSchema).optional(),
+  mode: z.enum(['goal', 'loop', 'pipeline']).optional(),
+  modeConfig: z.object({
+    intervalMs: z.number().int().min(100).max(86_400_000).optional(),
+    maxIterations: z.number().int().min(1).max(10_000).optional(),
+    goalCriteria: z.string().optional(),
+    stages: z.array(z.object({
+      name: z.string(),
+      description: z.string(),
+      assigneeId: z.string().optional(),
+    })).optional(),
+  }).optional(),
+  /** HITL 直发目标(缺省自动路由 lead);@ 某成员下发任务 */
+  assigneeId: z.string().optional(),
+  /** 人类发送者显示名(时间线"用户章"归属;缺省取登录用户名) */
+  fromLabel: z.string().optional(),
+})
+
+export default defineApiHandler(async (event) => {
+  const channelId = getRouterParam(event, 'id')!
+  const user = resolveUser(event)
+  const body = await readValidatedBody(event, zValidator(submitTaskSchema))
+  const manager = getWorkshopManager()
+  const channel = manager.getChannelForUser(channelId, user.id)
+  manager.requireOwned(channel.ownerUserId, user.id, 'channel')
+  return manager.submitChannelTask({
+    channelId,
+    title: body.title,
+    description: body.description,
+    parts: body.parts,
+    mode: body.mode,
+    modeConfig: body.modeConfig,
+    assigneeId: body.assigneeId,
+    fromLabel: body.fromLabel ?? user.name,
+  })
+})

package/server/api/workshop/channels/[id]/terminals.get.ts

@@ -0,0 +1,21 @@
+/**
+ * GET /api/workshop/channels/:id/terminals —— Channel 成员的 harness 终端会话列表。
+ *
+ * Agent lanes 控制面板的数据源:每个成员的 omp rpc-ui 终端镜像会话
+ * (pid / 存活 / 回合·流式状态)。omp lazy spawn —— 未出现在列表中的成员
+ * 表示其 harness 进程尚未启动(等待首个任务);前端用 agentId 寻址连接
+ * WS,进程重启后自动落到新会话。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '../../caller'
+import { getWorkshopManager } from '../../../../plugins/workshop'
+import { defineApiHandler } from '../../../../utils/response'
+import { listTerminalSessions } from '../../../../services/workshop/agents/harness-terminal'
+
+export default defineApiHandler(async (event) => {
+  const channelId = getRouterParam(event, 'id')!
+  const manager = getWorkshopManager()
+  const user = resolveUser(event)
+  manager.getChannelForUser(channelId, user.id)
+  return listTerminalSessions(channelId)
+})

package/server/api/workshop/channels/[id].delete.ts

@@ -0,0 +1,18 @@
+/**
+ * DELETE /api/workshop/channels/:id —— 删除 channel(级联删除 agents/messages/tasks)(设计文档 §6.2)。
+ * channel 不存在 → 404 NOT_FOUND。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '../caller'
+import { defineApiHandler } from '../../../utils/response'
+import { getWorkshopManager } from '../../../plugins/workshop'
+
+export default defineApiHandler(async (event) => {
+  const channelId = getRouterParam(event, 'id')!
+  const manager = getWorkshopManager()
+  const user = resolveUser(event)
+  const channel = manager.getChannelForUser(channelId, user.id)
+  manager.requireWritable(channel.ownerUserId, user, 'channel')
+  await manager.removeChannel(channelId)
+  return { ok: true }
+})

package/server/api/workshop/channels.get.ts

@@ -0,0 +1,11 @@
+/**
+ * GET /api/workshop/channels —— channel 列表(设计文档 §6.2)。
+ */
+import { defineApiHandler } from '../../utils/response'
+import { resolveUser } from './caller'
+import { getWorkshopManager } from '../../plugins/workshop'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  return getWorkshopManager().listChannelsForUser(user.id)
+})

package/server/api/workshop/channels.post.ts

@@ -0,0 +1,48 @@
+/**
+ * POST /api/workshop/channels —— 创建 channel(可带 leadAgent 定义与 workspace)(设计文档 §6.2)。
+ * - workspace 缺省 → data/workspaces/<channelId>(自动创建目录)
+ * - 创建 lead 后同步启动其 SchedulerLoop(与 plugin 启动恢复同路径)
+ */
+import { z } from 'zod'
+import { resolveUser } from './caller'
+import { readValidatedBody } from 'h3'
+import { zValidator } from '../../utils/validate'
+import { defineApiHandler } from '../../utils/response'
+import { getWorkshopManager, ensureLeadSchedulerLoop } from '../../plugins/workshop'
+
+const createChannelSchema = z.object({
+  name: z.string().min(1, 'name 必填'),
+  description: z.string().optional(),
+  /** channel 级作业场景 prompt(注入全部成员 harness;用户场景 × 系统设计组合) */
+  scenarioPrompt: z.string().optional(),
+  /** channel 独立工作目录(omp 子进程 cwd);缺省 data/workspaces/<channelId> */
+  workspace: z.string().optional(),
+  leadAgent: z
+    .object({
+      name: z.string().min(1, 'leadAgent.name 必填'),
+      harness: z.string().min(1, 'leadAgent.harness 必填'),
+      config: z.record(z.string(), z.unknown()).optional(),
+    })
+    .optional(),
+})
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const body = await readValidatedBody(event, zValidator(createChannelSchema))
+  const manager = getWorkshopManager()
+  const result = await manager.createChannel({
+    name: body.name,
+    description: body.description,
+    scenarioPrompt: body.scenarioPrompt,
+    workspace: body.workspace,
+    leadAgent: body.leadAgent,
+    ownerUserId: user.id,
+  })
+  // 全时事件录制:新 channel 即时建立常驻流(server 驱动落库,与订阅者无关)
+  const { ensureStream } = await import('./ws')
+  ensureStream(manager, result.channelId)
+  if (result.leadAgentId) {
+    ensureLeadSchedulerLoop(manager, result.channelId)
+  }
+  return result
+})

package/server/api/workshop/daq/[id]/bind.post.ts

@@ -0,0 +1,19 @@
+/**
+ * POST /api/workshop/daq/:id/bind —— 数采节点 ↔ 设备孪生绑定(端到端集成可视化)。
+ * body: { deviceId: string | null }(null = 解绑;绑定后通道值实时回写设备 telemetry)
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../../services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ deviceId?: string | null }>(event) ?? {}
+  const node = getDaqController().bind(id, body.deviceId ?? null)
+  return { node: node.toView() }
+})

package/server/api/workshop/daq/[id]/samples.get.ts

@@ -0,0 +1,22 @@
+/**
+ * GET /api/workshop/daq/:id/samples —— 节点历史(时序库)。
+ * query: from?/to?(epoch ms)、bucketMs?(降采样桶宽,给出返回桶聚合)、limit?(默认 500)
+ */
+import { getQuery, getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const q = getQuery(event)
+  const num = (k: string): number | undefined => (q[k] != null && !Number.isNaN(Number(q[k])) ? Number(q[k]) : undefined)
+  const points = await getDaqController().samples(id, {
+    fromMs: num('from'),
+    toMs: num('to'),
+    bucketMs: num('bucketMs'),
+    limit: num('limit'),
+  })
+  return { points }
+})

package/server/api/workshop/daq/[id]/test.post.ts

@@ -0,0 +1,17 @@
+/**
+ * POST /api/workshop/daq/:id/test —— 存量节点连接测试(用节点已保存的驱动参数)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../../services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const test = await getDaqController().testNode(id)
+  return { test }
+})

package/server/api/workshop/daq/[id].delete.ts

@@ -0,0 +1,30 @@
+/**
+ * DELETE /api/workshop/daq/:id —— 删除数采节点(广播 removed;绑定设备不受影响)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+import { recordOps } from '../../../services/workshop/ops/ops'
+
+export default defineApiHandler((event) => {
+  const user = resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const node = getDaqController().byId(id)
+  getDaqController().remove(id)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'daq.node.delete',
+    kind: 'daq',
+    targetKind: 'daq-node',
+    targetId: id,
+    summary: `删除数采节点「${node?.name ?? id}」`,
+    lineId: node?.lineId ?? '',
+  })
+  return { id }
+})

package/server/api/workshop/daq/[id].patch.ts

@@ -0,0 +1,31 @@
+/**
+ * PATCH /api/workshop/daq/:id —— 单节点参数控制(名称/驱动/量程/预警带/周期/启停/场景落点)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController, type DaqPatchInput } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+import { recordOps } from '../../../services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<DaqPatchInput>(event) ?? {}
+  const node = getDaqController().patch(id, body)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'daq.node.patch',
+    kind: 'daq',
+    targetKind: 'daq-node',
+    targetId: id,
+    summary: `修改数采节点「${node.name}」(${Object.keys(body).join('/') || '无变更'})`,
+    lineId: node.lineId ?? '',
+    detail: { keys: Object.keys(body) },
+  })
+  return { node: node.toView() }
+})

package/server/api/workshop/daq/alarms/[id]/ack.post.ts

@@ -0,0 +1,15 @@
+/**
+ * POST /api/workshop/daq/alarms/:id/ack —— 报警确认(S5 ack 闭环)。
+ * body 可空;记录 acked_by/acked_at(裁决人留痕,同 S4 口径)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  const id = getRouterParam(event, 'id')!
+  const acked = getDaqController().ackAlarm(id, user.id, user.name)
+  return { acked, id }
+})

package/server/api/workshop/daq/alarms.get.ts

@@ -0,0 +1,16 @@
+/**
+ * GET /api/workshop/daq/alarms?scope=open|all&limit= —— 报警列表(S5)。
+ * open = 未确认(默认);all = 含已确认历史(审计/复盘)。
+ */
+import { getQuery } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const q = getQuery(event)
+  const scope = q.scope === 'all' ? 'all' : 'open'
+  const limit = Math.min(500, Math.max(1, Number(q.limit) || 100))
+  return { alarms: getDaqController().listAlarms(scope, limit) }
+})

package/server/api/workshop/daq/controller.post.ts

@@ -0,0 +1,52 @@
+/**
+ * POST /api/workshop/daq/controller —— 采集总控:
+ * { action: 'start'|'stop'|'pause'|'resume'|'config', defaultIntervalMs?, defaultPublishIntervalMs? }
+ *
+ * pause/resume 为快照语义:暂停记录「当前启用节点集」,恢复仅恢复该集合
+ * (暂停期间手动停用的节点不被波及)。start/stop 为无快照的全局启停。
+ */
+import { readBody } from 'h3'
+import { requireRole, resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+const GATEWAY_ZH = { start: '启动', stop: '停止', pause: '暂停', resume: '恢复' } as const
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const ctrl = getDaqController()
+  const body = await readBody<{ action?: 'start' | 'stop' | 'pause' | 'resume' | 'config', defaultIntervalMs?: number, defaultPublishIntervalMs?: number }>(event) ?? {}
+  switch (body.action) {
+    case 'pause':
+    case 'resume':
+    case 'start':
+    case 'stop': {
+      // 总控属控制面操作:admin/editor 才可执行;pause/resume 快照留痕
+      requireRole(event, ['admin', 'editor'])
+      const controller = body.action === 'pause'
+        ? ctrl.pauseAll()
+        : body.action === 'resume'
+          ? ctrl.resumeAll()
+          : body.action === 'stop' ? ctrl.stopAll() : ctrl.startAll()
+      recordOps({
+        actor: user.id,
+        actorName: user.name,
+        actorKind: 'user',
+        action: `daq.controller.${body.action}`,
+        kind: 'daq',
+        targetKind: 'daq-gateway',
+        targetId: 'gateway',
+        summary: `数采网关${GATEWAY_ZH[body.action]}全部采集`,
+      })
+      return { controller }
+    }
+    case 'config':
+      return { controller: ctrl.configure({ defaultIntervalMs: body.defaultIntervalMs, defaultPublishIntervalMs: body.defaultPublishIntervalMs }) }
+    default:
+      return { controller: ctrl.controllerState() }
+  }
+})

package/server/api/workshop/daq/index.get.ts

@@ -0,0 +1,40 @@
+/**
+ * GET /api/workshop/daq —— 数采节点列表 + 控制器状态 + 后端能力自描述(登录用户)。
+ * 首访触发存量 device-twins(kind=daq)的幂等升格供给,此后渲染完全由本列表驱动。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { listDaqTemplates } from '@/server/services/workshop/daq/daq-templates'
+import { tsdbReady } from '@/server/services/workshop/daq/storage'
+import { getDaqQueue } from '@/server/services/workshop/daq/bus'
+import { daqInfraStatus } from '@/server/services/workshop/daq/infra'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  // ws.ts 出口装配 + 管线上电(幂等;路由模块加载即绑定)
+  bindDaqHost(broadcastSceneEvent)
+  await Promise.all([tsdbReady, getDaqQueue()])
+  const ctrl = getDaqController()
+  ctrl.provisionLegacyTwins()
+  const state = ctrl.controllerState()
+  return {
+    controller: state,
+    nodes: ctrl.listViews(),
+    meta: {
+      ...ctrl.backends(),
+      produced: state.produced ?? 0,
+      consumed: state.consumed ?? 0,
+      dropped: state.dropped ?? 0,
+      samplesStored: state.samplesStored ?? 0,
+    },
+    // 驱动协议栈可用性(包缺失 → UI 显示"未安装")
+    driverAvailable: await ctrl.driverAvailability(),
+    // 基础设施在线状态(降级 → 前端横幅 + 重连入口)
+    infra: daqInfraStatus(),
+    // 信号模板目录(内置 + 用户自定义;前端下拉/左轨/控制台同源消费)
+    templates: listDaqTemplates(),
+  }
+})

package/server/api/workshop/daq/index.post.ts

@@ -0,0 +1,33 @@
+/**
+ * POST /api/workshop/daq —— 创建数采节点(server 权威实体;拖入场景/加通道入口)。
+ * body: { templateRef?, name?, driver?, unit?, decimals?, min?, max?, warnLow?, warnHigh?,
+ *         intervalMs?, enabled?, posX?, posZ?, deviceBindingId? }
+ * 创建后广播 daq.node.changed(added),全部已连客户端即时收敛。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController, type DaqCreateInput } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+import { recordOps } from '../../../services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const body = await readBody<DaqCreateInput>(event) ?? {}
+  const node = getDaqController().create(body)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'daq.node.create',
+    kind: 'daq',
+    targetKind: 'daq-node',
+    targetId: node.id,
+    summary: `创建数采节点「${node.name}」(driver=${node.driver})`,
+    lineId: node.lineId ?? '',
+    detail: { driver: node.driver, templateRef: node.templateRef },
+  })
+  return { node: node.toView() }
+})

package/server/api/workshop/daq/infra/reconnect.post.ts

@@ -0,0 +1,17 @@
+/**
+ * POST /api/workshop/daq/infra/reconnect —— 手动重连(探测→Docker 拉起→重建后端→恢复/停用采集)。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { daqInfraConfig, daqInfraStatus } from '@/server/services/workshop/daq/infra'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const apply = (globalThis as unknown as { __daqApplyInfra?: (c: DaqInfraConfig) => Promise<void> }).__daqApplyInfra
+  if (!apply) {
+    return { infra: { ...daqInfraStatus(), warning: '启动插件未就绪,稍后重试' } }
+  }
+  // cfg 由启动插件闭包持有(与运行配置同源);此处触发一次完整装配
+  await apply(daqInfraConfig())
+  return { infra: daqInfraStatus() }
+})

package/server/api/workshop/daq/infra.get.ts

@@ -0,0 +1,11 @@
+/**
+ * GET /api/workshop/daq/infra —— 基础设施状态(MQTT/Timescale 在线与否、降级警告)。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { daqInfraStatus } from '@/server/services/workshop/daq/infra'
+
+export default defineApiHandler((event) => {
+  resolveUser(event)
+  return { infra: daqInfraStatus() }
+})

package/server/api/workshop/daq/templates/[key].delete.ts

@@ -0,0 +1,17 @@
+/**
+ * DELETE /api/workshop/daq/templates/:key —— 删除自定义信号模板(内置模板拒绝)。
+ * 成功后广播 daq.template.changed(op=removed);已建节点不受影响(域已落节点)。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqTemplateRegistry } from '@/server/services/workshop/daq/daq-templates'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import type { AepDaqTemplateChange } from '#shared/daq-protocol'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const key = getRouterParam(event, 'key') ?? ''
+  const removed = getDaqTemplateRegistry().remove(key)
+  broadcastSceneEvent('daq.template.changed', { op: 'removed', template: removed } satisfies AepDaqTemplateChange)
+  return { removed: removed.key }
+})

package/server/api/workshop/daq/templates/[key].patch.ts

@@ -0,0 +1,18 @@
+/**
+ * PATCH /api/workshop/daq/templates/:key —— 编辑自定义信号模板(内置模板拒绝)。
+ * 成功后广播 daq.template.changed(op=updated)。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqTemplateRegistry } from '@/server/services/workshop/daq/daq-templates'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import type { AepDaqTemplateChange, DaqTemplateInput } from '#shared/daq-protocol'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const key = getRouterParam(event, 'key') ?? ''
+  const body = (await readBody(event) ?? {}) as Partial<DaqTemplateInput>
+  const template = getDaqTemplateRegistry().update(key, body)
+  broadcastSceneEvent('daq.template.changed', { op: 'updated', template } satisfies AepDaqTemplateChange)
+  return { template }
+})

package/server/api/workshop/daq/templates/index.post.ts

@@ -0,0 +1,17 @@
+/**
+ * POST /api/workshop/daq/templates —— 新建自定义信号模板(登录用户)。
+ * 成功后广播 daq.template.changed(op=added)收敛全部客户端。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqTemplateRegistry } from '@/server/services/workshop/daq/daq-templates'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import type { AepDaqTemplateChange, DaqTemplateInput } from '#shared/daq-protocol'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const body = (await readBody(event) ?? {}) as DaqTemplateInput
+  const template = getDaqTemplateRegistry().create(body)
+  broadcastSceneEvent('daq.template.changed', { op: 'added', template } satisfies AepDaqTemplateChange)
+  return { template }
+})

package/server/api/workshop/daq/test-driver.post.ts

@@ -0,0 +1,23 @@
+/**
+ * POST /api/workshop/daq/test-driver —— 连接测试(按协议参数建连+读一次,不落库)。
+ * body: { driver: DaqDriverKind, driverConfig: Record<string, string|number|boolean> }
+ * → DriverTestResult { ok, message, sampleValue?, latencyMs? }
+ * 前端添加节点向导"测试连接"直达;通过后可直接创建节点开始采集。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDaqHost } from '@/server/services/workshop/daq/host-bindings'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+import { broadcastSceneEvent } from '../../../services/workshop/scene-events'
+import { normalizeDriverKind } from '@/server/services/workshop/daq/drivers'
+import type { DaqDriverKind } from '#shared/daq-protocol'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDaqHost(broadcastSceneEvent)
+  const body = await readBody<{ driver?: DaqDriverKind, driverConfig?: Record<string, string | number | boolean> }>(event) ?? {}
+  if (!body.driver) return { ok: false, message: '缺少 driver' }
+  const result = await getDaqController().testDriver(normalizeDriverKind(body.driver), body.driverConfig ?? {})
+  return { test: result }
+})

package/server/api/workshop/dcw/[id]/bind.post.ts

@@ -0,0 +1,17 @@
+/**
+ * POST /api/workshop/dcw/:id/bind —— 绑定/解绑设备孪生(body: { deviceId: string | null })。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ deviceId?: string | null }>(event) ?? {}
+  const node = getDcwController().bind(id, body.deviceId ?? null)
+  return { node: node.toView() }
+})

package/server/api/workshop/dcw/[id]/param-ledger.get.ts

@@ -0,0 +1,15 @@
+/**
+ * GET /api/workshop/dcw/:id/param-ledger —— 节点参数台账(三值对照 + 在册历史,一次读全)。
+ * current(当前设定) / recipeTarget(活动配方目标) / lastGood(良好批次值) / journal / records。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getRecipeRollBackManager } from '@/server/services/workshop/dcw/recipe-rollback-manager'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const ledger = getRecipeRollBackManager().ledger(id)
+  return { ledger }
+})

package/server/api/workshop/dcw/[id]/test.post.ts

@@ -0,0 +1,15 @@
+/**
+ * POST /api/workshop/dcw/:id/test —— 存量节点连接测试。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  return { test: await getDcwController().testNode(id) }
+})