agentworkshop 0.8.6 → 0.8.7

package/sdk/client.d.mts

@@ -1,110 +1,110 @@
-// AgentWorkShop SDK 类型声明(agentworkshop/sdk/client)
-// ------------------------------------------------------------
-// 与 sdk/client.mjs 一一对应(浏览器侧;自包含、零框架依赖)。
-// 运行时命名导出: CLIENT_SDK_VERSION, createClientContext, default
-// default 额外携带模块私有的 el() 助手(命名导出不含 el)。
-// 消费方通常直接 import { createClientContext } from 'agentworkshop/sdk/client'。
-
-/** 客户端 SDK 版本(与 sdk/client.mjs CLIENT_SDK_VERSION 同步) */
-export declare const CLIENT_SDK_VERSION: string
-
-/** HookBus:异步串行、错误隔离、'*' 通配、连续失败自动熔断 */
-export declare class HookBus {
-  constructor(opts?: { name?: string, onError?: (err: Error, meta?: { bus?: string, type?: string, fails?: number }) => void })
-  on(type: string, fn: (payload: any) => any): () => void
-  once(type: string, fn: (payload: any) => any): () => void
-  off(type: string, fn: (payload: any) => any): void
-  emit(type: string, payload?: any): Promise<any>
-  readonly size: number
-}
-
-/** ctx.log:前缀 console(前缀 [aw-plugin:<name>]) */
-export interface ClientLogger {
-  info(...args: unknown[]): void
-  warn(...args: unknown[]): void
-  error(...args: unknown[]): void
-}
-
-/** ctx.ui.registerPanel 的入参(loader 注入宿主实现) */
-export interface ClientPanelEntry {
-  /** 目标插槽名(经 <PluginSlot slot-name> 渲染) */
-  slot: string
-  /** 面板名(插件内唯一) */
-  name: string
-  /** 面板标题(缺省时宿主回退 titleKey / name) */
-  title?: string
-  /** i18n 标题键(优先于 title) */
-  titleKey?: string
-  /** 同插槽内排序权重 */
-  order?: number
-  /** 渲染回调:入参为该面板的宿主容器节点 */
-  mount(el: HTMLElement): void
-}
-
-/** ctx.ui:UI 注入面(宿主未提供时为告警桩) */
-export interface ClientUi {
-  registerPanel(entry: ClientPanelEntry): () => void
-  /** 已知插槽名(宿主未提供时为 []) */
-  readonly slots: readonly string[]
-}
-
-/** ctx.t 的翻译参数(占位符插值) */
-export type ClientTranslateParams = Record<string, unknown>
-
-/** ctx:客户端插件上下文(由 createClientContext 返回) */
-export interface ClientContext {
-  /** 插件名(与插件 def.name 一致) */
-  name: string
-  /** SDK 版本(= CLIENT_SDK_VERSION) */
-  sdkVersion: string
-  /** 客户端本地 HookBus(client:init / event:* / page:change / client:destroy) */
-  hooks: HookBus
-  /** scene 实时事件订阅(与 WS 同源;type='*' 通配);返回解绑函数,dispose 时自动回收 */
-  on(type: string, fn: (payload: any) => any): () => void
-  /** 同源平台 API 助手(JSON;自动解 {data} 信封;非 2xx 抛错;自动携带 cookie token) */
-  fetch<T = any>(path: string, opt?: { method?: string, body?: unknown, headers?: Record<string, string> }): Promise<T>
-  /** DOM 助手:创建元素;attrs 支持 style / class / on<event> / 其余 setAttribute */
-  el(tag: string, attrs?: Record<string, unknown>, children?: Array<Node | string> | Node | string): HTMLElement
-  /** 挂载节点到选择器/元素(缺失时回落 ctx.root()) */
-  mount(target: string | Element, node: Node): Node
-  /** 插件 UI 挂载点(懒创建,自动附加到 body,#aw-plugin-<name>) */
-  root(): HTMLElement
-  /** UI 注入面(loader 注入;脱离宿主时为告警桩) */
-  ui: ClientUi
-  /** 插件命名空间翻译:ctx.t('settings.title') -> plugin.<name>.settings.title */
-  t(key: string, params?: ClientTranslateParams): string
-  /** 当前界面语言(loader 维护;i18n:changed 钩子在切换时广播;未注入时 '') */
-  readonly locale: string
-  /** 前缀 console 日志 */
-  log: ClientLogger
-  /** 卸载:回收订阅 + 清空挂载点 + 广播 client:destroy(幂等) */
-  dispose(): void
-}
-
-/**
- * 创建客户端插件上下文(客户端 loader 调用)。
- * @param opts.name        插件名(必填)
- * @param opts.eventBridge scene 事件桥:注册回调并返回解绑函数
- * @param opts.baseUrl     ctx.fetch 的前缀(baseUrl + path)
- * @param opts.ui          UI 注入面(缺省告警桩)
- * @param opts.t           翻译函数(缺省回退 plugin.<name>.<key>)
- * @param opts.getLocale   当前语言读取器(缺省回退 '')
- */
-export declare function createClientContext(opts?: {
-  name: string
-  eventBridge?: (fn: (type: string, payload: any) => void) => (() => void)
-  baseUrl?: string
-  ui?: ClientUi
-  t?: (key: string, params?: ClientTranslateParams) => string
-  getLocale?: () => string
-}): ClientContext
-
-/** 模块私有 el() 助手(default 导出可见;命名导出不含) */
-export declare function el(tag: string, attrs?: Record<string, unknown>, children?: Array<Node | string> | Node | string): HTMLElement
-
-declare const _default: {
-  CLIENT_SDK_VERSION: string
-  createClientContext: typeof createClientContext
-  el: typeof el
-}
-export default _default
+// AgentWorkShop SDK 类型声明(agentworkshop/sdk/client)
+// ------------------------------------------------------------
+// 与 sdk/client.mjs 一一对应(浏览器侧;自包含、零框架依赖)。
+// 运行时命名导出: CLIENT_SDK_VERSION, createClientContext, default
+// default 额外携带模块私有的 el() 助手(命名导出不含 el)。
+// 消费方通常直接 import { createClientContext } from 'agentworkshop/sdk/client'。
+
+/** 客户端 SDK 版本(与 sdk/client.mjs CLIENT_SDK_VERSION 同步) */
+export declare const CLIENT_SDK_VERSION: string
+
+/** HookBus:异步串行、错误隔离、'*' 通配、连续失败自动熔断 */
+export declare class HookBus {
+  constructor(opts?: { name?: string, onError?: (err: Error, meta?: { bus?: string, type?: string, fails?: number }) => void })
+  on(type: string, fn: (payload: any) => any): () => void
+  once(type: string, fn: (payload: any) => any): () => void
+  off(type: string, fn: (payload: any) => any): void
+  emit(type: string, payload?: any): Promise<any>
+  readonly size: number
+}
+
+/** ctx.log:前缀 console(前缀 [aw-plugin:<name>]) */
+export interface ClientLogger {
+  info(...args: unknown[]): void
+  warn(...args: unknown[]): void
+  error(...args: unknown[]): void
+}
+
+/** ctx.ui.registerPanel 的入参(loader 注入宿主实现) */
+export interface ClientPanelEntry {
+  /** 目标插槽名(经 <PluginSlot slot-name> 渲染) */
+  slot: string
+  /** 面板名(插件内唯一) */
+  name: string
+  /** 面板标题(缺省时宿主回退 titleKey / name) */
+  title?: string
+  /** i18n 标题键(优先于 title) */
+  titleKey?: string
+  /** 同插槽内排序权重 */
+  order?: number
+  /** 渲染回调:入参为该面板的宿主容器节点 */
+  mount(el: HTMLElement): void
+}
+
+/** ctx.ui:UI 注入面(宿主未提供时为告警桩) */
+export interface ClientUi {
+  registerPanel(entry: ClientPanelEntry): () => void
+  /** 已知插槽名(宿主未提供时为 []) */
+  readonly slots: readonly string[]
+}
+
+/** ctx.t 的翻译参数(占位符插值) */
+export type ClientTranslateParams = Record<string, unknown>
+
+/** ctx:客户端插件上下文(由 createClientContext 返回) */
+export interface ClientContext {
+  /** 插件名(与插件 def.name 一致) */
+  name: string
+  /** SDK 版本(= CLIENT_SDK_VERSION) */
+  sdkVersion: string
+  /** 客户端本地 HookBus(client:init / event:* / page:change / client:destroy) */
+  hooks: HookBus
+  /** scene 实时事件订阅(与 WS 同源;type='*' 通配);返回解绑函数,dispose 时自动回收 */
+  on(type: string, fn: (payload: any) => any): () => void
+  /** 同源平台 API 助手(JSON;自动解 {data} 信封;非 2xx 抛错;自动携带 cookie token) */
+  fetch<T = any>(path: string, opt?: { method?: string, body?: unknown, headers?: Record<string, string> }): Promise<T>
+  /** DOM 助手:创建元素;attrs 支持 style / class / on<event> / 其余 setAttribute */
+  el(tag: string, attrs?: Record<string, unknown>, children?: Array<Node | string> | Node | string): HTMLElement
+  /** 挂载节点到选择器/元素(缺失时回落 ctx.root()) */
+  mount(target: string | Element, node: Node): Node
+  /** 插件 UI 挂载点(懒创建,自动附加到 body,#aw-plugin-<name>) */
+  root(): HTMLElement
+  /** UI 注入面(loader 注入;脱离宿主时为告警桩) */
+  ui: ClientUi
+  /** 插件命名空间翻译:ctx.t('settings.title') -> plugin.<name>.settings.title */
+  t(key: string, params?: ClientTranslateParams): string
+  /** 当前界面语言(loader 维护;i18n:changed 钩子在切换时广播;未注入时 '') */
+  readonly locale: string
+  /** 前缀 console 日志 */
+  log: ClientLogger
+  /** 卸载:回收订阅 + 清空挂载点 + 广播 client:destroy(幂等) */
+  dispose(): void
+}
+
+/**
+ * 创建客户端插件上下文(客户端 loader 调用)。
+ * @param opts.name        插件名(必填)
+ * @param opts.eventBridge scene 事件桥:注册回调并返回解绑函数
+ * @param opts.baseUrl     ctx.fetch 的前缀(baseUrl + path)
+ * @param opts.ui          UI 注入面(缺省告警桩)
+ * @param opts.t           翻译函数(缺省回退 plugin.<name>.<key>)
+ * @param opts.getLocale   当前语言读取器(缺省回退 '')
+ */
+export declare function createClientContext(opts?: {
+  name: string
+  eventBridge?: (fn: (type: string, payload: any) => void) => (() => void)
+  baseUrl?: string
+  ui?: ClientUi
+  t?: (key: string, params?: ClientTranslateParams) => string
+  getLocale?: () => string
+}): ClientContext
+
+/** 模块私有 el() 助手(default 导出可见;命名导出不含) */
+export declare function el(tag: string, attrs?: Record<string, unknown>, children?: Array<Node | string> | Node | string): HTMLElement
+
+declare const _default: {
+  CLIENT_SDK_VERSION: string
+  createClientContext: typeof createClientContext
+  el: typeof el
+}
+export default _default

