agentworkshop 0.5.8 → 0.6.0

package/scripts/test-plugin-ext.ts

@@ -0,0 +1,173 @@
+/**
+ * 插件扩展面单元测试:omp 插件工具(桥/合并/分发/热注入)+ 插件 DAQ 模板(桥/覆盖/REST 守卫)。
+ * 运行: npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-plugin-ext.ts
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import { openWorkshopDb } from '../server/services/workshop/db/database'
+import {
+  hostToolsForRole,
+} from '../server/services/workshop/agents/omp-agent'
+import { attachOmpPluginBridge, registerPluginTool, onPluginToolsChange, listPluginTools } from '../server/services/workshop/agents/plugin-tools'
+import { getDaqTemplateRegistry, findDaqTemplate } from '../server/services/workshop/daq/daq-templates'
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+// 全局桥接管(模拟 host.mjs 先行的装载顺序)
+attachOmpPluginBridge()
+
+// ===== omp 插件工具:注册 → 合并进角色工具面 =====
+console.log('\n--- omp 插件工具注册与合并 ---')
+{
+  registerPluginTool('demo-plugin', {
+    name: 'plugin_echo',
+    description: '回显测试工具',
+    parameters: { type: 'object', properties: { msg: { type: 'string' } }, required: ['msg'] },
+    handler: args => ({ text: `echo:${String(args.msg ?? '')}` }),
+  })
+  registerPluginTool('demo-plugin', {
+    name: 'plugin_lead_only',
+    description: '仅 lead 可见的工具',
+    parameters: { type: 'object', properties: {} },
+    roles: ['lead'],
+    handler: () => ({ text: 'lead tool' }),
+  })
+
+  const lead = hostToolsForRole('lead')
+  const worker = hostToolsForRole('worker')
+  check('lead 工具面含 plugin_echo', lead.some(t => t.name === 'plugin_echo'))
+  check('worker 工具面含 plugin_echo(缺省双角色)', worker.some(t => t.name === 'plugin_echo'))
+  check('roles 过滤:plugin_lead_only 仅 lead 可见', lead.some(t => t.name === 'plugin_lead_only') && !worker.some(t => t.name === 'plugin_lead_only'))
+  check('内置工具不因插件合并丢失', lead.some(t => t.name === 'complete_task') && lead.some(t => t.name === 'daq_frames'))
+
+  // 分发(handleHostTool 为类私有,经实例 + 任意未知内置名走插件查表)
+  const { OmpRpcAgentImpl } = await import('../server/services/workshop/agents/omp-agent')
+  const impl = new OmpRpcAgentImpl({ agentId: 'a1', name: 'A', role: 'worker', channelId: 'ch1' })
+  const handle = (impl as unknown as Record<string, (req: unknown) => Promise<{ text: string, isError?: boolean }>>).handleHostTool.bind(impl)
+  const out = await handle({ toolName: 'plugin_echo', arguments: { msg: 'hello' } })
+  check('handleHostTool 分发到插件 handler', out.text === 'echo:hello', out.text)
+
+  // 同名覆盖(热重载幂等:再注册同插件同名,byName 不重复)
+  const before = listPluginTools().size
+  registerPluginTool('demo-plugin', {
+    name: 'plugin_echo',
+    description: '回显测试工具 v2',
+    parameters: { type: 'object', properties: {} },
+    handler: () => ({ text: 'echo2' }),
+  })
+  check('同名覆盖不增表(热重载幂等)', listPluginTools().size === before, `size=${listPluginTools().size}`)
+  const out2 = await handle({ toolName: 'plugin_echo', arguments: {} })
+  check('覆盖后新 handler 生效', out2.text === 'echo2')
+}
+
+// ===== 运行时热注入:注册表变更 → 在跑实例重发 set_host_tools =====
+console.log('\n--- 运行时热注入 ---')
+{
+  const { OmpRpcAgentImpl } = await import('../server/services/workshop/agents/omp-agent')
+  const impl = new OmpRpcAgentImpl({ agentId: 'a2', name: 'B', role: 'worker', channelId: 'ch1' })
+  const sent: Array<Record<string, unknown>> = []
+  const fakeClient = {
+    alive: true,
+    onEvent: () => () => {},
+    send: async (cmd: Record<string, unknown>) => {
+      sent.push(cmd)
+      return { success: true }
+    },
+    onHostToolCall: () => {},
+    getContextUsage: () => null,
+    setContextWindow: () => {},
+  }
+  ;(impl as unknown as Record<string, unknown>).client = fakeClient
+
+  let changeCount = 0
+  const off = onPluginToolsChange(() => changeCount++)
+  registerPluginTool('hot-plugin', {
+    name: 'plugin_hot',
+    description: '热注入工具',
+    parameters: { type: 'object', properties: {} },
+    handler: () => ({ text: 'hot' }),
+  })
+  off()
+  await new Promise(r => setTimeout(r, 20))
+  check('注册触发变更通知', changeCount >= 1, `changes=${changeCount}`)
+  const setTools = sent.filter(c => c.type === 'set_host_tools')
+  if (setTools.length > 0) {
+    const tools = setTools[setTools.length - 1]!.tools as Array<{ name: string }>
+    check('热注入重发 set_host_tools', true)
+    check('热注入载荷含新插件工具', tools.some(t => t.name === 'plugin_hot'))
+  }
+  else {
+    fail('热注入重发 set_host_tools')
+  }
+  impl.dispose()
+}
+
+// ===== 插件 DAQ 模板:注册 → 目录可见 → findDaqTemplate 可解析 → REST 守卫 =====
+console.log('\n--- 插件 DAQ 模板 ---')
+{
+  const registry = getDaqTemplateRegistry()
+  registry.registerPlugin({
+    key: 'plug-test-probe',
+    name: '插件测试模板',
+    code: 'PLUG · T',
+    ch: '测试信号',
+    unit: 'mm',
+    base: 0.5,
+    amp: 0.01,
+    min: 0.4,
+    max: 0.6,
+    decimals: 3,
+    icon: 'tension',
+    signalKind: 'vector',
+    vector: { points: 16, min: 0.4, max: 0.6 },
+    sink: { processors: [{ name: 'derive-metric', args: { name: 'avg', op: 'avg' } }] },
+    metrics: [{ key: 'avg', label: '均值', unit: 'mm' }],
+    plugin: 'test-plugin',
+  })
+  check('插件模板进入目录', registry.all().some(t => t.key === 'plug-test-probe'))
+  check('findDaqTemplate 可解析插件模板', findDaqTemplate('plug-test-probe')?.signalKind === 'vector')
+  check('插件标记透传', registry.all().find(t => t.key === 'plug-test-probe')?.plugin === 'test-plugin')
+
+  // 同 key 覆盖(热重载幂等,不增行)
+  const before = registry.all().length
+  registry.registerPlugin({
+    key: 'plug-test-probe', name: '插件测试模板 v2', code: 'PLUG · T', ch: '测试信号', unit: 'mm',
+    base: 0.5, amp: 0.01, min: 0.4, max: 0.6, decimals: 3, icon: 'tension', plugin: 'test-plugin',
+  })
+  check('同 key 覆盖幂等(不增行)', registry.all().length === before && registry.byKey('plug-test-probe')?.name === '插件测试模板 v2')
+
+  // REST 守卫:插件模板不可改/删
+  let guarded = false
+  try {
+    registry.update('plug-test-probe', { name: 'hack' })
+  }
+  catch { guarded = true }
+  check('update 插件模板被拒', guarded)
+  guarded = false
+  try {
+    registry.remove('plug-test-probe')
+  }
+  catch { guarded = true }
+  check('remove 插件模板被拒', guarded)
+
+  // 与内置冲突拒绝
+  let builtinClash = false
+  try {
+    registry.registerPlugin({ key: 'temp-tc', name: 'x', code: 'x', ch: 'x', unit: 'x', base: 0, amp: 1, min: 0, max: 1, decimals: 1, icon: 'thermo' })
+  }
+  catch { builtinClash = true }
+  check('与内置模板 key 冲突拒绝', builtinClash)
+}
+
+// ===== db 依赖声明(类型面冒烟,防 import 环断裂)=====
+console.log('\n--- 冒烟 ---')
+{
+  const db: DatabaseSync = openWorkshopDb(':memory:')
+  check('db 可用( import 链健康)', db !== null)
+}
+
+console.log(failures === 0 ? '\nALL PASS' : `\n${failures} FAILED`)
+process.exit(failures === 0 ? 0 : 1)

package/server/api/system/settings/events.get.ts

@@ -1,28 +1,27 @@
-/**
- * GET /api/system/settings/events —— 设置变更 SSE 事件流。
- * 客户端用 fetch + ReadableStream（带 Authorization 头）订阅；
- * 服务端任何写入（UI / CLI / 文件监听）都会 push { type, changed, restartRequired, effective }。
- * 连接前先鉴权（无效 token 直接 401，不开流）。
- */
-import { createEventStream } from 'h3'
-import { resolveUser } from '../../workshop/caller'
-import { getSystemConfigService, type ConfigEventPayload } from '../../../services/system-config'
-
-export default defineEventHandler(async (event) => {
-  resolveUser(event) // 开流前鉴权：无 token → 401
-  const service = getSystemConfigService()
-  const stream = createEventStream(event)
-
-  let listener: ((payload: ConfigEventPayload) => void) | undefined
-  listener = (payload) => {
-    void stream.push(JSON.stringify(payload))
-  }
-  const unsubscribe = service.subscribe(listener)
-
-  stream.onClosed(async () => {
-    unsubscribe()
-    await stream.close()
-  })
-
-  return stream.send()
-})
+/**
+ * GET /api/system/settings/events —— 设置变更 SSE 事件流。
+ * 客户端用 fetch + ReadableStream（带 Authorization 头）订阅；
+ * 服务端任何写入（UI / CLI / 文件监听）都会 push { type, changed, restartRequired, effective }。
+ * 连接前先鉴权（无效 token 直接 401，不开流）。
+ */
+import { createEventStream } from 'h3'
+import { resolveUser } from '../../workshop/caller'
+import { getSystemConfigService, type ConfigEventPayload } from '../../../services/system-config'
+
+export default defineEventHandler(async (event) => {
+  resolveUser(event) // 开流前鉴权：无 token → 401
+  const service = getSystemConfigService()
+  const stream = createEventStream(event)
+
+  const listener = (payload: ConfigEventPayload): void => {
+    void stream.push(JSON.stringify(payload))
+  }
+  const unsubscribe = service.subscribe(listener)
+
+  stream.onClosed(async () => {
+    unsubscribe()
+    await stream.close()
+  })
+
+  return stream.send()
+})

