agentworkshop 0.2.1

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

@@ -0,0 +1,19 @@
+/**
+ * POST /api/workshop/dcw/:id/write —— 设定值下发(核心写命令;body: { value: number })。
+ * 工程量安全校验 → 驱动换算/写/回读校验 → ACK。越界 400;在飞 409。
+ * R1 留痕由 write() 中央埋点统一完成(manual 来源携带真实用户身份)。
+ */
+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) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ value?: number }>(event) ?? {}
+  const outcome = await getDcwController().write(id, Number(body.value), null, { source: 'manual', actor: user.id, actorName: user.name })
+  return { outcome }
+})

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

@@ -0,0 +1,30 @@
+/**
+ * DELETE /api/workshop/dcw/:id —— 删除写控制节点。
+ * R3:admin/editor 才可执行;approvalGate 开启时走双人复核(同 apply 口径)。
+ */
+import { getRouterParam, readBody, setResponseStatus } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { gateDangerous } from '@/server/utils/approval-gate'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { audit } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  // DELETE 语义下 body 常为空:approvalId 亦接受查询参数(?approvalId=…)
+  const body = await readBody<{ approvalId?: string }>(event).catch(() => ({})) ?? {}
+  const q = getQuery(event)
+  const approvalId = body.approvalId ?? (typeof q.approvalId === 'string' ? q.approvalId : undefined)
+  const gate = gateDangerous(useRuntimeConfig(event).approvalGate === true, user, { action: 'dcw.delete', targetId: id, summary: `删除写控制节点 ${id}` }, approvalId)
+  if (gate.pending) {
+    setResponseStatus(event, 202)
+    return { pending: true, requestId: gate.requestId }
+  }
+  getDcwController().remove(id)
+  // R1:删除写控制节点留痕
+  audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: 'dcw.delete', targetKind: 'dcw-node', targetId: id })
+  return { deleted: true }
+})

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

@@ -0,0 +1,18 @@
+/**
+ * PATCH /api/workshop/dcw/:id —— 单节点参数(名称/驱动/保写周期/量程/启停/落点)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import type { DcwPatchInput } from '@/server/services/workshop/dcw/dcw-controller'
+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<DcwPatchInput>(event) ?? {}
+  const node = getDcwController().patch(id, body)
+  return { node: node.toView() }
+})

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

@@ -0,0 +1,43 @@
+/**
+ * POST /api/workshop/dcw/controller —— 网关总控:{ action: 'start' | 'stop' | 'pause' | 'resume' }。
+ * R3:admin/editor 才可执行;approvalGate 开启时走双人复核(同 apply 口径)。
+ * pause/resume 为快照语义:暂停记录「当前启用节点集」,恢复仅恢复该集合。
+ */
+import { readBody, setResponseStatus } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { gateDangerous } from '@/server/utils/approval-gate'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const ctrl = getDcwController()
+  const body = await readBody<{ action?: 'start' | 'stop' | 'pause' | 'resume' }>(event) ?? {}
+  const action = (body.action === 'stop' || body.action === 'pause' || body.action === 'resume') ? body.action : 'start'
+  const zh = { start: '启动', stop: '停止', pause: '暂停', resume: '恢复' } as const
+  const gate = gateDangerous(useRuntimeConfig(event).approvalGate === true, user, { action: 'dcw.controller', targetId: `gateway:${action}`, summary: `写控制网关${zh[action]}全部节点` }, (body as { approvalId?: string }).approvalId)
+  if (gate.pending) {
+    setResponseStatus(event, 202)
+    return { pending: true, requestId: gate.requestId }
+  }
+  const controller = action === 'stop'
+    ? ctrl.stopAll()
+    : action === 'pause'
+      ? ctrl.pauseAll()
+      : action === 'resume' ? ctrl.resumeAll() : ctrl.startAll()
+  // R1:网关总控(影响全部下游设备)留痕 + 实时事件
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: `dcw.controller.${action}`,
+    kind: 'system',
+    targetKind: 'dcw-gateway',
+    targetId: 'gateway',
+    summary: `写控制网关${zh[action]}全部节点`,
+  })
+  return { controller }
+})

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