package/sdk/examples/line-sentinel/index.mjs

@@ -1,105 +1,105 @@
-/**
- * line-sentinel — 产线哨兵(真实场景插件)
- * ------------------------------------------------------------
- * 职责:持续监视运行中产线的数采样本,越过告警阈值即记录并在 API 暴露;
- * 心跳定时器自证存活;监听产线启停与配置变更;展示 SDK 全部能力面。
- *
- * 使用 SDK 面:ctx.hooks · ctx.api(平台客户端) · ctx.timer(自动回收)
- *            · ctx.onDispose · ctx.kv · ctx.route · ctx.config.onChange
- *            · ctx.events · ctx.logger
- */
-export default {
-  name: 'line-sentinel',
-  version: '1.0.0',
-  description: '产线哨兵:数采越限告警 + 心跳 + 产线生命周期跟踪',
-  client: './client.mjs',
-
-  async setup(ctx) {
-    ctx.logger.info(`装载完成(scope=${ctx.scope}, sdk=${ctx.sdkVersion})`)
-
-    // 平台服务消费:启动时经 SDK API 客户端读取产线清单(自环调用)
-    try {
-      // ⚠️ GET /api/workshop/dcw/lines 返回的是 { lines, states } —— **不是数组**。
-      // 旧写法 Array.isArray(lines) 恒为 false,linesTotal 永远是 0(静默错误)。
-      const { lines } = await ctx.api.lines.list()
-      ctx.kv.set('linesTotal', Array.isArray(lines) ? lines.length : 0)
-      ctx.logger.info(`平台产线清单: ${ctx.kv.get('linesTotal')} 条`)
-    }
-    catch (err) {
-      ctx.logger.warn('产线清单读取失败(服务启动中,跳过):', err?.message)
-    }
-
-    // 配置变更订阅(aw config set / 设置页写入 → runtime-settings.json 变化)
-    ctx.config.onChange(() => {
-      const theme = ctx.config.get('theme.primaryColor')
-      ctx.logger.info(`配置已变更,当前主题色: ${theme}`)
-      ctx.kv.set('lastConfigAt', new Date().toISOString())
-    })
-
-    // 产线生命周期跟踪(事件消费增强:运行中产线计数)
-    ctx.hooks.on('line:start', (p) => {
-      ctx.kv.set('running', true)
-      ctx.kv.bump('runningCount')
-      ctx.kv.set('lastRun', { lineId: p?.lineId, at: new Date().toISOString() })
-      ctx.logger.info(`▶ 产线开跑 ${p?.lineId}`)
-    })
-    ctx.hooks.on('line:stop', () => {
-      ctx.kv.set('running', false)
-      ctx.logger.info('■ 产线停止')
-    })
-
-    // 核心:数采样本越限告警(阈值可经插件 KV 配置,默认 180)
-    ctx.hooks.on('daq:sample', (s) => {
-      ctx.kv.bump('samples')
-      const threshold = Number(ctx.kv.get('threshold')) || 180
-      if (typeof s?.value === 'number' && s.value > threshold) {
-        const key = `alarm:${s.nodeId}`
-        const prev = ctx.kv.get(key) ?? { count: 0 }
-        ctx.kv.set(key, { count: (prev.count ?? 0) + 1, value: s.value, at: s.at })
-        if ((prev.count ?? 0) === 0) ctx.logger.warn(`⚠ 越限告警 ${s.nodeId}: ${s.value} > ${threshold}`)
-      }
-    })
-
-    // scene 实时事件订阅(糖衣)
-    ctx.events.on('daq.node.changed', (p) => {
-      ctx.logger.debug?.('节点变更', p?.op ?? '')
-    })
-
-    // 心跳定时器(服务关闭自动回收):活性自证经免鉴权 manifest ping 验证 REST 自环通道
-    ctx.timer.setInterval(() => {
-      ctx.kv.set('heartbeat', new Date().toISOString())
-      ctx.api.plugins.manifest()
-        .then(() => ctx.kv.set('apiOk', true))
-        .catch(() => ctx.kv.set('apiOk', false))
-    }, 5000)
-
-    // 清理登记(关停时宿主逐个调用)
-    ctx.onDispose(() => ctx.logger.info('哨兵清理:告警状态已随 KV 落盘'))
-
-    // 插件 API:综合报告
-    ctx.route('GET', '/report', () => {
-      const alarms = Object.entries(ctx.kv.all())
-        .filter(([k]) => k.startsWith('alarm:'))
-        .map(([k, v]) => ({ nodeId: k.slice(6), ...v }))
-      return {
-        plugin: ctx.name,
-        // ctx 上没有 version(插件版本由 manifest 记录);这里报 SDK 版本才有意义
-        sdkVersion: ctx.sdkVersion,
-        running: ctx.kv.get('running') ?? false,
-        runningCount: ctx.kv.get('runningCount') ?? 0,
-        heartbeat: ctx.kv.get('heartbeat'),
-        apiChannel: ctx.kv.get('apiOk') === true ? 'ok' : ctx.kv.get('apiOk') === false ? 'down' : 'pending',
-        samplesWatched: ctx.kv.get('samples') ?? 0,
-        threshold: Number(ctx.kv.get('threshold')) || 180,
-        alarms,
-      }
-    })
-
-    ctx.route('POST', '/threshold', (event) => {
-      // 宿主 catchall 已预读 body 挂在 event.awBody
-      const v = Number(event.awBody?.threshold) || 180
-      ctx.kv.set('threshold', v)
-      return { ok: true, threshold: v }
-    })
-  },
-}
+/**
+ * line-sentinel — 产线哨兵(真实场景插件)
+ * ------------------------------------------------------------
+ * 职责:持续监视运行中产线的数采样本,越过告警阈值即记录并在 API 暴露;
+ * 心跳定时器自证存活;监听产线启停与配置变更;展示 SDK 全部能力面。
+ *
+ * 使用 SDK 面:ctx.hooks · ctx.api(平台客户端) · ctx.timer(自动回收)
+ *            · ctx.onDispose · ctx.kv · ctx.route · ctx.config.onChange
+ *            · ctx.events · ctx.logger
+ */
+export default {
+  name: 'line-sentinel',
+  version: '1.0.0',
+  description: '产线哨兵:数采越限告警 + 心跳 + 产线生命周期跟踪',
+  client: './client.mjs',
+
+  async setup(ctx) {
+    ctx.logger.info(`装载完成(scope=${ctx.scope}, sdk=${ctx.sdkVersion})`)
+
+    // 平台服务消费:启动时经 SDK API 客户端读取产线清单(自环调用)
+    try {
+      // ⚠️ GET /api/workshop/dcw/lines 返回的是 { lines, states } —— **不是数组**。
+      // 旧写法 Array.isArray(lines) 恒为 false,linesTotal 永远是 0(静默错误)。
+      const { lines } = await ctx.api.lines.list()
+      ctx.kv.set('linesTotal', Array.isArray(lines) ? lines.length : 0)
+      ctx.logger.info(`平台产线清单: ${ctx.kv.get('linesTotal')} 条`)
+    }
+    catch (err) {
+      ctx.logger.warn('产线清单读取失败(服务启动中,跳过):', err?.message)
+    }
+
+    // 配置变更订阅(aw config set / 设置页写入 → runtime-settings.json 变化)
+    ctx.config.onChange(() => {
+      const theme = ctx.config.get('theme.primaryColor')
+      ctx.logger.info(`配置已变更,当前主题色: ${theme}`)
+      ctx.kv.set('lastConfigAt', new Date().toISOString())
+    })
+
+    // 产线生命周期跟踪(事件消费增强:运行中产线计数)
+    ctx.hooks.on('line:start', (p) => {
+      ctx.kv.set('running', true)
+      ctx.kv.bump('runningCount')
+      ctx.kv.set('lastRun', { lineId: p?.lineId, at: new Date().toISOString() })
+      ctx.logger.info(`▶ 产线开跑 ${p?.lineId}`)
+    })
+    ctx.hooks.on('line:stop', () => {
+      ctx.kv.set('running', false)
+      ctx.logger.info('■ 产线停止')
+    })
+
+    // 核心:数采样本越限告警(阈值可经插件 KV 配置,默认 180)
+    ctx.hooks.on('daq:sample', (s) => {
+      ctx.kv.bump('samples')
+      const threshold = Number(ctx.kv.get('threshold')) || 180
+      if (typeof s?.value === 'number' && s.value > threshold) {
+        const key = `alarm:${s.nodeId}`
+        const prev = ctx.kv.get(key) ?? { count: 0 }
+        ctx.kv.set(key, { count: (prev.count ?? 0) + 1, value: s.value, at: s.at })
+        if ((prev.count ?? 0) === 0) ctx.logger.warn(`⚠ 越限告警 ${s.nodeId}: ${s.value} > ${threshold}`)
+      }
+    })
+
+    // scene 实时事件订阅(糖衣)
+    ctx.events.on('daq.node.changed', (p) => {
+      ctx.logger.debug?.('节点变更', p?.op ?? '')
+    })
+
+    // 心跳定时器(服务关闭自动回收):活性自证经免鉴权 manifest ping 验证 REST 自环通道
+    ctx.timer.setInterval(() => {
+      ctx.kv.set('heartbeat', new Date().toISOString())
+      ctx.api.plugins.manifest()
+        .then(() => ctx.kv.set('apiOk', true))
+        .catch(() => ctx.kv.set('apiOk', false))
+    }, 5000)
+
+    // 清理登记(关停时宿主逐个调用)
+    ctx.onDispose(() => ctx.logger.info('哨兵清理:告警状态已随 KV 落盘'))
+
+    // 插件 API:综合报告
+    ctx.route('GET', '/report', () => {
+      const alarms = Object.entries(ctx.kv.all())
+        .filter(([k]) => k.startsWith('alarm:'))
+        .map(([k, v]) => ({ nodeId: k.slice(6), ...v }))
+      return {
+        plugin: ctx.name,
+        // ctx 上没有 version(插件版本由 manifest 记录);这里报 SDK 版本才有意义
+        sdkVersion: ctx.sdkVersion,
+        running: ctx.kv.get('running') ?? false,
+        runningCount: ctx.kv.get('runningCount') ?? 0,
+        heartbeat: ctx.kv.get('heartbeat'),
+        apiChannel: ctx.kv.get('apiOk') === true ? 'ok' : ctx.kv.get('apiOk') === false ? 'down' : 'pending',
+        samplesWatched: ctx.kv.get('samples') ?? 0,
+        threshold: Number(ctx.kv.get('threshold')) || 180,
+        alarms,
+      }
+    })
+
+    ctx.route('POST', '/threshold', (event) => {
+      // 宿主 catchall 已预读 body 挂在 event.awBody
+      const v = Number(event.awBody?.threshold) || 180
+      ctx.kv.set('threshold', v)
+      return { ok: true, threshold: v }
+    })
+  },
+}