package/server/api/system/settings/index.get.ts

@@ -1,14 +1,14 @@
-/**
- * GET /api/system/settings —— 运行时设置全量快照。
- * 返回描述符 + 有效值 + 各键来源(config.yml/runtime/env) + 覆盖文件路径。
- * 前端「系统设置 → 运行配置」表单据此渲染;CLI `aw status` 也走同源概念。
- * 鉴权:任何已登录用户可读(config.get 同语义)。
- */
-import { defineApiHandler } from '../../../utils/response'
-import { resolveUser } from '../../workshop/caller'
-import { getSystemConfigService } from '../../../services/system-config'
-
-export default defineApiHandler((event) => {
-  resolveUser(event)
-  return getSystemConfigService().snapshot()
-})
+/**
+ * GET /api/system/settings —— 运行时设置全量快照。
+ * 返回描述符 + 有效值 + 各键来源(config.yml/runtime/env) + 覆盖文件路径。
+ * 前端「系统设置 → 运行配置」表单据此渲染;CLI `aw status` 也走同源概念。
+ * 鉴权:任何已登录用户可读(config.get 同语义)。
+ */
+import { defineApiHandler } from '../../../utils/response'
+import { resolveUser } from '../../workshop/caller'
+import { getSystemConfigService } from '../../../services/system-config'
+
+export default defineApiHandler((event) => {
+  resolveUser(event)
+  return getSystemConfigService().snapshot()
+})

