agentworkshop 0.7.44 → 0.7.47

package/server/services/workshop/dcw/recipe-rollback-manager/sweep.ts

@@ -0,0 +1,77 @@
+/**
+ * RecipeRollBackManagerSweep —— 系统兜底评估(按 sweep 节拍)
+ * (拆分层,承 RecipeRollBackManagerRollback;方法体与原文件逐行一致)
+ */
+import { RecipeRollBackManagerRollback } from './rollback'
+import type { OptimizationRecord } from '../../../../../shared/dcw-protocol'
+import { BREACH_THRESHOLD, MAX_AUTO_ROLLBACKS, MIN_WINDOW_MS, RECHECK_MS } from './helpers'
+import { recordOps } from '../../ops/ops'
+
+export abstract class RecipeRollBackManagerSweep extends RecipeRollBackManagerRollback {
+  evaluateOpenRecords(now: number): void {
+    // 走 open 索引(O(open))而非 listRecords 的「全量倒序 + limit 500」:
+    // 后者在 open 记录 >500 时会**静默漏评估**,且每次 sweep 都对全量 records 做一次拷贝。
+    for (const record of this.repo.listOpenRecords()) {
+      if (record.policy === 'observe_only')
+        continue
+      const setMs = Date.parse(record.setAt)
+      if (now - setMs < MIN_WINDOW_MS())
+        continue
+      if (record.evaluatedAt && now - Date.parse(record.evaluatedAt) < RECHECK_MS)
+        continue
+      record.evaluatedAt = new Date(now).toISOString()
+      void this.evaluateOnce(record)
+    }
+  }
+
+  protected async evaluateOnce(record: OptimizationRecord): Promise<void> {
+    try {
+      const from = Date.parse(record.setAt)
+      const agg = await this.captureMetrics(record.nodeId, record.lineId, record.recipeId, from, Date.now())
+      const totalBreaches = agg.channels.reduce((sum, c) => sum + Math.max(0, c.breaches), 0)
+      if (totalBreaches < BREACH_THRESHOLD) {
+        this.repo.updateRecord(record.id, { evaluatedAt: record.evaluatedAt, windowAgg: record.windowAgg ?? agg })
+        return
+      }
+      const reason = `观察窗内数采越配方监控窗累计 ${totalBreaches} 采样(阈值 ${BREACH_THRESHOLD}),系统兜底判定回退`
+      if (record.policy === 'auto_rollback' && this.repo.chainRollbackCount(record.nodeId) < MAX_AUTO_ROLLBACKS) {
+        record.judge = { by: 'system', actor: 'system', verdict: 'rollback', reason, at: new Date().toISOString() }
+        this.repo.updateRecord(record.id, { judge: record.judge, evaluatedAt: record.evaluatedAt })
+        this.emit('judged', record)
+        recordOps({
+          actor: 'system',
+          actorName: 'system',
+          actorKind: 'system',
+          action: 'optimization.judge',
+          kind: 'rollback',
+          targetKind: 'optimization',
+          targetId: record.id,
+          summary: `系统兜底判定回退:窗口内累计越限 ${totalBreaches} 采样,自动恢复基线`,
+          lineId: record.lineId ?? '',
+          recipeId: record.recipeId ?? '',
+          detail: { breaches: totalBreaches, policy: record.policy },
+        })
+        await this.rollbackRecord(record.id, 'system', 'system')
+      }
+      else {
+        // approve_rollback 或自动回退链达上限:提议人工确认(判定入册,执行等 REST/工具)
+        record.judge = {
+          by: 'system',
+          actor: 'system',
+          verdict: 'rollback',
+          reason: `${reason};${record.policy === 'approve_rollback' ? '等待人工确认' : '自动回退链达上限,升级人工'}`,
+          at: new Date().toISOString(),
+        }
+        this.repo.updateRecord(record.id, { judge: record.judge, evaluatedAt: record.evaluatedAt })
+        this.emit('judged', record)
+      }
+    }
+    catch (err) {
+      console.error('[recipe-rollback] 兜底评估失败:', record.id, err)
+    }
+  }
+
+  // ================================================================
+  // 数据面:窗口聚合 / 台账 / 序列(全部复用 lineQuery 参数化查询)
+  // ================================================================
+}