package/sdk/examples/ops-notifier/index.mjs

@@ -1,34 +1,34 @@
-/**
- * ops-notifier — 写控与产线事件回声(SDK 示例插件)
- * 滚动记录最近写控/启停事件(内存 + KV 防抖落盘),提供 /recent 查询 API;
- * 客户端以 toast 展示最近一次写控。展示 dcw:write / line:* 钩子与事件消费。
- */
-const ROLL = 30
-
-export default {
-  name: 'ops-notifier',
-  version: '1.0.0',
-  description: '写控与产线事件回声:滚动记录最近事件 + 查询 API + 客户端通知',
-  client: './client.mjs',
-
-  async setup(ctx) {
-    ctx.logger.info('已装载 —— 监听 dcw:write 与产线启停')
-
-    const push = (entry) => {
-      const log = ctx.kv.get('recent') ?? []
-      log.unshift(entry)
-      ctx.kv.set('recent', log.slice(0, ROLL))
-    }
-
-    ctx.hooks.on('dcw:write', (w) => {
-      push({ kind: 'write', nodeId: w.nodeId, name: w.name, eng: w.eng, ok: w.ok, source: w.source, at: w.at })
-    })
-    ctx.hooks.on('line:start', p => push({ kind: 'line:start', lineId: p?.lineId, at: new Date().toISOString() }))
-    ctx.hooks.on('line:stop', p => push({ kind: 'line:stop', lineId: p?.lineId, at: new Date().toISOString() }))
-
-    ctx.route('GET', '/recent', () => ({
-      plugin: ctx.name,
-      recent: ctx.kv.get('recent') ?? [],
-    }))
-  },
-}
+/**
+ * ops-notifier — 写控与产线事件回声(SDK 示例插件)
+ * 滚动记录最近写控/启停事件(内存 + KV 防抖落盘),提供 /recent 查询 API;
+ * 客户端以 toast 展示最近一次写控。展示 dcw:write / line:* 钩子与事件消费。
+ */
+const ROLL = 30
+
+export default {
+  name: 'ops-notifier',
+  version: '1.0.0',
+  description: '写控与产线事件回声:滚动记录最近事件 + 查询 API + 客户端通知',
+  client: './client.mjs',
+
+  async setup(ctx) {
+    ctx.logger.info('已装载 —— 监听 dcw:write 与产线启停')
+
+    const push = (entry) => {
+      const log = ctx.kv.get('recent') ?? []
+      log.unshift(entry)
+      ctx.kv.set('recent', log.slice(0, ROLL))
+    }
+
+    ctx.hooks.on('dcw:write', (w) => {
+      push({ kind: 'write', nodeId: w.nodeId, name: w.name, eng: w.eng, ok: w.ok, source: w.source, at: w.at })
+    })
+    ctx.hooks.on('line:start', p => push({ kind: 'line:start', lineId: p?.lineId, at: new Date().toISOString() }))
+    ctx.hooks.on('line:stop', p => push({ kind: 'line:stop', lineId: p?.lineId, at: new Date().toISOString() }))
+
+    ctx.route('GET', '/recent', () => ({
+      plugin: ctx.name,
+      recent: ctx.kv.get('recent') ?? [],
+    }))
+  },
+}