@@ -0,0 +1,25 @@
+/**
+ * GET /api/workshop/dcw —— 写控制节点列表 + 网关状态 + 模板/配方/批次/写历史(登录用户)。
+ */
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { listDcwTemplates } from '@/server/services/workshop/dcw/dcw-templates'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const ctrl = getDcwController()
+  return {
+    controller: ctrl.controllerState(),
+    nodes: ctrl.listViews(),
+    templates: listDcwTemplates(),
+    recipes: ctrl.listRecipes(),
+    runs: ctrl.listRuns(),
+    history: ctrl.listHistory(60),
+    products: ctrl.listProducts(),
+    lines: ctrl.listLines(),
+    lineStates: ctrl.allLineStates(),
+  }
+})

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

@@ -0,0 +1,20 @@
+/**
+ * POST /api/workshop/dcw —— 创建写控制节点。
+ */
+import { readBody } from 'h3'
+import type { DcwCreateInput } from '@/server/services/workshop/dcw/dcw-controller'
+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'
+import { audit } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const body = await readBody<DcwCreateInput>(event) ?? {}
+  const node = getDcwController().create(body)
+  // R1:创建写控制节点(获得直写物理设备能力的入口)留痕
+  audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: 'dcw.create', targetKind: 'dcw-node', targetId: node.id, detail: { name: node.name } })
+  return { node: node.toView() }
+})

package/server/api/workshop/dcw/journal/index.get.ts

@@ -0,0 +1,21 @@
+/**
+ * GET /api/workshop/dcw/journal —— 参数变更账本查询(在册历史;append-only)。
+ * 查询参数:nodeId / lineId / source / limit。
+ */
+import { getQuery } 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 q = getQuery(event)
+  const limit = Number(q.limit ?? 100)
+  const anchors = getRecipeRollBackManager().journal({
+    nodeId: q.nodeId ? String(q.nodeId) : undefined,
+    lineId: q.lineId ? String(q.lineId) : undefined,
+    source: q.source ? String(q.source) : undefined,
+    limit: Number.isFinite(limit) ? Math.min(limit, 500) : 100,
+  })
+  return { anchors }
+})

package/server/api/workshop/dcw/journal/node/[nodeId]/rollback.post.ts

@@ -0,0 +1,22 @@
+/**
+ * POST /api/workshop/dcw/journal/node/:nodeId/rollback —— 节点级单步回退。
+ * body: { to?: anchorId, actor?: string } —— 目标缺省 = 最近稳定锚的 prevValue(撤销栈栈顶)。
+ * 回退经 write() 单点:量程/配方窗口/联锁门控自动继承;回退本身入册(source=rollback)。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { bindDcwBroadcast } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { getRecipeRollBackManager } from '@/server/services/workshop/dcw/recipe-rollback-manager'
+import { audit } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const nodeId = getRouterParam(event, 'nodeId') ?? ''
+  const body = await readBody<{ to?: string }>(event) ?? {}
+  const record = await getRecipeRollBackManager().rollbackNode(nodeId, user.id, 'user', body.to || undefined)
+  audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: 'dcw.rollback', targetKind: 'dcw-node', targetId: nodeId, detail: { to: body.to ?? 'last-stable', recordId: record?.id } })
+  return { record }
+})

package/server/api/workshop/dcw/line/query.get.ts

@@ -0,0 +1,31 @@
+/**
+ * GET /api/workshop/dcw/line/query —— 产线数据查询(产品/配方/工艺参数/时间/间隔)。
+ * qs: productId, recipeId, paramKey, from(epoch ms), to, bucketMs, limit
+ */
+import { getQuery } 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 q = getQuery(event)
+  const num = (v: unknown): number | undefined => {
+    const n = Number(v)
+    return v != null && v !== '' && Number.isFinite(n) ? n : undefined
+  }
+  const result = await getDcwController().lineQuery({
+    lineId: q.lineId ? String(q.lineId) : undefined,
+    productId: q.productId ? String(q.productId) : undefined,
+    recipeId: q.recipeId ? String(q.recipeId) : undefined,
+    paramKey: q.paramKey ? String(q.paramKey) : undefined,
+    nodeId: q.nodeId ? String(q.nodeId) : undefined,
+    fromMs: num(q.from),
+    toMs: num(q.to),
+    bucketMs: num(q.bucketMs),
+    limit: num(q.limit),
+  })
+  return result
+})

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

