agentworkshop 0.7.62 → 0.7.64

package/server/services/workshop/agents/industrial/dcw-tools.ts

@@ -1,255 +1,210 @@
-/**
- * 节点清单、数控下发/回读(dcw_control / dcw_read)
- * (由 server/services/workshop/agents/industrial-tools.ts 按职责拆出;内容逐行原文搬运)
- */
-import type { AgentNodeBinding } from '../node-bindings.repo'
-import { agentBadgeLabel } from '../agent-badge'
-import { findDcwTemplate } from '../../dcw/dcw-templates'
-import { getActiveLineRun } from '../../dcw/line-run'
-import { getAgentNodeBindingRepo } from '../node-bindings.repo'
-import { getDaqNodeRepo } from '../../daq/daq-node.repo'
-import { getDcwController } from '../../dcw/dcw-controller'
-import { getRecipeRollBackManager } from '../../dcw/recipe-rollback-manager'
-import { limitsBreakdownOf } from '../../dcw/param-limits'
-import { nodeSemanticCards, recipeOperationFace } from '../industrial-context'
-import { writeToleranceOf } from './param-tools'
-import { requestManualApproval } from './manual-approval'
-import { guardTwinWrite } from '../../aml/twin/write-guard'
-
-export async function toolMyIndustrialNodes(agentId: string): Promise<{ text: string }> {
-  const repo = getAgentNodeBindingRepo()
-  const bindings = repo.byAgent(agentId)
-  if (bindings.length === 0) {
-    return { text: '你尚未绑定任何工业对象。请让用户或 lead 为你绑定:数控/数采节点(kind=daq 观察)或配方(kind=recipe,参数写入与下发)。' }
-  }
-  const cards = nodeSemanticCards(agentId)
-  if (cards.stale > 0) repo.removeAgentNodeStale(agentId, bindings.filter((b) => {
-    const has = b.kind === 'dcw' ? !!getDcwController().byId(b.nodeId) : b.kind === 'daq' ? !!getDaqNodeRepo().byId(b.nodeId) : true
-    return !has
-  }).map(b => b.id))
-  // 配方操作面(v2:绑定配方的 Agent 在此直接看到"怎么做" —— 运行状态/绑定模式/认证/参数对照)
-  const recipeFace = recipeOperationFace(agentId)
-  if (!cards.text && !recipeFace) return { text: '绑定的节点均已不存在(可能被删除),请重新绑定。' }
-  const staleNote = cards.stale > 0
-    ? `
-(另有 ${cards.stale} 条失效绑定已自动清理)`
-    : ''
-  // 调控闭环洞察:每个数控节点的 open 优化记录 / lastGood / 最近判定(Agent 驱动的状态面)
-  const rb = getRecipeRollBackManager()
-  const insights: string[] = []
-  for (const b of bindings.filter(x => x.kind === 'dcw')) {
-    try {
-      const ins = rb.nodeInsight(b.nodeId)
-      const parts: string[] = []
-      if (ins.openRecord)
-        parts.push(`进行中优化 ${ins.openRecord.id}: ${ins.openRecord.params[0]?.from ?? '?'}→${ins.openRecord.params[0]?.to}(setAt ${ins.openRecord.setAt.slice(11, 19)},policy=${ins.openRecord.policy})`)
-      if (ins.lastGood != null)
-        parts.push(`上次良好值 ${ins.lastGood}`)
-      for (const j of ins.recentJudges.slice(0, 1))
-        parts.push(`最近判定 ${j.verdict}(${j.by}):${j.reason.slice(0, 60)}`)
-      if (parts.length > 0)
-        insights.push(`- ${b.nodeId}: ${parts.join(';')}`)
-    }
-    catch { /* 节点刚被删等情况忽略 */ }
-  }
-  const insightBlock = insights.length > 0 ? `\n\n调控闭环状态:\n${insights.join('\n')}` : ''
-  return {
-    text: `${cards.text}${staleNote}${insightBlock}${recipeFace ? `\n\n${recipeFace}` : ''}
-
----
-通用规则:
-1. 一个 Agent 可绑定多个节点与多个配方;先读本清单理解每个节点/配方的物理意义、下发链路与操作守则,再动手。
-2. 参数写入与下发一律走你绑定的配方(权限模型 v2,直接写节点已禁用):
-   recipe_update(recipe_id, params[{node_id,value}], reason) 保存新版本 → recipe_apply(整批下发到运行中批次)
-   或 recipe_trial(候选整批试验,不写版本);劣化用 recipe_rollback(dispatch=true) 统一回退。
-   设定值受四层限界联锁(节点安全量程 ∩ 工艺参数基准限界 ∩ 活动产品限界 ∩ 活动配方工艺窗口)逐层收窄,
-   越界一律拒绝 —— 用户与 Agent 一体约束,无旁路;底层数控节点(PLC/MES)由配置层承接,你只面对工程量。
-   配方必须正在执行(运行门),未运行时任何操作被拒。
-3. 数据获取 daq_query(不传 node_id = 全部数采节点),支持按产线/产品/配方/时间检索;解读数据时结合语义卡的判读方法;
-   MES 数据用 mes_catalog / mes_fetch(检测向量/图像帧/表格/事件全格式;统计摘要回包,原文落盘)。
-   需要完整波形(非统计摘要)做深度分析时用 daq_export:自选节点全量原始时序导出为 CSV + manifest.json
-   (节点映射/语义/产线-配方上下文);把 export_id 交 diag_run 发起深度根因诊断,或把目录绝对路径交给其他 worker 离线分析。
-4. 改动设定后等待工艺响应(热惯性/传动惯量)再评估,避免连续大幅调整。
-5. 调控闭环:每次下发自动开一条优化记录(open);观察数采后用 dcw_judge 落判定(keep/rollback/uncertain);
-   判 rollback 后用 recipe_rollback(dispatch=true, reason) 统一回退;dcw_journal 可查节点参数变更史。未判定前再下发,旧记录会被标记 superseded。
-   若节点被他人的 open 记录阻塞(对方已消失),超时(30 分钟)后你可接管:dcw_judge 会带接管标记入册。
-6. 自查面:line_context 看你控制的产线/产品/配方全景(动手前必读,确认归属);
-   ops_log 查你负责产线的运维日志(谁/何时做了什么,来源区分 Agent/用户/系统;
-   参数 line_id/node_id/kind/actor_kind/minutes/limit/mine);recipe_log 查配方下发与回退事件;
-   recipe_versions 查配方参数版本史(谁改的/为什么/参数 diff)。
-7. 配方操控闭环(在线优化框架):验证过参数更优 → recipe_update 保存进配方(记录你的名字与原因,
-   生成新版本);发现优化有问题 → recipe_rollback 回退到稳定版本(version)或已知良好批次
-   (to_last_good=true,dispatch=true 整批恢复运行中产线)。`,
-  }
-}
-
-/** 工具:dcw_control —— 数控下发(鉴权 → 停线守卫 → 手动审批 → 安全联锁 → 回读语义结果)。
- *  调控闭环:下发自动开优化记录;args.hypothesis 声明本次假设(入册),args.task_id 关联任务。 */
-export async function toolDcwControl(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
-  // 权限模型 v2:Agent 不直接操作数控节点 —— 参数写入与下发全部收敛到绑定的 recipe
-  // (defense in depth:工具面已摘除定义,handler 侧仍拒绝,防直连 invoke 绕行)
-  void agentId
-  void args
-  void channelId
-  return {
-    text: '直接节点写控已禁用(权限模型 v2):Agent 不再直接操作数控节点。请改用绑定的配方完成同样动作 —— recipe_update(参数写入,生成新版本)/ recipe_apply(整批下发)/ recipe_trial(候选整批试验,不写版本)/ recipe_rollback(回退);均为带理由与 HITL 的配方面操作,治理联锁(量程/步长/限速)照常生效。',
-    isError: true,
-  }
-}
-
-/**
- * v2 前的直写实现(工具面已摘除,但**治理链完整**:四层限界/HITL/60s 联锁/journal/open 记录)。
- * 仍允许**平台内部治理工具**复用:optimization_explore(工艺优化 Channel 的闭环探索,
- * profile 门控)的写入委托它执行 —— Agent 可调用面依然收敛在配方面,此处非 Agent 入口。
- */
-export async function dcwControlGovernedInternal(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
-  return _toolDcwControlDisabled(agentId, args, channelId)
-}
-
-/** v2 前的直写实现(已停用;保留供回溯/内部审计阅读,不再被任何入口调用) */
-async function _toolDcwControlDisabled(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
-  const twinGuard = guardTwinWrite(agentId, channelId)
-  if (!twinGuard.allowed) return { text: `${twinGuard.code}: ${twinGuard.message}`, isError: true }
-  const nodeId = String(args.node_id ?? '').trim()
-  const value = Number(args.value)
-  const repo = getAgentNodeBindingRepo()
-  const binding: AgentNodeBinding | undefined = nodeId ? repo.find(agentId, nodeId, 'dcw') : undefined
-  // 权限模型 v2:配方绑定(kind=recipe)覆盖其参数节点 —— 该节点在绑定配方参数内即算授权
-  let recipeAuthorized = false
-  if (!binding && nodeId) {
-    const recipes = repo.byAgent(agentId).filter(b => b.kind === 'recipe')
-    recipeAuthorized = recipes.some((b) => {
-      const r = getDcwController().listRecipes().find(x => x.id === b.nodeId)
-      return r?.params.some(p => p.nodeId === nodeId) ?? false
-    })
-  }
-  if (!binding && !recipeAuthorized) {
-    const mine = repo.byAgent(agentId).filter(b => b.kind === 'dcw')
-    return {
-      text: mine.length
-        ? `无权操作节点 ${nodeId || '(空)'}。你有权控制的数控节点:${mine.map(b => b.nodeId).join(', ')}(可用 my_industrial_nodes 查看物理含义)。`
-        : '你尚未绑定任何数控节点,也无含该参数的配方绑定,无权下发控制指令(权限模型 v2:持有含该参数的配方绑定即可)。',
-      isError: true,
-    }
-  }
-  if (!Number.isFinite(value)) {
-    return { text: '设定值 value 必须为数字。', isError: true }
-  }
-  const node = getDcwController().byId(nodeId)
-  if (!node) {
-    // 节点已被删除 → 绑定失效自清理,提示重新绑定(仅 dcw 直绑;配方路径无绑定可清)
-    if (binding) repo.removeAgentNode(agentId, nodeId, 'dcw')
-    return { text: `数控节点 ${nodeId} 已不存在(可能被删除),原绑定已自动清理,请重新绑定。`, isError: true }
-  }
-  // 停用/解绑守卫:停用节点拒绝下发(与手动/配方同源语义,给出恢复路径)
-  if (!node.enabled) {
-    return { text: `节点「${node.name}」已停用(控制已暂停),无法下发。请先让用户在产线/数采界面恢复该节点的控制,或改派其他节点。`, isError: true }
-  }
-  // 停线守卫:产线未开跑时手动写允许(调试),但提示当前无配方窗口约束
-  const tpl = findDcwTemplate(node.templateKey)
-
-  // 手动确认模式:与 param_control 同源审批面(manual-approval),批准附言回进回执
-  let manualFeedback = ''
-  if (binding?.mode === 'manual') {
-    const bd = limitsBreakdownOf(node)
-    const ap = await requestManualApproval({
-      agentId,
-      nodeId,
-      detail: `${node.name}(${tpl?.ch ?? node.templateKey})设定 ${value}${node.unit},有效写入区间 ${bd.effective.min}~${bd.effective.max}${node.unit}(${bd.layers.map(l => l.label).join(' ∩ ')})`,
-    })
-    if (!ap.ok) return { text: ap.text, isError: ap.isError }
-    manualFeedback = ap.comment ?? ''
-  }
-
-  try {
-    const meta = {
-      source: 'agent' as const,
-      actor: agentId,
-      // 人话操作者:「Channel名/成员名」——/logs 来源=Agent 与用户/系统操作可区分追溯
-      actorName: agentBadgeLabel(agentId),
-      taskId: args.task_id ? String(args.task_id) : undefined,
-      hypothesis: args.hypothesis ? String(args.hypothesis) : '',
-    }
-    const outcome = await getDcwController().write(nodeId, value, null, meta)
-    const run = node.lineId ? getActiveLineRun(node.lineId) : null
-    const winTxt = run
-      ? `当前活动配方「${run.recipeName}」`
-      : '当前无活动配方(全局量程约束)'
-    if (outcome.ok) {
-      // 调控闭环回包:记录 id + 上一稳定锚 + 策略提示(安全网信息,Agent 据此规划判定)
-      const rb = getRecipeRollBackManager()
-      const stable = rb.journal({ nodeId, limit: 10 }).find(a => a.prevValue != null && a.prevValue !== a.newValue)
-      const policyHint = binding?.mode === 'manual'
-        ? '本节点为手动确认模式:判定回退将推请用户确认'
-        : '本节点为自动模式:越配方监控窗将触发系统自动回退'
-      const loopTxt = [
-        outcome.recordId ? `优化记录 ${outcome.recordId} 已开窗(观察数采后 dcw_judge 落判定)` : null,
-        stable ? `上一稳定锚:${stable.prevValue}${node.unit}(可 dcw_rollback 回退)` : null,
-        policyHint,
-      ].filter(Boolean).join(';')
-      // ACK 鉴定如实表述(2026-10-08):ok 只是命令受理 —— 回读证实与仅链路受理必须区分,
-      // 不许对无回读驱动(mqtt/http-no-echo)虚报"回读一致"。
-      const ackTxt = outcome.ack === 'readback-verified'
-        ? `回读 ${outcome.readback != null ? `${outcome.readback}${node.unit}` : '-'}一致 [设备证实✓]`
-        : outcome.ack === 'transport-ack'
-          ? '设备侧未回读证实,仅链路受理 [未证实⚠,建议 daq_query 复测]'
-          : '无确认通道 [未证实⚠]'
-      return {
-        text: `下发受理:${node.name}(${tpl?.ch ?? node.templateKey})设定 ${value}${node.unit} → PLC 原始值 ${outcome.raw ?? '-'};${ackTxt}。${winTxt}。${outcome.message}\n[调控闭环] ${loopTxt}${manualFeedback ? `\n[人工反馈] ${manualFeedback}` : ''}`,
-      }
-    }
-    // 失败文案带自我纠正线索:当前保持原值 + 建议动作(缩小步进/稍后重试)
-    const keptHint = `当前设定值保持 ${node.value ?? '原值'}${node.unit} 未被改动`
-    const retryHint = /忙|busy/i.test(outcome.message) ? '链路忙属瞬时状态,可稍后重试' : '可缩小步进幅度后重试'
-    return { text: `下发失败:${outcome.message}(节点 ${node.name},物理量 ${tpl?.ch ?? node.templateKey},安全量程 ${node.min}~${node.max}${node.unit};${keptHint};${retryHint})`, isError: true }
-  }
-  catch (err) {
-    const msg = err instanceof Error ? err.message : String(err)
-    const retryHint = /忙|busy/i.test(msg) ? '链路忙属瞬时状态,可稍后重试' : '设定值必须落在安全量程与活动配方工艺窗口内'
-    return { text: `下发被拒绝:${msg}(节点 ${node.name},物理量 ${tpl?.ch ?? node.templateKey};${retryHint})`, isError: true }
-  }
-}
-
-/** 工具:dcw_read —— 读取数控节点的 PLC 当前值(读写集成的读半边;被动观测免审批)。
- *  返回 PLC 实时读数(标定解码后的物理量)与当前设定值对照,供下发前取证/下发后复核。 */
-export async function toolDcwRead(agentId: string, args: { node_id?: string }): Promise<{ text: string, isError?: boolean }> {
-  const nodeId = String(args.node_id ?? '').trim()
-  const repo = getAgentNodeBindingRepo()
-  const binding: AgentNodeBinding | undefined = nodeId ? repo.find(agentId, nodeId, 'dcw') : undefined
-  if (!binding) {
-    const mine = repo.byAgent(agentId).filter(b => b.kind === 'dcw')
-    return {
-      text: mine.length
-        ? `无权读取节点 ${nodeId || '(空)'}。你有权读取的数控节点:${mine.map(b => b.nodeId).join(', ')}。`
-        : '你尚未绑定任何数控节点,无权读取控制通道数据。请在数字孪生界面绑定数控节点。',
-      isError: true,
-    }
-  }
-  const node = getDcwController().byId(nodeId)
-  if (!node) {
-    repo.removeAgentNode(agentId, nodeId, 'dcw')
-    return { text: `数控节点 ${nodeId} 已不存在(可能被删除),原绑定已自动清理,请重新绑定。`, isError: true }
-  }
-  const tpl = findDcwTemplate(node.templateKey)
-  try {
-    const read = await getDcwController().readNow(nodeId)
-    if (!read.ok && read.value == null && !node.readValue) {
-      return { text: `读取失败:${read.message}(节点 ${node.name},驱动 ${node.driver} 可能不支持读取;可改用 daq_query 查关联数采通道)`, isError: true }
-    }
-    const setTxt = node.value != null ? `${node.value}${node.unit}` : '从未下发'
-    const readTxt = read.value != null
-      ? `${Number(read.value.toFixed(node.decimals))}${node.unit}`
-      : (node.readValue != null ? `${node.readValue}${node.unit}(最近一次)` : '无读数')
-    const devTxt = read.value != null && node.value != null
-      ? (Math.abs(read.value - node.value) < writeToleranceOf(node)
-          ? '读数与设定一致(设定已生效)'
-          : '读数与设定存在偏差(可能工艺在响应或被本地修改)')
-      : '设定与读数暂不可对照'
-    return {
-      text: `读取成功:${node.name}(${tpl?.ch ?? node.templateKey})\n  PLC 读数(ACT): ${readTxt} @ ${read.at.slice(11, 19)}\n  当前设定(SET): ${setTxt}\n  对照: ${devTxt}${read.raw != null ? `\n  原始值(raw): ${Number(read.raw.toFixed(4))}` : ''}`,
-    }
-  }
-  catch (err) {
-    return { text: `读取被拒绝:${err instanceof Error ? err.message : String(err)}(节点 ${node.name})`, isError: true }
-  }
-}
+/**
+ * 节点清单、数控下发/回读(dcw_control / dcw_read)
+ * (由 server/services/workshop/agents/industrial-tools.ts 按职责拆出;内容逐行原文搬运)
+ */
+import type { AgentNodeBinding } from '../node-bindings.repo'
+import { agentBadgeLabel } from '../agent-badge'
+import { findDcwTemplate } from '../../dcw/dcw-templates'
+import { getActiveLineRun } from '../../dcw/line-run'
+import { getAgentNodeBindingRepo } from '../node-bindings.repo'
+import { getDaqNodeRepo } from '../../daq/daq-node.repo'
+import { getDcwController } from '../../dcw/dcw-controller'
+import { getRecipeRollBackManager } from '../../dcw/recipe-rollback-manager'
+import { limitsBreakdownOf } from '../../dcw/param-limits'
+import { nodeSemanticCards, recipeOperationFace } from '../industrial-context'
+import { requestManualApproval } from './manual-approval'
+import { guardTwinWrite } from '../../aml/twin/write-guard'
+
+export async function toolMyIndustrialNodes(agentId: string): Promise<{ text: string }> {
+  const repo = getAgentNodeBindingRepo()
+  const bindings = repo.byAgent(agentId)
+  if (bindings.length === 0) {
+    return { text: '你尚未绑定任何工业对象。请让用户或 lead 为你绑定:数控/数采节点(kind=daq 观察)或配方(kind=recipe,参数写入与下发)。' }
+  }
+  const cards = nodeSemanticCards(agentId)
+  if (cards.stale > 0) repo.removeAgentNodeStale(agentId, bindings.filter((b) => {
+    const has = b.kind === 'dcw' ? !!getDcwController().byId(b.nodeId) : b.kind === 'daq' ? !!getDaqNodeRepo().byId(b.nodeId) : true
+    return !has
+  }).map(b => b.id))
+  // 配方操作面(v2:绑定配方的 Agent 在此直接看到"怎么做" —— 运行状态/绑定模式/认证/参数对照)
+  const recipeFace = recipeOperationFace(agentId)
+  if (!cards.text && !recipeFace) return { text: '绑定的节点均已不存在(可能被删除),请重新绑定。' }
+  const staleNote = cards.stale > 0
+    ? `
+(另有 ${cards.stale} 条失效绑定已自动清理)`
+    : ''
+  // 调控闭环洞察:每个数控节点的 open 优化记录 / lastGood / 最近判定(Agent 驱动的状态面)
+  const rb = getRecipeRollBackManager()
+  const insights: string[] = []
+  for (const b of bindings.filter(x => x.kind === 'dcw')) {
+    try {
+      const ins = rb.nodeInsight(b.nodeId)
+      const parts: string[] = []
+      if (ins.openRecord)
+        parts.push(`进行中优化 ${ins.openRecord.id}: ${ins.openRecord.params[0]?.from ?? '?'}→${ins.openRecord.params[0]?.to}(setAt ${ins.openRecord.setAt.slice(11, 19)},policy=${ins.openRecord.policy})`)
+      if (ins.lastGood != null)
+        parts.push(`上次良好值 ${ins.lastGood}`)
+      for (const j of ins.recentJudges.slice(0, 1))
+        parts.push(`最近判定 ${j.verdict}(${j.by}):${j.reason.slice(0, 60)}`)
+      if (parts.length > 0)
+        insights.push(`- ${b.nodeId}: ${parts.join(';')}`)
+    }
+    catch { /* 节点刚被删等情况忽略 */ }
+  }
+  const insightBlock = insights.length > 0 ? `\n\n调控闭环状态:\n${insights.join('\n')}` : ''
+  return {
+    text: `${cards.text}${staleNote}${insightBlock}${recipeFace ? `\n\n${recipeFace}` : ''}
+
+---
+通用规则:
+1. 一个 Agent 可绑定多个节点与多个配方;先读本清单理解每个节点/配方的物理意义、下发链路与操作守则,再动手。
+2. 参数写入与下发一律走你绑定的配方(权限模型 v2,直接写节点已禁用):
+   recipe_update(recipe_id, params[{node_id,value}], reason) 保存新版本 → recipe_apply(整批下发到运行中批次)
+   或 recipe_trial(候选整批试验,不写版本);劣化用 recipe_rollback(dispatch=true) 统一回退。
+   设定值受四层限界联锁(节点安全量程 ∩ 工艺参数基准限界 ∩ 活动产品限界 ∩ 活动配方工艺窗口)逐层收窄,
+   越界一律拒绝 —— 用户与 Agent 一体约束,无旁路;底层数控节点(PLC/MES)由配置层承接,你只面对工程量。
+   配方必须正在执行(运行门),未运行时任何操作被拒。
+3. 数据获取 daq_query(不传 node_id = 全部数采节点),支持按产线/产品/配方/时间检索;解读数据时结合语义卡的判读方法;
+   MES 数据用 mes_catalog / mes_fetch(检测向量/图像帧/表格/事件全格式;统计摘要回包,原文落盘)。
+   需要完整波形(非统计摘要)做深度分析时用 daq_export:自选节点全量原始时序导出为 CSV + manifest.json
+   (节点映射/语义/产线-配方上下文);把 export_id 交 diag_run 发起深度根因诊断,或把目录绝对路径交给其他 worker 离线分析。
+4. 改动设定后等待工艺响应(热惯性/传动惯量)再评估,避免连续大幅调整。
+5. 调控闭环:每次下发自动开一条优化记录(open);观察数采后用 dcw_judge 落判定(keep/rollback/uncertain);
+   判 rollback 后用 recipe_rollback(dispatch=true, reason) 统一回退;dcw_journal 可查节点参数变更史。未判定前再下发,旧记录会被标记 superseded。
+   若节点被他人的 open 记录阻塞(对方已消失),超时(30 分钟)后你可接管:dcw_judge 会带接管标记入册。
+6. 自查面:line_context 看你控制的产线/产品/配方全景(动手前必读,确认归属);
+   ops_log 查你负责产线的运维日志(谁/何时做了什么,来源区分 Agent/用户/系统;
+   参数 line_id/node_id/kind/actor_kind/minutes/limit/mine);recipe_log 查配方下发与回退事件;
+   recipe_versions 查配方参数版本史(谁改的/为什么/参数 diff)。
+7. 配方操控闭环(在线优化框架):验证过参数更优 → recipe_update 保存进配方(记录你的名字与原因,
+   生成新版本);发现优化有问题 → recipe_rollback 回退到稳定版本(version)或已知良好批次
+   (to_last_good=true,dispatch=true 整批恢复运行中产线)。`,
+  }
+}
+
+/** 工具:dcw_control —— 数控下发(鉴权 → 停线守卫 → 手动审批 → 安全联锁 → 回读语义结果)。
+ *  调控闭环:下发自动开优化记录;args.hypothesis 声明本次假设(入册),args.task_id 关联任务。 */
+export async function toolDcwControl(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
+  // 权限模型 v2:Agent 不直接操作数控节点 —— 参数写入与下发全部收敛到绑定的 recipe
+  // (defense in depth:工具面已摘除定义,handler 侧仍拒绝,防直连 invoke 绕行)
+  void agentId
+  void args
+  void channelId
+  return {
+    text: '直接节点写控已禁用(权限模型 v2):Agent 不再直接操作数控节点。请改用绑定的配方完成同样动作 —— recipe_update(参数写入,生成新版本)/ recipe_apply(整批下发)/ recipe_trial(候选整批试验,不写版本)/ recipe_rollback(回退);均为带理由与 HITL 的配方面操作,治理联锁(量程/步长/限速)照常生效。',
+    isError: true,
+  }
+}
+
+/**
+ * v2 前的直写实现(工具面已摘除,但**治理链完整**:四层限界/HITL/60s 联锁/journal/open 记录)。
+ * 仍允许**平台内部治理工具**复用:optimization_explore(工艺优化 Channel 的闭环探索,
+ * profile 门控)的写入委托它执行 —— Agent 可调用面依然收敛在配方面,此处非 Agent 入口。
+ */
+export async function dcwControlGovernedInternal(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
+  return _toolDcwControlDisabled(agentId, args, channelId)
+}
+
+/** v2 前的直写实现(已停用;保留供回溯/内部审计阅读,不再被任何入口调用) */
+async function _toolDcwControlDisabled(agentId: string, args: { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId?: string): Promise<{ text: string, isError?: boolean }> {
+  const twinGuard = guardTwinWrite(agentId, channelId)
+  if (!twinGuard.allowed) return { text: `${twinGuard.code}: ${twinGuard.message}`, isError: true }
+  const nodeId = String(args.node_id ?? '').trim()
+  const value = Number(args.value)
+  const repo = getAgentNodeBindingRepo()
+  const binding: AgentNodeBinding | undefined = nodeId ? repo.find(agentId, nodeId, 'dcw') : undefined
+  // 权限模型 v2:配方绑定(kind=recipe)覆盖其参数节点 —— 该节点在绑定配方参数内即算授权
+  let recipeAuthorized = false
+  if (!binding && nodeId) {
+    const recipes = repo.byAgent(agentId).filter(b => b.kind === 'recipe')
+    recipeAuthorized = recipes.some((b) => {
+      const r = getDcwController().listRecipes().find(x => x.id === b.nodeId)
+      return r?.params.some(p => p.nodeId === nodeId) ?? false
+    })
+  }
+  if (!binding && !recipeAuthorized) {
+    const mine = repo.byAgent(agentId).filter(b => b.kind === 'dcw')
+    return {
+      text: mine.length
+        ? `无权操作节点 ${nodeId || '(空)'}。你有权控制的数控节点:${mine.map(b => b.nodeId).join(', ')}(可用 my_industrial_nodes 查看物理含义)。`
+        : '你尚未绑定任何数控节点,也无含该参数的配方绑定,无权下发控制指令(权限模型 v2:持有含该参数的配方绑定即可)。',
+      isError: true,
+    }
+  }
+  if (!Number.isFinite(value)) {
+    return { text: '设定值 value 必须为数字。', isError: true }
+  }
+  const node = getDcwController().byId(nodeId)
+  if (!node) {
+    // 节点已被删除 → 绑定失效自清理,提示重新绑定(仅 dcw 直绑;配方路径无绑定可清)
+    if (binding) repo.removeAgentNode(agentId, nodeId, 'dcw')
+    return { text: `数控节点 ${nodeId} 已不存在(可能被删除),原绑定已自动清理,请重新绑定。`, isError: true }
+  }
+  // 停用/解绑守卫:停用节点拒绝下发(与手动/配方同源语义,给出恢复路径)
+  if (!node.enabled) {
+    return { text: `节点「${node.name}」已停用(控制已暂停),无法下发。请先让用户在产线/数采界面恢复该节点的控制,或改派其他节点。`, isError: true }
+  }
+  // 停线守卫:产线未开跑时手动写允许(调试),但提示当前无配方窗口约束
+  const tpl = findDcwTemplate(node.templateKey)
+
+  // 手动确认模式:与 param_control 同源审批面(manual-approval),批准附言回进回执
+  let manualFeedback = ''
+  if (binding?.mode === 'manual') {
+    const bd = limitsBreakdownOf(node)
+    const ap = await requestManualApproval({
+      agentId,
+      nodeId,
+      detail: `${node.name}(${tpl?.ch ?? node.templateKey})设定 ${value}${node.unit},有效写入区间 ${bd.effective.min}~${bd.effective.max}${node.unit}(${bd.layers.map(l => l.label).join(' ∩ ')})`,
+    })
+    if (!ap.ok) return { text: ap.text, isError: ap.isError }
+    manualFeedback = ap.comment ?? ''
+  }
+
+  try {
+    const meta = {
+      source: 'agent' as const,
+      actor: agentId,
+      // 人话操作者:「Channel名/成员名」——/logs 来源=Agent 与用户/系统操作可区分追溯
+      actorName: agentBadgeLabel(agentId),
+      taskId: args.task_id ? String(args.task_id) : undefined,
+      hypothesis: args.hypothesis ? String(args.hypothesis) : '',
+    }
+    const outcome = await getDcwController().write(nodeId, value, null, meta)
+    const run = node.lineId ? getActiveLineRun(node.lineId) : null
+    const winTxt = run
+      ? `当前活动配方「${run.recipeName}」`
+      : '当前无活动配方(全局量程约束)'
+    if (outcome.ok) {
+      // 调控闭环回包:记录 id + 上一稳定锚 + 策略提示(安全网信息,Agent 据此规划判定)
+      const rb = getRecipeRollBackManager()
+      const stable = rb.journal({ nodeId, limit: 10 }).find(a => a.prevValue != null && a.prevValue !== a.newValue)
+      const policyHint = binding?.mode === 'manual'
+        ? '本节点为手动确认模式:判定回退将推请用户确认'
+        : '本节点为自动模式:越配方监控窗将触发系统自动回退'
+      const loopTxt = [
+        outcome.recordId ? `优化记录 ${outcome.recordId} 已开窗(观察数采后 dcw_judge 落判定)` : null,
+        stable ? `上一稳定锚:${stable.prevValue}${node.unit}(可 dcw_rollback 回退)` : null,
+        policyHint,
+      ].filter(Boolean).join(';')
+      // ACK 鉴定如实表述(2026-10-08):ok 只是命令受理 —— 回读证实与仅链路受理必须区分,
+      // 不许对无回读驱动(mqtt/http-no-echo)虚报"回读一致"。
+      const ackTxt = outcome.ack === 'readback-verified'
+        ? `回读 ${outcome.readback != null ? `${outcome.readback}${node.unit}` : '-'}一致 [设备证实✓]`
+        : outcome.ack === 'transport-ack'
+          ? '设备侧未回读证实,仅链路受理 [未证实⚠,建议 daq_query 复测]'
+          : '无确认通道 [未证实⚠]'
+      return {
+        text: `下发受理:${node.name}(${tpl?.ch ?? node.templateKey})设定 ${value}${node.unit} → PLC 原始值 ${outcome.raw ?? '-'};${ackTxt}。${winTxt}。${outcome.message}\n[调控闭环] ${loopTxt}${manualFeedback ? `\n[人工反馈] ${manualFeedback}` : ''}`,
+      }
+    }
+    // 失败文案带自我纠正线索:当前保持原值 + 建议动作(缩小步进/稍后重试)
+    const keptHint = `当前设定值保持 ${node.value ?? '原值'}${node.unit} 未被改动`
+    const retryHint = /忙|busy/i.test(outcome.message) ? '链路忙属瞬时状态,可稍后重试' : '可缩小步进幅度后重试'
+    return { text: `下发失败:${outcome.message}(节点 ${node.name},物理量 ${tpl?.ch ?? node.templateKey},安全量程 ${node.min}~${node.max}${node.unit};${keptHint};${retryHint})`, isError: true }
+  }
+  catch (err) {
+    const msg = err instanceof Error ? err.message : String(err)
+    const retryHint = /忙|busy/i.test(msg) ? '链路忙属瞬时状态,可稍后重试' : '设定值必须落在安全量程与活动配方工艺窗口内'
+    return { text: `下发被拒绝:${msg}(节点 ${node.name},物理量 ${tpl?.ch ?? node.templateKey};${retryHint})`, isError: true }
+  }
+}

package/server/services/workshop/agents/industrial/index.ts

@@ -1,32 +1,32 @@
-/**
- * 工业工具族(daq_query / dcw_* / param_* / ops_* / recipe_* / aml_*)
- *
- * 由原单文件按职责拆分而来;此处保持**原文件的公开 API 与 import 路径不变**
- * (目录 index 解析),外部调用方无需改动。
- *
- * 模块划分:
- *   dcw-tools.ts           节点清单、数控下发/回读(dcw_control / dcw_read)
- *   param-tools.ts         工艺参数读写(param_control / param_read)与量程/容差辅助
- *   daq-tools.ts           数采查询与帧检索(daq_query / daq_frames)
- *   dcw-judge-tools.ts     判定与回滚(dcw_judge / dcw_rollback / dcw_journal)与绑定鉴权
- *   ops-tools.ts           运维日志与配方变更史(ops_log / recipe_* / line_context)
- *   aml-dataset-tools.ts   AML 数据集与节点目录(aml_node_catalog / aml_dataset_*)
- *   aml-job-tools.ts       AML 作业与模型(aml_job_* / aml_leaderboard / aml_model_*)
- *   mes-tools.ts           MES 数据集面(mes_catalog / mes_fetch / mes_dataset_read / mes_datasets)
- */
-export { toolMyIndustrialNodes, toolDcwControl, toolDcwRead } from './dcw-tools'
-export { toolParamControl, toolParamRead } from './param-tools'
-export { toolDaqQuery, toolDaqFrames } from './daq-tools'
-export { toolDaqExport } from './daq-export'
-export { toolDcwJudge, toolDcwRollback, toolDcwJournal } from './dcw-judge-tools'
-export { toolOpsLog, toolRecipeLog, toolLineContext, toolRecipeVersions, toolRecipeUpdate, toolRecipeRollback, toolRecipeTrial, toolRecipeApply } from './ops-tools'
-export { toolMesCatalog, toolMesFetch, toolMesDatasetRead, toolMesDatasets } from './mes-tools'
-export { toolAmlNodeCatalog, toolAmlDatasetBuild, toolAmlDatasetStats } from './aml-dataset-tools'
-export { toolAmlJobSubmit, toolAmlJobStatus, toolAmlJobLogs, toolAmlJobCancel, toolAmlLeaderboard, toolAmlModelFind, toolAmlModelPromote, toolAmlModelReference, toolAmlTrainingPlanList, toolAmlTrainingPlanTrain, toolAmlTrainingPlanCreate } from './aml-job-tools'
-
-export { toolOptimizationExplore } from './optimization-tools'
-export { toolTwinProviderCatalog, toolTwinSceneDiscover, toolTwinSceneCompile, toolTwinSceneFreeze, toolTwinSceneRead, toolTwinPhysicsSpecDraft, toolTwinPhysicsSpecValidate, toolTwinPhysicsSpecCompile, toolTwinSnapshotCreate, toolTwinTrialRun, toolMpcOptimize, toolTwinGateEvaluate, toolTwinCalibrationRequest, toolTwinBayesOptimize } from './twin-tools'
-export { toolAmlActivity } from './aml-activity'
-export { toolRecipePropose } from './recipe-propose-tools'
-export { toolLineStart, toolLineStop, toolLineStatus } from './line-tools'
-export { toolAnalysisSave, toolAnalysisQuery } from './analysis-tools'
+/**
+ * 工业工具族(daq_query / dcw_* / param_* / ops_* / recipe_* / aml_*)
+ *
+ * 由原单文件按职责拆分而来;此处保持**原文件的公开 API 与 import 路径不变**
+ * (目录 index 解析),外部调用方无需改动。
+ *
+ * 模块划分:
+ *   dcw-tools.ts           节点清单、数控下发/回读(dcw_control / dcw_read)
+ *   param-tools.ts         工艺参数读写(param_control / param_read)与量程/容差辅助
+ *   daq-tools.ts           数采查询与帧检索(daq_query / daq_frames)
+ *   dcw-judge-tools.ts     判定与回滚(dcw_judge / dcw_rollback / dcw_journal)与绑定鉴权
+ *   ops-tools.ts           运维日志与配方变更史(ops_log / recipe_* / line_context)
+ *   aml-dataset-tools.ts   AML 数据集与节点目录(aml_node_catalog / aml_dataset_*)
+ *   aml-job-tools.ts       AML 作业与模型(aml_job_* / aml_leaderboard / aml_model_*)
+ *   mes-tools.ts           MES 数据集面(mes_catalog / mes_fetch / mes_dataset_read / mes_datasets)
+ */
+export { toolMyIndustrialNodes, toolDcwControl } from './dcw-tools'
+export { toolParamControl } from './param-tools'
+export { toolDaqQuery, toolDaqFrames } from './daq-tools'
+export { toolDaqExport } from './daq-export'
+export { toolDcwJudge, toolDcwRollback, toolDcwJournal } from './dcw-judge-tools'
+export { toolOpsLog, toolRecipeLog, toolLineContext, toolRecipeVersions, toolRecipeUpdate, toolRecipeRollback, toolRecipeTrial, toolRecipeApply } from './ops-tools'
+export { toolMesCatalog, toolMesFetch, toolMesDatasetRead, toolMesDatasets } from './mes-tools'
+export { toolAmlNodeCatalog, toolAmlDatasetBuild, toolAmlDatasetStats } from './aml-dataset-tools'
+export { toolAmlJobSubmit, toolAmlJobStatus, toolAmlJobLogs, toolAmlJobCancel, toolAmlLeaderboard, toolAmlModelFind, toolAmlModelPromote, toolAmlModelReference, toolAmlTrainingPlanList, toolAmlTrainingPlanTrain, toolAmlTrainingPlanCreate } from './aml-job-tools'
+
+export { toolOptimizationExplore } from './optimization-tools'
+export { toolTwinProviderCatalog, toolTwinSceneDiscover, toolTwinSceneCompile, toolTwinSceneFreeze, toolTwinSceneRead, toolTwinPhysicsSpecDraft, toolTwinPhysicsSpecValidate, toolTwinPhysicsSpecCompile, toolTwinSnapshotCreate, toolTwinTrialRun, toolMpcOptimize, toolTwinGateEvaluate, toolTwinCalibrationRequest, toolTwinBayesOptimize } from './twin-tools'
+export { toolAmlActivity } from './aml-activity'
+export { toolRecipePropose } from './recipe-propose-tools'
+export { toolLineStart, toolLineStop, toolLineStatus } from './line-tools'
+export { toolAnalysisSave, toolAnalysisQuery } from './analysis-tools'

package/server/services/workshop/agents/industrial/param-tools.ts

@@ -150,43 +150,3 @@ async function _toolParamControlDisabled(agentId: string, args: {
     return { text: `下发被拒绝:${msg}(工艺参数 ${param.key};${paramLimitsText(param)})`, isError: true }
   }
 }
-
-/** 工具:param_read —— 按工艺参数读取 PLC 当前值(被动观测免审批) */
-export async function toolParamRead(agentId: string, args: {
-  param?: string
-  line_id?: string
-}): Promise<{ text: string, isError?: boolean }> {
-  const resolved = resolveParamRef(String(args.param ?? ''), args.line_id ? String(args.line_id) : undefined)
-  if (!resolved.ok) return resolved
-  const param = resolved.param
-  const repo = getAgentNodeBindingRepo()
-  if (!repo.find(agentId, param.nodeId, 'dcw')) {
-    const mine = repo.byAgent(agentId).filter(b => b.kind === 'dcw')
-    return {
-      text: mine.length
-        ? `无权读取工艺参数「${param.key}」(执行节点 ${param.nodeId} 未绑定给你)。你有权读取的数控节点:${mine.map(b => b.nodeId).join(', ')}。`
-        : '你尚未绑定任何数控节点,无权读取控制通道数据。请在数字孪生界面绑定数控节点。',
-      isError: true,
-    }
-  }
-  const node = getDcwController().byId(param.nodeId)
-  if (!node) {
-    repo.removeAgentNode(agentId, param.nodeId, 'dcw')
-    return { text: `工艺参数「${param.key}」的执行节点已不存在(可能被删除),原绑定已自动清理。`, isError: true }
-  }
-  try {
-    const read = await getDcwController().readParam(param.id)
-    if (!read.ok && read.value == null && !node.readValue) {
-      return { text: `读取失败:${read.message}(执行节点「${node.name}」驱动 ${node.driver} 可能不支持读取;可改用 daq_query 查关联数采通道)`, isError: true }
-    }
-    const readTxt = read.value != null
-      ? `${Number(read.value.toFixed(param.decimals))}${param.unit} @ ${read.at.slice(11, 19)}`
-      : (node.readValue != null ? `${node.readValue}${param.unit}(最近一次)` : '无读数')
-    return {
-      text: `读取成功:工艺参数「${param.key}」(${param.name})\n  PLC 读数(ACT): ${readTxt}\n  当前设定(SET): ${node.value != null ? `${node.value}${param.unit}` : '从未下发'}\n  ${paramLimitsText(param)}`,
-    }
-  }
-  catch (err) {
-    return { text: `读取被拒绝:${err instanceof Error ? err.message : String(err)}(工艺参数 ${param.key})`, isError: true }
-  }
-}