agentworkshop 0.2.2 → 0.4.0

package/server/data/line-runs.json

@@ -7,7 +7,7 @@
     "productId": "pd-3ad54846",
     "productName": "光学膜 BOPP",
     "startedAt": "2026-08-31T16:20:13.707Z",
-    "taggedSamples": 29498
+    "taggedSamples": 29766
   },
   {
     "lineId": "ln-c377a6bf",
@@ -17,7 +17,7 @@
     "productId": "pd-7e69e0ee",
     "productName": "警告验证产品-k2xh",
     "startedAt": "2026-09-01T03:23:18.233Z",
-    "taggedSamples": 11559
+    "taggedSamples": 11693
   },
   {
     "lineId": "ln-9224d3d7",
@@ -27,7 +27,7 @@
     "productId": "pd-910c0fa8",
     "productName": "新协议产品-9xhn",
     "startedAt": "2026-09-01T05:59:24.062Z",
-    "taggedSamples": 14533
+    "taggedSamples": 14666
   },
   {
     "lineId": "ln-386c53ed",
@@ -37,7 +37,7 @@
     "productId": "pd-2d4f9357",
     "productName": "新协议产品-6ofk",
     "startedAt": "2026-09-01T06:05:53.063Z",
-    "taggedSamples": 14823
+    "taggedSamples": 14956
   },
   {
     "lineId": "ln-5957f6db",
@@ -47,7 +47,7 @@
     "productId": "pd-a3ed5047",
     "productName": "新协议产品-x4hd",
     "startedAt": "2026-09-01T06:09:02.148Z",
-    "taggedSamples": 14409
+    "taggedSamples": 14542
   },
   {
     "lineId": "ln-9ec42f08",
@@ -57,7 +57,7 @@
     "productId": "pd-5de729c0",
     "productName": "新协议产品-teti",
     "startedAt": "2026-09-01T06:13:44.315Z",
-    "taggedSamples": 14388
+    "taggedSamples": 14521
   },
   {
     "lineId": "ln-69e37924",
@@ -67,7 +67,7 @@
     "productId": "pd-45eb8d43",
     "productName": "新协议产品-fg8t",
     "startedAt": "2026-09-01T06:16:47.469Z",
-    "taggedSamples": 14421
+    "taggedSamples": 14554
   },
   {
     "lineId": "ln-c269e692",
@@ -77,7 +77,7 @@
     "productId": "pd-b3bd0191",
     "productName": "新协议产品-w2sp",
     "startedAt": "2026-09-01T06:56:05.893Z",
-    "taggedSamples": 14472
+    "taggedSamples": 14605
   },
   {
     "lineId": "ln-229d1637",
@@ -87,7 +87,7 @@
     "productId": "pd-06b896f9",
     "productName": "新协议产品-lp4h",
     "startedAt": "2026-09-01T06:57:29.288Z",
-    "taggedSamples": 14344
+    "taggedSamples": 14477
   },
   {
     "lineId": "ln-9546f91f",
@@ -97,7 +97,7 @@
     "productId": "pd-53e55078",
     "productName": "新协议产品-jri6",
     "startedAt": "2026-09-01T07:00:25.059Z",
-    "taggedSamples": 13767
+    "taggedSamples": 13900
   },
   {
     "lineId": "ln-087aad5b",
@@ -107,7 +107,7 @@
     "productId": "pd-e7e969af",
     "productName": "新协议产品-4c2d",
     "startedAt": "2026-09-01T07:09:07.307Z",
-    "taggedSamples": 12758
+    "taggedSamples": 12891
   },
   {
     "lineId": "ln-97d44f8a",
@@ -117,7 +117,7 @@
     "productId": "pd-28a3ab2c",
     "productName": "新协议产品-b2ni",
     "startedAt": "2026-09-01T07:13:44.912Z",
-    "taggedSamples": 12607
+    "taggedSamples": 12740
   },
   {
     "lineId": "ln-a9551770",
@@ -127,7 +127,7 @@
     "productId": "pd-0c6a64c8",
     "productName": "新协议产品-uwkf",
     "startedAt": "2026-09-01T07:15:40.113Z",
-    "taggedSamples": 12252
+    "taggedSamples": 12385
   },
   {
     "lineId": "ln-844ad82f",
@@ -137,7 +137,7 @@
     "productId": "pd-6932b24f",
     "productName": "新协议产品-kk6l",
     "startedAt": "2026-09-01T09:06:55.728Z",
-    "taggedSamples": 10407
+    "taggedSamples": 10540
   },
   {
     "lineId": "ln-af002514",
@@ -147,6 +147,76 @@
     "productId": "pd-6348a595",
     "productName": "0.8mm 光学膜",
     "startedAt": "2026-09-01T14:06:28.766Z",
-    "taggedSamples": 676
+    "taggedSamples": 956
+  },
+  {
+    "lineId": "ln-0eccf6ba",
+    "runId": "rr-4e0a115f",
+    "recipeId": "rc-8a60518e",
+    "recipeName": "哨兵配方-mtjku36w",
+    "productId": "pd-4b71be77",
+    "productName": "哨兵产品-mtjku36w",
+    "startedAt": "2026-09-02T04:09:11.482Z",
+    "taggedSamples": 6
+  },
+  {
+    "lineId": "ln-e984246e",
+    "runId": "rr-39b3edda",
+    "recipeId": "rc-70f39a03",
+    "recipeName": "配方C-mtjkwyhu",
+    "productId": "pd-bb1e0bed",
+    "productName": "产品C-mtjkwyhu",
+    "startedAt": "2026-09-02T04:11:26.583Z",
+    "taggedSamples": 5
+  },
+  {
+    "lineId": "ln-1fe0b5bc",
+    "runId": "rr-2baf5f34",
+    "recipeId": "rc-25081a45",
+    "recipeName": "配方D-mtjkzcfr",
+    "productId": "pd-9f2d9507",
+    "productName": "产品D-mtjkzcfr",
+    "startedAt": "2026-09-02T04:13:17.902Z",
+    "taggedSamples": 4
+  },
+  {
+    "lineId": "ln-d826473e",
+    "runId": "rr-7585cef0",
+    "recipeId": "rc-3ebd1a97",
+    "recipeName": "配方E-mtjl43pv",
+    "productId": "pd-d230255e",
+    "productName": "产品E-mtjl43pv",
+    "startedAt": "2026-09-02T04:16:59.891Z",
+    "taggedSamples": 3
+  },
+  {
+    "lineId": "ln-156abb71",
+    "runId": "rr-d8002452",
+    "recipeId": "rc-fce9474f",
+    "recipeName": "配方F-mtjl60qf",
+    "productId": "pd-6065b4ba",
+    "productName": "产品F-mtjl60qf",
+    "startedAt": "2026-09-02T04:18:29.340Z",
+    "taggedSamples": 2
+  },
+  {
+    "lineId": "ln-bac43927",
+    "runId": "rr-7f4a6ac0",
+    "recipeId": "rc-e27a0673",
+    "recipeName": "配方G-mtjl98nl",
+    "productId": "pd-52f54e33",
+    "productName": "产品G-mtjl98nl",
+    "startedAt": "2026-09-02T04:20:59.682Z",
+    "taggedSamples": 1
+  },
+  {
+    "lineId": "ln-f223008a",
+    "runId": "rr-06caf6f4",
+    "recipeId": "rc-21479838",
+    "recipeName": "配方-mtjo000v",
+    "productId": "pd-d919d4bf",
+    "productName": "产品-mtjo000v",
+    "startedAt": "2026-09-02T05:37:50.743Z",
+    "taggedSamples": 0
   }
 ]