@@ -0,0 +1,35 @@
+/**
+ * POST /api/workshop/dcw/lines/:id/start —— 该产线开跑(body: { recipeId })。
+ * 门控:配方必归属本产线的产品且含工艺参数;激活窗口后本产线数采逐样本打标。
+ */
+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'
+import { getActiveLineRun } from '@/server/services/workshop/dcw/line-run'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id')!
+  const body = await readBody<{ recipeId?: string }>(event) ?? {}
+  const run = await getDcwController().lineStart(id, String(body.recipeId ?? ''))
+  const active = getActiveLineRun(id)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'line.start',
+    kind: 'line',
+    targetKind: 'line',
+    targetId: id,
+    summary: `产线开跑:批次 ${run.id} · 配方「${active?.recipeName ?? body.recipeId ?? ''}」已下发`,
+    lineId: id,
+    productId: active?.productId ?? '',
+    recipeId: active?.recipeId ?? String(body.recipeId ?? ''),
+    detail: { runId: run.id, recipeId: body.recipeId ?? '' },
+  })
+  return { run, line: getDcwController().lineState(id) }
+})

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

@@ -0,0 +1,34 @@
+/**
+ * POST /api/workshop/dcw/lines/:id/stop —— 停止该产线数据采集(关闭打标窗口;
+ * 该产线数采节点置 offline)。
+ */
+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'
+import { getActiveLineRun } from '@/server/services/workshop/dcw/line-run'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id')!
+  const active = getActiveLineRun(id)
+  const run = getDcwController().lineStop(id)
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'line.stop',
+    kind: 'line',
+    targetKind: 'line',
+    targetId: id,
+    summary: `产线停止采集:批次 ${active?.runId ?? run?.id ?? ''} 窗口关闭,样本不再打标`,
+    lineId: id,
+    productId: active?.productId ?? '',
+    recipeId: active?.recipeId ?? '',
+    detail: { runId: active?.runId ?? '' },
+  })
+  return { run, line: getDcwController().lineState(id) }
+})

package/server/api/workshop/dcw/lines/[id].delete.ts

@@ -0,0 +1,35 @@
+/**
+ * DELETE /api/workshop/dcw/lines/:id —— 删除产线。
+ * 自动停止运行窗口;?purge=1 连同旗下节点(含 Agent 绑定级联)/产品/配方一并删除,
+ * 否则仅解除挂载(lineId=''),历史数据保留。
+ */
+import { getQuery, 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'
+import { getDcwLineRepo } from '@/server/services/workshop/dcw/dcw-line.repo'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id')!
+  const q = getQuery(event).purge
+  const purge = q === '1' || q === 'true'
+  const lineName = getDcwLineRepo().byId(id)?.name ?? id
+  await getDcwController().removeLine(id, { purge })
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'line.delete',
+    kind: 'line',
+    targetKind: 'line',
+    targetId: id,
+    summary: `删除产线「${lineName}」${purge ? '(级联清理节点/产品/配方)' : '(仅解除挂载)'}`,
+    lineId: id,
+    detail: { purge },
+  })
+  return { ok: true, purged: purge }
+})

package/server/api/workshop/dcw/lines/[id].patch.ts

@@ -0,0 +1,15 @@
+/**
+ * PATCH /api/workshop/dcw/lines/:id —— 编辑产线(名称/光晕色/描述)。
+ */
+import { readBody } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import type { LineInput } from '#shared/dcw-protocol'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id')!
+  const body = await readBody<Partial<LineInput>>(event) ?? {}
+  return { line: getDcwController().updateLine(id, body) }
+})

package/server/api/workshop/dcw/lines/index.get.ts

@@ -0,0 +1,14 @@
+/**
+ * GET /api/workshop/dcw/lines —— 产线列表 + 各产线运行状态。
+ */
+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 ctrl = getDcwController()
+  return { lines: ctrl.listLines(), states: ctrl.allLineStates() }
+})

package/server/api/workshop/dcw/lines/index.post.ts

