agentworkshop 0.7.54 → 0.7.59

package/server/services/workshop/mes/mes-controller.ts

@@ -11,8 +11,12 @@
  *   其余(maxRows > 2000)         → createFetchJob 异步落 CSV,回 job_id/dataset_id。
  */
 import { resolveDcwDriver } from '../dcw/drivers'
+import type { DcwHistoryFormat as MesHistoryFormat } from '../dcw/drivers/shared'
+import { historyFormatOf } from '../dcw/drivers/mes-rest'
 import type { MesHistoryDriver, MesDatasetStatsView, MesDatasetStore } from './mes-datasets'
 import { getMesDatasets } from './mes-datasets'
+import { mesDataHookCode, mesRequestHookCode, runMesDataHook, runMesRequestHook, saveMesImageArtifact } from './mes-hook'
+import type { MesHookArtifact, MesHookData } from './mes-hook'
 
 /** mes-rest 驱动 kind(并行工作流收编进 DcwDriverKind 联合;此处按字符串经注册表解析,不 import 驱动实现) */
 export const MES_REST_DRIVER_KIND = 'mes-rest'
@@ -99,8 +103,19 @@ function defaultDeps(): MesControllerDeps {
       return getDcwNodeRepo().all()
     },
     boundNodeIds: async (agentId) => {
+      // 权限模型 v2:dcw 绑定(存量)∪ 绑定配方内的参数节点(kind='recipe' 的配方可见节点)
       const { getAgentNodeBindingRepo } = await import('../agents/node-bindings.repo')
-      return new Set(getAgentNodeBindingRepo().byAgent(agentId).filter(b => b.kind === 'dcw').map(b => b.nodeId))
+      const { getDcwController } = await import('../dcw/dcw-controller')
+      const bindings = getAgentNodeBindingRepo().byAgent(agentId)
+      const ids = new Set(bindings.filter(b => b.kind === 'dcw').map(b => b.nodeId))
+      const recipeIds = new Set(bindings.filter(b => b.kind === 'recipe').map(b => b.nodeId))
+      if (recipeIds.size > 0) {
+        for (const r of getDcwController().listRecipes()) {
+          if (!recipeIds.has(r.id)) continue
+          for (const p of r.params) ids.add(p.nodeId)
+        }
+      }
+      return ids
     },
     resolveDriver: kind => resolveDcwDriver(kind as Parameters<typeof resolveDcwDriver>[0]),
     nowMs: () => Date.now(),
@@ -118,6 +133,10 @@ export type MesCatalogEntry = {
   readable: boolean
   writable: boolean
   historyable: boolean
+  /** 历史格式(scalar/vector/image/table/event;historyMap 未配置时 scalar) */
+  format: MesHistoryFormat
+  /** 已配置数据下沉 hook(dataHook) */
+  hooked: boolean
   enabled: boolean
 }
 
@@ -135,6 +154,8 @@ export function mesCatalogEntryOf(n: MesNodeLike): MesCatalogEntry {
     readable: Boolean(cfg.readMap),
     writable: Boolean(cfg.writeMap),
     historyable: Boolean(cfg.historyMap),
+    format: historyFormatOf(cfg as Record<string, unknown>),
+    hooked: Boolean(cfg.dataHook),
     enabled: Boolean(n.enabled),
   }
 }
@@ -159,19 +180,26 @@ export interface MesFetchArgs {
   from?: string
   to?: string
   max_rows?: number | string
+  /** 透传给 requestHook/dataHook 的参数对象(Agent 只传 param,其余交给配置) */
+  param?: unknown
 }
 