package/server/services/workshop/dcw/recipe-rollback-manager/types.ts

@@ -0,0 +1,3 @@
+/**
+ * RecipeRollBackManager 的依赖类型与对外 DTO(原 server/services/workshop/dcw/recipe-rollback-manager.ts 顶部模块级类型声明)。纯类型。
+ */

package/server/services/workshop/dcw/recipe-rollback-manager/views.ts

@@ -0,0 +1,214 @@
+/**
+ * RecipeRollBackManagerViews —— 数据面:窗口聚合 / 台账 / 序列
+ * (拆分层,承 RecipeRollBackManagerSweep;方法体与原文件逐行一致)
+ */
+import { RecipeRollBackManagerSweep } from './sweep'
+import type { DcwJournalAnchor, OptimizationChannelMetrics, OptimizationMetrics, OptimizationRecord, OptimizationVerdict } from '../../../../../shared/dcw-protocol'
+import { AppError, ErrorCodes } from '../../../../utils/errors'
+import { clampMs } from './helpers'
+import { getActiveLineRun } from '../line-run'
+import { getDaqNodeRepo } from '../../daq/daq-node.repo'
+import { getDcwNodeRepo } from '../dcw-node.repo'
+import { getDcwRecipeRepo } from '../dcw-recipe.repo'
+
+export abstract class RecipeRollBackManagerViews extends RecipeRollBackManagerSweep {
+  /** 通道选择:同设备绑定优先,无则同产线(AC1.6 口径) */
+  protected selectDaqChannels(dcwNodeId: string, lineId: string) {
+    const all = getDaqNodeRepo().all()
+    const node = getDcwNodeRepo().byId(dcwNodeId)
+    if (node?.deviceBindingId) {
+      const sameDev = all.filter(d => d.deviceBindingId === node.deviceBindingId)
+      if (sameDev.length > 0)
+        return sameDev
+    }
+    if (lineId)
+      return all.filter(d => d.lineId === lineId)
+    return []
+  }
+
+  /** 经 lineQuery(queryTagged)拉窗口内逐通道序列;聚合 + 越窗计数在本方法内纯计算 */
+  protected async captureMetrics(nodeId: string, lineId: string, recipeId: string | null | undefined, fromMs: number, toMs: number): Promise<OptimizationMetrics> {
+    const daqNodes = this.selectDaqChannels(nodeId, lineId)
+    const channels: OptimizationChannelMetrics[] = daqNodes.map(d => ({
+      daqNodeId: d.id,
+      ch: d.templateKey ?? d.id,
+      unit: d.unit ?? '',
+      latest: null,
+      avg: null,
+      min: null,
+      max: null,
+      cnt: 0,
+      breaches: -1,
+    }))
+    if (daqNodes.length === 0)
+      return { at: new Date().toISOString(), fromMs, toMs, channels, degraded: true }
+    const { getDcwController } = await import('../dcw-controller')
+    const span = toMs - fromMs
+    const bucketMs = clampMs(span > 60_000 ? Math.max(1000, Math.round(span / 200)) : undefined)
+    const result = await getDcwController().lineQuery({
+      lineId: lineId || undefined,
+      nodeId: daqNodes.map(d => d.id).join(','),
+      fromMs,
+      toMs,
+      bucketMs,
+      limit: 800,
+    })
+    const byId = new Map(result.channels.map(c => [c.nodeId, c]))
+    const recipe = recipeId ? getDcwRecipeRepo().byId(recipeId) : undefined
+    for (const ch of channels) {
+      const series = byId.get(ch.daqNodeId)
+      if (!series || series.points.length === 0)
+        continue
+      const values: number[] = []
+      for (const p of series.points) {
+        const v = p.value ?? p.avg
+        if (v == null || !Number.isFinite(v))
+          continue
+        values.push(v)
+      }
+      const win = recipe?.daqWindows?.find(w => w.nodeId === ch.daqNodeId)
+      // 「有窗口且设了边界」才计越界:原实现用 breaches=-1 + 循环首拍 break 短路,
+      // 等价于整段跳过(循环体在 -1 时没有任何副作用)。把这条不变量显式上移,
+      // win 在循环内即可被收窄(不再需要断言/非空断言)。
+      const windowed = win != null && (win.min != null || win.max != null)
+      let breaches = windowed ? 0 : -1
+      if (win && windowed) {
+        for (const v of values) {
+          if ((win.min != null && v < win.min) || (win.max != null && v > win.max))
+            breaches++
+        }
+      }
+      ch.latest = values.length ? values[values.length - 1]! : null
+      ch.avg = values.length ? Number((values.reduce((a, b) => a + b, 0) / values.length).toFixed(2)) : null
+      ch.min = values.length ? Number(Math.min(...values).toFixed(2)) : null
+      ch.max = values.length ? Number(Math.max(...values).toFixed(2)) : null
+      ch.cnt = values.length
+      ch.breaches = breaches
+    }
+    return { at: new Date().toISOString(), fromMs, toMs, channels }
+  }
+
+  /** 关闭记录(同步)+ 异步补窗口聚合(F2) */
+  protected closeRecord(record: OptimizationRecord, closedBy: NonNullable<OptimizationRecord['closedBy']>, judge?: OptimizationRecord['judge']): void {
+    if (record.status !== 'open')
+      return
+    record.closedAt = new Date().toISOString()
+    record.closedBy = closedBy
+    if (judge)
+      record.judge = judge
+    record.status = closedBy === 'superseded-manual'
+      ? 'superseded-manual'
+      : closedBy === 'superseded'
+        ? 'superseded'
+        : closedBy === 'line-stop' ? 'closed-line-stop' : record.status
+    record.aggPending = true
+    this.repo.updateRecord(record.id, { closedAt: record.closedAt, closedBy: record.closedBy, status: record.status, judge: record.judge, aggPending: true })
+    void this.fillMetrics(record, 'windowAgg', Date.parse(record.setAt), Date.parse(record.closedAt))
+  }
+
+  /** 异步聚合回填(baseline / windowAgg 共用;防重入) */
+  protected async fillMetrics(record: OptimizationRecord, slot: 'baseline' | 'windowAgg', fromMs: number, toMs: number): Promise<void> {
+    const key = `${record.id}:${slot}`
+    if (this.capturing.has(key))
+      return
+    this.capturing.add(key)
+    try {
+      const agg = await this.captureMetrics(record.nodeId, record.lineId, record.recipeId, fromMs, toMs)
+      const patch: Partial<OptimizationRecord> = { [slot]: agg }
+      if (slot === 'windowAgg')
+        patch.aggPending = false
+      this.repo.updateRecord(record.id, patch)
+      this.emit('closed', record)
+    }
+    catch (err) {
+      console.error('[recipe-rollback] 聚合回填失败:', key, err)
+      if (slot === 'windowAgg') {
+        this.repo.updateRecord(record.id, {
+          windowAgg: { at: new Date().toISOString(), fromMs, toMs, channels: [], degraded: true },
+          aggPending: false,
+        })
+      }
+    }
+    finally {
+      this.capturing.delete(key)
+    }
+  }
+
+  /** 记录窗口序列(数采中心查看;经 lineQuery 参数化查询) */
+  async series(recordId: string, windowMs?: number) {
+    const record = this.repo.byId(recordId)
+    if (!record)
+      throw new AppError(404, ErrorCodes.NOT_FOUND, `优化记录不存在: ${recordId}`)
+    const from = Date.parse(record.setAt)
+    let to = record.closedAt ? Date.parse(record.closedAt) : Date.now()
+    const win = clampMs(windowMs)
+    if (win && to - from > win)
+      to = from + win
+    const daqNodes = this.selectDaqChannels(record.nodeId, record.lineId)
+    const span = to - from
+    const bucketMs = clampMs(span > 60_000 ? Math.max(1000, Math.round(span / 200)) : undefined)
+    const { getDcwController } = await import('../dcw-controller')
+    const result = await getDcwController().lineQuery({
+      lineId: record.lineId || undefined,
+      nodeId: daqNodes.map(d => d.id).join(','),
+      fromMs: from,
+      toMs: to,
+      bucketMs,
+      limit: 500,
+    })
+    return { record, from, to, channels: result.channels }
+  }
+
+  /** 节点参数台账(三值对照 + 在册历史;AC1.6) */
+  ledger(nodeId: string) {
+    const node = getDcwNodeRepo().byId(nodeId)
+    if (!node)
+      throw new AppError(404, ErrorCodes.NOT_FOUND, `控制节点不存在: ${nodeId}`)
+    const run = node.lineId ? getActiveLineRun(node.lineId) : null
+    const recipe = run ? getDcwRecipeRepo().byId(run.recipeId) : undefined
+    const recipeTarget = recipe?.params.find(p => p.nodeId === nodeId)?.value ?? null
+    let lastGood: number | null = null
+    const goodRunId = recipe?.lastGoodRunId ?? null
+    if (goodRunId) {
+      const goodRun = getDcwRecipeRepo().runById(goodRunId)
+      lastGood = goodRun?.paramsSnapshot?.find(p => p.nodeId === nodeId)?.value ?? null
+    }
+    return {
+      nodeId,
+      nodeName: node.name,
+      current: typeof node.value === 'number' ? node.value : null,
+      recipeTarget,
+      lastGood,
+      journal: this.repo.listAnchors({ nodeId, limit: 30 }),
+      records: this.repo.listRecords({ nodeId, limit: 20 }),
+    }
+  }
+
+  /** 在册历史查询 */
+  journal(filter: { nodeId?: string, lineId?: string, source?: string, limit?: number }): DcwJournalAnchor[] {
+    return this.repo.listAnchors(filter)
+  }
+
+  records(filter: { lineId?: string, recipeId?: string, nodeId?: string, status?: string, agentId?: string, limit?: number }): OptimizationRecord[] {
+    return this.repo.listRecords(filter)
+  }
+
+  recordById(id: string): OptimizationRecord | undefined {
+    return this.repo.byId(id)
+  }
+
+  /** 节点洞察(my_industrial_nodes 语义卡增量:open 记录 / lastGood / 最近判定) */
+  nodeInsight(nodeId: string): { openRecord: OptimizationRecord | null, lastGood: number | null, recentJudges: Array<{ at: string, verdict: OptimizationVerdict, by: string, reason: string }> } {
+    const led = this.ledger(nodeId)
+    const openRecord = led.records.find(r => r.status === 'open') ?? null
+    const recentJudges = led.records
+      .filter(r => r.judge)
+      .slice(0, 3)
+      .map(r => ({ at: r.judge!.at, verdict: r.judge!.verdict, by: r.judge!.by, reason: r.judge!.reason }))
+    return { openRecord, lastGood: led.lastGood, recentJudges }
+  }
+
+  // ================================================================
+  // 内部
+  // ================================================================
+}

