agentworkshop 0.7.52 → 0.7.54

package/server/services/workshop/db/database/seed.ts

@@ -121,21 +121,23 @@ export const DEFAULT_CHANNEL_TEMPLATES: Array<{
   {
     id: 'chtpl-generic-optimize-default',
     name: '通用闭环优化频道(标准)',
-    description: '标准 goal 驱动闭环优化团队,适配任意已建模产线(注塑/污水/退火/流延/双拉等):lead 编排(可选知识库检索与经验沉淀,支持把 lead 已绑定节点授权给 worker),工艺工程师治理下发,数据分析师证据判读。实例化时可开知识库集成(enableKnowledgeBase)。',
+    description: '标准 goal 驱动闭环优化团队,适配任意已建模产线(注塑/污水/退火/流延/双拉等):lead 统一编排(知识检索/节点授权/回退决策),数据分析师持续读数判读,知识调优工程师把知识与数据转化为调优方案,工艺工程师治理下发。实例化时可开知识库集成(enableKnowledgeBase)。',
     scenarioPrompt: `## 通用闭环优化作业(标准流程)
-你是产线闭环优化团队,围绕用户 goal 对**任意已接入产线**做「取证 → 寻优 → 治理下发 → 复测收口」的闭环优化。开工前先用 my_industrial_nodes 与 line_context 弄清本频道持有的节点授权、产线/产品/配方与安全量程,不假设场景。
+你是产线闭环优化团队,围绕用户 goal 对**任意已接入产线**做「取证 → 知识增强 → 寻优 → 治理下发 → 复测收口(劣化即回退)」的闭环优化。开工前先用 my_industrial_nodes 与 line_context 弄清本频道持有的节点授权、产线/产品/配方与安全量程,不假设场景。
 
 ## 团队分工
-- 生产主管(lead):把 goal 拆解为「数据分析」与「参数调整」子任务并派发(worker 缺节点权限时,用 team_grant_nodes 把 lead 已绑定的节点授予对应 worker,或在 dispatch_task 里带 grant_node_ids 随任务授予;只授予自己绑定的节点);复核成员结论(必须带数据证据)→ 汇总收口;对拿不准的现象先查知识库(若已启用)。
-- 工艺工程师(worker):持有数控节点授权 —— daq_query 取证 → 判定设定-响应关系 → 在「安全量程 ∩ 配方窗口 ∩ 单步限幅」内用 dcw_control/param_control 小步幅下发(单变量);manual 模式节点先说明理由等用户批准;调整后等工艺惯性响应再复测;把「调整↔响应」证据回报 lead。
-- 数据分析师(worker):持有数采节点授权 —— daq_query 时序取证(按批次/时间窗过滤),输出趋势/均值/越限统计与工况判读;异常第一时间通报 lead 与工艺工程师。
+- 生产主管(lead):统一调配 —— 把 goal 拆解为「数据分析」「知识调优」「参数调整」子任务并派发(worker 缺节点权限时,用 team_grant_nodes 把 lead 已绑定的节点授予对应 worker,或在 dispatch_task 里带 grant_node_ids 随任务授予;只授予自己绑定的节点);复核成员结论(必须带数据证据);复测劣化时决策回退(指示工艺工程师 dcw_rollback / 配方回退);对拿不准的现象先查知识库(若已启用)。
+- 数据分析师(worker):**持续读数** —— 按固定节拍(每批次或每 5 分钟)daq_query 拉取授权数采节点时窗数据,滑动窗口对比输出趋势/均值/越限统计与工况判读;异常第一时间通报 lead、工艺工程师与知识调优工程师。
+- 知识调优工程师(worker):**知识↔数据 → 调优方案** —— 用 kb_agent(mode=sync) 检索知识库中本场景的机理知识与历史经验(检索词带产线/产品/关键物理量),结合数据分析师的判读结论,产出带知识依据的调优方案(参数/方向/步幅/预期响应,引用知识条目与数据);知识库未启用或检索为空时退化为纯数据驱动建议并说明。收口后用 kb_agent(mode=async) 沉淀「知识↔调整↔响应」经验入库。
+- 工艺工程师(worker):持有数控节点授权 —— daq_query 取证 → 按调优方案在「安全量程 ∩ 配方窗口 ∩ 单步限幅」内用 dcw_control/param_control 小步幅下发(单变量);manual 模式节点先说明理由等用户批准;调整后等工艺惯性响应再复测;复测劣化立即 dcw_rollback 回退本次调整并通报 lead。
 
 ## 作业纪律
-数据先行 → 窗口内小步幅(单次 ≤ 量程 2%)→ 单变量调整 → 复测闭环 → 结论必附带单位与时间窗的数据证据;不得操作未授权节点;治理审批与硬约束(步长限幅/写入间隔)被拒时按指引降步重试,不绕行。`,
+数据先行 → 知识增强(检索在动手前)→ **产线上下文先行**(频道已绑定产线时,开工先用 line_context 读取绑定产线全景:运行状态/活动批次/当前配方与参数窗口 —— 频道绑定=只读授权,日志/配方史全员可查,写操作仍需节点授权)→ **参数变更一律走配方链路**:多参数候选 → recipe_trial 整批试验(一次带上所有要改的参数,**不写配方版本**;同线节拍 ≥5 分钟)→ 等工艺惯性后复测判读 → 有进步/达标 **recipe_update 固化**(同一配方 id,版本+1,更新而非新建)→ 需要正式落地用 recipe_apply 整批下发;无进步/劣化 **recipe_rollback(dispatch=true) 统一回退**(定义回退+PLC 整批恢复)→ 复测闭环 → 结论必附带单位与时间窗的数据证据;优化闭环内禁用 dcw_control/param_control 逐参数直调(防单参数震荡;AML 探索模式的小步激励除外);知识闭环 = 检索 → 增强 → 试验 → 判读 → 固化/回退 → 沉淀;不得操作未授权节点;治理审批与硬约束被拒时按指引降步重试,不绕行。`,
     members: [
-      { inline: { name: '生产主管', harness: 'omp', config: { rpcMode: 'rpc', role: 'lead', systemPromptPrefix: '你是通用闭环优化团队的生产主管(lead):把用户 goal 拆解为「数据分析」「参数调整」子任务并用 dispatch_task 派发(可带 grant_node_ids 随任务把你自己已绑定的节点授权给 worker,或用 team_grant_nodes 执行中授予;只能授予自己绑定的节点);复核成员结论(必须带数据证据)后 complete 收口;若知识库已启用,开工前先用 kb_agent(mode=sync) 检索场景相关数据分析与物理机理,收口后用 kb_agent(mode=async) 沉淀本次经验(标题/类别/问题/解决方案/关键数据)。' } }, role: 'lead' },
-      { inline: { name: '工艺工程师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的工艺工程师,按节点物理意义做治理参数下发:my_industrial_nodes 确认授权 → daq_query 取证 → dcw_control/param_control 在「安全量程 ∩ 配方窗口 ∩ 单步限幅」内小步幅下发(单变量)→ 等待工艺惯性后 daq_query 复测。你的节点授权可能由 lead 在派发时或执行中授予(权限变化以 my_industrial_nodes 实时查询为准)。manual 模式节点下发前说明理由等批准。结论一律引用带单位与时间窗的数据。' } }, role: 'worker' },
-      { inline: { name: '数据分析师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的数据分析师,擅长时序取证与工况判读:用 daq_query 获取授权数采节点数据(按批次/时间窗),输出趋势/均值/极值/越限统计,结合数控设定考虑设定-响应滞后;发现越限或异常趋势立即用 send_message_to_agent 通报 lead 与工艺工程师。结论一律引用具体数值。' } }, role: 'worker' },
+      { inline: { name: '生产主管', harness: 'omp', config: { rpcMode: 'rpc', role: 'lead', systemPromptPrefix: '你是通用闭环优化团队的生产主管(lead),统一调配三人(数据分析师/知识调优工程师/工艺工程师):把用户 goal 拆解为「数据分析」「知识调优」「参数调整」子任务并用 dispatch_task 派发(可带 grant_node_ids 随任务把你自己已绑定的节点授权给 worker,或用 team_grant_nodes 执行中授予;只能授予自己绑定的节点);复核成员结论(必须带数据证据);优化动作一律走配方链路(trial 试验 → 判读 → update 固化 / 统一回退),复测指标劣化时立即指示工艺工程师 recipe_rollback(dispatch=true) 统一回退后再调整方向;频道绑定的产线只优化其当前活动配方,不新建配方 id;若知识库已启用,开工前先用 kb_agent(mode=sync) 检索场景相关数据分析与物理机理,收口后用 kb_agent(mode=async) 沉淀本次经验(可交知识调优工程师执行)。' } }, role: 'lead' },
+      { inline: { name: '数据分析师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的数据分析师,负责持续读数与工况判读:按固定节拍(每批次或每 5 分钟,以任务要求为准)用 daq_query 拉取授权数采节点数据(按批次/时间窗),做滑动窗口对比(当前窗 vs 基线窗),输出趋势/均值/极值/越限统计;结合数控设定考虑设定-响应滞后;发现越限或异常趋势立即用 send_message_to_agent 通报 lead、工艺工程师与知识调优工程师。结论一律引用具体数值与时间窗。' } }, role: 'worker' },
+      { inline: { name: '知识调优工程师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的知识调优工程师,把「知识库经验」与「数据分析结论」转化为可执行调优方案:先用 kb_agent(mode=sync) 检索知识库中本场景的机理知识与历史经验(检索词带产线/产品/关键物理量);结合数据分析师的最新判读,产出带知识依据的调优方案(调哪个参数/方向/步幅/预期响应/依据哪条知识,引用知识条目与数据证据);知识库未启用或检索为空时退化为纯数据驱动建议并明确说明;方案交工艺工程师治理下发(或经 lead 授权后自行 param_control 小步验证);复测有效则用 kb_agent(mode=async) 把「知识↔调整↔响应」经验沉淀入库(异步提交后无需等待);复测劣化则立即建议回退并同步 lead。' } }, role: 'worker' },
+      { inline: { name: '工艺工程师', harness: 'omp', config: { rpcMode: 'rpc', systemPromptPrefix: '你是通用闭环优化团队的工艺工程师,按知识调优工程师的方案走配方链路执行:my_industrial_nodes 确认授权 → daq_query 取证 → 把方案转成 recipe_trial(多参数候选整批试验,一次带上所有要改的参数,带 hypothesis 声明依据;不写配方版本)→ 等待工艺惯性后 daq_query 复测 → 有进步/达标用 recipe_update 把候选值固化进配方(同 id 版本+1),需要正式落地用 recipe_apply 整批下发;无进步/劣化用 recipe_rollback(dispatch=true)统一回退(定义回退+PLC 整批恢复)。优化闭环内禁用 dcw_control/param_control 逐参数直调(防震荡)。你的节点授权可能由 lead 在派发时或执行中授予(权限变化以 my_industrial_nodes 实时查询为准)。manual 模式节点下发前说明理由等批准。结论一律引用带单位与时间窗的数据。' } }, role: 'worker' },
     ],
   },
 ]
@@ -182,6 +184,14 @@ export function seedDefaultWorkshopData(db: DatabaseSync): void {
   for (const tpl of DEFAULT_CHANNEL_TEMPLATES) {
     insertChannelTpl.run(tpl.id, tpl.name, tpl.description, tpl.scenarioPrompt, JSON.stringify(tpl.members), now, now)
   }
+  // 内置模板升级:INSERT OR IGNORE 对已种子库不可见 —— 本文件是内置模板的唯一权威定义,
+  // 定义变更后重启即同步(只触 owner_user_id IS NULL 的内置公共行;用户复制的模板是独立 id,不受影响)。
+  const upgradeTpl = db.prepare(
+    'UPDATE channel_templates SET name = ?, description = ?, scenario_prompt = ?, members_json = ?, updated_at = ? WHERE id = ? AND owner_user_id IS NULL',
+  )
+  for (const tpl of DEFAULT_CHANNEL_TEMPLATES) {
+    upgradeTpl.run(tpl.name, tpl.description, tpl.scenarioPrompt, JSON.stringify(tpl.members), now, tpl.id)
+  }
 }
 
 /** channels 表行 */

package/server/services/workshop/db/schema.sql

@@ -326,3 +326,35 @@ CREATE TABLE IF NOT EXISTS hitl_requests (
 CREATE INDEX IF NOT EXISTS idx_hitl_requests_status ON hitl_requests(status, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_hitl_requests_channel ON hitl_requests(channel_id, status);
 CREATE INDEX IF NOT EXISTS idx_hitl_requests_agent ON hitl_requests(agent_id, status);
+
+-- v25: MES REST · CSV 数据集(Agent mes_fetch 异步取数的落盘事实源;铁律:MES 原文不进 prompt,工具面只回 stats+采样)
+CREATE TABLE IF NOT EXISTS mes_datasets (
+  id TEXT PRIMARY KEY,
+  line_id TEXT,
+  node_id TEXT,
+  node_name TEXT,
+  from_ts TEXT,
+  to_ts TEXT,
+  rows INTEGER DEFAULT 0,
+  sha256 TEXT,
+  file_path TEXT,
+  status TEXT DEFAULT 'ready',   -- running(取数中) | ready | failed
+  error TEXT,
+  created_by TEXT,
+  created_at TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_mes_datasets_line ON mes_datasets(line_id, created_at DESC);
+
+-- v25: MES REST · 取数作业(进程内异步执行的账本,绝不进调度循环;重启后遗留 running 由查询侧按 failed 呈现)
+CREATE TABLE IF NOT EXISTS mes_fetch_jobs (
+  id TEXT PRIMARY KEY,
+  dataset_id TEXT,
+  agent_id TEXT,
+  status TEXT DEFAULT 'running',  -- running | done | failed
+  rows INTEGER DEFAULT 0,
+  error TEXT,
+  created_at TEXT,
+  updated_at TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_mes_fetch_jobs_dataset ON mes_fetch_jobs(dataset_id);
+CREATE INDEX IF NOT EXISTS idx_mes_fetch_jobs_agent ON mes_fetch_jobs(agent_id, created_at DESC);

package/server/services/workshop/dcw/dcw-controller/recipes.ts

@@ -43,9 +43,9 @@ export abstract class DcwControllerRecipes extends DcwControllerParams {
     return recipe
   }
 
-  /** 回退配方参数到历史版本/lastGood(生成新版本;非破坏) */
-  revertRecipe(id: string, target: { version?: number, toLastGood?: boolean }, meta: { by: 'user' | 'agent' | 'system', actorName: string, actor: string, description: string }) {
-    const recipe = getDcwRecipeRepo().revertToVersion(id, target, meta)
+  /** 回退配方参数到历史版本/lastGood(生成新版本;非破坏)。allowNoop:定义已在目标态时原样返回(统一回退的 PLC 恢复腿仍要执行) */
+  revertRecipe(id: string, target: { version?: number, toLastGood?: boolean }, meta: { by: 'user' | 'agent' | 'system', actorName: string, actor: string, description: string }, opts?: { allowNoop?: boolean }) {
+    const recipe = getDcwRecipeRepo().revertToVersion(id, target, meta, opts)
     try {
       recordOps({
         actor: meta.actor,
@@ -86,6 +86,7 @@ export abstract class DcwControllerRecipes extends DcwControllerParams {
    * 逐参数写核心(apply 与产线开跑共用):**节点级寻址** —— 每个参数显式指向
    * 控制节点(节点才是真实控制 PLC 工艺参数的执行体)→ 逐参数写命令
    * (runId 入写历史)→ 结果快照。节点不存在 → 该参数记失败不阻塞其余。
+   * v19 trial:传入 merged params(候选覆盖集),批次与写命令按候选值落账。
    */
   protected async writeRecipeParams(recipe: RecipeView, run: RecipeRunView): Promise<void> {
     const results: RecipeRunView['results'] = []
@@ -117,15 +118,44 @@ export abstract class DcwControllerRecipes extends DcwControllerParams {
     getDcwRecipeRepo().updateRun(run)
   }
 
-  /** Recipe 手动应用(一键下发工艺参数集;不激活产线窗口) */
-  async applyRecipe(recipeId: string) {
+  /** v19 试验节拍:同产线两次 trial 的最小间隔(防连发震荡;env 可调)。 */
+  private static readonly TRIAL_INTERVAL_MS = Math.max(0, Number(process.env.AW_TRIAL_INTERVAL_MS) || 5 * 60_000)
+  private trialLastAt = new Map<string, number>()
+
+  private assertTrialCadence(lineId: string): void {
+    if (DcwControllerRecipes.TRIAL_INTERVAL_MS <= 0) return
+    const last = this.trialLastAt.get(lineId) ?? 0
+    const elapsed = Date.now() - last
+    if (elapsed < DcwControllerRecipes.TRIAL_INTERVAL_MS) {
+      throw new AppError(429, ErrorCodes.WRITE_FREQUENT, `本产线上一次配方试验距今仅 ${Math.floor(elapsed / 1000)}s,试验节拍为 ≥${Math.round(DcwControllerRecipes.TRIAL_INTERVAL_MS / 1000)}s(防连发震荡),请等待 ${Math.ceil((DcwControllerRecipes.TRIAL_INTERVAL_MS - elapsed) / 1000)}s 后再试`)
+    }
+  }
+
+  /**
+   * Recipe 手动应用 / Agent 试验(一键下发工艺参数集;不激活产线窗口)。
+   * v19 trial 语义:overrides = 候选覆盖集(仅覆盖列出节点的值,必须已是配方内节点)——
+   * 整批下发候选参数但**不写配方版本**(复测有进步才由 Agent recipe_update 固化);
+   * trial 受同线节拍卡控;四层限界在 write() 咽喉点照常拦截(量程∩参数∩产品)。
+   */
+  async applyRecipe(recipeId: string, opts: { overrides?: Array<{ nodeId: string, value: number }>, trial?: boolean } = {}) {
     this.ensureLoop()
     const repo = getDcwRecipeRepo()
     const recipe = repo.byId(recipeId)
     if (!recipe) throw new AppError(404, ErrorCodes.NOT_FOUND, `Recipe 不存在: ${recipeId}`)
     if (recipe.params.length === 0) throw new AppError(400, ErrorCodes.VALIDATION_ERROR, 'Recipe 无工艺参数,无可下发内容')
-    const run = repo.createRun(recipe)
-    await this.writeRecipeParams(recipe, run)
+    const overrides = opts.overrides ?? []
+    const unknown = overrides.filter(o => !recipe.params.some(p => p.nodeId === o.nodeId))
+    if (unknown.length) {
+      throw new AppError(400, ErrorCodes.VALIDATION_ERROR, `覆盖参数不在配方内: ${unknown.map(o => o.nodeId).join(', ')}(试验只能修改配方已有参数的值;新增参数请先 recipe_update)`)
+    }
+    if (opts.trial) this.assertTrialCadence(recipe.lineId)
+    const merged = recipe.params.map((p) => {
+      const ov = overrides.find(x => x.nodeId === p.nodeId)
+      return ov ? { ...p, value: ov.value } : p
+    })
+    const run = repo.createRun(recipe, merged)
+    await this.writeRecipeParams({ ...recipe, params: merged }, run)
+    if (opts.trial) this.trialLastAt.set(recipe.lineId, Date.now())
     return run
   }
 
@@ -133,5 +163,34 @@ export abstract class DcwControllerRecipes extends DcwControllerParams {
     return getDcwRecipeRepo().closeRun(id)
   }
 
+  /**
+   * v19 统一回退:定义回退到目标版本(非破坏,生成新版本)+ **该版本参数整批重下发到 PLC**
+   * (与 recipe_rollback 仅改定义的区别:本方法把恢复值真正写回产线,批次级恢复)。
+   * 下发走 write() 咽喉点,四层限界照常(回退值是历史已固化参数,量程/参数/产品层兜底)。
+   */
+  async rollbackRecipeAndDispatch(recipeId: string, opts: {
+    version?: number
+    toLastGood?: boolean
+    by?: 'user' | 'agent' | 'system'
+    actorName?: string
+    actor?: string
+    description?: string
+  }): Promise<{ recipe: RecipeView, run: RecipeRunView, definitionNoop?: boolean }> {
+    const versionBefore = getDcwRecipeRepo().byId(recipeId)?.version ?? 1
+    const updated = this.revertRecipe(recipeId, {
+      version: opts.toLastGood ? undefined : opts.version,
+      toLastGood: opts.toLastGood === true,
+    }, {
+      by: opts.by ?? 'agent',
+      actorName: opts.actorName ?? 'Agent',
+      actor: opts.actor ?? 'system',
+      description: opts.description ?? '统一回退(定义回退+PLC 整批恢复)',
+    }, { allowNoop: true })
+    // 定义已在目标态(allowNoop)≠PLC 已在目标态:整批恢复照常执行
+    const definitionNoop = (updated.version ?? 1) === versionBefore
+    const run = await this.applyRecipe(recipeId)
+    return { recipe: updated, run, definitionNoop }
+  }
+
   // ---------- 产线(实体 CRUD;节点/产品/配方挂载其下实现隔离) ----------
 }

package/server/services/workshop/dcw/dcw-controller/write.ts

@@ -9,6 +9,7 @@ import { assertWithinLimits, assertStepLimit } from '../param-limits'
 import { getRecipeRollBackManager } from '../recipe-rollback-manager'
 import { normalizeDcwDriverKind, resolveDcwDriver } from '../drivers'
 import { recordDcwWriteOps } from './write-audit'
+import { recordOps } from '../../ops/ops'
 
 export abstract class DcwControllerWrite extends DcwControllerBindings {
   /** 手动设定:用户提交工程量,网关校验/换算/下发/回读校验。
@@ -30,7 +31,25 @@ export abstract class DcwControllerWrite extends DcwControllerBindings {
       throw new AppError(409, ErrorCodes.CONFLICT, `当前节点暂停:「${node.name}」控制已暂停,仅开启控制的节点可被设定`)
     }
     // 调控闭环护栏(F1/F8):Agent 互斥(open 记录他人持有)+ 回退冷却方向性
-    getRecipeRollBackManager().beforeWrite(node, eng, meta)
+    // v18 拒绝留痕:治理咽喉点的每一次拒绝(量程/配方窗/步限/间隔/保持窗)入审计 ——
+    // 安全审计需要"谁在何时试图把参数写到哪、被哪条防线拦下";给调用方的反馈由错误消息承担。
+    const reject = (err: AppError): never => {
+      try {
+        recordOps({
+          actor: meta?.actor ?? 'system', actorName: meta?.actorName ?? '', actorKind: meta?.source === 'agent' ? 'agent' : (meta?.source === 'manual' ? 'user' : 'system'),
+          action: 'dcw.write.rejected', kind: 'write', targetKind: 'dcw', targetId: id, lineId: node.lineId,
+          summary: `设定 ${eng}${node.unit || ''} 被拒:${err.message}`,
+        })
+      }
+      catch { /* 审计失败不改变拒绝语义 */ }
+      throw err
+    }
+    try {
+      getRecipeRollBackManager().beforeWrite(node, eng, meta)
+    }
+    catch (err) {
+      reject(err instanceof AppError ? err : new AppError(409, ErrorCodes.CONFLICT, String(err instanceof Error ? err.message : err)))
+    }
     // 写入限界分层联锁(param-limits):节点安全量程(结构层,驱动内 validateEng 结构性兜底)
     // ∩ 工艺参数基准限界 ∩ 活动产品限界 ∩ 活动配方工艺窗口 —— 逐层收窄取交集,
     // 手动 REST / Agent 工具 / 配方下发 / 回退四路共用本咽喉点,越界一律拒绝。
@@ -40,7 +59,12 @@ export abstract class DcwControllerWrite extends DcwControllerBindings {
     const benchNoInterlock = process.env.AW_BENCH_MODE === '1' && (meta?.benchArm === 'no-interlock' || meta?.benchArm === 'ungated')
     // 配方下发路径(recipeRunId != null)跳过配方窗口层:下发值已在配方保存时对自身窗口校验,
     // 且中途应用新配方不应被旧批次配方窗口误伤;产品/参数基准层对配方下发照常约束。
-    assertWithinLimits(node, eng, { includeSoft: !benchNoInterlock, skipRecipe: recipeRunId != null })
+    try {
+      assertWithinLimits(node, eng, { includeSoft: !benchNoInterlock, skipRecipe: recipeRunId != null })
+    }
+    catch (err) {
+      reject(err instanceof AppError ? err : new AppError(400, ErrorCodes.VALIDATION_ERROR, String(err instanceof Error ? err.message : err)))
+    }
     const srcForLock = meta?.source ?? (recipeRunId ? 'recipe' : 'manual')
     const benchBypass = process.env.AW_BENCH_MODE === '1'
     // 在线 Agent/人工控制都走安全小步与 60s 最小间隔:这是探索阶段的硬卡控，
@@ -50,12 +74,17 @@ export abstract class DcwControllerWrite extends DcwControllerBindings {
       const previous = typeof node.value === 'number'
         ? node.value
         : (typeof node.readValue === 'number' ? node.readValue : null)
-      assertStepLimit(node, eng, { includeSoft: !benchNoInterlock, skipRecipe: false }, previous)
+      try {
+        assertStepLimit(node, eng, { includeSoft: !benchNoInterlock, skipRecipe: false }, previous)
+      }
+      catch (err) {
+        reject(err instanceof AppError ? err : new AppError(409, ErrorCodes.STEP_LIMIT_EXCEEDED, String(err instanceof Error ? err.message : err)))
+      }
       const previousAt = node.lastWriteAt ? Date.parse(node.lastWriteAt) : NaN
       if (Number.isFinite(previousAt)) {
         const elapsed = Date.now() - previousAt
         if (elapsed < 60_000) {
-          throw new AppError(429, ErrorCodes.WRITE_INTERVAL_NOT_ELAPSED, `DCW 节点「${node.name}」两次在线写入间隔必须至少 60s，当前还需 ${Math.ceil((60_000 - elapsed) / 1000)}s`)
+          reject(new AppError(429, ErrorCodes.WRITE_INTERVAL_NOT_ELAPSED, `DCW 节点「${node.name}」两次在线写入间隔必须至少 60s，当前还需 ${Math.ceil((60_000 - elapsed) / 1000)}s`))
         }
       }
     }
@@ -78,11 +107,11 @@ export abstract class DcwControllerWrite extends DcwControllerBindings {
         }
       }
       if (now < until) {
-        throw new AppError(
+        reject(new AppError(
           429,
           ErrorCodes.WRITE_FREQUENT,
           `当前写入频繁:「${node.name}」处于写入保持窗口(剩余 ${Math.ceil((until - now) / 1000)}s),请稍后再试`,
-        )
+        ))
       }
     }
     // D8: no-readback / ungated 臂 → 容差置 MAX,回读差异不致败(假成功语义,供 I2 消融)

package/server/services/workshop/dcw/dcw-recipe.repo.ts

@@ -232,10 +232,13 @@ class DcwRecipeRepo {
   /**
    * 回退配方参数到指定历史版本(或已知良好批次快照),生成新版本(非破坏,历史完整保留)。
    * target: { version: N } = 回到 vN 的参数;{ toLastGood: true } = 回到 lastGood 批次的参数冻结。
+   * opts.allowNoop:目标参数与当前定义完全一致时不抛 409 而是原样返回 —— 统一回退
+   * (dispatch:true)路径必须放行:定义已在目标态≠PLC 已在目标态,整批恢复仍要执行;
+   * 仅定义回退(无 dispatch)保持 409(无可做之事,如实告知)。
    * 失效参数剪枝:目标快照里已删除/已改挂其他产线的节点参数先剔除(否则归一化整体失败),
    * 剔除动作如实记录进版本描述。
    */
-  revertToVersion(id: string, target: { version?: number, toLastGood?: boolean }, meta: RecipeUpdateMeta): RecipeView {
+  revertToVersion(id: string, target: { version?: number, toLastGood?: boolean }, meta: RecipeUpdateMeta, opts?: { allowNoop?: boolean }): RecipeView {
     const r = this.byId(id)
     if (!r) throw new AppError(404, ErrorCodes.NOT_FOUND, `Recipe 不存在: ${id}`)
     let snapshot: RecipeParam[]
@@ -260,6 +263,7 @@ class DcwRecipeRepo {
       desc = `回退到 v${v}(该版变更于 ${hit.at.slice(0, 19).replace('T', ' ')}${hit.actorName ? `,原操作者 ${hit.actorName}` : ''})`
     }
     if (JSON.stringify(snapshot) === JSON.stringify(r.params)) {
+      if (opts?.allowNoop) return r
       throw new AppError(409, ErrorCodes.CONFLICT, `目标版本参数与当前 v${r.version ?? 1} 完全一致,无需回退`)
     }
     // 失效参数剪枝:已删除节点、已解绑/已改挂其他产线的节点参数剔除(不自动收编,尊重显式解绑)
@@ -277,7 +281,9 @@ class DcwRecipeRepo {
       fullDesc += `;已剔除失效参数(${names}:节点已删除或解绑)`
     }
     return this.update(id, {
-      params: usable.map(p => ({ nodeId: p.nodeId, templateRef: p.templateRef, value: p.value, min: p.min, max: p.max })),
+      // stepLimit 必须随快照回填:丢弃会让"回退后定义"与历史版本不再逐字段一致,
+      // 既抹掉配方层单步限幅,又让下一次同值 update/revert 误判为有变化而空转增版
+      params: usable.map(p => ({ nodeId: p.nodeId, templateRef: p.templateRef, value: p.value, min: p.min, max: p.max, stepLimit: p.stepLimit })),
     }, { ...meta, description: fullDesc })
   }
 
@@ -353,7 +359,7 @@ class DcwRecipeRepo {
     }
   }
 
-  createRun(recipe: RecipeView): RecipeRunView {
+  createRun(recipe: RecipeView, paramsOverride?: RecipeView['params']): RecipeRunView {
     const run: RecipeRunView = {
       id: `rr-${randomUUID().slice(0, 8)}`,
       recipeId: recipe.id,
@@ -363,8 +369,9 @@ class DcwRecipeRepo {
       startedAt: new Date().toISOString(),
       endedAt: null,
       results: [],
-      // 参数冻结(调控闭环):配方事后修改不影响本批次的审计与回放
-      paramsSnapshot: recipe.params.map(p => ({ ...p })),
+      // 参数冻结(调控闭环):配方事后修改不影响本批次的审计与回放。
+      // v19 trial:候选覆盖集作为批次快照(批次实际按候选值生产,审计与回放以候选为准)。
+      paramsSnapshot: (paramsOverride ?? recipe.params).map(p => ({ ...p })),
     }
     this.runs.push(run)
     if (this.runs.length > RUNS_CAP) this.runs.splice(0, this.runs.length - RUNS_CAP)