agentworkshop 0.7.66 → 0.7.71

package/server/services/workshop/agents/host-tool-bridge/index.ts

@@ -1,15 +1,16 @@
-/**
- * server/services/workshop/agents/host-tool-bridge.ts 拆分后的门面(目录 index 解析,
- * 外部 import 路径与导出 API 完全不变)。
- *
- * 结构:
- *   types.ts     HostToolCall / HostToolResult / HostToolSessionState / HostToolBridgeContext
- *   session.ts   会话态 createSessionState 与 partsToText
- *   catalog.ts   HOST_TOOLS / LEAD_ONLY_TOOL_NAMES / 占位符注入 / hostToolsForRole
- *   dispatch.ts  dispatchHostTool(前置校验 + 路由)
- *   tools/       按工具族拆分的处理器:industrial / progress / tasks / messaging / memory / team
- */
-export { HOST_TOOLS, LEAD_ONLY_TOOL_NAMES, hostToolsForRole } from './catalog'
-export type { HostToolBridgeContext, HostToolCall, HostToolResult, HostToolSessionState } from './types'
-export { createSessionState, partsToText } from './session'
-export { dispatchHostTool } from './dispatch'
+/**
+ * server/services/workshop/agents/host-tool-bridge.ts 拆分后的门面(目录 index 解析,
+ * 外部 import 路径与导出 API 完全不变)。
+ *
+ * 结构:
+ *   types.ts     HostToolCall / HostToolResult / HostToolSessionState / HostToolBridgeContext
+ *   session.ts   会话态 createSessionState 与 partsToText
+ *   catalog.ts   HOST_TOOLS / LEAD_ONLY_TOOL_NAMES / 占位符注入 / hostToolsForRole
+ *   dispatch.ts  dispatchHostTool(前置校验 + 路由)
+ *   tools/       按工具族拆分的处理器:industrial / progress / tasks / messaging / memory / team
+ */
+export { HOST_TOOLS, LEAD_ONLY_TOOL_NAMES, hostToolsForRole } from './catalog'
+export { hostToolsForAgent, agentToolResources } from './per-agent'
+export type { HostToolBridgeContext, HostToolCall, HostToolResult, HostToolSessionState } from './types'
+export { createSessionState, partsToText } from './session'
+export { dispatchHostTool } from './dispatch'

package/server/services/workshop/agents/host-tool-bridge/optimizer-gate.ts

@@ -0,0 +1,72 @@
+/**
+ * Optimizer 工具门控(纯函数,无 Nitro/DB 依赖):
+ * dispatch 与验收脚本共用同一判定,避免"注入面隐藏但当 REST/MCP 直调仍可执行"。
+ */
+export const OPTIMIZER_PREFIX = 'optimizer_'
+
+export interface OptimizerGateInput {
+  toolName: string
+  /** Channel 档位(legacy / aml_training / aml_optimization / hybrid_twin / exp-miner / line-doctor) */
+  twinKind: string
+  /** 该 Agent 实例的有效绑定数(capabilities 允许 0) */
+  bindingCount: number
+}
+
+export interface OptimizerGateResult {
+  allowed: boolean
+  /** 拒绝时的可判定错误码(前缀)与可读指引 */
+  code?: 'OPTIMIZER_CHANNEL_DISABLED' | 'OPTIMIZER_PROFILE_DENIED' | 'BINDING_NOT_FOUND' | 'OPTIMIZATION_NOT_ELIGIBLE'
+  message?: string
+}
+
+export function optimizerDispatchGate(input: OptimizerGateInput): OptimizerGateResult {
+  const { toolName, twinKind, bindingCount } = input
+  if (!toolName.startsWith(OPTIMIZER_PREFIX)) return { allowed: true }
+  if (twinKind === 'legacy') {
+    return {
+      allowed: false,
+      code: 'OPTIMIZER_CHANNEL_DISABLED',
+      message: 'Channel 未启用 Twin profile,优化器工具拒绝执行。请先把 Channel 档位切到 aml_optimization(工艺优化)或 hybrid_twin。',
+    }
+  }
+  if (twinKind !== 'aml_optimization' && twinKind !== 'hybrid_twin') {
+    return {
+      allowed: false,
+      code: 'OPTIMIZER_PROFILE_DENIED',
+      message: `${toolName} 仅在工艺优化(aml_optimization)或 hybrid_twin Channel 可用(当前 profile=${twinKind})。`,
+    }
+  }
+  // capabilities 允许无绑定(用于解释为什么不可用);其余四个必须存在有效绑定
+  if (toolName !== 'optimizer_capabilities' && bindingCount < 1) {
+    return {
+      allowed: false,
+      code: 'BINDING_NOT_FOUND',
+      message: `该 Agent 未绑定优化器 Profile;先在 Channel 设置中绑定后再调用 ${toolName}。`,
+    }
+  }
+  return { allowed: true }
+}
+
+/**
+ * 旧 `mpc_optimize` 别名迁移(G4.6):
+ *  - 有优化器绑定 → 允许(新 Profile 路径仍应优先用 optimizer_solve);
+ *  - 无绑定但有已绑定的 AML 模型**且该模型有优化资格** → 允许(既有 AML 模型驱动流程);
+ *  - 有模型但无优化资格 / 两者皆无 → 拒绝并给"先绑定/先辨识"引导,不再返回可操作调参方案。
+ */
+export function legacyMpcAliasGate(input: { toolName: string, hasOptimizerBinding: boolean, hasBoundModel: boolean, hasEligibleModel?: boolean }): OptimizerGateResult {
+  if (input.toolName !== 'mpc_optimize') return { allowed: true }
+  if (input.hasOptimizerBinding) return { allowed: true }
+  if (input.hasBoundModel && input.hasEligibleModel) return { allowed: true }
+  if (input.hasBoundModel) {
+    return {
+      allowed: false,
+      code: 'OPTIMIZATION_NOT_ELIGIBLE',
+      message: '当前绑定的 AML 模型没有通过的优化资格报告(辨识不足/OOD/动作证据缺失)。请先完成 AML 数据集资格评估与模型晋级,或绑定优化器 Profile 后用 optimizer_solve。',
+    }
+  }
+  return {
+    allowed: false,
+    code: 'BINDING_NOT_FOUND',
+    message: 'mpc_optimize 需要已绑定优化器 Profile 或已绑定且具备优化资格的 AML 模型;当前两者皆无。请先在 Channel 设置中绑定 Profile,或完成 AML 训练与资格评估后再寻优。',
+  }
+}