package/server/services/workshop/plugins/host/api.mjs

@@ -0,0 +1,90 @@
+/**
+ * 对外 API:事件发射 / 客户端脚本 / 清单 / 关停
+ * (由 server/services/workshop/plugins/host.mjs 按职责拆出;内容逐行原文搬运)
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { g } from './config.mjs'
+import { isPathInside } from '@/sdk/index.mjs'
+
+export function getPluginHost() {
+  return g.__awPluginHost ?? null
+}
+
+/** scene-events 桥:全部无频道实时事件 → 插件 event:<type> */
+export function emitPluginEvent(type, payload) {
+  void g.__awPluginHost?.bus.emit(`event:${type}`, payload)
+}
+
+/** DAQ 下发级采样钩子(与 WS daq.reading 同点、同节拍语义) */
+export function emitDaqSample(payload) {
+  void g.__awPluginHost?.bus.emit('daq:sample', payload)
+}
+
+/** 帧观察钩子(v2 多形态信号;载荷只含元数据/指标/预览,不含 blob) */
+export function emitDaqFrame(payload) {
+  void g.__awPluginHost?.bus.emit('daq:frame', payload)
+}
+
+/** 写控 ACK 后观察钩子 */
+export function emitDcwWrite(payload) {
+  void g.__awPluginHost?.bus.emit('dcw:write', payload)
+}
+
+/** 产线启停钩子 */
+export function emitLineLifecycle(kind, payload) {
+  void g.__awPluginHost?.bus.emit(kind, payload)
+}
+
+/** 客户端脚本读取(免鉴权只读端点用;越界路径拒绝) */
+export function readClientScript(name) {
+  const host = getPluginHost()
+  const rec = host?.plugins.get(name)
+  if (!host || !rec) return { status: 404 }
+  if (!rec.clientPath || !existsSync(rec.clientPath)) return { status: 404 }
+  // 必须用 isPathInside:startsWith 会把兄弟同前缀目录(…/foo-evil)判为在内,可被 ../ 逃逸
+  if (!isPathInside(rec.dir, rec.clientPath)) return { status: 400 }
+  return { status: 200, code: readFileSync(rec.clientPath, 'utf8'), contentType: 'text/javascript; charset=utf-8' }
+}
+
+/** 清单(非敏感只读;含启停状态与路由)。builtin = 随项目检出提供的内置示例插件 */
+export function pluginManifest() {
+  const host = getPluginHost()
+  if (!host) return []
+  return [...host.plugins.values()].map(r => ({
+    name: r.name,
+    version: r.version,
+    description: r.description,
+    scope: r.scope,
+    builtin: r.scope === 'project' || r.scope === 'builtin',
+    enabled: r.enabled !== false,
+    hasClient: Boolean(r.clientPath),
+    hasI18n: Boolean(r.i18nPath),
+    settingsCount: Array.isArray(r.settings) ? r.settings.length : 0,
+    /** 本插件声明的配置分组(设置页独立分区;id 已收敛进 plugin-<name> 命名空间) */
+    configGroups: (Array.isArray(r.groups) ? r.groups : []).map(g => ({
+      id: g.id,
+      label: g.label,
+      fieldCount: (r.settings ?? []).filter(d => d.group === g.id).length,
+    })),
+    routes: host.routes.byPlugin(r.name),
+    error: r.error,
+  }))
+}
+
+/** 关机钩子(nitro close 时调用):先逐插件回收订阅/定时器,再广播 server:close */
+export async function shutdownPluginHost() {
+  const host = getPluginHost()
+  if (!host) return
+  for (const [name, list] of host.disposables ?? []) {
+    for (const fn of list.splice(0)) {
+      try {
+        await fn()
+      }
+      catch (err) {
+        host.logger.warn(`[${name}] onDispose 失败:`, err?.message)
+      }
+    }
+  }
+  await host.bus.emit('server:close', { at: new Date().toISOString() })
+  host.logger.info('插件清理完成,已发出 server:close')
+}