@@ -0,0 +1,31 @@
+/**
+ * POST /api/workshop/dcw/lines —— 新建产线。
+ * 缺省光晕色按创建序取色板(1号蓝 2号黄…);可显式指定 color。
+ */
+import { 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'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+import type { LineInput } from '#shared/dcw-protocol'
+
+export default defineApiHandler(async (event) => {
+  const user = resolveUser(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const body = await readBody<LineInput>(event) ?? { name: '' }
+  const line = getDcwController().createLine(body)
+  broadcastSceneEvent('dcw.node.changed', { op: 'updated', node: null, lineId: line.id })
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'line.create',
+    kind: 'line',
+    targetKind: 'line',
+    targetId: line.id,
+    summary: `新建产线「${line.name}」`,
+    lineId: line.id,
+  })
+  return { line }
+})

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

@@ -0,0 +1,24 @@
+/**
+ * POST /api/workshop/dcw/optimizations/:id/judge —— 对优化记录落判定(Agent/系统/用户三路)。
+ * body: { verdict: 'keep'|'rollback'|'uncertain', reason: string, by?: 'user' }
+ * 判定与执行分离:rollback 判定只入册,执行走 /rollback 接口或 Agent dcw_rollback。
+ */
+import { getRouterParam, readBody } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError, ErrorCodes } from '@/server/utils/errors'
+import { bindDcwBroadcast } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { getRecipeRollBackManager } from '@/server/services/workshop/dcw/recipe-rollback-manager'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ verdict?: string, reason?: string }>(event) ?? {}
+  const verdict = body.verdict as 'keep' | 'rollback' | 'uncertain'
+  if (!verdict || !['keep', 'rollback', 'uncertain'].includes(verdict))
+    throw new AppError(400, ErrorCodes.VALIDATION_ERROR, 'verdict 必须为 keep / rollback / uncertain')
+  const record = getRecipeRollBackManager().judge(id, verdict, String(body.reason ?? ''), 'user', user.id)
+  return { record }
+})

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

@@ -0,0 +1,29 @@
+/**
+ * POST /api/workshop/dcw/optimizations/:id/rollback —— 执行回退(判定与执行分离的执行半段)。
+ * body: { approvalId? }(approvalGate 开启时双人复核)。
+ * 目标 = 记录的 from 值;经 write() 单点下发,回退本身入册(source=rollback)。
+ */
+import { getRouterParam, readBody, setResponseStatus } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { gateDangerous } from '@/server/utils/approval-gate'
+import { bindDcwBroadcast } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { getRecipeRollBackManager } from '@/server/services/workshop/dcw/recipe-rollback-manager'
+import { audit } from '@/server/services/workshop/ops/ops'
+import { useRuntimeConfig } from '#imports'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ approvalId?: string }>(event) ?? {}
+  const gate = gateDangerous(useRuntimeConfig(event).approvalGate === true, user, { action: 'optimization.rollback', targetId: id, summary: `回退优化记录 ${id}` }, body.approvalId)
+  if (gate.pending) {
+    setResponseStatus(event, 202)
+    return { pending: true, requestId: gate.requestId }
+  }
+  const record = await getRecipeRollBackManager().rollbackRecord(id, user.id, 'user', body.approvalId)
+  audit({ actor: user.id, actorName: user.name, actorKind: 'user', action: 'optimization.rollback', targetKind: 'optimization', targetId: id, detail: { recordId: record?.id } })
+  return { record }
+})

package/server/api/workshop/dcw/optimizations/[id]/series.get.ts

@@ -0,0 +1,18 @@
+/**
+ * GET /api/workshop/dcw/optimizations/:id/series —— 优化记录窗口内的数采序列。
+ * 查询参数:windowMs(可选;限制返回 setAt 起的窗口长度)。
+ * 数据经 lineQuery(queryTagged 参数化接口)取逐通道序列。
+ */
+import { getQuery, 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 q = getQuery(event)
+  const windowMs = q.windowMs ? Number(q.windowMs) : undefined
+  const result = await getRecipeRollBackManager().series(id, Number.isFinite(windowMs) ? windowMs : undefined)
+  return result
+})

package/server/api/workshop/dcw/optimizations/[id].get.ts

@@ -0,0 +1,17 @@
+/**
+ * GET /api/workshop/dcw/optimizations/:id —— 优化记录详情(含 judge 与指标快照全文)。
+ */
+import { getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { AppError, ErrorCodes } from '@/server/utils/errors'
+import { getRecipeRollBackManager } from '@/server/services/workshop/dcw/recipe-rollback-manager'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const record = getRecipeRollBackManager().recordById(id)
+  if (!record)
+    throw new AppError(404, ErrorCodes.NOT_FOUND, `优化记录不存在: ${id}`)
+  return { record }
+})