-export interface MesCatalogArgs { q?: string, line_id?: string, limit?: number | string }
+export interface MesCatalogArgs { q?: string, line_id?: string, limit?: number | string, /** 调用者可读产线集(绑线授权口径);提供时严格过滤(孤儿/越线点位不可见,空集=空目录 fail-closed) */ scope_line_ids?: string[] }
 
 export function createMesController(deps: Partial<MesControllerDeps> = {}) {
   const d: MesControllerDeps = { ...defaultDeps(), ...deps }
 
   // ---------- 目录 ----------
 
-  /** mes-rest 点位目录(q 对 name/desc 子串过滤;line_id 精确过滤;limit 缺省 20) */
+  /** mes-rest 点位目录(q 对 name/desc 子串过滤;line_id 精确过滤;limit 缺省 20;
+   *  scope_line_ids 提供时按调用者可读产线严格过滤——跨产线点位与孤儿(未分配)点位不可见) */
   async function catalog(args: MesCatalogArgs = {}): Promise<MesToolResult & { entries: MesCatalogEntry[], total: number }> {
     const all = await d.nodes()
     let mes = all.filter(n => n.driver === MES_REST_DRIVER_KIND).map(mesCatalogEntryOf)
+    if (Array.isArray(args.scope_line_ids)) {
+      const scope = new Set(args.scope_line_ids)
+      mes = mes.filter(e => e.lineId !== '' && scope.has(e.lineId))
+    }
     const total = mes.length
     const lineId = String(args.line_id ?? '').trim()
     if (lineId) mes = mes.filter(e => e.lineId === lineId)
@@ -181,13 +209,14 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
     const shown = mes.slice(0, limit)
 
     const cap = (e: MesCatalogEntry): string => {
-      const ab = [e.readable ? '读' : null, e.writable ? '写' : null, e.historyable ? '史' : null].filter(Boolean)
+      const hist = e.historyable ? (e.format !== 'scalar' ? `史·${e.format}` : '史') : null
+      const ab = [e.readable ? '读' : null, e.writable ? '写' : null, hist, e.hooked ? '钩子' : null].filter(Boolean)
       return ab.length > 0 ? ab.join('/') : '无能力位'
     }
     const body = shown.map(e =>
       `- ${e.name}(id=${e.id}) | 产线 ${e.lineId || '未分配'} | 单位 ${e.unit || '-'} | 量程 ${e.min}~${e.max} | 能力 ${cap(e)}${e.enabled ? '' : ' [停用]'}${e.desc ? ` | ${e.desc.slice(0, 80)}` : ''}`)
     const more = mes.length - shown.length
-    const text = `MES REST 点位目录(共 ${total} 个${lineId ? `,产线 ${lineId}` : ''}${q ? `,关键字「${args.q}」` : ''};显示 ${shown.length} 条):\n${body.join('\n') || '(无匹配点位)'}${more > 0 ? `\n(另有 ${more} 条未显示,可收紧 q/line_id 或调大 limit≤100)` : ''}\n\n说明:能力 读=可读当前值,写=可写设定值,史=可取历史(fetchHistory);历史取数用 mes_fetch(ids=[点位id], from, to, max_rows),数据原文落 CSV 数据集,prompt 只回统计摘要。`
+    const text = `MES REST 点位目录(共 ${total} 个${lineId ? `,产线 ${lineId}` : ''}${q ? `,关键字「${args.q}」` : ''};显示 ${shown.length} 条):\n${body.join('\n') || '(无匹配点位)'}${more > 0 ? `\n(另有 ${more} 条未显示,可收紧 q/line_id 或调大 limit≤100)` : ''}\n\n说明:能力 读=可读当前值,写=可写设定值,史=可取历史(史·vector=每时间点检测向量,史·image=图像帧,史·table/event=记录流),钩子=已配 dataHook(取数后自动做下沉处理并回传摘要与产物)。历史取数用 mes_fetch(ids=[点位id], from, to, max_rows, param?),标量/向量全量行落 CSV 数据集,图像帧自动落盘为文件,prompt 只回统计摘要与采样。`
     return { text, entries: shown, total }
   }
 
@@ -269,22 +298,91 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
   const fmtN = (v: number | null | undefined, digits = 3): string =>
     v == null || !Number.isFinite(v) ? '-' : String(Number(v.toFixed(digits)))
   const shortTs = (iso: string | null): string => iso && iso.length >= 19 ? iso.slice(5, 19).replace('T', ' ') : (iso ?? '-')
+  const clip = (v: unknown, max: number): string => {
+    const s = typeof v === 'string' ? v : JSON.stringify(v) ?? String(v)
+    return s.length > max ? `${s.slice(0, max)}…` : s
+  }
+
+  // -------- 格式感知取数(行形态全谱;内存硬顶防大payload 拖垮进程) --------
+
+  /** 泛化历史行缓冲的硬顶 */
+  const VECTOR_ELEMENT_CAP = 2_000_000
+  const IMAGE_BASE64_CAP = 16_000_000
+  const RECORD_JSON_CAP = 8_000_000
+  /** image 格式自动落盘帧数上限(其余帧不落盘,回包注明) */
+  const IMAGE_AUTOSAVE_MAX = 20
+
+  interface GenRow { ts: string, value?: number, values?: number[], data?: string, mime?: string, record?: unknown }
+
+  interface GenStats extends MesDatasetStatsView {
+    /** vector:维度(首行长度)与维度不齐行数 */
+    dim?: number
+    dimMismatch?: number
+    /** vector:全体元素均值(比行均值更细) */
+    elementMean?: number
+  }
+
+  /** requestHook 覆盖合并:克隆 driverConfig,把 {path,query,headers} 合入 historyMap JSON */
+  async function configWithRequestHook(node: MesNodeLike, param: unknown): Promise<Record<string, unknown>> {
+    const cfg = { ...(node.driverConfig as Record<string, unknown>) }
+    const hookCode = mesRequestHookCode(cfg as Record<string, unknown>)
+    if (!hookCode) return cfg
+    const overrides = await runMesRequestHook(hookCode, param, { nodeId: node.id })
+    if (overrides.path === undefined && overrides.query === undefined && overrides.headers === undefined) return cfg
+    try {
+      const map = JSON.parse(String(cfg.historyMap ?? '{}')) as Record<string, unknown>
+      if (overrides.path !== undefined) map.path = overrides.path
+      const baseQuery = (map.query !== null && typeof map.query === 'object' && !Array.isArray(map.query) ? map.query : {}) as Record<string, unknown>
+      map.query = { ...baseQuery, ...(overrides.query ?? {}) }
+      const baseHeaders = (map.headers !== null && typeof map.headers === 'object' && !Array.isArray(map.headers) ? map.headers : {}) as Record<string, unknown>
+      if (overrides.headers !== undefined) map.headers = { ...baseHeaders, ...overrides.headers }
+      cfg.historyMap = JSON.stringify(map)
+    }
+    catch (err) {
+      throw new AppError(422, 'MES_HOOK_FAILED', `requestHook 覆盖合并失败(historyMap 非法 JSON):${err instanceof Error ? err.message : String(err)}`)
+    }
+    return cfg
+  }
+
+  /** 向量行统计摘要(行均值序列 stats + 维度 + 全体元素均值) */
+  function vectorStats(rows: GenRow[]): GenStats {
+    const rowMeans = rows.map((r) => {
+      const vs = r.values ?? []
+      return vs.length > 0 ? vs.reduce((a, b) => a + b, 0) / vs.length : NaN
+    }).filter(v => Number.isFinite(v))
+    const all: number[] = []
+    for (const r of rows) if (Array.isArray(r.values)) all.push(...r.values)
+    const base = statsOf(rowMeans, rows[0]?.ts ?? null, rows[rows.length - 1]?.ts ?? null) as GenStats
+    base.dim = Array.isArray(rows[0]?.values) ? rows[0]!.values!.length : undefined
+    base.dimMismatch = base.dim === undefined ? undefined : rows.filter(r => Array.isArray(r.values) && r.values!.length !== base.dim).length
+    base.elementMean = all.length > 0 ? all.reduce((a, b) => a + b, 0) / all.length : undefined
+    return base
+  }
 
-  /** 同步取单节点历史(缓冲截断保护;原文不回传,只回 stats+采样) */
-  async function inlineFetchNode(node: MesNodeLike, from: string, to: string, maxRows: number): Promise<{
+  /** 同步取单节点历史(格式感知:统计+采样+图像落盘+dataHook 下沉处理;原文不回传) */
+  async function inlineFetchNode(node: MesNodeLike, from: string, to: string, maxRows: number, param: unknown): Promise<{
     text: string
     stats: MesDatasetStatsView
     truncated: boolean
     sample: string[]
+    hookText?: string
+    artifacts: MesHookArtifact[]
   }> {
+    const cfg = node.driverConfig as Record<string, unknown>
+    const format = historyFormatOf(cfg)
     const driver = d.resolveDriver(node.driver)
     if (typeof driver.fetchHistory !== 'function') {
-      return { text: `驱动 ${node.driver} 未提供历史原语(fetchHistory)`, stats: statsOf([], null, null), truncated: true, sample: [] }
+      return { text: `驱动 ${node.driver} 未提供历史原语(fetchHistory)`, stats: statsOf([], null, null), truncated: true, sample: [], artifacts: [] }
     }
-    const buf: Array<{ ts: string, value: number }> = []
+    const effCfg = await configWithRequestHook(node, param)
+    const buf: GenRow[] = []
     let truncated = false
+    let vecElems = 0
+    let imgChars = 0
+    let recChars = 0
+    let memoryHit = ''
     const result = await driver.fetchHistory({
-      driverConfig: node.driverConfig as Record<string, unknown>,
+      driverConfig: effCfg,
       fromIso: from,
       toIso: to,
       maxRows,
@@ -294,25 +392,154 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
             truncated = true
             break
           }
-          buf.push({ ts: String(r?.ts ?? ''), value: Number(r?.value) })
+          const row: GenRow = { ts: String(r?.ts ?? '') }
+          if (typeof r?.value === 'number') row.value = r.value
+          if (Array.isArray(r?.values)) {
+            vecElems += r.values.length
+            if (vecElems > VECTOR_ELEMENT_CAP) {
+              memoryHit = `向量元素总量超过 ${VECTOR_ELEMENT_CAP} 上限`
+              truncated = true
+              break
+            }
+            row.values = r.values as number[]
+          }
+          if (typeof r?.data === 'string') {
+            imgChars += r.data.length
+            if (imgChars > IMAGE_BASE64_CAP) {
+              memoryHit = `图像载荷总量超过 ${Math.round(IMAGE_BASE64_CAP / 1024 / 1024)}MB 上限`
+              truncated = true
+              break
+            }
+            row.data = r.data
+            row.mime = typeof r?.mime === 'string' ? r.mime : 'image/png'
+          }
+          if (r?.record !== undefined && r.record !== null) {
+            let json: string
+            try {
+              json = JSON.stringify(r.record)
+            }
+            catch {
+              continue
+            }
+            recChars += json.length
+            if (recChars > RECORD_JSON_CAP) {
+              memoryHit = `记录载荷总量超过 ${Math.round(RECORD_JSON_CAP / 1024 / 1024)}MB 上限`
+              truncated = true
+              break
+            }
+            row.record = r.record
+          }
+          buf.push(row)
         }
       },
     })
     if (result && result.complete === false) truncated = true