package/server/api/system/settings/index.patch.ts

@@ -1,22 +1,22 @@
-/**
- * PATCH /api/system/settings —— 写入运行时设置（持久化 + 热重载）。
- * body: { "override": { "<key>": value | null } }
- *   value 非 null → 校验后写入 data/runtime-settings.json 并立即应用(live 键实时生效)
- *   value 为 null → 清除该键覆盖(回落 config.yml)
- * 返回 { changed, restartRequired, effective, sources, overrides }。
- * 鉴权:仅 admin（系统级设置变更属高危管理面）。
- */
-import { readBody } from 'h3'
-import { defineApiHandler } from '../../../utils/response'
-import { requireRole } from '../../workshop/caller'
-import { getSystemConfigService } from '../../../services/system-config'
-
-export default defineApiHandler(async (event) => {
-  requireRole(event, ['admin'])
-  const body = (await readBody(event)) ?? {}
-  const overrides = body.override ?? body.overrides ?? body
-  if (!overrides || typeof overrides !== 'object' || Array.isArray(overrides)) {
-    return { ok: false, message: '请求体应为 { "override": { key: value } }' }
-  }
-  return { ok: true, ...getSystemConfigService().patch(overrides as Record<string, unknown>) }
-})
+/**
+ * PATCH /api/system/settings —— 写入运行时设置（持久化 + 热重载）。
+ * body: { "override": { "<key>": value | null } }
+ *   value 非 null → 校验后写入 data/runtime-settings.json 并立即应用(live 键实时生效)
+ *   value 为 null → 清除该键覆盖(回落 config.yml)
+ * 返回 { changed, restartRequired, effective, sources, overrides }。
+ * 鉴权:仅 admin（系统级设置变更属高危管理面）。
+ */
+import { readBody } from 'h3'
+import { defineApiHandler } from '../../../utils/response'
+import { requireRole } from '../../workshop/caller'
+import { getSystemConfigService } from '../../../services/system-config'
+
+export default defineApiHandler(async (event) => {
+  requireRole(event, ['admin'])
+  const body = (await readBody(event)) ?? {}
+  const overrides = body.override ?? body.overrides ?? body
+  if (!overrides || typeof overrides !== 'object' || Array.isArray(overrides)) {
+    return { ok: false, message: '请求体应为 { "override": { key: value } }' }
+  }
+  return { ok: true, ...getSystemConfigService().patch(overrides as Record<string, unknown>) }
+})