package/server/plugins/aw-plugins.ts

@@ -11,7 +11,13 @@ import { dirname, resolve } from 'node:path'
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
 
 export default defineNitroPlugin((nitroApp) => {
-  void initPluginHost({ cwd: process.cwd(), packageRoot })
+  void initPluginHost({ cwd: process.cwd(), packageRoot }).then((host) => {
+    // 实际监听端口回填(nitro listen 后 ctx.api 自环 origin 才准确)
+    nitroApp.hooks.hookOnce('listen', (listener: { port?: number }) => {
+      if (listener?.port)
+        host.setSelfOrigin(listener.port)
+    })
+  })
   nitroApp.hooks.hookOnce('close', () => {
     void shutdownPluginHost()
   })

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

@@ -1,5 +1,5 @@
 // ============================================================
-// AgentWorkShop 插件宿主 —— 发现 / 装载 / 生命周期 / 路由表
+// AgentWorkShop 插件宿主 —— 发现 / 装载 / 启停状态 / 热重载 / 路由表
 // ------------------------------------------------------------
 // 目录(与 aw commands 同哲学):
 //   project: <repo>/.AgentWorkShop/plugins/<name>/index.mjs
@@ -7,10 +7,15 @@
 // 契约:入口导出普通对象 { name, version?, description?, setup(ctx)?,
 //   client?: './client.mjs', routes?: [{method,path,handler}] }
 // —— ctx 由宿主注入,插件运行时零导入依赖(sdk/ 供类型与显式糖)。
+//
+// 启停状态机:配置根 plugins-state.json { version, updatedAt, disabled: string[] }
+//   · 装载时跳过 disabled 插件(manifest 仍可见,enabled:false)
+//   · 状态文件变化(fs.watch)→ 热重载:全部 dispose/解绑 → 重新装载
+//   · CLI(aw plugin enable/disable) 与 Web 设置页均只写状态文件,服务自感知
 // 错误隔离:单插件装载/执行失败记入 failures,绝不拖垮主服务。
 // ============================================================
-import { existsSync, readdirSync, readFileSync } from 'node:fs'
-import { join, resolve } from 'node:path'
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, watch, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { HookBus, createPluginContext, createRouteTable, validatePluginModule } from '@/sdk/index.mjs'
 
@@ -18,6 +23,7 @@ const g = globalThis
 
 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),
@@ -35,6 +41,7 @@ function modePaths(cwd) {
   return {
     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(),
   }
 }
 
@@ -42,6 +49,29 @@ function pathToUrl(p) {
   return pathToFileURL(resolve(p)).href
 }
 
+// ---- 启停状态(单一事实源:<配置根>/plugins-state.json;CLI/Web/宿主三方读写) ----
+export function statePathFor(homeDir) {
+  return join(homeDir, 'plugins-state.json')
+}
+
+export function readDisabledSet(homeDir) {
+  try {
+    const j = JSON.parse(readFileSync(statePathFor(homeDir), 'utf8'))
+    return new Set(Array.isArray(j.disabled) ? j.disabled : [])
+  }
+  catch {
+    return new Set()
+  }
+}
+
+export function writeDisabledSet(homeDir, disabled) {
+  const p = statePathFor(homeDir)
+  mkdirSync(dirname(p), { recursive: true })
+  const tmp = `${p}.${process.pid}.tmp`
+  writeFileSync(tmp, `${JSON.stringify({ version: 1, updatedAt: new Date().toISOString(), disabled: [...disabled] }, null, 2)}\n`, 'utf8')
+  renameSync(tmp, p)
+}
+
 /** 发现两个作用域下的插件入口(project 同名覆盖 user) */
 export function discoverPluginDirs(cwd = process.cwd()) {
   const { projectDir, userDir } = modePaths(cwd)
@@ -62,12 +92,11 @@ export function discoverPluginDirs(cwd = process.cwd()) {
 
 /**
  * 装载插件宿主(idempotent;nitro 启动期调用一次)。
- * 装载 = 动态 import 入口 → 形态校验 → createPluginContext → setup(ctx)
- *       → 收集 routes/client → emit plugin:host:init
  */
 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',
@@ -75,15 +104,20 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
     }),
     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,
   }
   g.__awPluginHost = host
 