package/sdk/examples/sample-insight/index.mjs

@@ -1,39 +1,39 @@
-/**
- * sample-insight — SDK 示例插件(服务端面)。
- * 订阅下发级数采采样计数,并暴露插件 API:GET /api/plugins/sample-insight/stats
- * 完整指南见 docs/plugins.md。
- */
-export default {
-  name: 'sample-insight',
-  version: '1.0.0',
-  description: 'SDK 示例:数采采样计数 + 统计 API + 客户端徽标',
-
-  async setup(ctx) {
-    ctx.logger.info('示例插件已装载 —— daq:sample 计数中')
-
-    ctx.hooks.on('daq:sample', (s) => {
-      ctx.kv.bump('samples')
-      if (s?.nodeId) ctx.kv.set(`last:${s.nodeId}`, { value: s.value, at: s.at })
-    })
-
-    ctx.hooks.on('line:start', (p) => {
-      ctx.logger.info(`产线开跑: ${p?.lineId}`)
-      ctx.kv.set('lineRunning', true)
-    })
-
-    ctx.hooks.on('line:stop', () => ctx.kv.set('lineRunning', false))
-
-    ctx.route('GET', '/stats', () => ({
-      plugin: ctx.name,
-      version: ctx.sdkVersion,
-      samples: ctx.kv.get('samples') ?? 0,
-      lineRunning: ctx.kv.get('lineRunning') ?? false,
-      scope: ctx.scope,
-    }))
-
-    ctx.route('POST', '/reset', () => {
-      ctx.kv.set('samples', 0)
-      return { ok: true }
-    })
-  },
-}
+/**
+ * sample-insight — SDK 示例插件(服务端面)。
+ * 订阅下发级数采采样计数,并暴露插件 API:GET /api/plugins/sample-insight/stats
+ * 完整指南见 docs/plugins.md。
+ */
+export default {
+  name: 'sample-insight',
+  version: '1.0.0',
+  description: 'SDK 示例:数采采样计数 + 统计 API + 客户端徽标',
+
+  async setup(ctx) {
+    ctx.logger.info('示例插件已装载 —— daq:sample 计数中')
+
+    ctx.hooks.on('daq:sample', (s) => {
+      ctx.kv.bump('samples')
+      if (s?.nodeId) ctx.kv.set(`last:${s.nodeId}`, { value: s.value, at: s.at })
+    })
+
+    ctx.hooks.on('line:start', (p) => {
+      ctx.logger.info(`产线开跑: ${p?.lineId}`)
+      ctx.kv.set('lineRunning', true)
+    })
+
+    ctx.hooks.on('line:stop', () => ctx.kv.set('lineRunning', false))
+
+    ctx.route('GET', '/stats', () => ({
+      plugin: ctx.name,
+      version: ctx.sdkVersion,
+      samples: ctx.kv.get('samples') ?? 0,
+      lineRunning: ctx.kv.get('lineRunning') ?? false,
+      scope: ctx.scope,
+    }))
+
+    ctx.route('POST', '/reset', () => {
+      ctx.kv.set('samples', 0)
+      return { ok: true }
+    })
+  },
+}

