agentworkshop 0.7.54 → 0.7.59

package/server/plugins/workshop.ts

@@ -1,230 +1,258 @@
-/**
- * Workshop 启动插件(设计文档 §8)。
- * Nitro 启动时:创建 data/ 目录 → openWorkshopDb(data/workshop.sqlite)→ 装配 5 个 repo
- * + createAgentImpl 工厂 → createAgentChannelManager → restore() 恢复运行时
- * → 为有 lead 的 channel 启动 SchedulerLoop → 挂 globalThis.__workshopManager。
- *
- * 导出:
- *  - getWorkshopManager():读取进程级 manager 单例(先检查已设置;未初始化抛 503)
- *  - ensureLeadSchedulerLoop():为 channel 装配并启动 lead 的 SchedulerLoop(幂等)
- *
- * 注意:不静态 import 'nitropack/runtime/plugin'——defineNitroPlugin 是恒等函数,
- * 插件 default 直接导出普通函数即可,避免把 nitropack 依赖引入可被 tsx 直跑测试
- * 导入的模块图(顶层 node_modules 无 nitropack 符号链接)。
- */
-import { mkdirSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { ensureDataDir } from '@/shared/config/home.mjs'
-import { openWorkshopDb, initWorkshopDb } from '../services/workshop/db/database'
-import { backupRegistry } from '../services/workshop/db/backup-registry'
-import { createChannelRepo } from '../services/workshop/db/channel.repo'
-import { createAgentRepo } from '../services/workshop/db/agent.repo'
-import { createChannelAgentRepo } from '../services/workshop/db/channel-agent.repo'
-import { createTeamRepo } from '../services/workshop/db/team.repo'
-import { createTeamMemberRepo } from '../services/workshop/db/team-member.repo'
-import { createChannelTemplateRepo } from '../services/workshop/db/channel-template.repo'
-import { createTaskRepo } from '../services/workshop/db/task.repo'
-import { createMessageRepo } from '../services/workshop/db/message.repo'
-import { createSubscriptionRepo } from '../services/workshop/db/subscription.repo'
-import { createMemoryRepo } from '../services/workshop/db/memory.repo'
-import { createUserRepo } from '../services/workshop/db/user.repo'
-import { createChannelEventRepo } from '../services/workshop/db/channel-event.repo'
-import { createScheduledTaskRepo } from '../services/workshop/db/scheduled-task.repo'
-import { createChannelMemberRepo } from '../services/workshop/db/channel-member.repo'
-import { createChatMessageRepo } from '../services/workshop/db/chat-message.repo'
-import { createNotificationRepo } from '../services/workshop/db/notification.repo'
-import { createOutboxRepo } from '../services/workshop/db/outbox.repo'
-import { createHitlRequestRepo } from '../services/workshop/db/hitl-request.repo'
-import { createApprovalHistoryRepo, createAlarmEventRepo, createAuditRepo, createApprovalRequestRepo } from '../services/workshop/db/ops.repo'
-import { bindOpsRepos } from '../services/workshop/ops/ops'
-import { configureHitlResolver } from '../services/workshop/agents/hitl-registry'
-import { reconcileHitlOnStartup } from '../services/workshop/agents/hitl-decision'
-import { configureAgentBadgeResolver } from '../services/workshop/agents/agent-badge'
-import { ensureAllEventRecorders } from '../api/workshop/ws'
-import { createAgentImpl } from '../services/workshop/agents/factory'
-import {
-  createAgentChannelManager,
-  type AgentChannelManager,
-  type AllRepos,
-  type ManagerDeps,
-} from '../services/workshop/runtime/manager'
-import { AppError } from '../utils/errors'
-import { workshopSettings } from '../services/workshop/settings'
-import { configureAmlRuntime } from '../services/workshop/aml/runtime'
-import { recoverInterruptedJobs, shutdownOrchestrator } from '../services/workshop/aml/job-orchestrator'
-import { envStatus, startCreateVenv } from '../services/workshop/aml/env-manager'
-import { attachOmpPluginBridge } from '../services/workshop/agents/plugin-tools'
-import { startAmlRetentionTimer, stopAmlRetentionTimer } from '../services/workshop/aml/retention'
-import { configureMesDatasets, defaultDatasetsDir } from '../services/workshop/mes/mes-datasets'
-
-declare global {
-
-  var __workshopManager: AgentChannelManager | undefined
-}
-
-/** 读取进程级 manager 单例(先检查已设置;未初始化抛 503) */
-export function getWorkshopManager(): AgentChannelManager {
-  const manager = globalThis.__workshopManager
-  if (!manager) {
-    throw new AppError(503, 'WORKSHOP_NOT_READY', 'workshop 尚未初始化(plugin 未执行)')
-  }
-  return manager
-}
-
-/**
- * 为 channel 装配并启动 lead 的 SchedulerLoop(幂等)。
- * 委托 manager.ensureChannelActive(懒加载:装配 lead + 调度循环)。
- */
-export function ensureLeadSchedulerLoop(
-  manager: AgentChannelManager,
-  channelId: string,
-  options?: { tickMs?: number, stallMs?: number },
-): void {
-  manager.ensureChannelActive(channelId, options)
-}
-
-/**
- * Nitro 启动插件(默认导出普通函数;defineNitroPlugin 为恒等包装)。
- * 注意:runNitroPlugins 同步调用 plugin,不 await 返回值;manager.restore() 方法体全同步
- * (无 await 语句),直接调用即同步完成恢复,故此处不 await。
- * 幂等:globalThis.__workshopManager 已设置(如测试预置)则跳过初始化。
- */
-export default function workshopPlugin(nitroApp: {
-  hooks: { hook(name: string, fn: (...args: unknown[]) => void | Promise<void>): void }
-}): void {
-  // 进程级未处理拒绝兜底(Node ≥23 默认对 unhandledRejection 抛错可击穿整个服务)。
-  // 环境型连接复位(休眠/断网后陈旧 socket read ECONNRESET、omp 子进程管道抖动等)
-  // 不应让服务崩溃;记录上下文后继续运行(正常业务错误仍走各自显式处理路径)。
-  process.on('unhandledRejection', (reason) => {
-    console.error('[workshop] 未处理 Promise rejection(已兜底,不影响服务):', reason)
-  })
-
-  // 先检查已设置:避免重复装配覆盖既有单例
-  if (globalThis.__workshopManager) return
-
-  // 数据目录经配置根解析（repo: <repo>/.AgentWorkShop/data;home: ~/.AgentWorkShop/data;
-  // ensureDataDir 自动迁移旧 cwd/data 位置,目录不存在则创建）
-  const dataDir = ensureDataDir()
-  mkdirSync(dataDir, { recursive: true })
-
-  // 打开(或创建)数据库 → 初始化(建表 + PRAGMA;openWorkshopDb 已内置,显式再调一次保持幂等)
-  const db = openWorkshopDb(resolve(dataDir, 'workshop.sqlite'))
-  initWorkshopDb(db)
-  // 登记主连接(备份插件 serialize 跑在主连接上,杜绝第二连接失效语句的事故)
-  backupRegistry.register(resolve(dataDir, 'workshop.sqlite'), db)
-
-  // 装配 repos + Agent impl 工厂
-  const repos: AllRepos = {
-    users: createUserRepo(db),
-    channelEvents: createChannelEventRepo(db),
-    channels: createChannelRepo(db),
-    agents: createAgentRepo(db),
-    teams: createTeamRepo(db),
-    teamMembers: createTeamMemberRepo(db),
-    channelTemplates: createChannelTemplateRepo(db),
-    channelAgents: createChannelAgentRepo(db),
-    messages: createMessageRepo(db),
-    subscriptions: createSubscriptionRepo(db),
-    tasks: createTaskRepo(db),
-    memories: createMemoryRepo(db),
-    // v16 定时任务(scheduled_tasks / scheduled_task_runs)
-    schedules: createScheduledTaskRepo(db),
-    // v17 群聊层:成员 / 群聊事实表 / 用户通知 / outbox / HITL 持久化
-    channelMembers: createChannelMemberRepo(db),
-    chatMessages: createChatMessageRepo(db),
-    notifications: createNotificationRepo(db),
-    outbox: createOutboxRepo(db),
-    hitlRequests: createHitlRequestRepo(db),
-  }
-  // S4/S5/R1/R3:合规三表仓储接线(审批历史/报警事件/审计日志/高危复核)
-  bindOpsRepos({
-    approvalHistory: createApprovalHistoryRepo(db),
-    alarmEvents: createAlarmEventRepo(db),
-    audit: createAuditRepo(db),
-    approvalRequests: createApprovalRequestRepo(db),
-  })
-  const deps: ManagerDeps = { repos, implFactory: createAgentImpl, db }
-
-  // AML 自动建模平台:装配仓储 + 中断作业恢复 + GC 定时器(见 services/workshop/aml)
-  configureAmlRuntime(db, dataDir)
-  recoverInterruptedJobs()
-  startAmlRetentionTimer()
-
-  // MES 数据集服务(新表由 SCHEMA_SQL 启动建出;CSV 落 <configRoot>/datasets/<id>.csv)
-  configureMesDatasets(db, defaultDatasetsDir(dataDir))
-
-  // 插件 omp 工具注册桥:启动即接管 pending 队列(此前首次 spawn omp agent 才挂桥,
-  // 全新实例未 spawn 前 kb_agent/diag_run 等插件工具会一直"未知工具")
-  attachOmpPluginBridge()
-
-  // AML 训练环境启动预热(用户规约:启动时检测 uv,有则在运行时目录 <configRoot>/aml/.venv
-  // 直接创建训练环境;异步执行不阻塞启动;失败只记日志,可在「运行环境」面板重试)
-  void (async () => {
-    try {
-      const st = await envStatus()
-      if (!st.venv.ready && (st.uv.ok || st.python.ok)) {
-        console.info(`[aml] 启动预热:${st.uv.ok ? `检测到 uv ${st.uv.version}(来源=${st.uv.source}),` : '未检测到 uv,回退 python -m venv,'}后台创建训练环境(${st.dirs.venv})...`)
-        startCreateVenv()
-      }
-    }
-    catch (err) {
-      console.warn('[aml] 启动预热失败(不阻塞启动):', err instanceof Error ? err.message : err)
-    }
-  })()
-
-  // 创建 manager → 挂全局单例(后续 REST/A2A/WS 经 getWorkshopManager() 读取)
-  const manager = createAgentChannelManager(deps)
-  globalThis.__workshopManager = manager
-
-  // HITL 全局待办:agentId → channelId/agentName 解析器(避免 registry 反向依赖 manager)
-  configureHitlResolver((agentId) => {
-    const row = repos.channelAgents.findById(agentId)
-    return row ? { channelId: row.channelId, agentName: row.name } : null
-  })
-
-  // 运维日志徽标:agentId → 「Channel名/成员名」(Agent 下发/判定/回退入册的操作者展示)
-  configureAgentBadgeResolver((agentId) => {
-    const row = repos.channelAgents.findById(agentId)
-    if (!row) return null
-    const ch = repos.channels.findById(row.channelId)
-    return { name: row.name, channelName: ch?.name ?? row.channelId.slice(0, 8) }
-  })
-
-  // 懒加载恢复:仅激活有待办任务的 channel(装配 lead + 调度循环);其余纯持久化
-  manager.restore()
-
-  // v17 HITL 重启对账(§13.4):把**本进程启动前**的非终态 HITL 条目收敛为 failed,
-  // 绝不自动批准。决策服务首次触碰时也会幂等执行,这里显式调一次让语义更早确定
-  // (重启后立刻查 pending 就能看到确定状态,而不是等下一个人操作才收敛)。
-  // 静态 import:产物是 ESM,运行时没有 require(用 require 会在 .output 下抛 undefined)。
-  try {
-    const { failed } = reconcileHitlOnStartup()
-    if (failed > 0) console.log(`[workshop] HITL 重启对账:${failed} 条非终态待办已标记 failed(不自动批准)`)
-  }
-  catch (err) {
-    console.error('[workshop] HITL 重启对账失败(不影响启动):', err)
-  }
-
-  // v16 定时任务运行时:唯一周期 timer,到期触发 → submitChannelTask 下发
-  manager.startScheduleRuntime()
-
-  // 全时事件录制:为全部存量 channel 建立常驻流(事件 server 驱动落库,与 client 无关)
-  void ensureAllEventRecorders(manager).catch(err => console.error('[workshop] 事件录制器初始化失败:', err))
-
-  // idle sweeper:空闲 agent 超时自动卸载(释放 omp 子进程与内存)。
-  // busy 成员有三重守卫(state!==idle / 信箱 pending / lead 活跃任务)不会被卸载,
-  // "作业期间进程不断开"由守卫保证;空闲宽限可经 workshop.idle_grace_ms 调整 ——
-  // 需要进程更长常驻(免冷启动 30~90s)时调大(env WORKSHOP_IDLE_GRACE_MS 兼容)。
-  const idleSweepMs = workshopSettings().idle_sweep_ms
-  const idleGraceMs = workshopSettings().idle_grace_ms
-  const stopSweeper = manager.startIdleSweeper({ intervalMs: idleSweepMs, graceMs: idleGraceMs })
-
-  // 关机:完整关闭 manager(sweeper + 调度循环 + agent 运行时),关闭数据库
-  nitroApp.hooks.hook('close', async () => {
-    stopAmlRetentionTimer()
-    shutdownOrchestrator()
-    stopSweeper()
-    await manager.shutdown()
-    db.close()
-  })
-}
+/**
+ * Workshop 启动插件(设计文档 §8)。
+ * Nitro 启动时:创建 data/ 目录 → openWorkshopDb(data/workshop.sqlite)→ 装配 5 个 repo
+ * + createAgentImpl 工厂 → createAgentChannelManager → restore() 恢复运行时
+ * → 为有 lead 的 channel 启动 SchedulerLoop → 挂 globalThis.__workshopManager。
+ *
+ * 导出:
+ *  - getWorkshopManager():读取进程级 manager 单例(先检查已设置;未初始化抛 503)
+ *  - ensureLeadSchedulerLoop():为 channel 装配并启动 lead 的 SchedulerLoop(幂等)
+ *
+ * 注意:不静态 import 'nitropack/runtime/plugin'——defineNitroPlugin 是恒等函数,
+ * 插件 default 直接导出普通函数即可,避免把 nitropack 依赖引入可被 tsx 直跑测试
+ * 导入的模块图(顶层 node_modules 无 nitropack 符号链接)。
+ */
+import { mkdirSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { ensureDataDir } from '@/shared/config/home.mjs'
+import { openWorkshopDb, initWorkshopDb } from '../services/workshop/db/database'
+import { backupRegistry } from '../services/workshop/db/backup-registry'
+import { createChannelRepo } from '../services/workshop/db/channel.repo'
+import { createAgentRepo } from '../services/workshop/db/agent.repo'
+import { createChannelAgentRepo } from '../services/workshop/db/channel-agent.repo'
+import { createTeamRepo } from '../services/workshop/db/team.repo'
+import { createTeamMemberRepo } from '../services/workshop/db/team-member.repo'
+import { createChannelTemplateRepo } from '../services/workshop/db/channel-template.repo'
+import { createTaskRepo } from '../services/workshop/db/task.repo'
+import { createMessageRepo } from '../services/workshop/db/message.repo'
+import { createSubscriptionRepo } from '../services/workshop/db/subscription.repo'
+import { createMemoryRepo } from '../services/workshop/db/memory.repo'
+import { createUserRepo } from '../services/workshop/db/user.repo'
+import { createChannelEventRepo } from '../services/workshop/db/channel-event.repo'
+import { createScheduledTaskRepo } from '../services/workshop/db/scheduled-task.repo'
+import { createChannelMemberRepo } from '../services/workshop/db/channel-member.repo'
+import { createChatMessageRepo } from '../services/workshop/db/chat-message.repo'
+import { createNotificationRepo } from '../services/workshop/db/notification.repo'
+import { createOutboxRepo } from '../services/workshop/db/outbox.repo'
+import { createHitlRequestRepo } from '../services/workshop/db/hitl-request.repo'
+import { createApprovalHistoryRepo, createAlarmEventRepo, createAuditRepo, createApprovalRequestRepo } from '../services/workshop/db/ops.repo'
+import { bindOpsRepos } from '../services/workshop/ops/ops'
+import { configureHitlResolver } from '../services/workshop/agents/hitl-registry'
+import { reconcileHitlOnStartup } from '../services/workshop/agents/hitl-decision'
+import { configureAgentBadgeResolver } from '../services/workshop/agents/agent-badge'
+import { ensureAllEventRecorders } from '../api/workshop/ws'
+import { createAgentImpl } from '../services/workshop/agents/factory'
+import {
+  createAgentChannelManager,
+  type AgentChannelManager,
+  type AllRepos,
+  type ManagerDeps,
+} from '../services/workshop/runtime/manager'
+import { AppError } from '../utils/errors'
+import { workshopSettings } from '../services/workshop/settings'
+import { configureAmlRuntime } from '../services/workshop/aml/runtime'
+import { recoverInterruptedJobs, shutdownOrchestrator } from '../services/workshop/aml/job-orchestrator'
+import { envStatus, startCreateVenv } from '../services/workshop/aml/env-manager'
+import { attachOmpPluginBridge } from '../services/workshop/agents/plugin-tools'
+import { startAmlRetentionTimer, stopAmlRetentionTimer } from '../services/workshop/aml/retention'
+import { configureMesDatasets, defaultDatasetsDir } from '../services/workshop/mes/mes-datasets'
+import { configureMesHooks } from '../services/workshop/mes/mes-hook'
+
+declare global {
+
+  var __workshopManager: AgentChannelManager | undefined
+}
+
+/** 读取进程级 manager 单例(先检查已设置;未初始化抛 503) */
+export function getWorkshopManager(): AgentChannelManager {
+  const manager = globalThis.__workshopManager
+  if (!manager) {
+    throw new AppError(503, 'WORKSHOP_NOT_READY', 'workshop 尚未初始化(plugin 未执行)')
+  }
+  return manager
+}
+
+/**
+ * 为 channel 装配并启动 lead 的 SchedulerLoop(幂等)。
+ * 委托 manager.ensureChannelActive(懒加载:装配 lead + 调度循环)。
+ */
+export function ensureLeadSchedulerLoop(
+  manager: AgentChannelManager,
+  channelId: string,
+  options?: { tickMs?: number, stallMs?: number },
+): void {
+  manager.ensureChannelActive(channelId, options)
+}
+
+/**
+ * Nitro 启动插件(默认导出普通函数;defineNitroPlugin 为恒等包装)。
+ * 注意:runNitroPlugins 同步调用 plugin,不 await 返回值;manager.restore() 方法体全同步
+ * (无 await 语句),直接调用即同步完成恢复,故此处不 await。
+ * 幂等:globalThis.__workshopManager 已设置(如测试预置)则跳过初始化。
+ */
+export default function workshopPlugin(nitroApp: {
+  hooks: { hook(name: string, fn: (...args: unknown[]) => void | Promise<void>): void }
+}): void {
+  // 进程级未处理拒绝兜底(Node ≥23 默认对 unhandledRejection 抛错可击穿整个服务)。
+  // 环境型连接复位(休眠/断网后陈旧 socket read ECONNRESET、omp 子进程管道抖动等)
+  // 不应让服务崩溃;记录上下文后继续运行(正常业务错误仍走各自显式处理路径)。
+  process.on('unhandledRejection', (reason) => {
+    console.error('[workshop] 未处理 Promise rejection(已兜底,不影响服务):', reason)
+  })
+
+  // 先检查已设置:避免重复装配覆盖既有单例
+  if (globalThis.__workshopManager) return
+
+  // 数据目录经配置根解析（repo: <repo>/.AgentWorkShop/data;home: ~/.AgentWorkShop/data;
+  // ensureDataDir 自动迁移旧 cwd/data 位置,目录不存在则创建）
+  const dataDir = ensureDataDir()
+  mkdirSync(dataDir, { recursive: true })
+
+  // 打开(或创建)数据库 → 初始化(建表 + PRAGMA;openWorkshopDb 已内置,显式再调一次保持幂等)
+  const db = openWorkshopDb(resolve(dataDir, 'workshop.sqlite'))
+  initWorkshopDb(db)
+  // 登记主连接(备份插件 serialize 跑在主连接上,杜绝第二连接失效语句的事故)
+  backupRegistry.register(resolve(dataDir, 'workshop.sqlite'), db)
+
+  // 装配 repos + Agent impl 工厂
+  const repos: AllRepos = {
+    users: createUserRepo(db),
+    channelEvents: createChannelEventRepo(db),
+    channels: createChannelRepo(db),
+    agents: createAgentRepo(db),
+    teams: createTeamRepo(db),
+    teamMembers: createTeamMemberRepo(db),
+    channelTemplates: createChannelTemplateRepo(db),
+    channelAgents: createChannelAgentRepo(db),
+    messages: createMessageRepo(db),
+    subscriptions: createSubscriptionRepo(db),
+    tasks: createTaskRepo(db),
+    memories: createMemoryRepo(db),
+    // v16 定时任务(scheduled_tasks / scheduled_task_runs)
+    schedules: createScheduledTaskRepo(db),
+    // v17 群聊层:成员 / 群聊事实表 / 用户通知 / outbox / HITL 持久化
+    channelMembers: createChannelMemberRepo(db),
+    chatMessages: createChatMessageRepo(db),
+    notifications: createNotificationRepo(db),
+    outbox: createOutboxRepo(db),
+    hitlRequests: createHitlRequestRepo(db),
+  }
+  // S4/S5/R1/R3:合规三表仓储接线(审批历史/报警事件/审计日志/高危复核)
+  bindOpsRepos({
+    approvalHistory: createApprovalHistoryRepo(db),
+    alarmEvents: createAlarmEventRepo(db),
+    audit: createAuditRepo(db),
+    approvalRequests: createApprovalRequestRepo(db),
+  })
+  const deps: ManagerDeps = { repos, implFactory: createAgentImpl, db }
+
+  // AML 自动建模平台:装配仓储 + 中断作业恢复 + GC 定时器(见 services/workshop/aml)
+  configureAmlRuntime(db, dataDir)
+  recoverInterruptedJobs()
+  startAmlRetentionTimer()
+
+  // MES 数据集服务(新表由 SCHEMA_SQL 启动建出;CSV 落 <configRoot>/datasets/<id>.csv)
+  configureMesDatasets(db, defaultDatasetsDir(dataDir))
+  // MES 数据下沉 hook 运行时(产物落 <configRoot>/data/mes-artifacts/<nodeId>/)
+  configureMesHooks(dataDir)
+
+  // 插件 omp 工具注册桥:启动即接管 pending 队列(此前首次 spawn omp agent 才挂桥,
+  // 全新实例未 spawn 前 kb_agent/diag_run 等插件工具会一直"未知工具")
+  attachOmpPluginBridge()
+
+  // AML 训练环境启动预热(用户规约:启动时检测 uv,有则在运行时目录 <configRoot>/aml/.venv
+  // 直接创建训练环境;异步执行不阻塞启动;失败只记日志,可在「运行环境」面板重试)
+  void (async () => {
+    try {
+      const st = await envStatus()
+      if (!st.venv.ready && (st.uv.ok || st.python.ok)) {
+        console.info(`[aml] 启动预热:${st.uv.ok ? `检测到 uv ${st.uv.version}(来源=${st.uv.source}),` : '未检测到 uv,回退 python -m venv,'}后台创建训练环境(${st.dirs.venv})...`)
+        startCreateVenv()
+      }
+    }
+    catch (err) {
+      console.warn('[aml] 启动预热失败(不阻塞启动):', err instanceof Error ? err.message : err)
+    }
+  })()
+
+  // 创建 manager → 挂全局单例(后续 REST/A2A/WS 经 getWorkshopManager() 读取)
+  const manager = createAgentChannelManager(deps)
+  globalThis.__workshopManager = manager
+
+  // HITL 全局待办:agentId → channelId/agentName 解析器(避免 registry 反向依赖 manager)
+  configureHitlResolver((agentId) => {
+    const row = repos.channelAgents.findById(agentId)
+    return row ? { channelId: row.channelId, agentName: row.name } : null
+  })
+
+  // 运维日志徽标:agentId → 「Channel名/成员名」(Agent 下发/判定/回退入册的操作者展示)
+  configureAgentBadgeResolver((agentId) => {
+    const row = repos.channelAgents.findById(agentId)
+    if (!row) return null
+    const ch = repos.channels.findById(row.channelId)
+    return { name: row.name, channelName: ch?.name ?? row.channelId.slice(0, 8) }
+  })
+
+  // 懒加载恢复:仅激活有待办任务的 channel(装配 lead + 调度循环);其余纯持久化
+  manager.restore()
+
+  // DAQ 采集恢复(时序竞态补挂):daq 插件按 nitro 装配序先于本插件执行,其 boot
+  // startAll 时节点运行时多半尚未从 repo 重建(空集,startAll 空转);本插件此处节点
+  // 已就绪,补一次 startAll(幂等:已在采的节点 rearm,停用节点不受影响)。dev 下
+  // 30s 自动重连循环会掩盖该竞态,生产单次启动必须依赖此处。plugin 为同步函数,
+  // 动态 import 落到 microtask,不阻塞其余启动步骤。
+  // 端口装配必须先于 resumeAll(2026-10-04 实测事故):bindDaqHostPorts 此前只在
+  // daq REST 路由处理时绑定 —— 冷启动无人访问 DAQ 页面时 sweep() 因
+  // getDaqHostPorts()=null 永久空转,开机补挂形同虚设(实测 8min 零采样死窗,
+  // 首次 API 探测才"顺手救活")。启动即装配端口(幂等),把绑定从"有人访问"收窄为"进程存在"。
+  void (async () => {
+    try {
+      const [{ getDaqController }, { bindDaqHost }] = await Promise.all([
+        import('../services/workshop/daq/daq-controller'),
+        import('../services/workshop/daq/host-bindings'),
+      ])
+      const { broadcastSceneEvent } = await import('../services/workshop/scene-events')
+      bindDaqHost(broadcastSceneEvent)
+      const st = getDaqController().resumeAll()
+      console.log(`[workshop] DAQ 采集补挂完成(running=${st.running},宿主端口已装配)`)
+    }
+    catch (err) {
+      console.error('[workshop] DAQ 采集补挂失败(30s 自动重连可恢复):', err instanceof Error ? err.message : err)
+    }
+  })()
+
+  // v17 HITL 重启对账(§13.4):把**本进程启动前**的非终态 HITL 条目收敛为 failed,
+  // 绝不自动批准。决策服务首次触碰时也会幂等执行,这里显式调一次让语义更早确定
+  // (重启后立刻查 pending 就能看到确定状态,而不是等下一个人操作才收敛)。
+  // 静态 import:产物是 ESM,运行时没有 require(用 require 会在 .output 下抛 undefined)。
+  try {
+    const { failed } = reconcileHitlOnStartup()
+    if (failed > 0) console.log(`[workshop] HITL 重启对账:${failed} 条非终态待办已标记 failed(不自动批准)`)
+  }
+  catch (err) {
+    console.error('[workshop] HITL 重启对账失败(不影响启动):', err)
+  }
+
+  // v16 定时任务运行时:唯一周期 timer,到期触发 → submitChannelTask 下发
+  manager.startScheduleRuntime()
+
+  // 全时事件录制:为全部存量 channel 建立常驻流(事件 server 驱动落库,与 client 无关)
+  void ensureAllEventRecorders(manager).catch(err => console.error('[workshop] 事件录制器初始化失败:', err))
+
+  // idle sweeper:空闲 agent 超时自动卸载(释放 omp 子进程与内存)。
+  // busy 成员有三重守卫(state!==idle / 信箱 pending / lead 活跃任务)不会被卸载,
+  // "作业期间进程不断开"由守卫保证;空闲宽限可经 workshop.idle_grace_ms 调整 ——
+  // 需要进程更长常驻(免冷启动 30~90s)时调大(env WORKSHOP_IDLE_GRACE_MS 兼容)。
+  const idleSweepMs = workshopSettings().idle_sweep_ms
+  const idleGraceMs = workshopSettings().idle_grace_ms
+  const stopSweeper = manager.startIdleSweeper({ intervalMs: idleSweepMs, graceMs: idleGraceMs })
+
+  // 关机:完整关闭 manager(sweeper + 调度循环 + agent 运行时),关闭数据库
+  nitroApp.hooks.hook('close', async () => {
+    stopAmlRetentionTimer()
+    shutdownOrchestrator()
+    stopSweeper()
+    await manager.shutdown()
+    db.close()
+  })
+}

package/server/plugins-builtin/diag-bridge/client.mjs

@@ -1,6 +1,7 @@
 /**
  * diag-bridge 客户端面板 —— 注入 'plugins.page' 插槽。
- * 诊断记录表(runId/产线/状态/评分/入库),30s 自动刷新,语言切换即重渲染。
+ * 诊断记录表(runId/产线/状态/评分/入库/报告),30s 自动刷新,语言切换即重渲染;
+ * 已完成诊断可点「报告」在线查看 report md 全文(经 /report 路由代理诊断服务)。
  */
 export function setup(ctx) {
   const styleId = 'aw-diag-styles'
@@ -9,6 +10,7 @@ export function setup(ctx) {
       .aw-diag { display:flex; flex-direction:column; gap:8px; font-size:12px; }
       .aw-diag-toolbar { display:flex; justify-content:flex-end; }
       .aw-diag-btn { padding:4px 12px; border:1px solid color-mix(in srgb, currentColor 28%, transparent); border-radius:7px; background:transparent; color:inherit; cursor:pointer; }
+      .aw-diag-btn:disabled { opacity:.45; cursor:default; }
       .aw-diag-table { width:100%; border-collapse:collapse; }
       .aw-diag-table th, .aw-diag-table td { text-align:left; padding:5px 8px; border-bottom:1px solid color-mix(in srgb, currentColor 10%, transparent); }
       .aw-diag-table th { opacity:.65; font-weight:500; }
@@ -18,6 +20,10 @@ export function setup(ctx) {
       .aw-diag-dot-completed { background:#35e0a0; }
       .aw-diag-dot-failed, .aw-diag-dot-stopped { background:#e05a5a; }
       .aw-diag-empty { opacity:.6; padding:8px 0; }
+      .aw-diag-modal { position:fixed; inset:0; z-index:9999; background:rgba(0,0,0,.55); display:flex; align-items:center; justify-content:center; }
+      .aw-diag-modal-box { width:min(860px, 92vw); max-height:84vh; display:flex; flex-direction:column; gap:8px; background:var(--aw-bg, #101826); color:inherit; border:1px solid color-mix(in srgb, currentColor 22%, transparent); border-radius:12px; padding:14px 16px; }
+      .aw-diag-modal-head { display:flex; align-items:center; justify-content:space-between; gap:12px; font-weight:600; }
+      .aw-diag-report { flex:1; overflow:auto; white-space:pre-wrap; font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size:12px; line-height:1.6; }
     `]))
   }
 
@@ -45,6 +51,36 @@ export function setup(ctx) {
         ])
       }
 
+      // 报告查看:拉 /report 路由,弹层渲染 report md 全文
+      async function showReport(runId, btn) {
+        const modal = ctx.el('div', { class: 'aw-diag-modal' }, [
+          ctx.el('div', { class: 'aw-diag-modal-box' }, [
+            ctx.el('div', { class: 'aw-diag-modal-head' }, [
+              ctx.el('span', {}, [`${t('report')} · ${runId}`]),
+              ctx.el('button', { class: 'aw-diag-btn', onclick: () => modal.remove() }, [t('close')]),
+            ]),
+            ctx.el('div', { class: 'aw-diag-report' }, [t('loading')]),
+          ]),
+        ])
+        modal.addEventListener('click', (e) => {
+          if (e.target === modal) modal.remove()
+        })
+        document.body.append(modal)
+        const box = modal.querySelector('.aw-diag-report')
+        try {
+          const r = await ctx.fetch(`/api/plugins/diag-bridge/report?run_id=${encodeURIComponent(runId)}`)
+          if (!r?.success) throw new Error(r?.error || `HTTP error(${runId})`)
+          const rep = r.report ?? {}
+          box.textContent = typeof rep === 'string' ? rep : String(rep.content ?? JSON.stringify(rep, null, 2))
+        }
+        catch (err) {
+          box.textContent = `${t('report_fail')}: ${err?.message ?? err}`
+        }
+        finally {
+          if (btn) btn.disabled = false
+        }
+      }
+
       async function load() {
         const r = await ctx.fetch('/api/plugins/diag-bridge/runs').catch(() => null)
         const runs = Array.isArray(r?.runs) ? r.runs.slice(0, 8) : []
@@ -58,15 +94,27 @@ export function setup(ctx) {
           ctx.el('th', {}, [t('status')]),
           ctx.el('th', {}, [t('score')]),
           ctx.el('th', {}, [t('stored')]),
+          ctx.el('th', {}, [t('report')]),
         ])
         const tbody = ctx.el('tbody')
         for (const run of runs) {
+          const isDone = String(run.status ?? '') === 'completed'
+          const btn = isDone
+            ? ctx.el('button', {
+                class: 'aw-diag-btn',
+                onclick: () => {
+                  btn.disabled = true
+                  void showReport(String(run.runId), btn)
+                },
+              }, [t('view')])
+            : ctx.el('span', { style: 'opacity:.4' }, ['-'])
           tbody.append(ctx.el('tr', {}, [
             ctx.el('td', { class: 'aw-mono' }, [String(run.runId ?? '-')]),
             ctx.el('td', {}, [String(run.line ?? '-')]),
             ctx.el('td', {}, [statusOf(String(run.status ?? ''))]),
             ctx.el('td', {}, [run.score != null ? String(run.score) : '-']),
             ctx.el('td', {}, [run.stored === true ? t('yes') : t('no')]),
+            ctx.el('td', {}, [btn]),
           ]))
         }
         table.replaceChildren(ctx.el('table', { class: 'aw-diag-table' }, [ctx.el('thead', {}, [thead]), tbody]))