-  // 有效配置(只读面;引擎/模式解析从运行根动态加载,js-yaml 由对应 node_modules 解析)
+  // 有效配置(只读面;引擎/模式解析从运行根动态加载)
   let config = null
-  let paths = { home: defaultHome(), configRoot: join(cwd, '.AgentWorkShop'), dataDir: join(cwd, '.AgentWorkShop', 'data') }
+  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 })
@@ -91,6 +125,7 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
     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} 模式)`)
@@ -98,9 +133,38 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
   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}`)
 
-  const entries = discoverPluginDirs(cwd)
-  if (entries.length) host.logger.info(`发现 ${entries.length} 个插件,开始装载 ...`)
+  await loadAllPlugins(host, { config, settingsPath, paths })
+  ensureStateWatcher(host)
+  return host
+}
+
+/** 装载/重载全部插件(跳过 disabled;manifest 仍可见) */
+async function loadAllPlugins(host, { config, paths }) {
+  const homeDir = modePaths(host.cwd).homeDir
+  const disabled = readDisabledSet(homeDir)
+  host.disabledSet = disabled
+
+  const entries = discoverPluginDirs(host.cwd)
+  if (entries.length) host.logger.info(`发现 ${entries.length} 个插件(停用 ${disabled.size}),开始装载 ...`)
 
   for (const { dir, scope } of entries) {
     const entry = join(dir, 'index.mjs')
@@ -111,6 +175,22 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
       const def = check.def
 
       if (host.plugins.has(def.name)) throw new Error(`插件重名(后装载者跳过): ${def.name}`)
+      if (disabled.has(def.name)) {
+        host.plugins.set(def.name, {
+          name: def.name,
+          version: String(def.version ?? '0.0.0'),
+          description: String(def.description ?? ''),
+          scope,
+          dir,
+          entry,
+          clientPath: def.client ? resolve(dir, def.client) : null,
+          routes: [],
+          enabled: false,
+          error: null,
+        })
+        host.logger.info(`⊘ 跳过(已停用) [${scope}] ${def.name}`)
+        continue
+      }
 
       const rec = {
         name: def.name,
@@ -121,6 +201,8 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
         entry,
         clientPath: def.client ? resolve(dir, def.client) : null,
         routes: [],
+        enabled: true,
+        error: null,
       }
 
       const emitter = {
@@ -129,22 +211,45 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
           rec.routes.push({ method: String(m).toUpperCase(), path: p })
         },
       }
+      const perPluginDisposables = []
+      const hookOffs = []
+      host.disposables.set(def.name, perPluginDisposables)
+      host.hookOffs.set(def.name, hookOffs)
+      const scopedHooks = {
+        on: (t, fn) => {
+          const off = host.bus.on(t, fn)
+          hookOffs.push(off)
+          return off
+        },
+        once: (t, fn) => {
+          const off = host.bus.once(t, fn)
+          hookOffs.push(off)
+          return off
+        },
+        off: (t, fn) => host.bus.off(t, fn),
+        emit: (t, p) => host.bus.emit(t, p),
+      }
       const ctx = createPluginContext({
         name: def.name,
         scope,
         dir,
-        hooks: host.bus,
+        hooks: scopedHooks,
         logger: {
-          info: (...a) => logger.info(`[${def.name}]`, ...a),
-          warn: (...a) => logger.warn(`[${def.name}]`, ...a),
-          error: (...a) => logger.error(`[${def.name}]`, ...a),
+          debug: (...a) => host.logger.info(`[${def.name}][debug]`, ...a),
+          info: (...a) => host.logger.info(`[${def.name}]`, ...a),
+          warn: (...a) => host.logger.warn(`[${def.name}]`, ...a),
+          error: (...a) => host.logger.error(`[${def.name}]`, ...a),
         },
         config,
         paths,
         emitter,
+        onDispose: (fn) => {
+          perPluginDisposables.push(fn)
+          return fn
+        },
+        selfOrigin: () => selfOriginRef(host),
       })
 
-      // 声明式 routes + setup 内 ctx.route() 两种形态都支持
       for (const r of (Array.isArray(def.routes) ? def.routes : [])) {
         emitter.registerRoute(def.name, r.method ?? 'GET', r.path, r.handler)
       }
@@ -161,10 +266,87 @@ export async function initPluginHost({ cwd = process.cwd(), packageRoot } = {})
 
   host.initedAt = new Date().toISOString()
   await host.bus.emit('plugin:host:init', { plugins: [...host.plugins.keys()], failures: host.failures.length })
-  host.logger.info(`装载完成: ${host.plugins.size} 成功 / ${host.failures.length} 失败 / 路由 ${host.routes.size} 条`)
+  host.logger.info(`装载完成: ${host.plugins.size} 个(含停用)/ ${host.failures.length} 失败 / 活跃路由 ${host.routes.size} 条`)
+}
+
+function selfOriginRef(host) {
+  return host.selfOrigin()
+}
+
+/** 热重载:全部 dispose/解绑 → 重新装载(跳过停用)→ 广播 plugins.reloaded(并发合并) */
+export async function reloadPluginHost() {
+  const host = getPluginHost()
+  if (!host) return null
+  if (host.reloadInFlight) return host.reloadInFlight
+  host.reloadInFlight = doReload(host).finally(() => {
+    host.reloadInFlight = null
+  })
+  return host.reloadInFlight
+}
+
+async function doReload(host) {
+  host.logger.info('热重载插件宿主 ...')
+  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)
+      }
+    }
+  }
+  for (const offs of (host.hookOffs ?? new Map()).values()) {
+    for (const off of offs.splice(0)) {
+      try {
+        off()
+      }
+      catch { /* 解绑失败忽略 */ }
+    }
+  }
+  host.plugins.clear()
+  host.routes = createRouteTable()
+  host.failures = []
+  await loadAllPlugins(host, { config: host.config, settingsPath: null, paths: { home: modePaths(host.cwd).homeDir, configRoot: join(host.cwd, '.AgentWorkShop'), dataDir: join(host.cwd, '.AgentWorkShop', 'data') } })
+  await host.bus.emit('plugins:reloaded', { plugins: pluginManifest() })
+  try {
+    const m = await import('@/server/services/workshop/scene-events')
+    m.broadcastSceneEvent('plugins.reloaded', { plugins: pluginManifest() })
+  }
+  catch { /* 广播失败不影响重载 */ }
   return host
 }
 
