agentworkshop 0.7.54 → 0.7.59

package/server/plugins-builtin/diag-bridge/host/diagnosis.mjs

@@ -6,7 +6,7 @@ import { baseOf, harnessOf, jpost, maxMinutesOf, maxTurnsOf, runKey, runningOfLi
 import { snapshotCore } from './snapshot.mjs'
 import { startingLines } from './constants.mjs'
 
-export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source, dataPath }) {
+export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene, source, dataPath, dataPaths, harness, agentId, channelId }) {
   const base = baseOf(ctx)
   if (!base) return { ok: false, error: 'diag.base_url 非法(仅允许 http/https 且 host 为 127.0.0.1/localhost)。' }
   if (startingLines.has(line)) return { ok: false, error: `产线 ${line} 已有诊断正在启动,请稍后再试。` }
@@ -15,7 +15,7 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
   startingLines.add(line)
   try {
     let snap = { ok: true, csvPath: '', rows: 0, nodes: 0 }
-    if (!dataPath) {
+    if (!dataPath && !(Array.isArray(dataPaths) && dataPaths.length > 0)) {
       snap = await snapshotCore(ctx, line, fromMs, toMs)
       if (!snap.ok) return { ok: false, error: snap.error }
     }
@@ -23,11 +23,15 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
     const sceneName = scene || `${line}_diag`
     // v2.1:统一走 IDD 任务管理面 /api/diagnosis/tasks——接收即返 task_id,
     // 诊断在 IDD 后台线程执行(内部 start+execute),Channel 绝不等待。
+    // v2.2:dataPaths(多文件,manifest 首位)走 IDD multi 模式;harness 可按次覆盖。
+    const payload = Array.isArray(dataPaths) && dataPaths.length > 0
+      ? { dataPaths }
+      : { dataPath: dataPath || snap.csvPath }
     const started = await jpost(ctx, `${base}/api/diagnosis/tasks`, {
-      dataPath: dataPath || snap.csvPath,
+      ...payload,
       sceneName,
       userQuestion: q,
-      harness: harnessOf(ctx), // 缺省落 claude 引擎会因无 key 失败,必须显式(系统配置 plugins.diag-bridge.harness → kv → omp)
+      harness: harness || harnessOf(ctx), // 缺省落 claude 引擎会因无 key 失败,必须显式(系统配置 plugins.diag-bridge.harness → kv → omp;diag_run 可按次覆盖)
       enhancement: 'off',
       reportLanguage: 'zh',
       maxTurns: maxTurnsOf(ctx), // 修复循环会加转数;150 不够走完全管线
@@ -38,9 +42,14 @@ export async function startDiagnosis(ctx, { line, fromMs, toMs, question, scene,
     if (!runId) return { ok: false, error: `tasks 响应缺少 data.task_id: ${short(started)}` }
     ctx.kv.set(runKey(runId), {
       line, fromMs, toMs, question: q, scene: sceneName,
-      status: 'running', createdAt: Date.now(), source, csvPath: snap.csvPath, name,
+      status: 'running', createdAt: Date.now(), source,
+      csvPath: snap.csvPath,
+      files: Array.isArray(dataPaths) ? dataPaths.length : 0,
+      name,
+      // 归因:发起 Agent 完成后的结果回执靠它寻址(平台通告面 deliver)
+      agentId: agentId || '', channelId: channelId || '',
     })
-    return { ok: true, runId, name, csvPath: snap.csvPath, rows: snap.rows, nodes: snap.nodes }
+    return { ok: true, runId, name, csvPath: snap.csvPath, rows: snap.rows, nodes: snap.nodes, files: Array.isArray(dataPaths) ? dataPaths.length : 0 }
   }
   catch (err) {
     return { ok: false, error: `发起诊断失败: ${err?.message ?? err}` }

package/server/plugins-builtin/diag-bridge/host/exports.mjs

@@ -0,0 +1,104 @@
+/**
+ * 数据集上传(da_pin daq-export 数据集 → IDD 多文件分析)
+ *
+ * 平台宿主工具 daq_export 把全量时序落盘到 <dataDir>/daq-exports/<exportId>/
+ * (manifest.json + nodes/<nodeId>.csv)。本模块负责把整份数据集上传到诊断服务
+ * (folder=aw-snapshots/exp-<exportId>),并按 manifest 的节点顺序拼出 dataPaths
+ * (manifest 在首位,IDD 诊断 agent 先读映射与上下文,再逐节点读 CSV)。
+ */
+import { readFile, readdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { authHeadersOf, baseOf, short } from './helpers.mjs'
+
+/** export_id 白名单(路径穿越防护;宿主 daqexp-<ts>-<hex> 格式,兼容旧手填) */
+export function validExportId(id) {
+  return /^[A-Za-z0-9_-]{4,80}$/.test(String(id ?? '').trim())
+}
+
+/** 数据集目录(<dataDir>/daq-exports/<id>;ctx.paths.dataDir 由 SDK 注入) */
+export function exportsRootOf(ctx) {
+  const dataDir = ctx?.paths?.dataDir
+  if (!dataDir) return null
+  return join(dataDir, 'daq-exports')
+}
+
+/** 读取数据集:{ ok, manifest, files:[{ name, abs }] };失败返回 { ok:false, error } */
+export async function readExportDataset(ctx, exportId) {
+  if (!validExportId(exportId)) return { ok: false, error: `export_id 非法(仅允许字母数字_-):${short(exportId)}` }
+  const root = exportsRootOf(ctx)
+  if (!root) return { ok: false, error: '平台数据目录未注入(ctx.paths.dataDir 缺失),无法读取 daq-export 数据集。' }
+  const dir = join(root, String(exportId).trim())
+  let manifest
+  try {
+    manifest = JSON.parse(await readFile(join(dir, 'manifest.json'), 'utf8'))
+  }
+  catch (err) {
+    return { ok: false, error: `数据集 ${exportId} 不存在或 manifest.json 不可读(${err?.message ?? err});先用宿主工具 daq_export 导出。` }
+  }
+  // 收集 CSV:以 manifest.nodes[].file 为准,缺失时回退扫 nodes/ 目录
+  let names = (Array.isArray(manifest?.nodes) ? manifest.nodes : [])
+    .map(n => String(n?.file ?? '')).filter(Boolean)
+  if (names.length === 0) {
+    try {
+      names = (await readdir(join(dir, 'nodes'))).filter(f => f.endsWith('.csv')).map(f => `nodes/${f}`)
+    }
+    catch { names = [] }
+  }
+  const files = [{ name: 'manifest.json', abs: join(dir, 'manifest.json') }]
+  for (const rel of names) files.push({ name: rel.split('/').pop(), abs: join(dir, rel) })
+  return { ok: true, dir, manifest, files }
+}
+
+/** 单次 multipart 最多文件数(IDD /api/files/data/upload max_files=50) */
+const UPLOAD_BATCH = 50
+
+/**
+ * 上传数据集到诊断服务:manifest + 全部节点 CSV → folder aw-snapshots/exp-<id>。
+ * 返回 { ok, dataPaths(manifest 首位), files, manifest };失败 { ok:false, error }。
+ */
+export async function uploadExportDataset(ctx, exportId) {
+  const ds = await readExportDataset(ctx, exportId)
+  if (!ds.ok) return ds
+  const base = baseOf(ctx)
+  if (!base) return { ok: false, error: 'diag.base_url 非法(仅允许 http/https 且 host 为 127.0.0.1/localhost)。' }
+  const folder = `aw-snapshots/exp-${String(exportId).trim()}`
+  const byName = new Map()
+  try {
+    for (let i = 0; i < ds.files.length; i += UPLOAD_BATCH) {
+      const batch = ds.files.slice(i, i + UPLOAD_BATCH)
+      const fd = new FormData()
+      fd.append('folder', folder)
+      for (const f of batch) {
+        const buf = await readFile(f.abs)
+        fd.append('files', new Blob([buf], { type: 'text/plain' }), f.name)
+      }
+      const ac = new AbortController()
+      const timer = setTimeout(() => ac.abort(), 120_000)
+      let body
+      try {
+        const res = await fetch(`${base}/api/files/data/upload`, { method: 'POST', body: fd, signal: ac.signal, headers: authHeadersOf(ctx) })
+        body = await res.json().catch(() => null)
+        if (!res.ok) throw new Error(`HTTP ${res.status} ${short(body)}`)
+        if (!body || body.success !== true) throw new Error(`success!=true ${short(body)}`)
+      }
+      finally {
+        clearTimeout(timer)
+      }
+      for (const entry of (Array.isArray(body?.data) ? body.data : [])) {
+        if (entry?.name && entry?.path) byName.set(String(entry.name), String(entry.path))
+      }
+    }
+  }
+  catch (err) {
+    return { ok: false, error: `数据集上传失败: ${err?.message ?? err}` }
+  }
+  if (!byName.has('manifest.json')) return { ok: false, error: '上传响应缺少 manifest.json 的路径映射。' }
+  // dataPaths:manifest 首位,节点 CSV 按 manifest.nodes 顺序(逐文件名映射,顺序无关上传)
+  const dataPaths = [byName.get('manifest.json')]
+  for (const rel of (Array.isArray(ds.manifest?.nodes) ? ds.manifest.nodes : [])) {
+    const name = String(rel?.file ?? '').split('/').pop()
+    const p = byName.get(name)
+    if (p) dataPaths.push(p)
+  }
+  return { ok: true, dataPaths, files: dataPaths.length, manifest: ds.manifest, folder }
+}

package/server/plugins-builtin/diag-bridge/host/plugin.mjs

@@ -6,12 +6,13 @@ import { AUTO_COOLDOWN_MS, DEFAULT_BASE, MIN } from './constants.mjs'
 import { authHeadersOf, authHint, autoEnabledOf, autoRulesOf, baseOf, diagTokenOf, harnessOf, jget, kvRuns, parseAutoRules, runKey } from './helpers.mjs'
 import { snapshotCore } from './snapshot.mjs'
 import { startDiagnosis } from './diagnosis.mjs'
+import { uploadExportDataset } from './exports.mjs'
 import { sweepOnce } from './sweep.mjs'
 
 export default {
   name: 'diag-bridge',
-  version: '2.1.0',
-  description: '深度诊断桥接 v2.1:异步任务式深度诊断(提交即返 task_id,Channel 免等待);完成后 diag_status 给出报告 md 路径,由 Agent 调 rag-bridge 的 kb_agent 入库知识库(插件协同)。',
+  version: '2.2.0',
+  description: '深度诊断桥接 v2.2:异步任务式深度诊断(提交即返 task_id)+ daq-export 数据集多文件分析(diag_run export_id= 全量时序+manifest)+ 同步等待模式(mode=sync)+ 完成自动回执 Channel(修复发起者身份丢失)+ 报告在线查看。完成后经 rag-bridge kb_agent 入库知识库。',
   auth: 'user',
   client: './client.mjs', // 前端面板(插件页注入;i18n 见 i18n.json)
   // 插件配置分组(声明式):连接 / 执行 / 自动化 三个独立分区
@@ -94,40 +95,109 @@ export default {
     ctx.omp.registerTool({
       name: 'diag_run',
       label: '深度诊断',
-      description: '导出产线指定时窗的 DAQ 快照 CSV 并发起深度根因诊断(异步任务,提交即返 task_id,无需等待)。Channel 可继续其他任务,空闲时用 diag_status 查询;完成后按其给出的指引调 kb_agent 入库知识库。',
+      description: '发起深度根因诊断(异步任务,提交即返 task_id,无需等待)。三种数据来源:① line+时间窗:导出产线 DAQ 快照 CSV;② data_path:诊断服务内已有数据文件;③ export_id(推荐):上传宿主工具 daq_export 导出的数据集(manifest 节点映射 + 全量原始时序多文件)。Channel 可继续其他任务;完成后平台自动把结果回执到本频道,空闲时也可 diag_status 查询;mode=sync 可同步等待完成。',
       parameters: {
         type: 'object',
         properties: {
-          line: { type: 'string', description: '产线 id(与 data_path 二选一)' },
-          data_path: { type: 'string', description: '可选:直接指定诊断数据 CSV 绝对路径(跳过 DAQ 快照导出,适合离线数据分析);给了 data_path 则 line 可填 any' },
-          from_ms: { type: 'number', description: '窗口起点(epoch 毫秒;缺省 now-60min)' },
-          to_ms: { type: 'number', description: '窗口终点(epoch 毫秒;缺省 now)' },
-          question: { type: 'string', description: '诊断问题(缺省为该产线时窗数据深度根因诊断)' },
-          scene: { type: 'string', description: '场景名(缺省 <line>_diag)' },
+          line: { type: 'string', description: '产线 id(与 data_path/export_id 三选一;export/data_path 模式可填 any)' },
+          export_id: { type: 'string', description: 'daq_export 返回的数据集 id(daqexp-…):上传 manifest+全部节点全量时序 CSV 做多文件深度分析' },
+          data_path: { type: 'string', description: '可选:诊断服务内数据文件相对路径(如 data/aw-snapshots/x.csv;跳过快照导出,适合离线数据分析)' },
+          from_ms: { type: 'number', description: '窗口起点(epoch 毫秒;仅 line 模式;缺省 now-60min)' },
+          to_ms: { type: 'number', description: '窗口终点(epoch 毫秒;仅 line 模式;缺省 now)' },
+          question: { type: 'string', description: '诊断问题(缺省按数据来源自动组题;export 模式自动携带 manifest 场景备注)' },
+          scene: { type: 'string', description: '场景名(缺省 <line>_diag);场景为自由标签,诊断管线按数据特征自适应' },
+          mode: { type: 'string', enum: ['async', 'sync'], description: 'async(缺省)=提交即返后台跑;sync=同步等待完成(最长 sync_timeout_s,超时自动转后台继续)' },
+          sync_timeout_s: { type: 'number', description: 'sync 模式等待上限秒(缺省 240,上限 540)' },
+          harness: { type: 'string', description: '诊断引擎按次覆盖(omp/claude/mock;缺省用插件设置)' },
         },
-        required: ['line'],
+        required: [],
       },
       roles: ['lead', 'worker'],
-      handler: async (args) => {
+      handler: async (args, agent) => {
         try {
           const line = String(args.line ?? '').trim()
           const dataPathDirect = String(args.data_path ?? '').trim()
-          if (!line && !dataPathDirect) return { text: 'line 与 data_path 至少给一个(产线 id 或诊断数据 CSV 绝对路径)。', isError: true }
+          const exportId = String(args.export_id ?? '').trim()
+          if (!line && !dataPathDirect && !exportId) return { text: 'line / data_path / export_id 至少给一个。', isError: true }
           const toMs = Number(args.to_ms) > 0 ? Number(args.to_ms) : Date.now()
           const fromMs = Number(args.from_ms) > 0 ? Number(args.from_ms) : toMs - 60 * MIN
           if (fromMs >= toMs) return { text: 'from_ms 必须小于 to_ms。', isError: true }
+
+          // 数据集模式:上传 manifest + 全部节点 CSV(manifest 首位,IDD multi 模式)
+          let dataPaths
+          let via = ''
+          let manifest = null
+          if (exportId) {
+            const up = await uploadExportDataset(ctx, exportId)
+            if (!up.ok) return { text: up.error, isError: true }
+            dataPaths = up.dataPaths
+            manifest = up.manifest
+            const nodeCount = Array.isArray(manifest?.nodes) ? manifest.nodes.length : dataPaths.length - 1
+            const win = manifest?.window ? `窗口 ${String(manifest.window.from ?? '').slice(0, 16)} ~ ${String(manifest.window.to ?? '').slice(0, 16)}` : ''
+            via = `数据集 ${up.folder}(${nodeCount} 节点全量时序 + manifest,${win})`
+          }
+
+          // 问题缺省:按数据来源自动组题(export 模式带产线与场景备注)
+          let question = args.question ? String(args.question) : ''
+          if (!question) {
+            if (manifest) {
+              const lineNames = (Array.isArray(manifest.lines) ? manifest.lines : []).map(l => l?.lineName || l?.lineId).filter(Boolean).join('、') || line || 'offline'
+              const note = manifest.note ? `;场景备注:${String(manifest.note).slice(0, 200)}` : ''
+              question = `${lineNames} 产线数据集深度根因诊断(${via})${note}`
+            }
+            else {
+              question = `${line || 'offline-data'} 产线该时窗数据深度根因诊断`
+            }
+          }
           const r = await startDiagnosis(ctx, {
             line: line || 'offline-data',
             fromMs, toMs,
-            question: args.question ? String(args.question) : '',
+            question,
             scene: args.scene ? String(args.scene) : '',
             source: 'agent',
-            dataPath: dataPathDirect || '',
+            dataPath: dataPathDirect || undefined,
+            dataPaths,
+            harness: args.harness ? String(args.harness) : undefined,
+            // 归因(分发层注入的调用方上下文):诊断完成后平台据此把结果回执给发起 Agent
+            agentId: agent?.agentId ?? '',
+            channelId: agent?.channelId ?? '',
           })
           if (!r.ok) return { text: r.error, isError: true }
-          const via = dataPathDirect ? `离线数据 ${r.csvPath}` : `产线 ${line} 窗口 ${new Date(fromMs).toISOString()} ~ ${new Date(toMs).toISOString()} 快照 ${r.rows} 行 × ${r.nodes} 节点`
+          if (!via) via = dataPathDirect ? `离线数据 ${r.csvPath}` : `产线 ${line} 窗口 ${new Date(fromMs).toISOString()} ~ ${new Date(toMs).toISOString()} 快照 ${r.rows} 行 × ${r.nodes} 节点`
+
+          // 同步模式:轮询到终态或超时(超时自动转后台,sweep 完成仍会回执)
+          if (String(args.mode ?? '').toLowerCase() === 'sync') {
+            const base = baseOf(ctx)
+            const timeoutS = Math.min(Math.max(Number(args.sync_timeout_s) || 240, 10), 540)
+            if (base) {
+              const deadline = Date.now() + timeoutS * 1000
+              while (Date.now() < deadline) {
+                await new Promise(resolve => setTimeout(resolve, 5000))
+                let st = null
+                try {
+                  st = (await jget(ctx, `${base}/api/diagnosis/tasks/${encodeURIComponent(r.runId)}`, 8000)).data ?? null
+                }
+                catch { /* 单次轮询失败继续等 */ }
+                const status = String(st?.status ?? 'running')
+                if (status === 'completed') {
+                  // 已同步拿到结果,认领回执防 sweep 补送重复
+                  try {
+                    const notify = await ctx.services.get('notify')
+                    await notify?.claim?.('diag_run', r.runId)
+                  }
+                  catch { /* 未接线时忽略 */ }
+                  const rep = st?.result?.report_md_path ?? '-'
+                  return { text: `✅ 同步诊断完成 task_id=${r.runId}(${via})\n评分=${st?.result?.score ?? '-'} 结论=${st?.result?.verdict ?? '-'}\nreport_md_path=${rep}\n总结:${String(st?.result?.summary ?? '').slice(0, 800)}\n\n入库知识库:调用 rag-bridge 的 kb_agent(mode=async,prompt=「请把这份深度诊断报告入库到 aw-industrial 知识库:读取文件 ${rep} 的全文内容并入库,完成后报告 doc_path 与分块数。标签:诊断、深度诊断。」),完成后 kb_agent_status(task_id) 查询。` }
+                }
+                if (status === 'failed' || status === 'stopped') {
+                  return { text: `诊断 ${r.runId} 以 ${status} 结束:${st?.result?.error ?? '详见 diag_status'}`, isError: true }
+                }
+              }
+              return { text: `已发起深度诊断 task_id=${r.runId}(${via})。同步等待 ${timeoutS}s 超时,诊断仍在后台运行——完成后平台会自动把结果回执到你的信箱并唤醒你;也可 diag_status(run_id=${r.runId}) 主动查询。` }
+            }
+          }
           return {
-            text: `已发起深度诊断异步任务 task_id=${r.runId}(${via})。知识库 IDD 在后台执行,Channel 无需等待——可继续其他任务,空闲时用 diag_status(run_id=${r.runId}) 查询;完成后按 diag_status 给出的指引调用 kb_agent 把报告 md 入库知识库。`,
+            text: `已发起深度诊断异步任务 task_id=${r.runId}(${via})。知识库 IDD 在后台执行,Channel 无需等待——可继续其他任务;完成后平台会自动把结果回执到你的信箱并唤醒你(空闲时也可用 diag_status(run_id=${r.runId}) 主动查询;完成后按指引调 kb_agent 入库知识库)。`,
           }
         }
         catch (err) {
@@ -182,6 +252,11 @@ export default {
           }
           if (!st && !meta) return { text: `诊断 ${id} 不存在或诊断服务不可达。`, isError: true }
           const status = st?.engineStatus || st?.status || meta?.status || 'unknown'
+          // 终态经轮询面亲自看到 → 认领结果所有权,取消平台的事后补送(先到先得)
+          if (['completed', 'failed', 'stopped'].includes(status)) {
+            const notify = await ctx.services.get('notify').catch(() => null)
+            notify?.claim?.('diag_run', id)
+          }
           const parts = [
             `run_id=${id}`,
             `name=${st?.name ?? meta?.name ?? '?'}`,
@@ -298,6 +373,34 @@ export default {
       }
     })
 
-    ctx.logger.info('diag-bridge 就绪:工具 diag_run/diag_status + 路由 health/runs/snapshot,轮询 15s 已启动')
+    // 报告查看(面板/前端):run_id → 诊断任务 → workspace run 目录 → report md 内容
+    ctx.route('GET', '/report', async (event) => {
+      try {
+        const u = new URL(String(event?.path ?? event?.node?.req?.url ?? ''), 'http://local')
+        const runId = String(u.searchParams.get('run_id') ?? '').trim()
+        if (!runId) return { success: false, error: 'run_id 必填' }
+        const base = baseOf(ctx)
+        if (!base) return { success: false, error: 'diag.base_url 非法' }
+        const st = (await jget(ctx, `${base}/api/diagnosis/tasks/${encodeURIComponent(runId)}`, 8000)).data ?? {}
+        if (String(st.status ?? '') !== 'completed') {
+          return { success: false, error: `诊断 ${runId} 状态 ${st.status ?? 'unknown'},报告未就绪` }
+        }
+        const ws = (await jget(ctx, `${base}/api/files/workspace`, 8000)).data ?? []
+        const names = (Array.isArray(ws) ? ws : [])
+        const meta = ctx.kv.get(runKey(runId)) ?? {}
+        // 目录命名不统一(<ts>_<scene> 或 <ts>_<scene>_<runId>):runId → scene → 最新 逐级兜底
+        const hit = names.find(e => String(e?.name ?? '').includes(runId))
+          ?? names.find(e => meta?.scene && String(e?.name ?? '').toLowerCase().includes(String(meta.scene).toLowerCase()))
+          ?? (names.length ? names.slice().sort((a, b) => Number(b?.created ?? 0) - Number(a?.created ?? 0))[0] : null)
+        if (!hit) return { success: false, error: `诊断服务 workspace 未找到 ${runId} 的运行目录` }
+        const rep = (await jget(ctx, `${base}/api/files/workspace/report/${encodeURIComponent(hit.name)}`, 15000)).data
+        return { success: true, run_id: runId, run_name: hit.name, report: rep ?? null }
+      }
+      catch (err) {
+        return { success: false, error: String(err?.message ?? err) }
+      }
+    })
+
+    ctx.logger.info('diag-bridge 就绪:工具 diag_run/diag_status + 路由 health/runs/snapshot/report,轮询 15s 已启动')
   },
 }

package/server/plugins-builtin/diag-bridge/host/sweep.mjs

@@ -4,6 +4,16 @@
  */
 import { baseOf, jget, kvRuns, runKey } from './helpers.mjs'
 
+/** 平台通告面(异步结果回执):懒取,未接线/平台未就绪时 null(回执降级为日志,行为同旧版) */
+async function notifyOf(ctx) {
+  try {
+    return await ctx.services.get('notify')
+  }
+  catch {
+    return null
+  }
+}
+
 export async function sweepOnce(ctx) {
   const running = kvRuns(ctx).filter(r => r.meta?.status === 'running')
   if (!running.length) return
@@ -12,6 +22,7 @@ export async function sweepOnce(ctx) {
     ctx.logger.warn('diag.base_url 非法,本轮跳过诊断轮询')
     return
   }
+  const notify = await notifyOf(ctx)
   for (const { id, meta } of running) {
     try {
       const st = (await jget(ctx, `${base}/api/diagnosis/status/${encodeURIComponent(id)}`, 8000)).data ?? {}
@@ -27,6 +38,28 @@ export async function sweepOnce(ctx) {
           reportPath: st.report_path ?? null,
         })
         ctx.logger.info(`诊断 ${id}(产线 ${meta.line})完成——待 Channel 空闲时 diag_status 查询,经 kb_agent 入库知识库`)
+        // 异步结果回执:发起 Agent 不必轮询,完成后平台投递信箱消息并即时唤醒;
+        // claim 先到先得(Agent 已用 diag_status 看到则不再补送)
+        if (meta.agentId) {
+          const reportPath = st.report_path ?? null
+          notify?.deliver({
+            kind: 'tool-result',
+            tool: 'diag_run',
+            jobId: id,
+            agentId: meta.agentId,
+            ...(meta.channelId ? { channelId: meta.channelId } : {}),
+            ok: true,
+            title: `深度诊断完成(产线 ${meta.line})`,
+            summary: [
+              st.score != null ? `评分=${st.score}` : '',
+              st.judge_verdict ? `结论=${st.judge_verdict}` : '',
+              reportPath ? `report_md_path=${reportPath}` : '',
+              reportPath
+                ? '入库知识库:调用 rag-bridge 的 kb_agent(mode=async)读取该报告文件全文入库(标签:诊断、深度诊断),完成后用 kb_agent_status 查询入库结果。'
+                : '报告路径未就绪,可用 diag_status(run_id=' + id + ') 查询详情。',
+            ].filter(Boolean).join(';'),
+          })
+        }
       }
       else if (status === 'failed' || status === 'stopped') {
         ctx.kv.set(runKey(id), {
@@ -37,6 +70,20 @@ export async function sweepOnce(ctx) {
           error: st.error_message ?? null,
         })
         ctx.logger.warn(`诊断 ${id}(产线 ${meta.line})结束: ${status}${st.error_message ? `(${st.error_message})` : ''}`)
+        if (meta.agentId) {
+          notify?.deliver({
+            kind: 'tool-result',
+            tool: 'diag_run',
+            jobId: id,
+            agentId: meta.agentId,
+            ...(meta.channelId ? { channelId: meta.channelId } : {}),
+            ok: false,
+            title: `深度诊断${status === 'stopped' ? '已停止' : '失败'}(产线 ${meta.line})`,
+            summary: st.error_message
+              ? `原因:${st.error_message}`
+              : `诊断以 ${status} 结束;可用 diag_status(run_id=${id}) 查询详情。`,
+          })
+        }
       }
       else if (status !== meta.status) {
         ctx.kv.set(runKey(id), { ...meta, status, name: st.name ?? meta.name })

package/server/plugins-builtin/diag-bridge/i18n.json

@@ -1,72 +1,82 @@
-{
-  "zh-CN": {
-    "settings": {
-      "base_url": "诊断服务地址",
-      "token": "诊断 API Token",
-      "harness": "诊断引擎",
-      "max_turns": "诊断最大轮数",
-      "max_minutes": "诊断超时(分钟)",
-      "auto_enabled": "自动诊断",
-      "auto_rules": "自动诊断规则"
-    },
-    "group": {
-      "conn": "诊断服务连接",
-      "run": "诊断执行参数",
-      "auto": "自动诊断",
-      "rules": "自动诊断规则"
-    },
-    "panel": {
-      "title": "深度诊断(industrial-deep-diagnostic)",
-      "runs": "诊断记录",
-      "none": "暂无诊断记录;Agent 经 diag_run 工具发起",
-      "run": "Run",
-      "line": "产线",
-      "status": "状态",
-      "score": "评分",
-      "stored": "入库",
-      "refresh": "刷新",
-      "st_running": "运行中",
-      "st_completed": "已完成",
-      "st_failed": "失败",
-      "st_stopped": "已停止",
-      "st_other": "其他",
-      "yes": "是",
-      "no": "否"
-    }
-  },
-  "en": {
-    "settings": {
-      "base_url": "Diagnosis service URL",
-      "token": "Diagnosis API token",
-      "harness": "Diagnosis harness",
-      "max_turns": "Max turns",
-      "max_minutes": "Timeout (minutes)",
-      "auto_enabled": "Auto diagnosis",
-      "auto_rules": "Auto diagnosis rules"
-    },
-    "group": {
-      "conn": "Diagnosis service connection",
-      "run": "Diagnosis run parameters",
-      "auto": "Auto diagnosis",
-      "rules": "Auto diagnosis rules"
-    },
-    "panel": {
-      "title": "Deep diagnosis (industrial-deep-diagnostic)",
-      "runs": "Diagnosis runs",
-      "none": "No runs yet; agents start one via the diag_run tool",
-      "run": "Run",
-      "line": "Line",
-      "status": "Status",
-      "score": "Score",
-      "stored": "Stored",
-      "refresh": "Refresh",
-      "st_running": "Running",
-      "st_completed": "Completed",
-      "st_failed": "Failed",
-      "st_stopped": "Stopped",
-      "st_other": "Other",
-      "yes": "Yes",
-      "no": "No"
-    }
-  }
-}
+{
+  "zh-CN": {
+    "settings": {
+      "base_url": "诊断服务地址",
+      "token": "诊断 API Token",
+      "harness": "诊断引擎",
+      "max_turns": "诊断最大轮数",
+      "max_minutes": "诊断超时(分钟)",
+      "auto_enabled": "自动诊断",
+      "auto_rules": "自动诊断规则"
+    },
+    "group": {
+      "conn": "诊断服务连接",
+      "run": "诊断执行参数",
+      "auto": "自动诊断",
+      "rules": "自动诊断规则"
+    },
+    "panel": {
+      "title": "深度诊断(industrial-deep-diagnostic)",
+      "runs": "诊断记录",
+      "none": "暂无诊断记录;Agent 经 diag_run 工具发起",
+      "run": "Run",
+      "line": "产线",
+      "status": "状态",
+      "score": "评分",
+      "stored": "入库",
+      "refresh": "刷新",
+      "st_running": "运行中",
+      "st_completed": "已完成",
+      "st_failed": "失败",
+      "st_stopped": "已停止",
+      "st_other": "其他",
+      "yes": "是",
+      "no": "否",
+      "report": "报告",
+      "view": "查看",
+      "close": "关闭",
+      "loading": "加载中…",
+      "report_fail": "报告获取失败"
+    }
+  },
+  "en": {
+    "settings": {
+      "base_url": "Diagnosis service URL",
+      "token": "Diagnosis API token",
+      "harness": "Diagnosis harness",
+      "max_turns": "Max turns",
+      "max_minutes": "Timeout (minutes)",
+      "auto_enabled": "Auto diagnosis",
+      "auto_rules": "Auto diagnosis rules"
+    },
+    "group": {
+      "conn": "Diagnosis service connection",
+      "run": "Diagnosis run parameters",
+      "auto": "Auto diagnosis",
+      "rules": "Auto diagnosis rules"
+    },
+    "panel": {
+      "title": "Deep diagnosis (industrial-deep-diagnostic)",
+      "runs": "Diagnosis runs",
+      "none": "No runs yet; agents start one via the diag_run tool",
+      "run": "Run",
+      "line": "Line",
+      "status": "Status",
+      "score": "Score",
+      "stored": "Stored",
+      "refresh": "Refresh",
+      "st_running": "Running",
+      "st_completed": "Completed",
+      "st_failed": "Failed",
+      "st_stopped": "Stopped",
+      "st_other": "Other",
+      "yes": "Yes",
+      "no": "No",
+      "report": "Report",
+      "view": "View",
+      "close": "Close",
+      "loading": "Loading…",
+      "report_fail": "Failed to load report"
+    }
+  }
+}