agentworkshop 0.8.3 → 0.8.4

package/app/utils/chart-pipeline.ts

@@ -0,0 +1,193 @@
+/**
+ * EDA 管道前端工具 —— 数据后处理(用户代码,仅浏览器执行) + 通用图表 option 构建 + PNG 导出。
+ *
+ * 安全边界:transform 代码只在用户自己的浏览器里 new Function 执行(行业惯例,同
+ * Observable/Jupyter 客户端单元格),永不发往服务端 eval;服务端只存代码文本。
+ */
+import type { EChartsOption } from 'echarts'
+
+export interface PipelineRow {
+  [key: string]: unknown
+}
+
+/** 行内数值判定(null/undefined/空串不算数) */
+export function isNum(v: unknown): v is number {
+  return typeof v === 'number' && Number.isFinite(v)
+}
+
+/** 推断数据列(保序;数值列/时间列/其他) */
+export function deriveFields(rows: PipelineRow[]): { name: string, numeric: boolean }[] {
+  const cols = new Map<string, { numeric: number, seen: number }>()
+  for (const row of rows.slice(0, 200)) {
+    for (const [k, v] of Object.entries(row)) {
+      const c = cols.get(k) ?? { numeric: 0, seen: 0 }
+      c.seen += 1
+      if (isNum(v)) c.numeric += 1
+      cols.set(k, c)
+    }
+  }
+  return [...cols.entries()].map(([name, c]) => ({ name, numeric: c.numeric > 0 && c.numeric >= c.seen * 0.6 }))
+}
+
+/**
+ * 执行用户后处理代码。约定:代码里定义 `function transform(rows) { return rows }`,
+ * 返回新行数组;亦可就地 filter/map。任何异常都收敛为 { error },不抛出拖垮页面。
+ */
+export function runTransform(rows: PipelineRow[], code: string): { rows: PipelineRow[], error: string } {
+  const trimmed = code.trim()
+  if (!trimmed) return { rows, error: '' }
+  try {
+    const fn = new Function('rows', `"use strict";\n${trimmed}\n;return transform(rows);`) as (rows: PipelineRow[]) => PipelineRow[]
+    const out = fn(rows)
+    if (!Array.isArray(out)) return { rows, error: 'transform 必须返回数组。' }
+    return { rows: out as PipelineRow[], error: '' }
+  }
+  catch (err) {
+    return { rows, error: err instanceof Error ? `${err.name}: ${err.message}` : String(err) }
+  }
+}
+
+export interface PipelineConfig {
+  xField: string
+  yFields: string[]
+  groupField?: string
+  agg: 'avg' | 'sum' | 'min' | 'max' | 'count'
+  title?: string
+  yMin?: number | null
+  yMax?: number | null
+  refLine?: number | null
+}
+
+const AGG_FN: Record<PipelineConfig['agg'], (vals: number[]) => number> = {
+  avg: vs => vs.reduce((a, b) => a + b, 0) / Math.max(vs.length, 1),
+  sum: vs => vs.reduce((a, b) => a + b, 0),
+  min: vs => Math.min(...vs),
+  max: vs => Math.max(...vs),
+  count: vs => vs.length,
+}
+
+/** 按 x 分桶聚合(groupField 存在时再按组拆系列) */
+export function aggregateRows(rows: PipelineRow[], cfg: PipelineConfig): { categories: string[], series: Map<string, Array<number | null>> } {
+  const agg = AGG_FN[cfg.agg] ?? AGG_FN.avg
+  const buckets = new Map<string, Map<string, Map<string, number[]>>>()
+  for (const row of rows) {
+    const rawX = row[cfg.xField]
+    if (rawX === undefined || rawX === null) continue
+    const x = String(rawX)
+    const group = cfg.groupField ? String(row[cfg.groupField] ?? '—') : '__all__'
+    const bucket = buckets.get(x) ?? new Map<string, Map<string, number[]>>()
+    const cell = bucket.get(group) ?? new Map<string, number[]>()
+    for (const yf of cfg.yFields) {
+      const arr = cell.get(yf) ?? []
+      const v = row[yf]
+      if (isNum(v)) arr.push(v)
+      cell.set(yf, arr)
+    }
+    bucket.set(group, cell)
+    buckets.set(x, bucket)
+  }
+  const categories = [...buckets.keys()]
+  const series = new Map<string, Array<number | null>>()
+  const groups = new Set<string>()
+  for (const b of buckets.values()) for (const g of b.keys()) groups.add(g)
+  for (const g of groups) {
+    for (const yf of cfg.yFields) {
+      const key = groups.size > 1 || cfg.yFields.length > 1 ? `${g === '__all__' ? '' : `${g} · `}${yf}` : g === '__all__' ? yf : g
+      series.set(key, categories.map((x) => {
+        const vals = (buckets.get(x)?.get(g)?.get(yf) ?? []).filter(isNum)
+        return vals.length ? Math.round(agg(vals) * 1e6) / 1e6 : null
+      }))
+    }
+  }
+  return { categories, series }
+}
+
+/** 数值列直方图(等宽分箱) */
+export function histogramBins(rows: PipelineRow[], field: string, bins = 20): { edges: number[], counts: number[] } {
+  const vals = rows.map(r => r[field]).filter(isNum)
+  if (!vals.length) return { edges: [], counts: [] }
+  const min = Math.min(...vals)
+  const max = Math.max(...vals)
+  const width = (max - min) / bins || 1
+  const counts = new Array<number>(bins).fill(0)
+  for (const v of vals) {
+    const idx = Math.min(Math.floor((v - min) / width), bins - 1)
+    counts[idx] = (counts[idx] ?? 0) + 1
+  }
+  const edges = counts.map((_, i) => Math.round((min + width * i) * 1e4) / 1e4)
+  return { edges, counts }
+}
+
+const PALETTE = ['#35e0a0', '#41c8f4', '#f5c451', '#e57373', '#9f8fef', '#63d8c6']
+
+/** 通用 option:line/bar/scatter/pie/histogram 全走这里 */
+export function buildPipelineOption(type: string, cfg: PipelineConfig, rows: PipelineRow[]): EChartsOption {
+  const title = cfg.title ? { title: { text: cfg.title, left: 'left', textStyle: { fontSize: 13 } } } : {}
+  const base = {
+    ...title,
+    color: PALETTE,
+    tooltip: { trigger: 'axis' as const },
+    legend: { type: 'scroll' as const, bottom: 0, textStyle: { fontSize: 11 } },
+    grid: { left: 56, right: 24, top: cfg.title ? 44 : 24, bottom: 56 },
+    toolbox: { right: 8, top: 0, feature: { saveAsImage: { pixelRatio: 2 } } },
+  }
+  if (type === 'histogram') {
+    const field = cfg.yFields[0] ?? cfg.xField
+    const { edges, counts } = histogramBins(rows, field)
+    return {
+      ...base,
+      tooltip: { trigger: 'axis' as const },
+      xAxis: { type: 'category' as const, data: edges.map(e => String(e)), axisLabel: { fontSize: 10 } },
+      yAxis: { type: 'value' as const, ...(cfg.yMin != null ? { min: cfg.yMin } : {}), ...(cfg.yMax != null ? { max: cfg.yMax } : {}) },
+      series: [{ type: 'bar', name: field, data: counts, barCategoryGap: '8%' }],
+    }
+  }
+  if (type === 'pie') {
+    const field = cfg.yFields[0] ?? ''
+    const data = rows.slice(0, 200).map(r => ({ name: String(r[cfg.xField] ?? '?'), value: isNum(r[field]) ? r[field] : 0 }))
+    return {
+      ...base,
+      tooltip: { trigger: 'item' as const },
+      legend: { type: 'scroll' as const, bottom: 0, textStyle: { fontSize: 11 } },
+      series: [{ type: 'pie', radius: ['38%', '68%'], data, label: { fontSize: 10 } }],
+    }
+  }
+  const { categories, series } = aggregateRows(rows, cfg)
+  const xAxis = {
+    type: 'category' as const,
+    data: categories,
+    axisLabel: { fontSize: 10, rotate: categories.length > 24 ? 40 : 0 },
+  }
+  const yAxis = {
+    type: 'value' as const,
+    ...(cfg.yMin != null ? { min: cfg.yMin } : {}),
+    ...(cfg.yMax != null ? { max: cfg.yMax } : {}),
+  }
+  const markLine = cfg.refLine != null
+    ? { markLine: { silent: true, symbol: 'none', lineStyle: { type: 'dashed' as const }, data: [{ yAxis: cfg.refLine }] } }
+    : {}
+  if (type === 'bar') {
+    return {
+      ...base,
+      xAxis, yAxis,
+      series: [...series.entries()].map(([name, data]) => ({ type: 'bar' as const, name, data, barMaxWidth: 32, ...markLine })),
+    }
+  }
+  if (type === 'scatter') {
+    return {
+      ...base,
+      tooltip: { trigger: 'item' as const },
+      xAxis: { ...xAxis, type: 'category' as const },
+      yAxis,
+      series: [...series.entries()].map(([name, data]) => ({ type: 'scatter' as const, name, data, symbolSize: 7, ...markLine })),
+    }
+  }
+  return {
+    ...base,
+    xAxis, yAxis,
+    series: [...series.entries()].map(([name, data]) => ({
+      type: 'line' as const, name, data, symbol: 'none', lineWidth: 1.6,
+      ...markLine,
+    })),
+  }
+}