package/server/api/plugins/client/[name].get.ts

@@ -1,18 +1,18 @@
-/**
- * GET /api/plugins/client/:name —— 插件客户端脚本(text/javascript)。
- * 自包含 ESM(无裸导入);客户端 loader 动态 import 后以 setup(ctx) 装载。
- * 信任模型与 aw commands 相同:仅装载自己放入插件目录的可信代码。
- */
-import { defineEventHandler, getRouterParam, setHeader, createError } from 'h3'
-import { readClientScript } from '@/server/services/workshop/plugins/host.mjs'
-
-export default defineEventHandler((event) => {
-  const name = String(getRouterParam(event, 'name') ?? '').replace(/\.mjs$/, '')
-  const r = readClientScript(name)
-  if (r.status !== 200) {
-    throw createError({ statusCode: r.status, statusMessage: r.status === 404 ? 'plugin client not found' : 'bad request' })
-  }
-  setHeader(event, 'content-type', r.contentType ?? 'text/javascript; charset=utf-8')
-  setHeader(event, 'cache-control', 'no-cache')
-  return r.code
-})
+/**
+ * GET /api/plugins/client/:name —— 插件客户端脚本(text/javascript)。
+ * 自包含 ESM(无裸导入);客户端 loader 动态 import 后以 setup(ctx) 装载。
+ * 信任模型与 aw commands 相同:仅装载自己放入插件目录的可信代码。
+ */
+import { defineEventHandler, getRouterParam, setHeader, createError } from 'h3'
+import { readClientScript } from '@/server/services/workshop/plugins/host.mjs'
+
+export default defineEventHandler((event) => {
+  const name = String(getRouterParam(event, 'name') ?? '').replace(/\.mjs$/, '')
+  const r = readClientScript(name)
+  if (r.status !== 200) {
+    throw createError({ statusCode: r.status, statusMessage: r.status === 404 ? 'plugin client not found' : 'bad request' })
+  }
+  setHeader(event, 'content-type', r.contentType ?? 'text/javascript; charset=utf-8')
+  setHeader(event, 'cache-control', 'no-cache')
+  return r.code
+})

