agentworkshop 0.7.66 → 0.7.70

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

@@ -0,0 +1,114 @@
+/**
+ * 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 } from './catalog'
+import { getAgentNodeBindingRepo } from '../node-bindings.repo'
+import { getDaqController } from '../../daq/daq-controller'
+import { getDcwController } from '../../dcw/dcw-controller'
+
+/** 需要追加“可见资源”描述的工具族 */
+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
+}
+
+const listText = (items: Array<{ id: string, name: string, unit?: string }>): string =>
+  items.map(x => `${x.name}(${x.id}${x.unit ? `,${x.unit}` : ''})`).join('、')
+
+/** 在角色过滤后的工具面上追加 Agent 绑定资源描述 */
+export function hostToolsForAgent(agentId: string, role: 'lead' | 'worker', channelId?: string) {
+  const tools = hostToolsForRole(role, channelId)
+  const res = agentToolResources(agentId)
+  const lineOnlyDaq = res.daqLineNodes.filter(n => !res.daqNodes.some(x => x.id === n.id))
+  if (res.daqNodes.length === 0 && lineOnlyDaq.length === 0 && res.recipes.length === 0) return tools
+  const daqParts = [
+    res.daqNodes.length > 0 ? `本 Agent 直接绑定的数采节点(仅这些可查):${listText(res.daqNodes)}` : '',
+    lineOnlyDaq.length > 0 ? `频道绑线只读数采节点(可查):${listText(lineOnlyDaq)}` : '',
+  ].filter(Boolean)
+  const daqLine = daqParts.length > 0 ? `\n\n${daqParts.join('\n')}` : ''
+  const recipeLine = res.recipes.length > 0
+    ? `\n\n本 Agent 已绑定的配方(仅这些可写/下发):${res.recipes.map(r => `${r.name}(${r.id},v${r.version};参数:${r.params.map(p => `${p.name}(${p.nodeId})`).join('、') || '无'})`).join(';')}`
+    : ''
+  const mesLine = res.mesNodes.length > 0
+    ? `\n\n本 Agent 可经配方参数面取数的 MES 点位:${listText(res.mesNodes)}`
+    : ''
+  return tools.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
+    if (!suffix) return t
+    return { ...t, description: `${t.description ?? ''}${suffix}` }
+  })
+}

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