-    const values = buf.map(r => r.value).filter(v => Number.isFinite(v))
-    const stats = statsOf(values, buf[0]?.ts ?? null, buf[buf.length - 1]?.ts ?? null)
+    if (!truncated && memoryHit) truncated = true
+
+    // 统计与采样(按格式)
+    let stats: GenStats
+    let autosaved: MesHookArtifact[] = []
     const sample: string[] = []
-    if (buf.length > 0) {
+    if (format === 'vector') {
+      stats = vectorStats(buf)
+      const idx = [...new Set([0, Math.floor((buf.length - 1) / 2), buf.length - 1])].slice(0, 3)
+      for (const i of idx) {
+        const r = buf[i]!
+        const vs = r.values ?? []
+        const m = vs.length > 0 ? vs.reduce((a, b) => a + b, 0) / vs.length : NaN
+        sample.push(`${shortTs(r.ts)},dim=${vs.length},mean=${fmtN(m)},min=${fmtN(vs.length ? Math.min(...vs) : NaN)},max=${fmtN(vs.length ? Math.max(...vs) : NaN)}`)
+      }
+    }
+    else if (format === 'image') {
+      stats = { count: buf.length, min: null, max: null, mean: null, stddev: null, firstTs: buf[0]?.ts ?? null, lastTs: buf[buf.length - 1]?.ts ?? null }
+      // 图像 base64 永不进 prompt:自动落盘(≤20 帧),采样给文件名
+      const saved: MesHookArtifact[] = []
+      for (const [i, r] of buf.entries()) {
+        if (typeof r.data !== 'string') continue
+        if (saved.length >= IMAGE_AUTOSAVE_MAX) break
+        const a = saveMesImageArtifact(node.id, `frame-${String(i).padStart(4, '0')}`, r.data, r.mime ?? 'image/png')
+        if (a) saved.push(a)
+      }
+      const idx = [...new Set([0, Math.floor((buf.length - 1) / 2), buf.length - 1])].slice(0, 3)
+      for (const i of idx) {
+        const r = buf[i]!
+        const kb = r.data ? Math.round(r.data.length * 3 / 4 / 1024) : 0
+        const f = saved.find(x => x.name.includes(`frame-${String(i).padStart(4, '0')}`))
+        sample.push(`${shortTs(r.ts)},${r.mime ?? 'image/png'},~${kb}KB${f ? ` → ${f.name}` : ''}`)
+      }
+      autosaved = saved
+    }
+    else if (format === 'table' || format === 'event') {
+      stats = { count: buf.length, min: null, max: null, mean: null, stddev: null, firstTs: buf[0]?.ts ?? null, lastTs: buf[buf.length - 1]?.ts ?? null }
+      const idx = [...new Set([0, Math.floor((buf.length - 1) / 2), buf.length - 1])].slice(0, 3)
+      for (const i of idx) {
+        const r = buf[i]!
+        let body: string
+        try {
+          body = JSON.stringify(r.record)
+        }
+        catch {
+          body = '(不可序列化)'
+        }
+        sample.push(`${shortTs(r.ts)},${clip(body ?? '', 120)}`)
+      }
+    }
+    else {
+      const values = buf.map(r => r.value).filter((v): v is number => Number.isFinite(v))
+      stats = statsOf(values, buf[0]?.ts ?? null, buf[buf.length - 1]?.ts ?? null)
       const idx = [...new Set([0, Math.floor((buf.length - 1) / 2), buf.length - 1])].slice(0, 3)
-      for (const i of idx) sample.push(`${shortTs(buf[i]!.ts)},${fmtN(buf[i]!.value)}`)
+      for (const i of idx) sample.push(`${shortTs(buf[i]!.ts)},${fmtN(buf[i]!.value ?? NaN)}`)
     }
+
+    const fmtLabel = format === 'scalar' ? `标量` : format === 'vector' ? `向量(dim=${stats.dim ?? '?'})` : format === 'image' ? `图像(${(buf[0]?.mime as string) ?? 'image/png'})` : format === 'table' ? `表格记录` : `事件记录`
+    const statLine = format === 'scalar'
+      ? `  统计:min ${fmtN(stats.min)} / max ${fmtN(stats.max)} / mean ${fmtN(stats.mean)} / stddev ${fmtN(stats.stddev)} ${node.unit}`
+      : format === 'vector'
+        ? `  统计(按行均值):min ${fmtN(stats.min)} / max ${fmtN(stats.max)} / mean ${fmtN(stats.mean)} / stddev ${fmtN(stats.stddev)} ${node.unit};全体元素均值 ${fmtN(stats.elementMean ?? NaN)}${stats.dimMismatch ? `;维度漂移 ${stats.dimMismatch} 行` : ''}`
+        : `  统计:${stats.count} 条记录(非数值格式不做均值)`
     const text = [
-      `■ ${node.name}(id=${node.id})`,
-      `  行数 ${stats.count}${truncated ? '(截断:达到 maxRows 上限)' : '(完整)'} | 首 ${shortTs(stats.firstTs)} ~ 末 ${shortTs(stats.lastTs)}`,
-      `  统计:min ${fmtN(stats.min)} / max ${fmtN(stats.max)} / mean ${fmtN(stats.mean)} / stddev ${fmtN(stats.stddev)} ${node.unit}`,
-      sample.length > 0 ? `  采样(≤3 行,ts,value): ${sample.join(' | ')}` : '  采样:无有效数值行',
+      `■ ${node.name}(id=${node.id})[格式 ${fmtLabel}]`,
+      `  行数 ${stats.count}${truncated ? `(截断:${memoryHit || '达到 maxRows 上限'})` : '(完整)'} | 首 ${shortTs(stats.firstTs)} ~ 末 ${shortTs(stats.lastTs)}`,
+      statLine,
+      sample.length > 0 ? `  采样(≤3 行): ${sample.join(' | ')}` : '  采样:无有效行',
     ].join('\n')
-    return { text, stats, truncated, sample }
+
+    // dataHook 下沉处理(用户配置的 (param, data, ctx) => {...})
+    let hookText: string | undefined
+    const artifacts: MesHookArtifact[] = [...(autosaved as MesHookArtifact[])]
+    const hookCode = mesDataHookCode(cfg)
+    if (hookCode) {
+      const hookData: MesHookData = {
+        node: { id: node.id, name: node.name, lineId: node.lineId, unit: node.unit },
+        format,
+        rows: buf,
+        window: { from, to },
+      }
+      try {
+        const outcome = await runMesDataHook(hookCode, param, hookData, { nodeId: node.id })
+        if (outcome.ok) {
+          artifacts.push(...outcome.artifacts)
+          const parts = [`  钩子(dataHook):已执行,产物 ${outcome.artifacts.length} 个`]
+          if (outcome.summary) parts.push(`  处理摘要: ${outcome.summary}`)
+          if (outcome.context) parts.push(`  处理说明: ${outcome.context}`)
+          if (outcome.logs.length > 0) parts.push(`  hook 日志(≤3): ${outcome.logs.slice(0, 3).join(' / ')}`)
+          hookText = parts.join('\n')
+        }
+        else {
+          hookText = `  钩子(dataHook)执行失败:${outcome.error ?? '未知原因'}(统计仍基于原始数据)`
+        }
+      }
+      catch (err) {
+        hookText = `  钩子(dataHook)执行失败:${err instanceof Error ? err.message : String(err)}`
+      }
+    }
+
+    // 产物行(hook 之外含自动落盘图像)
+    if (artifacts.length > 0) {
+      const shown = artifacts.slice(0, 8).map(a => `${a.name}(${Math.max(1, Math.round(a.bytes / 1024))}KB)`)
+      hookText = `${hookText ?? ''}\n  产物(${artifacts.length}${artifacts.length > 8 ? ',显示前8' : ''}): ${shown.join(' | ')}`
+    }
+    return { text, stats, truncated, sample, hookText, artifacts }
   }
 
   /**
@@ -330,6 +557,18 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
     if (!mesFetchRateCheck(agentId, d.nowMs())) {
       return { text: `取数过于频繁:每 60 秒最多 ${MES_RATE_MAX_CALLS} 次。请先消化已有结果,稍后再取。`, isError: true }
     }
+    // ④ 格式门控:image/table/event 的原文(帧/记录)不进 prompt 也不落 CSV 数据集,
+    //    只支持内联行数(≤MES_SYNC_INLINE_MAX_ROWS);大窗口请拆小分批
+    if (win.maxRows > MES_SYNC_INLINE_MAX_ROWS) {
+      const INLINE_ONLY = new Set(['image', 'table', 'event'])
+      const hits = vis.nodes.filter(n => INLINE_ONLY.has(historyFormatOf(n.driverConfig as Record<string, unknown>)))
+      if (hits.length > 0) {
+        return {
+          text: `行数上限冲突:${hits.map(n => `${n.name}(${n.id})`).join(', ')} 是 图像/表格/事件 格式点位,只在 max_rows ≤ ${MES_SYNC_INLINE_MAX_ROWS} 的内联模式支持(原文不落 CSV 数据集)。请缩小时间窗或调低 max_rows 后重取。`,
+          isError: true,
+        }
+      }
+    }
 
     // 模式一:当前值快照(无 from/to)
     if (!win.from || !win.to) {
@@ -357,14 +596,14 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
       }
     }
 
-    // 模式二:同步内联(行数 ≤ MES_SYNC_INLINE_MAX_ROWS)
+    // 模式二:同步内联(行数 ≤ MES_SYNC_INLINE_MAX_ROWS;格式感知+dataHook 下沉)
     if (win.maxRows <= MES_SYNC_INLINE_MAX_ROWS) {
       const sections: string[] = []
       const statsOut: NonNullable<MesFetchOutcome['data']>['stats'] = []
       for (const node of vis.nodes) {
         try {
-          const one = await inlineFetchNode(node, win.from, win.to, win.maxRows)
-          sections.push(one.text)
+          const one = await inlineFetchNode(node, win.from, win.to, win.maxRows, args.param)
+          sections.push(one.hookText ? `${one.text}\n${one.hookText}` : one.text)
           statsOut.push({ nodeId: node.id, stats: one.stats, truncated: one.truncated })
         }
         catch (err) {
@@ -373,16 +612,25 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
       }
       return {
         mode: 'inline',
-        text: `MES 历史取数(内联同步,${vis.nodes.length} 个点位,窗口 ${shortTs(win.from)} ~ ${shortTs(win.to)}):\n${sections.join('\n')}\n\n说明:以上为统计摘要与 ≤3 行采样;MES 原文不进入对话。需要全量行数据请用更大 max_rows(> ${MES_SYNC_INLINE_MAX_ROWS})走异步数据集,再用 mes_dataset_read 读。`,
+        text: `MES 历史取数(内联同步,${vis.nodes.length} 个点位,窗口 ${shortTs(win.from)} ~ ${shortTs(win.to)}):\n${sections.join('\n')}\n\n说明:以上为统计摘要与 ≤3 行采样;MES 原文不进入对话。向量/图像/记录点位按各自格式呈现,已配置数据钩子(dataHook)的点位会附处理摘要与产物清单(文件落 <数据根>/mes-artifacts/<点位id>/)。需要标量/向量全量行请用更大 max_rows(> ${MES_SYNC_INLINE_MAX_ROWS})走异步数据集,再用 mes_dataset_read 读。`,
         data: { stats: statsOut },
       }
     }
 
-    // 模式三:异步数据集(行数 > MES_SYNC_INLINE_MAX_ROWS;进程内异步,绝不进调度循环)
+    // 模式三:异步数据集(行数 > MES_SYNC_INLINE_MAX_ROWS;进程内异步,绝不进调度循环;
+    // requestHook 覆盖在此同样生效——合并进作业用的 driverConfig)
     const jobIds: string[] = []
     const datasetIds: string[] = []
     const lines: string[] = []
     for (const node of vis.nodes) {
+      let effCfg: Record<string, unknown>
+      try {
+        effCfg = await configWithRequestHook(node, args.param)
+      }
+      catch (err) {
+        lines.push(`- ${node.name}(${node.id}):requestHook 失败,作业未创建(${err instanceof Error ? err.message : String(err)})`)
+        continue
+      }
       const { jobId, datasetId } = d.store.createFetchJob({
         nodeId: node.id,
         fromIso: win.from,
@@ -391,7 +639,7 @@ export function createMesController(deps: Partial<MesControllerDeps> = {}) {
         agentId,
         lineId: node.lineId,
         nodeName: node.name,
-        driverConfig: node.driverConfig as Record<string, unknown>,
+        driverConfig: effCfg,
       })
       jobIds.push(jobId)
       datasetIds.push(datasetId)