package/server/services/workshop/plugins/host/config.mjs

@@ -0,0 +1,135 @@
+/**
+ * 模块头 / 懒加载权限与仓储 / 日志 / 路径与插件 i18n 读取
+ * (由 server/services/workshop/plugins/host.mjs 按职责拆出;内容逐行原文搬运)
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { getPluginHost } from './api.mjs'
+import { join, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+// ============================================================
+// AgentWorkShop 插件宿主 —— 发现 / 装载 / 启停状态 / 热重载 / 路由表
+// ------------------------------------------------------------
+// 目录(与 aw commands 同哲学):
+//   project: <repo>/.AgentWorkShop/plugins/<name>/index.mjs
+//   user:    ~/.AgentWorkShop/plugins/<name>/index.mjs(同名 project 优先)
+// 契约:入口导出普通对象 { name, version?, description?, setup(ctx)?,
+//   client?: './client.mjs', routes?: [{method,path,handler}] }
+// —— ctx 由宿主注入,插件运行时零导入依赖(sdk/ 供类型与显式糖)。
+//
+// 启停状态机:<home>/plugins-state.json { version, updatedAt, disabled: string[] }
+//   ⚠️ home = $AW_HOME 或 ~/.AgentWorkShop —— **不是**配置根。源码检出下两者不同:
+//   configRoot=<repo>/.AgentWorkShop(数据/kv 在这里),home=~/.AgentWorkShop(状态在这里)。
+//   全局安装两者重合,所以旧注释写"配置根"时看不出问题。
+//   · 装载时跳过 disabled 插件(manifest 仍可见,enabled:false)
+//   · 状态文件变化(fs.watch)→ 热重载:全部 dispose/解绑 → 重新装载
+//   · CLI(aw plugin enable/disable) 与 Web 设置页均只写状态文件,服务自感知
+// 错误隔离:单插件装载/执行失败记入 failures,绝不拖垮主服务。
+// ============================================================
+
+// 延迟解析的产线权限服务(esbuild/别名下避免 nitro 打包循环导入;失败降级为拒绝一切)
+let permissions = null
+let userRepository = null
+
+/**
+ * 跨模块只读访问器。
+ *
+ * 为什么不是 `export let`:原文件里这两者本就是**模块私有**(写入只发生在 loadPermissions 内部),
+ * 拆成多文件后由 load.mjs 读取;导出可变绑定会被 `import/no-mutable-exports` 拒绝,
+ * 且跨模块可变导出容易被误写 ⇒ 用 getter 暴露当前值。
+ */
+export function permissionsOf() {
+  return permissions
+}
+
+export function userRepositoryOf() {
+  return userRepository
+}
+export async function loadPermissions() {
+  if (permissions) return
+  try {
+    permissions = await import('@/server/services/workshop/permissions')
+    userRepository = await import('@/server/repositories/user.repository').then(m => m.userRepository)
+  }
+  catch (err) {
+    hostLoggerFallback()?.warn('权限服务加载失败(插件 ctx.permissions 降级):', err?.message)
+  }
+}
+export function hostLoggerFallback() {
+  return globalThis.__awPluginHost?.logger ?? console
+}
+
+export const g = globalThis
+
+export function log() {
+  return {
+    debug: (...a) => console.log('[aw-plugins][debug]', ...a),
+    info: (...a) => console.log('[aw-plugins]', ...a),
+    warn: (...a) => console.warn('[aw-plugins]', ...a),
+    error: (...a) => console.error('[aw-plugins]', ...a),
+  }
+}
+
+export function defaultHome() {
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? ''
+  return join(home, '.AgentWorkShop')
+}
+
+/** 运行模式路径(cwd 为检出根时启用 project 作用域) */
+export function modePaths(cwd) {
+  const isRepo = existsSync(join(cwd, 'config.yml')) && existsSync(join(cwd, 'nuxt.config.ts'))
+  // packageRoot:宿主运行时取 initPluginHost 注入值;冒烟/单测(cwd 在包根)回退 cwd
+  const packageRoot = g.__awPluginHost?.packageRoot ?? (isRepo ? cwd : null)
+  const builtinDir = packageRoot ? join(packageRoot, 'server', 'plugins-builtin') : null
+  return {
+    builtinDir: builtinDir && existsSync(builtinDir) ? builtinDir : null,
+    projectDir: isRepo ? join(cwd, '.AgentWorkShop', 'plugins') : null,
+    userDir: join(process.env.AW_HOME && String(process.env.AW_HOME).trim() ? String(process.env.AW_HOME).trim() : defaultHome(), 'plugins'),
+    homeDir: process.env.AW_HOME && String(process.env.AW_HOME).trim() ? String(process.env.AW_HOME).trim() : defaultHome(),
+  }
+}
+
+export function pathToUrl(p) {
+  return pathToFileURL(resolve(p)).href
+}
+
+/** 插件根目录 i18n.json 路径(存在才返回;多语言消息包,按 plugin.<name> 命名空间注入前端) */
+export function pluginI18nPath(dir) {
+  const p = join(dir, 'i18n.json')
+  return existsSync(p) ? p : null
+}
+
+/** 读取并解析插件 i18n.json(形态 { "<locale>": { key: value } };坏文件返回 null 不阻断) */
+export function readPluginI18n(rec) {
+  if (!rec?.i18nPath || !existsSync(rec.i18nPath)) return null
+  try {
+    const obj = JSON.parse(readFileSync(rec.i18nPath, 'utf8'))
+    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) return null
+    const out = {}
+    for (const [locale, messages] of Object.entries(obj)) {
+      if (messages && typeof messages === 'object' && !Array.isArray(messages)) out[locale] = messages
+    }
+    return Object.keys(out).length ? out : null
+  }
+  catch {
+    return null
+  }
+}
+
+/**
+ * 全部插件的 i18n 消息包(免鉴权只读端点用;仅 UI 文案,插件作者不得放置敏感信息):
+ * { "<plugin>": { "<locale>": { key: value } } }
+ */
+export function pluginI18nBundle() {
+  const host = getPluginHost()
+  if (!host) return {}
+  const out = {}
+  for (const rec of host.plugins.values()) {
+    if (rec.enabled === false) continue
+    const bundle = readPluginI18n(rec)
+    if (bundle) out[rec.name] = bundle
+  }
+  return out
+}
+
+// ---- 后端运行时服务面(ctx.services;只读取数优先,跨插件服务带 <plugin>. 前缀) ----