package/server/api/plugins/i18n.get.ts

@@ -1,12 +1,12 @@
-/**
- * GET /api/plugins/i18n —— 全部插件的 i18n 消息包(免鉴权只读)。
- * 返回 { "<plugin>": { "<locale>": { key: value } } };前端 loader 启动/热重载时
- * 拉取,按 vue-i18n 命名空间 `plugin.<plugin>` 合并 —— 插件设置标签、面板文案
- * 由此获得多语言支持。仅 UI 文案:插件作者不得把敏感信息放进 i18n.json。
- */
-import { defineEventHandler } from 'h3'
-import { pluginI18nBundle } from '@/server/services/workshop/plugins/host.mjs'
-
-export default defineEventHandler(() => {
-  return { i18n: pluginI18nBundle(), locales: ['zh-CN', 'en'] }
-})
+/**
+ * GET /api/plugins/i18n —— 全部插件的 i18n 消息包(免鉴权只读)。
+ * 返回 { "<plugin>": { "<locale>": { key: value } } };前端 loader 启动/热重载时
+ * 拉取,按 vue-i18n 命名空间 `plugin.<plugin>` 合并 —— 插件设置标签、面板文案
+ * 由此获得多语言支持。仅 UI 文案:插件作者不得把敏感信息放进 i18n.json。
+ */
+import { defineEventHandler } from 'h3'
+import { pluginI18nBundle } from '@/server/services/workshop/plugins/host.mjs'
+
+export default defineEventHandler(() => {
+  return { i18n: pluginI18nBundle(), locales: ['zh-CN', 'en'] }
+})