package/config.yml

@@ -12,7 +12,7 @@
 app:
   name: AgentWorkShop
   title: AgentWorkShop
-  version: 0.8.3
+  version: 0.8.4
   description: 基于 Nuxt 4 的配置驱动运行范式
 
 # 运行模式（dev/prod 实际由启动命令决定，此处仅作运行时展示）

package/docs/cli.en.md

@@ -62,7 +62,7 @@ pnpm tui             # the terminal workbench
 ### 3. Quick use via npx (no global install)
 
 ```bash
-npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.8.3 start)
+npx agentworkshop start            # fetch and start (pin a version with: npx agentworkshop@0.8.4 start)
 npx agentworkshop doctor           # subcommands work as usual
 npx -p agentworkshop aw doctor     # use -p when you want the name aw
 ```
@@ -79,7 +79,7 @@ npx -p agentworkshop aw doctor     # use -p when you want the name aw
 | Package manager | `pnpm@11.9.0` (`packageManager`, needed only for source development) |
 | Module format | ESM (`type: module`) |
 | License | `Apache-2.0` |
-| Current version | `0.8.3` (`package.json`) |
+| Current version | `0.8.4` (`package.json`) |
 
 ## 2. First start (the Claude Code experience)
 

package/docs/cli.md

@@ -60,7 +60,7 @@ pnpm tui             # 终端工作台
 ### 3. npx 快速使用（免全局安装）
 
 ```bash
-npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.8.3 start)
+npx agentworkshop start            # 拉取并启动(可锁定版本: npx agentworkshop@0.8.4 start)
 npx agentworkshop doctor           # 子命令照常可用
 npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 ```