package/server/services/workshop/plugins/host/index.mjs

@@ -0,0 +1,23 @@
+/**
+ * 插件宿主:配置与 i18n / 运行时服务种子 / 状态与发现 / 初始化 / 装载 / 回滚 / 重载 / 开关 / 对外查询
+ *
+ * 由原单文件按职责拆分而来;此处保持**原文件的公开 API 与 import 路径不变**
+ * (目录 index 解析),外部调用方无需改动。
+ *
+ * 模块划分:
+ *   config.mjs             模块头 / 懒加载权限与仓储 / 日志 / 路径与插件 i18n 读取
+ *   services.mjs           插件运行时服务种子(ctx.* 懒绑定)
+ *   state.mjs              状态文件路径 / 启停集合读写 / 插件目录发现
+ *   init.mjs               宿主初始化(加载配置、种子服务、装载全部插件)
+ *   load.mjs               单个插件的装载与校验(配置事件中继 + 主装载流程)
+ *   rollback.mjs           装载失败回滚 / 自身 origin / 设置同步
+ *   reload.mjs             热重载(reloadPluginHost / doReload)
+ *   toggle.mjs             单插件启停 / 状态文件监听 / 宿主查询
+ *   api.mjs                对外 API:事件发射 / 客户端脚本 / 清单 / 关停
+ */
+export { readPluginI18n, pluginI18nBundle } from './config.mjs'
+export { statePathFor, readDisabledSet, writeDisabledSet, discoverPluginDirs } from './state.mjs'
+export { initPluginHost } from './init.mjs'
+export { reloadPluginHost } from './reload.mjs'
+export { setPluginEnabled } from './toggle.mjs'
+export { getPluginHost, emitPluginEvent, emitDaqSample, emitDaqFrame, emitDcwWrite, emitLineLifecycle, readClientScript, pluginManifest, shutdownPluginHost } from './api.mjs'

