Recipe 版本管理

配方参数的每一次修改都自动版本化入史,记录来源(用户/Agent/系统)、操作者、原因, 回退是非破坏的(生成新版本,历史完整保留)—— 为在线闭环优化提供治理基座。

版本化规则

• 配方创建即 v1;活动批次外的参数修改 → 版本自增,旧版整体入 paramsHistory(上限 20);
• 每条历史:{ version, params, at, by, actorName, actor, description };
  • 用户界面编辑 → 归因登录用户;
  • Agent recipe_update → 归因「Channel名/成员名」+ 必填原因;
• 批次级安全网:判定 keep 的优化记录可标记 lastGood 批次(参数冻结快照)。

REST

# 版本历史(旧→新,尾行=当前版)
GET /api/workshop/dcw/recipes/:id/versions

# 回退:到指定版本 / 到 lastGood 批次冻结(生成新版本)
POST /api/workshop/dcw/recipes/:id/revert
{ "version": 2, "reason": "界面回退" }
{ "toLastGood": true, "reason": "优化翻车,回良好批次" }

Agent 工具

工具	作用	鉴权
line_context	我控制的产线/产品/配方全景(逐参数目标 vs PLC 当前值)	绑定节点所属产线
recipe_versions	版本史 + 参数 diff(谁/何时/为什么)	同上
recipe_update	保存最佳参数(部分合并,reason 必填,生成新版本)	逐节点 dcw 绑定
recipe_rollback	回退到指定版本 / lastGood(reason 必填)	同上

节点级参数变更史用 dcw_journal(逐笔 锚/优化记录/判定),节点单步回退用 dcw_rollback。

失效节点守卫

配方参数引用的节点被删除/停用/解绑时:

• 下发(一键下发/开跑批次)自动跳过并在批次结果记明「已停用/已取消绑定/已删除」;
• 界面参数芯片灰化 + 徽标;编辑表单自动剔除已删除行并横幅告知;
• Agent recipe_update 触到失效节点精确拒因;保存时自动剪除基线失效参数并告知;
• 回退到含失效节点的历史版本 → 剪枝成功,剔除动作写入版本描述。

闭环示例

Agent: line_context(确认归属与当前值)
  → dcw_control 下发试验值 → daq_query 取数采证据
  → dcw_judge keep(证据充分)→ recipe_update 固化为 vN
翻车:recipe_rollback(to_last_good 或 version)→ 新版本,PLC 不受影响