package/server/services/workshop/agents/host-tool-bridge/per-agent.ts

@@ -0,0 +1,149 @@
+/**
+ * per-agent.ts —— 按 Agent 绑定的节点/配方增强工具描述。
+ *
+ * 目的:同一份 host-tools.json 在注入不同 Agent 时,`daq_query`/`recipe_*`/`mes_*`
+ * 的描述应带上**该 Agent 实际可见的节点与配方**,让模型不必先猜/先探测绑定面。
+ * 注入面(MCP tools/list、omp set_host_tools、pi registerTool)全部经本函数,
+ * 与执行面(dispatch 的 grant-guard)同源,不会出现“描述里有、执行时无权”的错位。
+ *
+ * 只读装配:不改变工具集合(角色/插件/档位过滤仍由 hostToolsForRole 决定),
+ * 仅在描述尾部追加可见资源清单。无绑定 → 原样返回,零行为变化。
+ */
+import { hostToolsForRole, OPTIMIZER_TOOL_NAMES } from './catalog'
+import { getAgentNodeBindingRepo } from '../node-bindings.repo'
+import { getDaqController } from '../../daq/daq-controller'
+import { getDcwController } from '../../dcw/dcw-controller'
+import { listBindingsForAgent } from '../../optimization/binding.service'
+import { foldList as foldListImpl, sortedById } from './description-budget'
+
+/** 需要追加“可见资源”描述的工具族 */
+const DAQ_TOOLS = new Set(['daq_query', 'daq_frames', 'daq_export'])
+const RECIPE_TOOLS = new Set(['recipe_catalog', 'recipe_log', 'recipe_versions', 'recipe_update', 'recipe_rollback', 'recipe_trial', 'recipe_apply', 'recipe_propose'])
+const MES_TOOLS = new Set(['mes_catalog', 'mes_fetch', 'mes_export', 'mes_dataset_read', 'mes_datasets'])
+
+export interface AgentToolResourceView {
+  /** Agent 显式绑定的数采节点(kind=daq) */
+  daqNodes: Array<{ id: string, name: string, unit: string }>
+  /** 频道绑线带来的只读数采节点(v28;执行面 daqTargetsOf 同样并入) */
+  daqLineNodes: Array<{ id: string, name: string, unit: string }>
+  recipes: Array<{ id: string, name: string, version: number, params: Array<{ nodeId: string, name: string, unit: string }> }>
+  mesNodes: Array<{ id: string, name: string, unit: string }>
+}
+
+/** 频道绑线(与 daqTargetsOf 同源;globalThis 单例避免 per-agent → manager 循环依赖) */
+function channelLineOf(agentId: string): string {
+  try {
+    const g = globalThis as typeof globalThis & {
+      __workshopManager?: { channelLineBindingOf?(id: string): string | null }
+    }
+    return g.__workshopManager?.channelLineBindingOf?.(agentId) ?? ''
+  }
+  catch {
+    return ''
+  }
+}
+
+/** 读取 Agent 的绑定面(只读;异常降级为空,绝不影响工具注入) */
+export function agentToolResources(agentId: string): AgentToolResourceView {
+  const out: AgentToolResourceView = { daqNodes: [], daqLineNodes: [], recipes: [], mesNodes: [] }
+  if (!agentId) return out
+  try {
+    const bindings = getAgentNodeBindingRepo().byAgent(agentId)
+    const daq = getDaqController()
+    const dcw = getDcwController()
+    const lineId = channelLineOf(agentId)
+    if (lineId) {
+      for (const n of daq.listViews()) {
+        if (n.lineId === lineId) out.daqLineNodes.push({ id: n.id, name: n.name, unit: n.unit ?? '' })
+      }
+    }
+    for (const b of bindings) {
+      if (b.kind === 'daq') {
+        const n = daq.byId(b.nodeId)
+        if (n) out.daqNodes.push({ id: n.id, name: n.name, unit: n.unit ?? '' })
+      }
+      else if (b.kind === 'recipe') {
+        const r = dcw.listRecipes().find(x => x.id === b.nodeId)
+        if (!r) continue
+        const params: AgentToolResourceView['recipes'][number]['params'] = []
+        for (const p of r.params ?? []) {
+          const n = dcw.byId(p.nodeId)
+          params.push({ nodeId: p.nodeId, name: n?.name ?? p.nodeId, unit: n?.unit ?? '' })
+          // MES 取数授权配方:仅 mes-rest 驱动的参数节点才是 MES 点位
+          // (forge-channel 3b 用配方参数面授权历史-only MES 节点;普通产线配方不冒充 MES)。
+          if (n?.driver === 'mes-rest' && !out.mesNodes.some(x => x.id === p.nodeId)) {
+            out.mesNodes.push({ id: p.nodeId, name: n.name, unit: n.unit ?? '' })
+          }
+        }
+        out.recipes.push({ id: r.id, name: r.name, version: r.version ?? 1, params })
+      }
+    }
+  }
+  catch {
+    /* 绑定仓储不可用(单测/启动早期)→ 不增强 */
+  }
+  return out
+}
+
+/**
+ * WP6 描述预算:大绑定面不再全量拼进 description(撑上下文 + 放大 10s 轮询载荷 + 触发
+ * 无意义 list_changed)。折叠确定性由 description-budget 叶子模块保证。
+ * env AW_DESC_BUDGET=0 关闭折叠(回退原行为)。
+ */
+const foldList = (prefix: string, items: string[]): string => foldListImpl(prefix, items)
+
+/** 在角色过滤后的工具面上追加 Agent 绑定资源描述 + 优化器绑定裁剪 */
+export function hostToolsForAgent(agentId: string, role: 'lead' | 'worker', channelId?: string) {
+  const tools = hostToolsForRole(role, channelId)
+  // G4.3 #10:无有效绑定时移除 solve/status/cancel/plan_get(保留 capabilities 作解释入口);
+  // 多绑定时在描述中列出 bindingId(solve 需显式选择)。过滤不改变返回类型。
+  const bindings = listOptimizerBindings(agentId)
+  const filtered = bindings.length
+    ? tools
+    : tools.filter(t => !OPTIMIZER_REQUIRES_BINDING.has(t.name))
+  const optimizerLine = bindings.length
+    ? `\n\n本 Agent 的优化器绑定:${bindings.map(b => `${b.id}(profile ${b.profileVersion},${b.mode};能力:${b.capabilities.join('/')})`).join('; ')}${bindings.length > 1 ? '\n多绑定:调用 optimizer_solve 必须显式传 binding_id。' : ''}`
+    : ''
+  const res = agentToolResources(agentId)
+  // WP6:排序保证同一绑定面确定性输出(折叠/不折叠都稳定)
+  const sortedDaq = sortedById(res.daqNodes)
+  const sortedRecipes = sortedById(res.recipes)
+  const sortedMes = sortedById(res.mesNodes)
+  const lineOnlyDaq = sortedById(res.daqLineNodes.filter(n => !sortedDaq.some(x => x.id === n.id)))
+  if (sortedDaq.length === 0 && lineOnlyDaq.length === 0 && sortedRecipes.length === 0 && !bindings.length) return filtered
+  const daqParts = [
+    sortedDaq.length > 0 ? foldList(`本 Agent 直接绑定的数采节点(仅这些可查):`, sortedDaq.map(x => `${x.name}(${x.id}${x.unit ? `,${x.unit}` : ''})`)) : '',
+    lineOnlyDaq.length > 0 ? foldList(`频道绑线只读数采节点(可查):`, lineOnlyDaq.map(x => `${x.name}(${x.id}${x.unit ? `,${x.unit}` : ''})`)) : '',
+  ].filter(Boolean)
+  const daqLine = daqParts.length > 0 ? `\n\n${daqParts.join('\n')}` : ''
+  const recipeLine = sortedRecipes.length > 0
+    ? foldList(
+        `\n\n本 Agent 已绑定的配方(仅这些可写/下发):`,
+        sortedRecipes.map(r => `${r.name}(${r.id},v${r.version};参数:${r.params.map(p => `${p.name}(${p.nodeId})`).join('、') || '无'})`),
+      )
+    : ''
+  const mesLine = sortedMes.length > 0
+    ? foldList(`\n\n本 Agent 可经配方参数面取数的 MES 点位:`, sortedMes.map(x => `${x.name}(${x.id}${x.unit ? `,${x.unit}` : ''})`))
+    : ''
+  return filtered.map((t) => {
+    let suffix = ''
+    if (DAQ_TOOLS.has(t.name)) suffix = daqLine
+    else if (RECIPE_TOOLS.has(t.name)) suffix = recipeLine
+    else if (MES_TOOLS.has(t.name)) suffix = mesLine
+    else if (OPTIMIZER_TOOL_NAMES.has(t.name)) suffix = optimizerLine
+    if (!suffix) return t
+    return { ...t, description: `${t.description ?? ''}${suffix}` }
+  })
+}
+
+/** 优化器中必须绑定才能注入/调用的四个工具(capabilities 始终保留)。 */
+const OPTIMIZER_REQUIRES_BINDING = new Set(['optimizer_solve', 'optimizer_status', 'optimizer_cancel', 'optimizer_plan_get'])
+
+function listOptimizerBindings(agentId: string): Array<{ id: string, profileVersion: string, mode: string, capabilities: string[] }> {
+  try {
+    return listBindingsForAgent(agentId).map(b => ({ id: b.id, profileVersion: b.profileVersion, mode: b.mode, capabilities: b.capabilities as string[] }))
+  }
+  catch {
+    return []
+  }
+}