package/server/services/workshop/plugins/host/init.mjs

@@ -0,0 +1,101 @@
+/**
+ * 宿主初始化(加载配置、种子服务、装载全部插件)
+ * (由 server/services/workshop/plugins/host.mjs 按职责拆出;内容逐行原文搬运)
+ */
+import { HookBus, createRouteTable } from '@/sdk/index.mjs'
+import { ensureStateWatcher } from './toggle.mjs'
+import { existsSync } from 'node:fs'
+import { g, log, modePaths, pathToUrl } from './config.mjs'
+import { join } from 'node:path'
+import { loadAllPlugins, relayConfigEvents } from './load.mjs'
+import { syncPluginSettings } from './rollback.mjs'
+
+export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {}) {
+  if (g.__awPluginHost) return g.__awPluginHost
+  const logger = log()
+  const homeDir = modePaths(cwd).homeDir
+  const host = {
+    bus: new HookBus({
+      name: 'aw-plugins',
+      onError: (err, meta) => logger.warn(`钩子错误(${meta?.type}):`, err?.message ?? err),
+    }),
+    routes: createRouteTable(),
+    plugins: new Map(),
+    disposables: new Map(), // name → fn[](ctx.onDispose 登记)
+    hookOffs: new Map(), // name → off[](ctx.hooks.on 登记;热重载时解绑)
+    failures: [],
+    initedAt: null,
+    cwd,
+    packageRoot,
+    logger,
+    configRelayOff: null,
+  }
+  g.__awPluginHost = host
+
+  // 有效配置(只读面;引擎/模式解析从运行根动态加载)
+  let config = null
+  let settingsPath = null
+  let paths = { home: homeDir, configRoot: join(cwd, '.AgentWorkShop'), dataDir: join(cwd, '.AgentWorkShop', 'data') }
+  try {
+    const homeMod = await import(pathToUrl(join(cwd, 'shared', 'config', 'home.mjs')))
+    const rm = homeMod.resolveRunMode({ cwd, packageRoot, env: process.env })
+    const engineRoot = rm.mode === 'repo' ? rm.root : (packageRoot ?? rm.root)
+    if (engineRoot && existsSync(join(engineRoot, 'shared', 'config', 'engine.mjs'))) {
+      const engine = await import(pathToUrl(join(engineRoot, 'shared', 'config', 'engine.mjs')))
+      config = engine.loadEffective({ configPath: rm.configPath, settingsPath: rm.settingsPath, env: process.env })
+      settingsPath = rm.settingsPath
+    }
+    paths = { home: rm.home, configRoot: rm.configRoot, dataDir: rm.dataDir }
+    host.logger.info(`配置根: ${rm.configRoot} (${rm.mode} 模式)`)
+  }
+  catch (err) {
+    host.logger.warn('配置引擎加载降级(插件 ctx.config 将为空):', err?.message)
+  }
+  // 配置热更新:system-config 变化(设置页 PATCH / runtime-settings 文件监听)即刷新
+  // effective —— 插件 ctx.config.get 每次调用实时读到新值(插件 API 地址等改配置即生效,无需重启)
+  try {
+    const { getSystemConfigService } = await import('@/server/services/system-config')
+    getSystemConfigService().subscribe((tail) => {
+      try {
+        if (config?.effective && tail?.effective) Object.assign(config.effective, tail.effective)
+      }
+      catch { /* 刷新失败保留旧值 */ }
+    })
+  }
+  catch (err) {
+    host.logger.warn('配置热更新订阅失败(插件 ctx.config 为装载时快照):', err?.message)
+  }
+  host.config = config
+
+  // 自环 origin:PORT env(prod:start.mjs 注入 / dev:dev-guard 注入 CLI 显式值)权威;
+  // nitro listen 钩子兜底回填
+  const argPort = (() => {
+    const argv = process.argv
+    const i = argv.indexOf('--port')
+    if (i >= 0 && argv[i + 1]) return argv[i + 1]
+    const eq = argv.find(a => a.startsWith('--port='))
+    return eq ? eq.slice(7) : null
+  })()
+  let selfOrigin = `http://127.0.0.1:${process.env.PORT ?? process.env.NITRO_PORT ?? argPort ?? config?.effective?.['server.dev.port'] ?? 3000}`
+  host.setSelfOrigin = (port) => {
+    selfOrigin = `http://127.0.0.1:${port}`
+    host.logger.info(`自环 origin 就绪: ${selfOrigin}`)
+  }
+  host.selfOrigin = () => selfOrigin
+  host.logger.info(`自环 origin: ${selfOrigin}`)
+
+  await loadAllPlugins(host, { config, settingsPath, paths })
+  await syncPluginSettings()
+  relayConfigEvents(host)
+  ensureStateWatcher(host)
+  return host
+}
+
+/**
+ * 平台设置变更 → 转发到插件总线。
+ *
+ * SDK 的 `ctx.config.onChange(fn)` 订阅的是 `config:changed`,而该事件此前只广播给
+ * SystemConfigService 自己的 listeners —— 插件永远收不到,「配置变更即时生效」对插件
+ * 是空承诺(实测:改 base_url 后插件的出站守卫仍沿用装载期判定)。这里做一次桥接。
+ * 只在宿主初始化时挂一次(热重载不会重复订阅)。
+ */