package/server/api/system/settings/reset.post.ts

@@ -1,12 +1,12 @@
-/**
- * POST /api/system/settings/reset —— 清空全部运行时覆盖（回落 config.yml/base + env）。
- * 鉴权:仅 admin。
- */
-import { defineApiHandler } from '../../../utils/response'
-import { requireRole } from '../../workshop/caller'
-import { getSystemConfigService } from '../../../services/system-config'
-
-export default defineApiHandler((event) => {
-  requireRole(event, ['admin'])
-  return { ok: true, ...getSystemConfigService().reset() }
-})
+/**
+ * POST /api/system/settings/reset —— 清空全部运行时覆盖（回落 config.yml/base + env）。
+ * 鉴权:仅 admin。
+ */
+import { defineApiHandler } from '../../../utils/response'
+import { requireRole } from '../../workshop/caller'
+import { getSystemConfigService } from '../../../services/system-config'
+
+export default defineApiHandler((event) => {
+  requireRole(event, ['admin'])
+  return { ok: true, ...getSystemConfigService().reset() }
+})

package/server/api/workshop/daq/[id]/frames/content.get.ts

@@ -0,0 +1,24 @@
+/**
+ * GET /api/workshop/daq/:id/frames/content —— 帧图像内容(对象存储流式输出)。
+ * query: ts(epoch ms,必填)、thumb?(1=缩略图,缺省主图)
+ * 像素不落 Timescale(元数据分离,plan D1);此处经 DaqObjectStore 读取后直出。
+ * 注意:二进制路由不走 defineApiHandler(JSON 信封会把 Buffer 序列化成
+ * {type:'Buffer',data:[…]} 文本,84 字节 500 事故实录),h3 对 Buffer 原生二进制响应。
+ */
+import { createError, defineEventHandler, getQuery, getRouterParam, setResponseHeader } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+
+export default defineEventHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const q = getQuery(event)
+  const ts = Number(q.ts)
+  if (!Number.isFinite(ts) || ts <= 0) {
+    throw createError({ statusCode: 400, statusMessage: '参数 ts(epoch ms)必填' })
+  }
+  const { data, mime } = await getDaqController().frameContent(id, ts, q.thumb === '1')
+  setResponseHeader(event, 'content-type', mime)
+  setResponseHeader(event, 'cache-control', 'private, max-age=86400')
+  return data
+})

package/server/api/workshop/daq/[id]/frames.get.ts

@@ -0,0 +1,44 @@
+/**
+ * GET /api/workshop/daq/:id/frames —— 节点帧历史(v2 多形态信号:向量/图像元数据)。
+ * query: from?/to?(epoch ms)、kind?(vector|image)、limit?(默认 100,上限 1000)
+ * 图像像素经 contentUrl(鉴权流式)按需取,本接口只返回元数据与派生指标。
+ */
+import { getQuery, getRouterParam } from 'h3'
+import { resolveUser } from '@/server/api/workshop/caller'
+import { defineApiHandler } from '@/server/utils/response'
+import { getDaqController } from '@/server/services/workshop/daq/daq-controller'
+
+export default defineApiHandler(async (event) => {
+  resolveUser(event)
+  const id = getRouterParam(event, 'id') ?? ''
+  const q = getQuery(event)
+  const num = (k: string): number | undefined => (q[k] != null && !Number.isNaN(Number(q[k])) ? Number(q[k]) : undefined)
+  const kind = q.kind === 'vector' || q.kind === 'image' ? q.kind : undefined
+  const frames = await getDaqController().frames(id, {
+    fromMs: num('from'),
+    toMs: num('to'),
+    kind,
+    limit: num('limit'),
+  })
+  return {
+    frames: frames.map(f => ({
+      at: f.at,
+      kind: f.kind,
+      points: f.points,
+      metrics: f.metrics,
+      /** 图像元数据(objectKey/thumbKey/mime/width/height) */
+      meta: f.meta,
+      deviceBindingId: f.deviceBindingId,
+      lineId: f.lineId,
+      productId: f.productId,
+      recipeId: f.recipeId,
+      runId: f.runId,
+      contentUrl: f.kind === 'image'
+        ? `/api/workshop/daq/${id}/frames/content?ts=${f.at}`
+        : undefined,
+      thumbUrl: f.kind === 'image'
+        ? `/api/workshop/daq/${id}/frames/content?ts=${f.at}&thumb=1`
+        : undefined,
+    })),
+  }
+})