@@ -9,7 +9,7 @@
  * 该族**不依赖 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 { 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'
@@ -58,7 +58,11 @@ const INDUSTRIAL_HANDLERS = new Map<string, IndustrialToolHandler>([
   ['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])],
@@ -67,6 +71,7 @@ const INDUSTRIAL_HANDLERS = new Map<string, IndustrialToolHandler>([
   ['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 })],

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 去重(排序/过滤/截断由调用方按需做) */

package/server/services/workshop/agents/industrial/daq-export.ts

@@ -1,5 +1,6 @@
 /**
- * daq_export —— 绑定数采节点的**全量原始时序**导出(CSV + 节点映射 manifest.json)。
+ * daq_export —— 可见数采节点(直接绑定 ∪ 频道绑线只读面)的**全量原始时序**导出
+ * (CSV + 节点映射 manifest.json)。
  *
  * 与 daq_query(文本统计面)/diag-bridge 快照(5s 降采样单 CSV)互补:本工具把
  * Agent 自选节点的**逐样本完整时序**分页拉全,落盘到数据目录
@@ -20,6 +21,7 @@ import { getDaqNodeRepo } from '../../daq/daq-node.repo'
 import { getActiveLineRun } from '../../dcw/line-run'
 import { getDcwLineRepo } from '../../dcw/dcw-line.repo'
 import { getDcwController } from '../../dcw/dcw-controller'
+import { channelBoundLineId } from './ops-tools'
 import { settingOf } from '../../settings'
 
 const PAGE_LIMIT = 5000 // 与 tsdb 适配器单查硬上限一致(满页即续拉)
@@ -43,6 +45,8 @@ export interface ExportNodeMeta {
   semantics?: string
   /** 信号形态(vector/image=帧节点:导出帧文件而非标量 CSV;缺省 scalar) */
   signalKind?: 'scalar' | 'vector' | 'image'
+  /** 向量布局/逐点语义(导出 manifest 与 README,离线分析可读) */
+  vector?: { points: number, min: number, max: number, axis?: string, pointUnit?: string, pointLabelPrefix?: string, pointIndexBase?: 0 | 1, labels?: string[] }
 }
 
 export interface ExportLineContext {
@@ -170,6 +174,7 @@ async function exportFrames(
       semantics: meta.semantics || '', unit: meta.unit,
       file: fileRel, frames: n, points: rows.length - 1,
       value_range_observed: null, state_summary: {},
+      ...(meta.vector ? { vector: meta.vector } : {}),
       metrics_summary: metricSummary,
       ...(truncated ? { truncated: true } : {}),
     }
@@ -327,6 +332,7 @@ export async function exportDaqDataset(opts: {
   }
 
   const exactRows = files.reduce((s, f) => s + f.rows, 0)
+  const mergedFile = opts.merge ? writeMergedCsv(dir, files, nodeOf) : undefined
   const manifest: Record<string, unknown> = {
     schema: 'aw.daq-export/1',
     export_id: exportId,
@@ -340,7 +346,44 @@ export async function exportDaqDataset(opts: {
     truncated_nodes: truncated,
     usage: 'nodes/ 下每标量节点一份全量原始时序 CSV(ts_iso,ts_ms,value,state;无降采样);帧节点(vector/image)在 frames/ 下:向量=单 CSV 长表(ts_iso,ts_ms,point_index,value),图像=逐帧原文件 frames/<node_id>/<ts>.<ext>。请结合本清单的节点语义/量程/产线-配方上下文做分析;深度根因诊断请用 diag-bridge 的 diag_run(export_id=本 export_id)。',
   }
+  manifest.readme = 'README.md'
   writeFileSync(join(dir, 'manifest.json'), JSON.stringify(manifest, null, 2), 'utf8')
+  // 人/Agent 可直读的语义说明:离线拿到目录后不必回读平台
+  try {
+    const md: string[] = [
+      `# ${title || 'DAQ 数据导出'}`,
+      '',
+      `- 导出时间: ${new Date(now()).toISOString()}`,
+      `- 时间窗: ${new Date(fromMs).toISOString()} ~ ${new Date(toMs).toISOString()}`,
+      `- 导出目录: ${dir}`,
+      `- 说明: ${note || '(无)'}`,
+      '',
+      '## 节点与字段',
+      '',
+    ]
+    for (const n of nodeMetas) {
+      md.push(`### ${String(n.name)} (${String(n.id)})`)
+      md.push(`- 单位: ${String(n.unit || '-')};量程: ${JSON.stringify(n.range)};预警带: ${JSON.stringify(n.warn)}`)
+      if (n.semantics) md.push(`- 物理意义: ${String(n.semantics)}`)
+      if (n.file) md.push(`- 全量时序: ${String(n.file)}(ts_iso,ts_ms,value,state;无降采样)`)
+      if (n.kind === 'vector') {
+        md.push(`- 向量文件: ${String(n.file)}(长表 ts_iso,ts_ms,point_index,value)`)
+        const v = n.vector as ExportNodeMeta['vector'] | undefined
+        if (v) {
+          const base = v.pointIndexBase === 0 ? 0 : 1
+          const labels = v.labels?.slice(0, 8).map((x, i) => `${i + base}=${x}`).join(', ')
+          const prefix = v.pointLabelPrefix ? `${v.pointLabelPrefix}${base}…${v.pointLabelPrefix}${v.points - 1 + base}` : ''
+          md.push(`- 点位布局: ${v.points} 点;轴 ${v.axis ?? '-'};${labels ? `前 8 点: ${labels}` : prefix ? `点标签: ${prefix}` : `点序号从 ${base} 开始`}`)
+        }
+      }
+      if (n.kind === 'image') md.push(`- 图像目录: ${String(n.dir)}(逐帧原文件;manifest 有统计)`)
+      md.push('')
+    }
+    if (mergedFile) md.push(`多参数对齐宽表: ${mergedFile}`, '')
+    md.push('## 用法', '', 'CSV 首行为列名,可直接用 Python/pandas、Excel 或任何分析工具读取。产线/产品/配方/批次归属与配方监控窗口见 manifest.json 的 lines[];节点语义与逐点含义见 nodes[]。')
+    writeFileSync(join(dir, 'README.md'), `${md.join('\n')}\n`, 'utf8')
+  }
+  catch { /* README 失败不影响数据 */ }
   // 保留策略:超出 RETAIN_EXPORTS 的最旧导出目录直接清理(mes-artifacts 同款思路)
   try {
     const siblings = readdirSync(rootDir, { withFileTypes: true })
@@ -352,13 +395,12 @@ export async function exportDaqDataset(opts: {
     }
   }
   catch { /* 清理失败不阻断导出 */ }
-  const mergedFile = opts.merge ? writeMergedCsv(dir, files, nodeOf) : undefined
   return { exportId, dir, manifest, files, totalRows: exactRows, truncated, mergedFile: mergedFile ?? undefined }
 }
 
 /**
- * 工具:daq_export —— 导出绑定数采节点全量原始时序到数据目录(CSV + manifest.json)。
- * 权限边界与 daq_query 一致:只能收窄到自己的绑定(node_ids/line_id 越权即拒)。
+ * 工具:daq_export —— 导出可见数采节点(直接绑定 ∪ 频道绑线只读)全量原始时序到数据目录
+ * (CSV + manifest.json)。权限边界与 daq_query 一致:绑定面 ∪ 频道绑线,node_ids/line_id 越权即拒。
  */
 export async function toolDaqExport(agentId: string, args: {
   node_ids?: string | string[]
@@ -372,12 +414,17 @@ export async function toolDaqExport(agentId: string, args: {
   merge?: boolean | string
 }): Promise<{ text: string, isError?: boolean }> {
   const bindings = getAgentNodeBindingRepo().byAgent(agentId).filter(b => b.kind === 'daq')
-  if (bindings.length === 0) {
-    return { text: '你尚未绑定任何数采节点,无权导出采集数据。请在数字孪生界面绑定数采节点。', isError: true }
+  // 与 daq_query/daq_frames 同源:v28 频道绑线只读扩权同样覆盖全量导出
+  const boundLine = channelBoundLineId(agentId)
+  const lineNodes = boundLine
+    ? getDaqNodeRepo().all().filter(n => n.lineId === boundLine).map(n => n.id)
+    : []
+  const allowed = new Set([...bindings.map(b => b.nodeId), ...lineNodes])
+  if (allowed.size === 0) {
+    return { text: '你尚未绑定任何数采节点,频道也未绑定产线,无权导出采集数据。请在数字孪生界面绑定数采节点,或将频道绑定到目标产线(绑线后可只读导出该线数采数据)。', isError: true }
   }
-  const allowed = new Set(bindings.map(b => b.nodeId))
-  // 目标解析:node_ids(可多个)> line_id 过滤 > 全部绑定
-  let targets = bindings.map(b => b.nodeId)
+  // 目标解析:node_ids(可多个)> line_id 过滤 > 全部可见节点
+  let targets = [...allowed]
   const wantedRaw = args.node_ids
   if (wantedRaw != null && String(wantedRaw).trim() !== '') {
     const wanted = (Array.isArray(wantedRaw) ? wantedRaw : String(wantedRaw).split(/[,\s;]+/))
@@ -394,17 +441,30 @@ export async function toolDaqExport(agentId: string, args: {
   if (lineFilter) {
     const onLine = targets.filter(id => getDaqNodeRepo().byId(id)?.lineId === lineFilter)
     if (onLine.length === 0) {
-      return { text: `你绑定的数采节点中没有归属产线 ${lineFilter} 的,无法导出。`, isError: true }
+      return { text: `你的可见数采节点(绑定 ∪ 频道绑线)中没有归属产线 ${lineFilter} 的,无法导出。`, isError: true }
     }
     targets = onLine
   }
   targets = [...new Set(targets)].filter(id => getDaqNodeRepo().byId(id))
+  if (targets.length === 0) {
+    return { text: '没有可导出的节点:指定节点均不存在或已删除。请用 daq_query/mes_catalog 核对在线对象。', isError: true }
+  }
 
   // 时间窗:from/to 优先,否则 last_minutes(缺省 60);护栏 ≤7 天
-  const toMs = Number(args.to_ms) > 0 ? Number(args.to_ms) : Date.now()
-  const fromMs = Number(args.from_ms) > 0
+  const provided = (v: unknown): boolean => v !== undefined && v !== null && String(v).trim() !== ''
+  if (provided(args.to_ms) && (!Number.isFinite(Number(args.to_ms)) || Number(args.to_ms) <= 0)) {
+    return { text: `to_ms 必须是正的 epoch 毫秒(收到 ${String(args.to_ms)})。`, isError: true }
+  }
+  if (provided(args.from_ms) && (!Number.isFinite(Number(args.from_ms)) || Number(args.from_ms) <= 0)) {
+    return { text: `from_ms 必须是正的 epoch 毫秒(收到 ${String(args.from_ms)})。`, isError: true }
+  }
+  if (provided(args.last_minutes) && (!Number.isFinite(Number(args.last_minutes)) || Number(args.last_minutes) <= 0)) {
+    return { text: `last_minutes 必须大于 0(收到 ${String(args.last_minutes)})。`, isError: true }
+  }
+  const toMs = provided(args.to_ms) ? Number(args.to_ms) : Date.now()
+  const fromMs = provided(args.from_ms)
     ? Number(args.from_ms)
-    : toMs - (Number(args.last_minutes) > 0 ? Number(args.last_minutes) : 60) * 60_000
+    : toMs - (provided(args.last_minutes) ? Number(args.last_minutes) : 60) * 60_000
   if (fromMs >= toMs) return { text: 'from_ms 必须小于 to_ms。', isError: true }
   if (toMs - fromMs > MAX_WINDOW_MS) {
     return { text: `时间窗超限(最大 7 天):请缩小窗口(当前 ${(Math.round((toMs - fromMs) / 3600_000) / 10).toFixed(1)} 小时)。`, isError: true }
@@ -428,6 +488,7 @@ export async function toolDaqExport(agentId: string, args: {
       decimals: n.decimals,
       semantics: n.semantics || tpl?.semantics || tpl?.ch || '',
       signalKind: tpl?.signalKind === 'vector' || tpl?.signalKind === 'image' ? tpl.signalKind : 'scalar',
+      ...(tpl?.vector ? { vector: tpl.vector } : {}),
     }
   }
   const lineIds = [...new Set(targets.map(id => getDaqNodeRepo().byId(id)?.lineId ?? '').filter(Boolean))]