@@ -76,7 +76,7 @@ npx -p agentworkshop aw doctor     # 需要 aw 这个名字时用 -p 指定包
 | 包管理器 | `pnpm@11.9.0`（`packageManager`，仅源码开发需要） |
 | 模块形态 | ESM（`type: module`） |
 | 许可证 | `Apache-2.0` |
-| 当前版本 | `0.8.3`（`package.json`） |
+| 当前版本 | `0.8.4`（`package.json`） |
 
 ## 二、首次启动（Claude Code 式）
 

package/docs/plugins.en.md

@@ -9,7 +9,7 @@
 >
 > Applies to: plugin system v2 has been available since **v0.7.29** (frontend component
 > injection / plugin settings / plugin i18n / runtime services surface); this document
-> describes **v0.8.3**. `ctx.sdkVersion` is currently `0.3.0`.
+> describes **v0.8.4**. `ctx.sdkVersion` is currently `0.3.0`.
 
 ## 1. Folder layout & quick start
 

package/docs/plugins.md

@@ -6,7 +6,7 @@
 > 本文是唯一权威参考;`docs/site/plugins/` 的分页文档与本文同源。
 >
 > 适用版本:插件系统 v2 自 **v0.7.29** 起可用(前端组件注入 / 插件设置 / 插件 i18n /
-> 运行时服务面);本文档对应当前版本 **v0.8.3**。`ctx.sdkVersion` 当前为 `0.3.0`。
+> 运行时服务面);本文档对应当前版本 **v0.8.4**。`ctx.sdkVersion` 当前为 `0.3.0`。
 
 ## 一、目录结构与快速开始
 

package/docs/sdk.en.md

@@ -7,7 +7,7 @@
 
 **SDK version constants**: server-side `SDK_VERSION = '0.3.0'`, browser-side `CLIENT_SDK_VERSION = '0.3.0'`.
 These two constants are the **interface version of the SDK itself** and evolve **independently**