package/server/services/workshop/agents/host-tool-bridge/tools/industrial.ts

@@ -1,96 +1,111 @@
-/**
- * 工业工具族(my_industrial_nodes / aml_* / dcw_* / param_* / daq_* / ops_log / recipe_* / line_context / analysis_*)。
- *
- * 原 dispatchHostTool 首个 switch 的 26 个转发分支按行搬运到本模块:每个分支都只是
- * 「按 agentId 查绑定与节点后转交 industrial 模块的同名函数」,因此把闭包捕获的
- * (identity.agentId, args) 收敛为显式参数,并整理成「工具名 → 处理器」一张表。
- * 工具名集合与处理器表同源(INDUSTRIAL_TOOL_NAMES 由表键导出),不会出现有名字无处理器的分支。
- *
- * 该族**不依赖 workspace**,由 dispatch 在 workspace 门控之前分流(保持原分发顺序)。
- */
-import type { HostToolResult } from '../types'
-import { toolLineStart, toolLineStop, toolLineStatus, toolAmlDatasetBuild, toolAmlDatasetStats, toolAmlJobCancel, toolAmlJobLogs, toolAmlJobStatus, toolAmlJobSubmit, toolAmlLeaderboard, toolAmlModelFind, toolAmlModelPromote, toolAmlModelReference, toolAmlNodeCatalog, toolAmlTrainingPlanCreate, toolAmlTrainingPlanList, toolAmlTrainingPlanTrain, toolDaqExport, toolDaqFrames, toolDaqQuery, toolDcwControl, toolDcwJudge, toolDcwJournal, toolDcwRollback, toolLineContext, toolMesCatalog, toolMesDatasetRead, toolMesDatasets, toolMesFetch, toolMyIndustrialNodes, toolOpsLog, toolParamControl, toolRecipeApply, toolRecipeLog, toolRecipeRollback, toolRecipeTrial, toolRecipeUpdate, toolRecipeVersions, toolOptimizationExplore, toolTwinProviderCatalog, toolTwinSceneDiscover, toolTwinSceneCompile, toolTwinSceneFreeze, toolTwinSceneRead, toolTwinPhysicsSpecDraft, toolTwinPhysicsSpecValidate, toolTwinPhysicsSpecCompile, toolTwinSnapshotCreate, toolTwinTrialRun, toolMpcOptimize, toolTwinGateEvaluate, toolTwinBayesOptimize, toolTwinCalibrationRequest, toolAnalysisSave, toolAnalysisQuery } from '../../industrial'
-
-import { toolExpCollect } from '../../industrial/exp-tools'
-import { toolRecipePropose } from '../../industrial/recipe-propose-tools'
-import { toolAmlActivity } from '../../industrial/aml-activity'
-
-type IndustrialToolHandler = (agentId: string, args: Record<string, unknown>, channelId?: string) => Promise<HostToolResult>
-
-/** 工具名 → 转发处理器(顺序与原 dispatch 首个 switch 的分支顺序一致) */
-const INDUSTRIAL_HANDLERS = new Map<string, IndustrialToolHandler>([
-  ['my_industrial_nodes', agentId => toolMyIndustrialNodes(agentId)],
-  ['aml_node_catalog', agentId => toolAmlNodeCatalog(agentId)],
-  ['aml_dataset_build', (agentId, args) => toolAmlDatasetBuild(agentId, args as Parameters<typeof toolAmlDatasetBuild>[1])],
-  ['aml_dataset_stats', (agentId, args) => toolAmlDatasetStats(agentId, args as Parameters<typeof toolAmlDatasetStats>[1])],
-  ['aml_job_submit', (agentId, args) => toolAmlJobSubmit(agentId, args as Parameters<typeof toolAmlJobSubmit>[1])],
-  ['aml_job_status', (agentId, args) => toolAmlJobStatus(agentId, args as Parameters<typeof toolAmlJobStatus>[1])],
-  ['aml_job_logs', (agentId, args) => toolAmlJobLogs(agentId, args as Parameters<typeof toolAmlJobLogs>[1])],
-  ['aml_job_cancel', (agentId, args) => toolAmlJobCancel(agentId, args as Parameters<typeof toolAmlJobCancel>[1])],
-  ['aml_leaderboard', (agentId, args) => toolAmlLeaderboard(agentId, args as Parameters<typeof toolAmlLeaderboard>[1])],
-  ['aml_model_find', (agentId, args) => toolAmlModelFind(agentId, args as Parameters<typeof toolAmlModelFind>[1])],
-  ['aml_model_promote', (agentId, args) => toolAmlModelPromote(agentId, args as Parameters<typeof toolAmlModelPromote>[1])],
-  ['aml_model_reference', (agentId, args) => toolAmlModelReference(agentId, args as Parameters<typeof toolAmlModelReference>[1])],
-  ['aml_training_plan_list', (agentId, args) => toolAmlTrainingPlanList(agentId, args)],
-  ['aml_training_plan_create', (agentId, args) => toolAmlTrainingPlanCreate(agentId, args as Parameters<typeof toolAmlTrainingPlanCreate>[1])],
-  ['aml_training_plan_train', (agentId, args) => toolAmlTrainingPlanTrain(agentId, args as Parameters<typeof toolAmlTrainingPlanTrain>[1])],
-  ['twin_provider_catalog', (agentId, args) => toolTwinProviderCatalog(agentId, args)],
-  ['twin_scene_discover', (agentId, args) => toolTwinSceneDiscover(agentId, args)],
-  ['twin_scene_compile', (agentId, args) => toolTwinSceneCompile(agentId, args)],
-  ['twin_scene_freeze', (agentId, args) => toolTwinSceneFreeze(agentId, args)],
-  ['twin_physics_spec_draft', (agentId, args) => toolTwinPhysicsSpecDraft(agentId, args)],
-  ['twin_physics_spec_validate', (agentId, args) => toolTwinPhysicsSpecValidate(agentId, args)],
-  ['twin_physics_spec_compile', (agentId, args) => toolTwinPhysicsSpecCompile(agentId, args)],
-  ['twin_scene_read', (agentId, args) => toolTwinSceneRead(agentId, args)],
-  ['twin_snapshot_create', (agentId, args) => toolTwinSnapshotCreate(agentId, args)],
-  ['twin_trial_run', (agentId, args) => toolTwinTrialRun(agentId, args)],
-  ['mpc_optimize', (agentId, args) => toolMpcOptimize(agentId, args)],
-  ['twin_gate_evaluate', (agentId, args) => toolTwinGateEvaluate(agentId, args)],
-  ['twin_calibration_request', (agentId, args) => toolTwinCalibrationRequest(agentId, args)],
-  ['optimization_explore', (agentId, args, channelId) => toolOptimizationExplore(agentId, args as Parameters<typeof toolOptimizationExplore>[1], channelId)],
-  ['twin_bayes_optimize', (agentId, args) => toolTwinBayesOptimize(agentId, args)],
-  ['dcw_control', (agentId, args, channelId) => toolDcwControl(agentId, args as { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId)],
-  ['param_control', (agentId, args, channelId) => toolParamControl(agentId, args as { param?: string, value?: number | string, hypothesis?: string, task_id?: string, line_id?: string }, channelId)],
-  ['daq_query', (agentId, args) => toolDaqQuery(agentId, args as Parameters<typeof toolDaqQuery>[1])],
-  ['daq_export', (agentId, args) => toolDaqExport(agentId, args as Parameters<typeof toolDaqExport>[1])],
-  ['daq_frames', (agentId, args) => toolDaqFrames(agentId, args as Parameters<typeof toolDaqFrames>[1])],
-  ['dcw_judge', (agentId, args) => toolDcwJudge(agentId, args as { record_id?: string, verdict?: string, reason?: string })],
-  ['dcw_rollback', (agentId, args) => toolDcwRollback(agentId, args as { record_id?: string, node_id?: string, to?: string })],
-  ['dcw_journal', (agentId, args) => toolDcwJournal(agentId, args as { node_id?: string, recipe_id?: string, limit?: number | string })],
-  ['ops_log', (agentId, args) => toolOpsLog(agentId, args as Parameters<typeof toolOpsLog>[1])],
-  ['recipe_log', (agentId, args) => toolRecipeLog(agentId, args as Parameters<typeof toolRecipeLog>[1])],
-  ['line_context', (agentId, args) => toolLineContext(agentId, args as { line_id?: string })],
-  ['recipe_versions', (agentId, args) => toolRecipeVersions(agentId, args as { recipe_id?: string, limit?: number | string })],
-  ['recipe_update', (agentId, args) => toolRecipeUpdate(agentId, args as Parameters<typeof toolRecipeUpdate>[1])],
-  ['recipe_rollback', (agentId, args) => toolRecipeRollback(agentId, args as Parameters<typeof toolRecipeRollback>[1])],
-  ['recipe_trial', (agentId, args) => toolRecipeTrial(agentId, args as Parameters<typeof toolRecipeTrial>[1])],
-  ['recipe_apply', (agentId, args) => toolRecipeApply(agentId, args as Parameters<typeof toolRecipeApply>[1])],
-  ['mes_catalog', (agentId, args) => toolMesCatalog(agentId, args as Parameters<typeof toolMesCatalog>[1])],
-  ['mes_fetch', (agentId, args) => toolMesFetch(agentId, args as Parameters<typeof toolMesFetch>[1])],
-  ['mes_dataset_read', (agentId, args) => toolMesDatasetRead(agentId, args as Parameters<typeof toolMesDatasetRead>[1])],
-  ['mes_datasets', (agentId, args) => toolMesDatasets(agentId, args as Parameters<typeof toolMesDatasets>[1])],
-  ['exp_collect', (agentId, args) => toolExpCollect(agentId, args as { line_id?: string, lineId?: string })],
-  // 产线 Co-Pilot P2(诊断工程师下发面):整包方案审批 + AML 活动硬闸自查
-  ['recipe_propose', (agentId, args) => toolRecipePropose(agentId, args as Parameters<typeof toolRecipePropose>[1])],
-  ['line_start', (agentId, args, channelId) => toolLineStart(agentId, args as Parameters<typeof toolLineStart>[1], channelId)],
-  ['line_stop', (agentId, args, channelId) => toolLineStop(agentId, args as Parameters<typeof toolLineStop>[1], channelId)],
-  ['line_status', (agentId, args, channelId) => toolLineStatus(agentId, args as Parameters<typeof toolLineStatus>[1], channelId)],
-  ['aml_activity', (agentId, args) => toolAmlActivity(agentId, args as { line_id?: string })],
-  // 数据分析系统:分析结果留痕台账(save 可写台账(非产线写);query 查历史留痕)
-  ['analysis_save', (agentId, args, channelId) => toolAnalysisSave(agentId, args as Parameters<typeof toolAnalysisSave>[1], channelId)],
-  ['analysis_query', (agentId, args) => toolAnalysisQuery(agentId, args as Parameters<typeof toolAnalysisQuery>[1])],
-])
-
-/** 工业工具名集合(与 INDUSTRIAL_HANDLERS 同源;dispatch 据此在 workspace 门控前分流) */
-export const INDUSTRIAL_TOOL_NAMES: ReadonlySet<string> = new Set(INDUSTRIAL_HANDLERS.keys())
-
-/**
- * 工业工具族分发:按工具名转交 industrial 模块(调用参数与该族原分支逐字一致)。
- * 调用方先经 INDUSTRIAL_TOOL_NAMES 判断,故「未登记的工具名」不可达 —— 仍然显式拒绝,
- * 避免静默返回与未知工具混淆。
- */
-export function dispatchIndustrialTool(agentId: string, toolName: string, args: Record<string, unknown>, channelId?: string): Promise<HostToolResult> {
-  const handler = INDUSTRIAL_HANDLERS.get(toolName)
-  if (!handler) return Promise.reject(new Error(`未知工业工具: ${toolName}`))
-  return handler(agentId, args, channelId)
-}
+/**
+ * 工业工具族(my_industrial_nodes / aml_* / dcw_* / param_* / daq_* / ops_log / recipe_* / line_context / analysis_*)。
+ *
+ * 原 dispatchHostTool 首个 switch 的 26 个转发分支按行搬运到本模块:每个分支都只是
+ * 「按 agentId 查绑定与节点后转交 industrial 模块的同名函数」,因此把闭包捕获的
+ * (identity.agentId, args) 收敛为显式参数,并整理成「工具名 → 处理器」一张表。
+ * 工具名集合与处理器表同源(INDUSTRIAL_TOOL_NAMES 由表键导出),不会出现有名字无处理器的分支。
+ *
+ * 该族**不依赖 workspace**,由 dispatch 在 workspace 门控之前分流(保持原分发顺序)。
+ */
+import type { HostToolResult } from '../types'
+import { toolLineStart, toolLineStop, toolLineStatus, toolAmlDatasetBuild, toolAmlDatasetStats, toolAmlJobCancel, toolAmlJobLogs, toolAmlJobStatus, toolAmlJobSubmit, toolAmlLeaderboard, toolAmlModelFind, toolAmlModelPromote, toolAmlModelReference, toolAmlNodeCatalog, toolAmlTrainingPlanCreate, toolAmlTrainingPlanList, toolAmlTrainingPlanTrain, toolDaqExport, toolDaqFrames, toolDaqQuery, toolDcwControl, toolDcwJudge, toolDcwJournal, toolDcwRollback, toolLineContext, toolMesCatalog, toolMesDatasetRead, toolMesDatasets, toolMesExport, toolMesFetch, toolMyIndustrialNodes, toolOpsLog, toolParamControl, toolRecipeApply, toolRecipeCatalog, toolRecipeCreate, toolRecipeLog, toolRecipeRollback, toolRecipeTrial, toolRecipeUpdate, toolRecipeVersions, toolOptimizationExplore, toolTwinProviderCatalog, toolTwinSceneDiscover, toolTwinSceneCompile, toolTwinSceneFreeze, toolTwinSceneRead, toolTwinPhysicsSpecDraft, toolTwinPhysicsSpecValidate, toolTwinPhysicsSpecCompile, toolTwinSnapshotCreate, toolTwinTrialRun, toolMpcOptimize, toolTwinGateEvaluate, toolTwinBayesOptimize, toolTwinCalibrationRequest, toolAnalysisSave, toolAnalysisQuery } from '../../industrial'
+
+import { toolExpCollect } from '../../industrial/exp-tools'
+import { toolRecipePropose } from '../../industrial/recipe-propose-tools'
+import { toolAmlActivity } from '../../industrial/aml-activity'
+import { toolOptimizerCancel, toolOptimizerCapabilities, toolOptimizerPlanGet, toolOptimizerSolve, toolOptimizerStatus } from '../../industrial/optimizer-tools'
+import { toolIndustrialResources } from '../../industrial/resources-tools'
+
+type IndustrialToolHandler = (agentId: string, args: Record<string, unknown>, channelId?: string) => Promise<HostToolResult>
+
+/** 工具名 → 转发处理器(顺序与原 dispatch 首个 switch 的分支顺序一致) */
+const INDUSTRIAL_HANDLERS = new Map<string, IndustrialToolHandler>([
+  ['my_industrial_nodes', agentId => toolMyIndustrialNodes(agentId)],
+  // WP6:绑定面按需分页查询(工具描述折叠后的配套读面;只读、无引用参数)
+  ['industrial_resources', (agentId, args) => toolIndustrialResources(agentId, args)],
+  ['aml_node_catalog', agentId => toolAmlNodeCatalog(agentId)],
+  ['aml_dataset_build', (agentId, args) => toolAmlDatasetBuild(agentId, args as Parameters<typeof toolAmlDatasetBuild>[1])],
+  ['aml_dataset_stats', (agentId, args) => toolAmlDatasetStats(agentId, args as Parameters<typeof toolAmlDatasetStats>[1])],
+  ['aml_job_submit', (agentId, args) => toolAmlJobSubmit(agentId, args as Parameters<typeof toolAmlJobSubmit>[1])],
+  ['aml_job_status', (agentId, args) => toolAmlJobStatus(agentId, args as Parameters<typeof toolAmlJobStatus>[1])],
+  ['aml_job_logs', (agentId, args) => toolAmlJobLogs(agentId, args as Parameters<typeof toolAmlJobLogs>[1])],
+  ['aml_job_cancel', (agentId, args) => toolAmlJobCancel(agentId, args as Parameters<typeof toolAmlJobCancel>[1])],
+  ['aml_leaderboard', (agentId, args) => toolAmlLeaderboard(agentId, args as Parameters<typeof toolAmlLeaderboard>[1])],
+  ['aml_model_find', (agentId, args) => toolAmlModelFind(agentId, args as Parameters<typeof toolAmlModelFind>[1])],
+  ['aml_model_promote', (agentId, args) => toolAmlModelPromote(agentId, args as Parameters<typeof toolAmlModelPromote>[1])],
+  ['aml_model_reference', (agentId, args) => toolAmlModelReference(agentId, args as Parameters<typeof toolAmlModelReference>[1])],
+  ['aml_training_plan_list', (agentId, args) => toolAmlTrainingPlanList(agentId, args)],
+  ['aml_training_plan_create', (agentId, args) => toolAmlTrainingPlanCreate(agentId, args as Parameters<typeof toolAmlTrainingPlanCreate>[1])],
+  ['aml_training_plan_train', (agentId, args) => toolAmlTrainingPlanTrain(agentId, args as Parameters<typeof toolAmlTrainingPlanTrain>[1])],
+  ['twin_provider_catalog', (agentId, args) => toolTwinProviderCatalog(agentId, args)],
+  ['twin_scene_discover', (agentId, args) => toolTwinSceneDiscover(agentId, args)],
+  ['twin_scene_compile', (agentId, args) => toolTwinSceneCompile(agentId, args)],
+  ['twin_scene_freeze', (agentId, args) => toolTwinSceneFreeze(agentId, args)],
+  ['twin_physics_spec_draft', (agentId, args) => toolTwinPhysicsSpecDraft(agentId, args)],
+  ['twin_physics_spec_validate', (agentId, args) => toolTwinPhysicsSpecValidate(agentId, args)],
+  ['twin_physics_spec_compile', (agentId, args) => toolTwinPhysicsSpecCompile(agentId, args)],
+  ['twin_scene_read', (agentId, args) => toolTwinSceneRead(agentId, args)],
+  ['twin_snapshot_create', (agentId, args) => toolTwinSnapshotCreate(agentId, args)],
+  ['twin_trial_run', (agentId, args) => toolTwinTrialRun(agentId, args)],
+  ['mpc_optimize', (agentId, args) => toolMpcOptimize(agentId, args)],
+  ['twin_gate_evaluate', (agentId, args) => toolTwinGateEvaluate(agentId, args)],
+  ['twin_calibration_request', (agentId, args) => toolTwinCalibrationRequest(agentId, args)],
+  ['optimization_explore', (agentId, args, channelId) => toolOptimizationExplore(agentId, args as Parameters<typeof toolOptimizationExplore>[1], channelId)],
+  ['twin_bayes_optimize', (agentId, args) => toolTwinBayesOptimize(agentId, args)],
+  ['dcw_control', (agentId, args, channelId) => toolDcwControl(agentId, args as { node_id?: string, value?: number | string, hypothesis?: string, task_id?: string }, channelId)],
+  ['param_control', (agentId, args, channelId) => toolParamControl(agentId, args as { param?: string, value?: number | string, hypothesis?: string, task_id?: string, line_id?: string }, channelId)],
+  ['daq_query', (agentId, args) => toolDaqQuery(agentId, args as Parameters<typeof toolDaqQuery>[1])],
+  ['daq_export', (agentId, args) => toolDaqExport(agentId, args as Parameters<typeof toolDaqExport>[1])],
+  ['daq_frames', (agentId, args) => toolDaqFrames(agentId, args as Parameters<typeof toolDaqFrames>[1])],
+  ['dcw_judge', (agentId, args) => toolDcwJudge(agentId, args as { record_id?: string, verdict?: string, reason?: string })],
+  ['dcw_rollback', (agentId, args) => toolDcwRollback(agentId, args as { record_id?: string, node_id?: string, to?: string })],
+  ['dcw_journal', (agentId, args) => toolDcwJournal(agentId, args as { node_id?: string, recipe_id?: string, limit?: number | string })],
+  ['ops_log', (agentId, args) => toolOpsLog(agentId, args as Parameters<typeof toolOpsLog>[1])],
+  // 显式别名:line_log 与 ops_log 同一 handler,便于 Agent 直接把「产线日志」与产线对象关联
+  ['line_log', (agentId, args) => toolOpsLog(agentId, args as Parameters<typeof toolOpsLog>[1])],
+  ['recipe_log', (agentId, args) => toolRecipeLog(agentId, args as Parameters<typeof toolRecipeLog>[1])],
+  ['recipe_catalog', (agentId, args) => toolRecipeCatalog(agentId, args as Parameters<typeof toolRecipeCatalog>[1])],
+  ['recipe_create', (agentId, args) => toolRecipeCreate(agentId, args as Parameters<typeof toolRecipeCreate>[1])],
+  ['line_context', (agentId, args) => toolLineContext(agentId, args as { line_id?: string })],
+  ['recipe_versions', (agentId, args) => toolRecipeVersions(agentId, args as { recipe_id?: string, limit?: number | string })],
+  ['recipe_update', (agentId, args) => toolRecipeUpdate(agentId, args as Parameters<typeof toolRecipeUpdate>[1])],
+  ['recipe_rollback', (agentId, args) => toolRecipeRollback(agentId, args as Parameters<typeof toolRecipeRollback>[1])],
+  ['recipe_trial', (agentId, args) => toolRecipeTrial(agentId, args as Parameters<typeof toolRecipeTrial>[1])],
+  ['recipe_apply', (agentId, args) => toolRecipeApply(agentId, args as Parameters<typeof toolRecipeApply>[1])],
+  ['mes_catalog', (agentId, args) => toolMesCatalog(agentId, args as Parameters<typeof toolMesCatalog>[1])],
+  ['mes_fetch', (agentId, args) => toolMesFetch(agentId, args as Parameters<typeof toolMesFetch>[1])],
+  ['mes_export', (agentId, args) => toolMesExport(agentId, args as Parameters<typeof toolMesExport>[1])],
+  ['mes_dataset_read', (agentId, args) => toolMesDatasetRead(agentId, args as Parameters<typeof toolMesDatasetRead>[1])],
+  ['mes_datasets', (agentId, args) => toolMesDatasets(agentId, args as Parameters<typeof toolMesDatasets>[1])],
+  ['exp_collect', (agentId, args) => toolExpCollect(agentId, args as { line_id?: string, lineId?: string })],
+  // 产线 Co-Pilot P2(诊断工程师下发面):整包方案审批 + AML 活动硬闸自查
+  ['recipe_propose', (agentId, args) => toolRecipePropose(agentId, args as Parameters<typeof toolRecipePropose>[1])],
+  ['line_start', (agentId, args, channelId) => toolLineStart(agentId, args as Parameters<typeof toolLineStart>[1], channelId)],
+  ['line_stop', (agentId, args, channelId) => toolLineStop(agentId, args as Parameters<typeof toolLineStop>[1], channelId)],
+  ['line_status', (agentId, args, channelId) => toolLineStatus(agentId, args as Parameters<typeof toolLineStatus>[1], channelId)],
+  ['aml_activity', (agentId, args) => toolAmlActivity(agentId, args as { line_id?: string })],
+  // 数据分析系统:分析结果留痕台账(save 可写台账(非产线写);query 查历史留痕)
+  ['analysis_save', (agentId, args, channelId) => toolAnalysisSave(agentId, args as Parameters<typeof toolAnalysisSave>[1], channelId)],
+  ['analysis_query', (agentId, args) => toolAnalysisQuery(agentId, args as Parameters<typeof toolAnalysisQuery>[1])],
+  // Optimizer(零写设备;绑定/资格/工况逐次重校验在 dispatch + verify + manager)
+  ['optimizer_capabilities', agentId => toolOptimizerCapabilities(agentId)],
+  ['optimizer_solve', (agentId, args) => toolOptimizerSolve(agentId, args)],
+  ['optimizer_status', (agentId, args) => toolOptimizerStatus(agentId, args)],
+  ['optimizer_cancel', (agentId, args) => toolOptimizerCancel(agentId, args)],
+  ['optimizer_plan_get', (agentId, args) => toolOptimizerPlanGet(agentId, args)],
+])
+
+/** 工业工具名集合(与 INDUSTRIAL_HANDLERS 同源;dispatch 据此在 workspace 门控前分流) */
+export const INDUSTRIAL_TOOL_NAMES: ReadonlySet<string> = new Set(INDUSTRIAL_HANDLERS.keys())
+
+/**
+ * 工业工具族分发:按工具名转交 industrial 模块(调用参数与该族原分支逐字一致)。
+ * 调用方先经 INDUSTRIAL_TOOL_NAMES 判断,故「未登记的工具名」不可达 —— 仍然显式拒绝,
+ * 避免静默返回与未知工具混淆。
+ */
+export function dispatchIndustrialTool(agentId: string, toolName: string, args: Record<string, unknown>, channelId?: string): Promise<HostToolResult> {
+  const handler = INDUSTRIAL_HANDLERS.get(toolName)
+  if (!handler) return Promise.reject(new Error(`未知工业工具: ${toolName}`))
+  return handler(agentId, args, channelId)
+}

package/server/services/workshop/agents/industrial/aml-job-tools.ts

@@ -18,6 +18,7 @@ import { claimToolResult } from '../../runtime/platform-notice'
 import { predictProduction, readIoSpecFor } from '../../aml/predictor'
 import { recordOps } from '../../ops/ops'
 import { transitionModel } from '../../aml/model-registry'
+import { resolveRefFaces } from './tool-verify'
 
 /** 工具:aml_job_submit —— 提交训练作业(train.py 全文内联;归因 agentId;队列 FIFO) */
 export async function toolAmlJobSubmit(agentId: string, args: {
@@ -98,7 +99,7 @@ export async function toolAmlJobSubmit(agentId: string, args: {
 }
 
 /** 工具:aml_job_status —— 作业状态(单作业详情 / 缺省列最近 10 个) */
-export async function toolAmlJobStatus(_agentId: string, args: { job_id?: string }): Promise<{ text: string, isError?: boolean }> {
+export async function toolAmlJobStatus(agentId: string, args: { job_id?: string }): Promise<{ text: string, isError?: boolean }> {
   const rt = getAmlRuntime()
   const jobId = String(args.job_id ?? '').trim()
   if (jobId) {
@@ -108,9 +109,19 @@ export async function toolAmlJobStatus(_agentId: string, args: { job_id?: string
     if (['done', 'failed', 'cancelled'].includes(job.status)) claimToolResult('aml_job', jobId)
     return { text: `${amlJobCard(job)}\n\n轮询建议:training 阶段 30~60s 查一次;终态(done/failed)后看门禁与错误,失败原因可 in aml_job_logs 定位。训练完成后平台也会自动回执到你的信箱,无需持续轮询。` }
   }
-  const jobs = rt.repo.job.list({ limit: 10 })
+  // 无 job_id 的清单必须按调用者可读面过滤(2026-10-18):此前返回全平台最近 10 个,
+  // 任意零绑定 Agent 可读到其他产线/频道的作业 id 与数据集谱系。
+  const readableLines = resolveRefFaces(agentId).readableLines
+  const visible = (job: { datasetId: string, agentId?: string }): boolean => {
+    if (job.agentId === agentId) return true
+    const ds = rt.repo.dataset.get(job.datasetId)
+    return !!ds && readableLines.has(ds.lineId)
+  }
+  const jobs = rt.repo.job.list({ limit: 10 }).filter(visible)
   if (jobs.length === 0) {
-    return { text: '尚无训练作业。路径:aml_node_catalog 确认节点 → aml_dataset_build 组数据集 → aml_job_submit 提交训练。' }
+    return {
+      text: `你的可读范围内没有训练作业(可读产线:${readableLines.size ? [...readableLines].join(', ') : '(无)'})。路径:aml_node_catalog 确认节点 → aml_dataset_build 组数据集 → aml_job_submit 提交训练;如需查看他线作业,请让用户授予对应产线权限。`,
+    }
   }
   for (const j of jobs) {
     if (['done', 'failed', 'cancelled'].includes(j.status)) claimToolResult('aml_job', j.id)
@@ -480,10 +491,13 @@ export async function toolAmlModelReference(agentId: string, args: {
 /* ═══ 建模任务(aml_training_plan_*;2026-09-26 解耦计划:训练 Channel 的编排入口) ═══ */
 
 /** 工具:aml_training_plan_list —— 建模任务清单(状态/最新模型/新批次检测基数) */
-export async function toolAmlTrainingPlanList(_agentId: string, _args: Record<string, unknown>): Promise<{ text: string, isError?: boolean }> {
-  const plans = listTrainingPlans()
+export async function toolAmlTrainingPlanList(agentId: string, _args: Record<string, unknown>): Promise<{ text: string, isError?: boolean }> {
+  // 按调用者可读面过滤(2026-10-18):此前 listTrainingPlans() 全表返回,
+  // 任意 Agent 可枚举其他产线的计划/模型/作业 id。
+  const readableLines = resolveRefFaces(agentId).readableLines
+  const plans = listTrainingPlans().filter(p => p.createdBy === agentId || readableLines.has(p.lineId))
   if (plans.length === 0) {
-    return { text: '尚无建模任务。创建路径:AML 界面「建模任务」表单,或 aml_training_plan_create(绑定产线/产品/配方 + 数据集 IO 契约);auto 策略的任务在新批次数据到达时自动修正训练。' }
+    return { text: `你的可读范围内没有建模任务(可读产线:${readableLines.size ? [...readableLines].join(', ') : '(无)'})。创建路径:AML 界面「建模任务」表单,或 aml_training_plan_create(绑定产线/产品/配方 + 数据集 IO 契约);auto 策略的任务在新批次数据到达时自动修正训练。` }
   }
   const lines = plans.map((p) => {
     const specFixed = p.trainingSpecJson ? 'spec已固化' : 'spec未固化(需先完成 draft 流程后 PATCH 固化)'

package/server/services/workshop/agents/industrial/audit-query.ts

@@ -1,6 +1,6 @@
 /**
  * 审计日志查询共用骨架(ops_log / recipe_log 两工具收敛而来):
- * 窗口参数归一(minutes/limit/from)与多产线扇出去重。
+ * 窗口参数归一(minutes / from / to / limit)与多产线扇出去重。
  * audit 仓储为内存/SQLite repo 的 query 接口(结构化过滤参数,非 SQL 拼接)。
  */
 import type { getOps } from '../../ops/ops'
@@ -9,11 +9,47 @@ export type AuditRepo = NonNullable<ReturnType<typeof getOps>>['audit']
 export type AuditQuery = Parameters<AuditRepo['query']>[0]
 export type AuditRow = ReturnType<AuditRepo['query']>[number]
 
-/** 查询窗口参数(minutes 缺省 1440;limit 缺省 20、上限 100;from = 窗口起点 ISO) */
-export function windowOf(args: { minutes?: number | string, limit?: number | string }): { minutes: number, limit: number, from: string } {
+export interface OpsWindow {
+  /** 回看分钟数(仅在未显式给 from 时用于计算窗口起点;输出文案也用它) */
+  minutes: number
+  /** 返回条数上限(1..100) */
+  limit: number
+  /** 窗口起点(ISO,配置时区偏移格式;恒有值) */
+  from: string
+  /** 窗口终点(ISO;缺省 = 现在/不限) */
+  to?: string
+  /** 参数错误(非空时调用方应直接回包 isError,不执行查询) */
+  error?: string
+}
+
+function normalizeTime(value: string | undefined, label: string): { iso?: string, error?: string } {
+  const text = String(value ?? '').trim()
+  if (!text) return {}
+  const ms = Date.parse(text)
+  if (!Number.isFinite(ms))
+    return { error: `${label} 不是合法时间: ${text}(示例 2026-10-19T08:00:00+08:00)` }
+  return { iso: new Date(ms).toISOString() }
+}
+
+/** 查询窗口参数归一:显式 from/to 优先,否则按 minutes 回看;非法时间给出可行动错误。 */
+export function windowOf(args: {
+  minutes?: number | string
+  limit?: number | string
+  from?: string
+  to?: string
+}): OpsWindow {
   const minutes = Number(args.minutes) || 1440
-  const limit = Math.min(Number(args.limit) || 20, 100)
-  return { minutes, limit, from: new Date(Date.now() - minutes * 60_000).toISOString() }
+  const limit = Math.max(1, Math.min(Number(args.limit) || 20, 100))
+  const fromArg = normalizeTime(args.from, 'from')
+  if (fromArg.error) return { minutes, limit, from: '', error: fromArg.error }
+  const toArg = normalizeTime(args.to, 'to')
+  if (toArg.error) return { minutes, limit, from: '', error: toArg.error }
+  const from = fromArg.iso ?? new Date(Date.now() - minutes * 60_000).toISOString()
+  const to = toArg.iso
+  if (to && Date.parse(from) > Date.parse(to)) {
+    return { minutes, limit, from, to, error: `时间区间无效:from(${args.from ?? from}) 晚于 to(${args.to ?? to})` }
+  }
+  return { minutes, limit, from, ...(to ? { to } : {}) }
 }
 
 /** 多产线扇出查询(每产线可发一条或多条过滤参数)+ id 去重(排序/过滤/截断由调用方按需做) */