+/** 启停单插件(写状态文件;调用方随后 reloadPluginHost 或由 state watcher 触发) */
+export function setPluginEnabled(name, enabled) {
+  const host = getPluginHost()
+  const homeDir = modePaths(host?.cwd ?? process.cwd()).homeDir
+  const set = readDisabledSet(homeDir)
+  if (enabled) set.delete(name)
+  else set.add(name)
+  writeDisabledSet(homeDir, set)
+  return [...set]
+}
+
+/** 状态文件监视 → 热重载(CLI/Web 只写文件,服务自感知) */
+function ensureStateWatcher(host) {
+  const statePath = statePathFor(modePaths(host.cwd).homeDir)
+  try {
+    mkdirSync(dirname(statePath), { recursive: true })
+    if (!existsSync(statePath)) writeDisabledSet(modePaths(host.cwd).homeDir, new Set())
+    let debounce = null
+    watch(statePath, () => {
+      clearTimeout(debounce)
+      debounce = setTimeout(() => {
+        void reloadPluginHost()
+      }, 400)
+    })
+  }
+  catch (err) {
+    host.logger.warn('状态文件监视不可用(启停需手动重启):', err?.message)
+  }
+}
+
 /** 单例访问(未初始化返回 null —— 桥接点据此快速 no-op) */
 export function getPluginHost() {
   return g.__awPluginHost ?? null
@@ -200,7 +382,7 @@ export function readClientScript(name) {
   return { status: 200, code: readFileSync(rec.clientPath, 'utf8'), contentType: 'text/javascript; charset=utf-8' }
 }
 
-/** 清单(非敏感只读:名称/版本/作用域/描述/路由/是否有客户端) */
+/** 清单(非敏感只读;含启停状态与路由) */
 export function pluginManifest() {
   const host = getPluginHost()
   if (!host) return []
@@ -209,15 +391,27 @@ export function pluginManifest() {
     version: r.version,
     description: r.description,
     scope: r.scope,
+    enabled: r.enabled !== false,
     hasClient: Boolean(r.clientPath),
     routes: host.routes.byPlugin(r.name),
+    error: r.error,
   }))
 }
 
-/** 关机钩子(nitro close 时调用) */
+/** 关机钩子(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,插件宿主关闭')
+  host.logger.info('插件清理完成,已发出 server:close')
 }