-from the npm package version (the `version` field in `package.json`, currently 0.8.3) —
+from the npm package version (the `version` field in `package.json`, currently 0.8.4) —
 them being out of sync is expected. Never use `SDK_VERSION` to infer the package version, or the reverse.
 **Module format**: ESM only (only `import` / `export`; there is no CJS entry).
 **Types**: `sdk/index.d.mts` and `sdk/client.d.mts` ship with the package, so TypeScript projects

package/docs/sdk.md

@@ -5,7 +5,7 @@
 > 零第三方运行时依赖,Node ≥ 23.4 与现代浏览器双端可用。
 
 **SDK 版本常量**:服务端 `SDK_VERSION = '0.3.0'`,浏览器端 `CLIENT_SDK_VERSION = '0.3.0'`。
-这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.8.3)
+这两个常量是 **SDK 自身接口的版本号**,与 npm 包版本(`package.json` 的 `version`,当前 0.8.4)
 **各自独立演进** —— 常数不同步是预期行为,不要拿 `SDK_VERSION` 去推断包版本,反之亦然。
 **模块形态**:ESM only(只有 `import` / `export`,没有 CJS 入口)。
 **类型**:`sdk/index.d.mts`、`sdk/client.d.mts` 随包发布,TS 项目零配置获得提示(覆盖范围见 §7)。

package/i18n/locales/en.ts