package/server/api/workshop/dcw/optimizations/index.get.ts

@@ -0,0 +1,23 @@
+/**
+ * GET /api/workshop/dcw/optimizations —— Agent 优化记录查询(数采中心/产线详情共用)。
+ * 查询参数:lineId / recipeId / nodeId / status / agentId / limit。
+ */
+import { getQuery } 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 q = getQuery(event)
+  const limit = Number(q.limit ?? 100)
+  const records = getRecipeRollBackManager().records({
+    lineId: q.lineId ? String(q.lineId) : undefined,
+    recipeId: q.recipeId ? String(q.recipeId) : undefined,
+    nodeId: q.nodeId ? String(q.nodeId) : undefined,
+    status: q.status ? String(q.status) : undefined,
+    agentId: q.agentId ? String(q.agentId) : undefined,
+    limit: Number.isFinite(limit) ? Math.min(limit, 500) : 100,
+  })
+  return { records }
+})

package/server/api/workshop/dcw/products/[id].delete.ts

@@ -0,0 +1,16 @@
+/**
+ * DELETE /api/workshop/dcw/products/:id —— 删除产品(运行中拒绝)。
+ */
+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') ?? ''
+  getDcwController().removeProduct(id)
+  return { deleted: true }
+})

package/server/api/workshop/dcw/products/[id].patch.ts

@@ -0,0 +1,17 @@
+/**
+ * PATCH /api/workshop/dcw/products/:id —— 编辑产品。
+ */
+import { getRouterParam, readBody } from 'h3'
+import type { ProductInput } from '#shared/dcw-protocol'
+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<Partial<ProductInput>>(event) ?? {}
+  return { product: getDcwController().updateProduct(id, body) }
+})

package/server/api/workshop/dcw/products/index.post.ts

@@ -0,0 +1,16 @@
+/**
+ * POST /api/workshop/dcw/products —— 创建产品(body: { name, description? })。
+ */
+import { readBody } from 'h3'
+import type { ProductInput } from '#shared/dcw-protocol'
+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 body = await readBody<ProductInput>(event) ?? { name: '' }
+  return { product: getDcwController().createProduct(body) }
+})

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

@@ -0,0 +1,40 @@
+/**
+ * POST /api/workshop/dcw/recipes/:id/apply —— 一键下发配方(创建批次 + 逐参数写)。
+ * R3:admin/editor 才可执行;approvalGate 开启时走双人复核(首次 202 返回待审 id,
+ * 另一 admin 批准后申请人携 approvalId 重放放行)。
+ */
+import { getRouterParam, readBody, setResponseStatus } from 'h3'
+import { requireRole } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { gateDangerous } from '@/server/utils/approval-gate'
+import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/dcw/dcw-controller'
+import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
+import { recordOps } from '@/server/services/workshop/ops/ops'
+
+export default defineApiHandler(async (event) => {
+  const user = requireRole(event)
+  bindDcwBroadcast(broadcastSceneEvent)
+  const id = getRouterParam(event, 'id') ?? ''
+  const body = await readBody<{ approvalId?: string }>(event) ?? {}
+  const gate = gateDangerous(useRuntimeConfig(event).approvalGate === true, user, { action: 'recipe.apply', targetId: id, summary: `一键下发配方 ${id}` }, body.approvalId)
+  if (gate.pending) {
+    setResponseStatus(event, 202)
+    return { pending: true, requestId: gate.requestId }
+  }
+  const run = await getDcwController().applyRecipe(id)
+  // R1:配方一键下发 = 批量写命令,留痕 + 实时事件
+  recordOps({
+    actor: user.id,
+    actorName: user.name,
+    actorKind: 'user',
+    action: 'recipe.apply',
+    kind: 'recipe',
+    targetKind: 'recipe',
+    targetId: id,
+    summary: `一键下发配方批次 ${((run as { id?: string }).id ?? '')},逐参数写命令已执行`,
+    productId: (run as { productId?: string }).productId ?? '',
+    recipeId: id,
+    detail: { runId: (run as { id?: string }).id },
+  })
+  return { run }
+})