@@ -1744,6 +1744,7 @@ export default {
     graph: {
       viewGraph: 'Graph',
       viewTable: 'Table',
+      baseline: 'baseline',
       hint: 'Click a node for details and neighbours; dashed = candidate influence, solid = observed / validated',
       searchEntity: 'Search entity key or name',
       largeGraph: '{n} entities — focus mode: search one entity to inspect its neighbourhood',
@@ -3279,6 +3280,51 @@ export default {
     promptTitle: 'Agent deep-analysis prompt (paste into a Channel)',
     copy: 'Copy',
     copied: 'Copied to clipboard',
+    pipeline: {
+      title: 'EDA Analysis Pipeline',
+      sub: 'Fetch data → custom post-processing → chart config (save as template) → draw / export / online viewer',
+      backToStudio: 'Back to Studio',
+      s1: 'Fetch data',
+      pickLine: 'Pick a line…',
+      w15: 'Last 15 min',
+      w60: 'Last 1 h',
+      w240: 'Last 4 h',
+      fetch: 'Fetch data',
+      importPlaceholder: 'Paste CSV/TSV (header row):\nbatch,weight\nB1,32.5\nB2,32.7',
+      importBtn: 'Import table',
+      fetching: 'Fetching…',
+      s2: 'Data table & post-processing (code your own aggregation/filter)',
+      noRows: 'No data yet. Pick a line and nodes, then press Fetch.',
+      rowsInfo: '{n} rows, previewing first {show}:',
+      codePlaceholder: 'Define transform(rows) to filter/aggregate/derive columns and return the new row array (runs locally in your browser).',
+      applyTransform: 'Apply transform',
+      resetTransform: 'Reset to raw',
+      transformedTo: 'Transformed: {n} rows.',
+      s3: 'Chart config',
+      chartType: 'Type',
+      valueField: 'Value field',
+      groupBy: 'Group by',
+      agg: 'Agg',
+      refLine: 'Ref line',
+      chartTitle: 'Chart title',
+      s4: 'Config templates (persisted; one-click re-plot on new data)',
+      templateName: 'Template name…',
+      templateSave: 'Save as template',
+      templateSaved: 'Template saved.',
+      templateApplied: 'Template "{name}" applied.',
+      s5: 'Draw & output',
+      draw: 'Draw',
+      openViewer: 'Online viewer',
+      download: 'Download PNG',
+      saveChart: 'Save as chart',
+      saveResult: 'Save as analysis result',
+      savedChart: 'Chart saved (visible in Studio/Board).',
+      savedResult: 'Analysis result saved (visible in ledger).',
+      resultTitle: 'EDA pipeline analysis result',
+      resultSummary: 'Pipeline analysis over {n} rows × {cols} numeric columns.',
+      resultReport: 'Chart type {type}, {rows} rows; see metrics & context.',
+      viewerHint: 'Scroll to zoom / toolbox top-right to save image',
+    },
   },
   board: {
     title: 'EDA Board',

package/i18n/locales/zh-CN.ts

@@ -1744,6 +1744,7 @@ export default {
     graph: {
       viewGraph: '图',
       viewTable: '表',
+      baseline: '基线',
       hint: '点击节点查看详情与邻接；虚线=候选影响，实线=已观测/已验证',
       searchEntity: '搜索实体 key 或名称',
       largeGraph: '实体较多（{n} 个），已切换为聚焦模式：先搜索一个实体再看邻接',
@@ -3278,6 +3279,51 @@ export default {
     promptTitle: 'Agent 深度分析提示词(复制到 Channel 即可发起)',
     copy: '复制',
     copied: '已复制到剪贴板',
+    pipeline: {
+      title: 'EDA 分析管道',
+      sub: '拉取数据 → 自定义后处理 → 图表配置(可存模板) → 绘图/导出/在线查看',
+      backToStudio: '返回工坊',
+      s1: '拉取数据',
+      pickLine: '选择产线…',
+      w15: '近 15 分钟',
+      w60: '近 1 小时',
+      w240: '近 4 小时',
+      fetch: '拉取数据',
+      importPlaceholder: '粘贴 CSV/TSV(首行表头):\n批次,克重\nB1,32.5\nB2,32.7',
+      importBtn: '导入数据表',
+      fetching: '拉取中…',
+      s2: '数据表与后处理(可写代码聚合/筛选)',
+      noRows: '尚未拉取数据。选择产线与测点后点「拉取数据」。',
+      rowsInfo: '共 {n} 行,预览前 {show} 行:',
+      codePlaceholder: '定义 transform(rows) 函数,做过滤/聚合/派生列,返回新行数组(在浏览器本地执行)。',
+      applyTransform: '应用后处理',
+      resetTransform: '还原原始数据',
+      transformedTo: '后处理完成:{n} 行。',
+      s3: '图表配置',
+      chartType: '图型',
+      valueField: '值字段',
+      groupBy: '分组',
+      agg: '聚合',
+      refLine: '参考线',
+      chartTitle: '图表标题',
+      s4: '配置模板(持久化,换数据一键复绘)',
+      templateName: '模板名…',
+      templateSave: '保存为模板',
+      templateSaved: '模板已保存。',
+      templateApplied: '已应用模板「{name}」。',
+      s5: '绘图与输出',
+      draw: '开始绘图',
+      openViewer: '在线查看',
+      download: '下载 PNG',
+      saveChart: '保存为图表',
+      saveResult: '保存为分析结果',
+      savedChart: '图表已保存(工坊/看板可见)。',
+      savedResult: '分析结果已保存(台账可见)。',
+      resultTitle: 'EDA 管道分析结果',
+      resultSummary: '基于 {n} 行 × {cols} 个数值列的管道分析。',
+      resultReport: '图型 {type},数据 {rows} 行;详见 metrics 与 context。',
+      viewerHint: '滚轮缩放 / 工具箱右上角可存图',
+    },
   },
   board: {
     title: 'EDA 看板',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "type": "module",
   "description": "AgentWorkShop 软件开发系统 - 基于 Nuxt 4 的配置驱动运行范式",
   "license": "Apache-2.0",

package/scripts/check-docs-sync.mjs

@@ -292,7 +292,7 @@ section('[5/6] VitePress 模板安全:正文裸尖括号不得被当成未闭合
 // 占位符,Vue 会把它当成自定义元素并因缺少 </home> 直接**构建失败**
 // (实际发生过:plugins/guide.md 曾导致 `vitepress build` 报 Element is missing end tag)。
 // 行内代码/围栏代码里的尖括号会被 markdown-it 转义,是安全的 —— 先剥掉再扫。
-const SAFE_TAGS = new Set(['div', 'img', 'br', 'b', 'i', 'strong', 'em', 'a', 'span', 'code', 'pre', 'table', 'thead', 'tbody', 'tr', 'th', 'td', 'sub', 'sup', 'p', 'ul', 'ol', 'li', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'kbd', 'details', 'summary', 'picture', 'source', 'video', 'hr', 'small', 'figure', 'figcaption', 'section', 'input'])
+const SAFE_TAGS = new Set(['div', 'img', 'br', 'b', 'i', 'strong', 'em', 'a', 'span', 'code', 'pre', 'table', 'thead', 'tbody', 'tr', 'th', 'td', 'sub', 'sup', 'p', 'ul', 'ol', 'li', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'kbd', 'details', 'summary', 'picture', 'source', 'video', 'audio', 'track', 'hr', 'small', 'figure', 'figcaption', 'section', 'input', 'blockquote', 'del', 'ins', 'mark'])
 const stripCode = md => md
   .replace(/^```[\s\S]*?^```/gm, '')
   .replace(/<!--[\s\S]*?-->/g, '')