agentworkshop 0.7.59 → 0.7.61

package/app/components/analysis/AnalysisTable.vue

@@ -0,0 +1,322 @@
+<script setup lang="ts">
+/**
+ * 分析报告台账表:时间 / 产线 / 标题(类别) / 配方 / 关键结论 / 来源 / 详情。
+ * 行内展开详情(结论明细 + 完整正文 + 支撑指标 + 证据窗),照 LogsEventTable 的
+ * 原生 table + 展开行模式(全站惯例:原生表格,antd a-table 才需要显式 columns)。
+ */
+import { formatLocalClock } from '@/app/composables/workshop/useLocalTime'
+import { useLogsScope } from '@/app/pages/logs/composables/useLogsScope'
+import type { AnalysisReportView } from '@/app/pages/analysis/types'
+
+defineProps<{
+  rows: AnalysisReportView[]
+  loading: boolean
+  error: string
+  /** 管理面:admin 可见删除(清污数据;台账 Agent 面无删) */
+  admin: boolean
+}>()
+
+const emit = defineEmits<{
+  toggle: [row: AnalysisReportView]
+  remove: [row: AnalysisReportView]
+  edit: [row: AnalysisReportView]
+}>()
+
+const expandedId = defineModel<string>('expandedId', { default: '' })
+
+const { lineName } = useLogsScope()
+const { t } = useI18n()
+
+const fmtTime = (iso: string): string => formatLocalClock(iso)
+const catLabel = (c: string): string => {
+  const known = ['quality', 'oee', 'alarm', 'trend', 'optimization', 'general']
+  return known.includes(c) ? t(`analysis.cat.${c}`) : c
+}
+
+const recipeLabel = (r: AnalysisReportView): string =>
+  r.recipeId ? `${r.recipeId}${r.recipeVersion ? ` v${r.recipeVersion}` : ''}` : '—'
+
+const hasDetail = (r: AnalysisReportView): boolean =>
+  Boolean(r.conclusions.length || r.report || Object.keys(r.metrics ?? {}).length || r.dataSources)
+
+const metricsText = (r: AnalysisReportView): string => {
+  try {
+    return JSON.stringify(r.metrics ?? {}, null, 1)
+  }
+  catch {
+    return ''
+  }
+}
+
+const contextText = (r: AnalysisReportView): string => {
+  try {
+    return JSON.stringify(r.context ?? {}, null, 1)
+  }
+  catch {
+    return ''
+  }
+}
+</script>
+
+<template>
+  <section class="table-card">
+    <div class="card-meta">
+      <span class="count">{{ $t('analysis.count', { p0: rows.length }) }}</span>
+      <span class="hint">{{ $t('analysis.ledgerHint') }}</span>
+    </div>
+    <p
+      v-if="error"
+      class="err"
+    >
+      {{ error }}
+    </p>
+    <table class="ar-table">
+      <thead>
+        <tr>
+          <th class="th-time">
+            {{ $t('analysis.thTime') }}
+          </th>
+          <th class="th-line">
+            {{ $t('analysis.thLine') }}
+          </th>
+          <th>{{ $t('analysis.thTitle') }}</th>
+          <th class="th-recipe">
+            {{ $t('analysis.thRecipe') }}
+          </th>
+          <th>{{ $t('analysis.thSummary') }}</th>
+          <th class="th-src">
+            {{ $t('analysis.thSource') }}
+          </th>
+          <th class="th-detail">
+            {{ $t('analysis.thDetail') }}
+          </th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr v-if="loading && rows.length === 0">
+          <td
+            colspan="7"
+            class="empty"
+          >
+            {{ $t('analysis.loading') }}
+          </td>
+        </tr>
+        <tr v-else-if="rows.length === 0">
+          <td
+            colspan="7"
+            class="empty"
+          >
+            {{ $t('analysis.empty') }}
+          </td>
+        </tr>
+        <template
+          v-for="row in rows"
+          :key="row.id"
+        >
+          <tr>
+            <td class="mono dim">
+              {{ fmtTime(row.createdAt) }}
+            </td>
+            <td>
+              <span class="scope-chip">{{ row.lineName || lineName(row.lineId) || row.lineId || '—' }}</span>
+            </td>
+            <td class="title-cell">
+              {{ row.title }}
+              <small
+                class="cat-chip"
+                :class="row.category"
+              >{{ catLabel(row.category) }}</small>
+            </td>
+            <td class="mono dim">
+              {{ recipeLabel(row) }}
+            </td>
+            <td class="summary">
+              {{ row.summary || '—' }}
+            </td>
+            <td class="src">
+              {{ row.actorName || row.actor || '—' }}
+              <small
+                v-if="row.channelName"
+                class="dim"
+              >@{{ row.channelName }}</small>
+            </td>
+            <td class="detail-cell">
+              <button
+                v-if="hasDetail(row)"
+                class="mini-btn"
+                @click="emit('toggle', row)"
+              >
+                {{ expandedId === row.id ? $t('analysis.fold') : $t('analysis.expand') }}
+              </button>
+              <span
+                v-else
+                class="dim"
+              >{{ $t('analysis.noDetail') }}</span>
+              <button
+                v-if="row.canEdit"
+                class="mini-btn"
+                :title="$t('analysis.editTitle')"
+                @click="emit('edit', row)"
+              >
+                <span class="i-tabler-pencil" />
+              </button>
+              <a-popconfirm
+                v-if="admin"
+                :title="$t('analysis.removeConfirm', { p0: row.title })"
+                :ok-text="$t('analysis.remove')"
+                :cancel-text="$t('analysis.cancel')"
+                placement="left"
+                @confirm="emit('remove', row)"
+              >
+                <button
+                  class="mini-btn danger"
+                  :title="$t('analysis.remove')"
+                >
+                  <span class="i-tabler-trash" />
+                </button>
+              </a-popconfirm>
+            </td>
+          </tr>
+          <tr
+            v-if="expandedId === row.id"
+            class="ar-detail-row"
+          >
+            <td colspan="7">
+              <div class="detail-grid">
+                <div
+                  v-if="row.updatedAt"
+                  class="kv kv-full revised"
+                >
+                  <span class="k">{{ $t('analysis.kRevised') }}</span>
+                  <span>{{ fmtTime(row.updatedAt) }} · {{ row.updatedByName || row.updatedBy }}</span>
+                </div>
+                <div class="kv">
+                  <span class="k">{{ $t('analysis.kId') }}</span>
+                  <span class="mono">{{ row.id }}</span>
+                </div>
+                <div class="kv">
+                  <span class="k">{{ $t('analysis.kWindow') }}</span>
+                  <span class="mono">
+                    {{ row.windowFrom ? fmtTime(row.windowFrom) : '—' }} ~ {{ row.windowTo ? fmtTime(row.windowTo) : '—' }}
+                  </span>
+                </div>
+                <div
+                  v-if="row.dataSources"
+                  class="kv kv-full"
+                >
+                  <span class="k">{{ $t('analysis.kSources') }}</span>
+                  <span>{{ row.dataSources }}</span>
+                </div>
+                <template v-if="row.conclusions.length">
+                  <div class="sec-title">
+                    {{ $t('analysis.kConclusions') }}
+                  </div>
+                  <ol class="conclusions">
+                    <li
+                      v-for="(c, i) in row.conclusions"
+                      :key="i"
+                    >
+                      {{ c }}
+                    </li>
+                  </ol>
+                </template>
+                <template v-if="row.report">
+                  <div class="sec-title">
+                    {{ $t('analysis.kReport') }}
+                  </div>
+                  <pre class="report-body">{{ row.report }}</pre>
+                </template>
+                <template v-if="Object.keys(row.metrics ?? {}).length">
+                  <div class="sec-title">
+                    {{ $t('analysis.kMetrics') }}
+                  </div>
+                  <pre class="json-body">{{ metricsText(row) }}</pre>
+                </template>
+                <template v-if="Object.keys(row.context ?? {}).length">
+                  <div class="sec-title">
+                    {{ $t('analysis.kContext') }}
+                  </div>
+                  <pre class="json-body">{{ contextText(row) }}</pre>
+                </template>
+              </div>
+            </td>
+          </tr>
+        </template>
+      </tbody>
+    </table>
+  </section>
+</template>
+
+<style scoped>
+.table-card {
+  background: var(--surface-glass);
+  border: 1px solid var(--glass-line);
+  border-radius: 10px;
+  backdrop-filter: var(--aurora-blur) saturate(1.15);
+  overflow: hidden;
+}
+.card-meta {
+  display: flex; gap: 12px; align-items: center;
+  padding: 8px 14px;
+  border-bottom: 1px solid color-mix(in srgb, var(--glass-line) 55%, transparent);
+  font-size: 11.5px; color: var(--ink-faint);
+}
+.card-meta .count { font-weight: 600; color: var(--ink); }
+.card-meta .hint { margin-left: auto; }
+.mini-btn.danger { color: var(--tone-danger-dot, #ff6b6b); margin-left: 4px; }
+.err { margin: 0; padding: 10px 14px; font-size: 12.5px; color: var(--tone-danger-dot, #ff6b6b); }
+.ar-table { width: 100%; border-collapse: collapse; font-size: 12.5px; }
+.ar-table thead th {
+  position: sticky; top: 0; z-index: 1;
+  padding: 9px 12px; text-align: left; font-weight: 600; font-size: 11.5px; color: var(--ink-faint);
+  background: color-mix(in srgb, var(--frost-bg) 92%, transparent);
+  border-bottom: 1px solid var(--glass-line);
+  white-space: nowrap;
+}
+.ar-table tbody td { padding: 9px 12px; border-bottom: 1px solid color-mix(in srgb, var(--glass-line) 55%, transparent); vertical-align: top; }
+.th-time { width: 128px; }
+.th-line { width: 130px; }
+.th-recipe { width: 170px; }
+.th-src { width: 150px; }
+.th-detail { width: 92px; }
+.title-cell { max-width: 320px; font-weight: 600; }
+.cat-chip {
+  display: inline-block; margin-left: 6px; padding: 1px 7px; border-radius: 999px;
+  font-size: 10.5px; font-weight: 500; color: var(--ink-faint);
+  background: color-mix(in srgb, var(--glass-line) 40%, transparent);
+  vertical-align: 1px;
+}
+.summary { max-width: 380px; }
+.src small { display: block; }
+.mono { font-family: var(--font-mono, monospace); font-size: 11.5px; }
+.dim { color: var(--ink-faint); }
+.empty { padding: 28px 12px !important; text-align: center; color: var(--ink-faint); }
+.scope-chip {
+  display: inline-block; padding: 1px 8px; border-radius: 999px; font-size: 11px;
+  background: color-mix(in srgb, var(--tone-info-dot) 14%, transparent);
+  border: 1px solid color-mix(in srgb, var(--tone-info-dot) 25%, transparent);
+}
+.detail-cell { white-space: nowrap; }
+.ar-detail-row td {
+  background: color-mix(in srgb, var(--frost-bg) 55%, transparent);
+}
+.detail-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 8px 18px; padding: 4px 2px; }
+.kv { display: flex; gap: 10px; font-size: 12px; align-items: baseline; }
+.kv-full { grid-column: 1 / -1; }
+.kv .k { flex: none; min-width: 64px; color: var(--ink-faint); font-size: 11.5px; }
+.sec-title { grid-column: 1 / -1; margin-top: 6px; font-size: 11.5px; font-weight: 600; color: var(--ink-faint); }
+.conclusions { grid-column: 1 / -1; margin: 0; padding-left: 22px; font-size: 12.5px; line-height: 1.7; }
+.report-body, .json-body {
+  grid-column: 1 / -1; margin: 0; padding: 10px 12px;
+  font-family: var(--font-mono, monospace); font-size: 11.5px; line-height: 1.6;
+  white-space: pre-wrap; word-break: break-word;
+  background: color-mix(in srgb, var(--glass-line) 22%, transparent);
+  border: 1px solid color-mix(in srgb, var(--glass-line) 45%, transparent);
+  border-radius: 8px;
+  max-height: 340px; overflow: auto;
+}
+@media (max-width: 899px) {
+  .th-recipe, .th-src { display: none; }
+  .ar-table tbody td:nth-child(4), .ar-table tbody td:nth-child(6) { display: none; }
+}
+</style>

package/app/composables/useRouteMeta.ts

@@ -32,6 +32,7 @@ export function useRouteMeta() {
     // 新增路由必须同时登记进这张表,否则标题就是"路径首字母大写"。
     '/aml': { key: 'menu.aml', icon: 'i-tabler-flask' },
     '/logs': { key: 'menu.logs', icon: 'i-tabler-list-details' },
+    '/analysis': { key: 'menu.analysis', icon: 'i-tabler-report-analytics' },
     '/permissions': { key: 'menu.permissions', icon: 'i-tabler-shield-lock' },
     '/plugins': { key: 'menu.plugins', icon: 'i-tabler-puzzle' },
     '/users': { key: 'menu.users', icon: 'i-tabler-users-group' },

package/app/config/schema.ts

@@ -137,6 +137,7 @@ export const appConfigSchema = z.object({
     messages_days: z.number().min(1).max(3650).default(30),
     audit_days: z.number().min(1).max(3650).default(90),
     approval_days: z.number().min(1).max(3650).default(180),
+    analysis_days: z.number().min(1).max(3650).default(365),
   }).default({}),
   log: z.object({
     level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),

package/app/pages/analysis/composables/useAnalysisFeed.ts

@@ -0,0 +1,85 @@
+/**
+ * 数据分析页的数据面:REST 快照为底 + WS 实时帧触发节流刷新。
+ *
+ * 权威查询走 GET /api/workshop/analysis(lineId/category/q/from/to);
+ * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',由 analysis_save 的 recordOps 广播)——
+ * 收到新留痕帧后去抖拉一次快照,避免自己维护两套行形状的合并去重。
+ */
+import { computed, onScopeDispose, reactive, ref } from 'vue'
+import { apiFetch } from '@/app/composables/workshop/apiClient'
+import { useTownBus } from '@/app/composables/workshop/useTownBus'
+import { ANALYSIS_WINDOW_PRESETS, type AnalysisReportView, type AnalysisWindowPreset } from '../types'
+
+/** 统一客户端:信封 {code,message,data} 解析取 .data(与 aml 页请求写法同源) */
+function analysisApi<T>(path: string, init?: RequestInit): Promise<T> {
+  return apiFetch<T>({ base: '/api/workshop/analysis', path, init })
+}
+
+export function useAnalysisFeed() {
+  const bus = useTownBus()
+
+  const q = reactive<{ lineId: string, category: string, preset: AnalysisWindowPreset, text: string }>({
+    lineId: '',
+    category: '',
+    preset: 'all',
+    text: '',
+  })
+  const hasFilter = computed(() => Boolean(q.lineId || q.category || q.preset !== 'all' || q.text.trim()))
+
+  const rows = ref<AnalysisReportView[]>([])
+  const loading = ref(false)
+  const error = ref('')
+  /** 实时轨计数(本会话收到的 analysis 留痕帧数,页头脉冲用) */
+  const liveCount = ref(0)
+
+  async function doQuery(): Promise<void> {
+    loading.value = true
+    error.value = ''
+    try {
+      const preset = ANALYSIS_WINDOW_PRESETS.find(p => p.key === q.preset)
+      const params = new URLSearchParams()
+      if (q.lineId) params.set('lineId', q.lineId)
+      if (q.category) params.set('category', q.category)
+      if (q.text.trim()) params.set('q', q.text.trim())
+      if (preset?.ms) params.set('from', new Date(Date.now() - preset.ms).toISOString())
+      params.set('limit', '200')
+      const data = await analysisApi<{ reports: AnalysisReportView[], count: number }>(`/?${params.toString()}`)
+      rows.value = data.reports ?? []
+    }
+    catch (err) {
+      error.value = err instanceof Error ? err.message : String(err)
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  function resetFilters(): void {
+    q.lineId = ''
+    q.category = ''
+    q.preset = 'all'
+    q.text = ''
+    void doQuery()
+  }
+
+  // WS 实时面:analysis 留痕帧 → 计数 + 去抖刷新快照(连发多份报告只拉一次)。
+  // TownBus 信封 type 是宽化联合,kind 按字段读取收窄。
+  let refreshTimer: ReturnType<typeof setTimeout> | null = null
+  const unsubscribe = bus.subscribe((e) => {
+    if (e.type !== 'ops.log') return
+    const p = e.payload as { kind?: string, action?: string }
+    if (p.kind !== 'analysis' || p.action === 'analysis.delete') return
+    liveCount.value++
+    if (refreshTimer) return
+    refreshTimer = setTimeout(() => {
+      refreshTimer = null
+      void doQuery()
+    }, 800)
+  })
+  onScopeDispose(() => {
+    unsubscribe()
+    if (refreshTimer) clearTimeout(refreshTimer)
+  })
+
+  return { q, hasFilter, rows, loading, error, liveCount, doQuery, resetFilters }
+}

package/app/pages/analysis/index.vue

@@ -0,0 +1,128 @@
+<template>
+  <div class="page">
+    <!-- 页头(aw-page-head 规范)+ 实时轨计数 -->
+    <AnalysisPageHead :live-count="feed.liveCount.value" />
+
+    <!-- 筛选:产线 / 类别 / 时间窗 / 关键词 -->
+    <AnalysisFilterCard
+      v-model:line-id="feed.q.lineId"
+      v-model:category="feed.q.category"
+      v-model:preset="feed.q.preset"
+      v-model:text="feed.q.text"
+      :has-filter="feed.hasFilter.value"
+      :loading="feed.loading.value"
+      @query="feed.doQuery"
+      @reset="feed.resetFilters"
+    />
+
+    <!-- 分析报告台账:REST 快照为底,analysis 留痕 WS 帧去抖刷新;admin 可删,canEdit 可修订 -->
+    <AnalysisTable
+      v-model:expanded-id="expandedId"
+      :rows="feed.rows.value"
+      :loading="feed.loading.value"
+      :error="feed.error.value"
+      :admin="userStore.isAdmin"
+      @toggle="toggleRow"
+      @remove="removeReport"
+      @edit="openEdit"
+    />
+
+    <!-- 人工修订弹窗(v27 编辑面;canEdit 行可见) -->
+    <AnalysisEditModal
+      :report="editing"
+      :saving="savingEdit"
+      @close="editing = null"
+      @save="saveEdit"
+    />
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * 数据分析页 —— Agent Channel 分析产出的持久留痕台账(append-only)。
+ *
+ * 数据权威在 server analysis_reports 表:GET /api/workshop/analysis 按维度查询;
+ * 实时面是 TownBus 旁路的 ops.log 帧(kind='analysis',analysis_save 的 recordOps 广播),
+ * 收到帧后去抖拉快照。留痕由 Agent 经 analysis_save 原生工具写入,页面纯只读
+ * (清污数据走 admin 的 DELETE /api/workshop/analysis/:id)。
+ * 数据面在 composables/useAnalysisFeed,展示在 components/analysis/*
+ * (app/pages 下任何 .vue 都会成为路由,页面私有子组件不放这里)。
+ */
+import { onMounted, ref } from 'vue'
+import { useUserStore } from '~/stores/workshop/user'
+import { useWorkshopWs } from '@/app/composables/workshop/useWorkshopWs'
+import { apiFetch } from '@/app/composables/workshop/apiClient'
+import { apiErrorMessage } from '@/app/utils/api-error'
+import { useAnalysisFeed } from './composables/useAnalysisFeed'
+import type { AnalysisReportView } from './types'
+import AnalysisPageHead from '~/components/analysis/AnalysisPageHead.vue'
+import AnalysisFilterCard from '~/components/analysis/AnalysisFilterCard.vue'
+import AnalysisTable from '~/components/analysis/AnalysisTable.vue'
+import AnalysisEditModal from '~/components/analysis/AnalysisEditModal.vue'
+
+const ws = useWorkshopWs()
+const feed = useAnalysisFeed()
+const userStore = useUserStore()
+const expandedId = ref('')
+
+function toggleRow(row: AnalysisReportView): void {
+  expandedId.value = expandedId.value === row.id ? '' : row.id
+}
+
+/** 管理面删除(仅 admin;REST 侧 requireRole 兜底) */
+const removing = ref(false)
+async function removeReport(row: AnalysisReportView): Promise<void> {
+  if (removing.value) return
+  removing.value = true
+  try {
+    await apiFetch({ base: '/api/workshop/analysis', path: `/${row.id}`, init: { method: 'DELETE' } })
+    if (expandedId.value === row.id) expandedId.value = ''
+    await feed.doQuery()
+  }
+  catch (err) {
+    feed.error.value = apiErrorMessage(err)
+  }
+  finally {
+    removing.value = false
+  }
+}
+
+/** 人工修订(v27 编辑面):弹窗预填 → PATCH → 刷新(服务端按 canEdit 同口径鉴权) */
+const editing = ref<AnalysisReportView | null>(null)
+const savingEdit = ref(false)
+function openEdit(row: AnalysisReportView): void {
+  editing.value = row
+}
+async function saveEdit(patch: Record<string, unknown>): Promise<void> {
+  if (!editing.value || savingEdit.value) return
+  savingEdit.value = true
+  try {
+    await apiFetch({
+      base: '/api/workshop/analysis',
+      path: `/${editing.value.id}`,
+      init: { method: 'PATCH', body: JSON.stringify(patch) },
+    })
+    editing.value = null
+    await feed.doQuery()
+  }
+  catch (err) {
+    feed.error.value = apiErrorMessage(err)
+  }
+  finally {
+    savingEdit.value = false
+  }
+}
+
+onMounted(() => {
+  ws.ensureConnected()
+  void feed.doQuery()
+})
+</script>
+
+<script lang="ts">
+export default { name: 'AnalysisPage' }
+</script>
+
+<style scoped>
+.page { display: flex; flex-direction: column; gap: 12px; }
+</style>

package/app/pages/analysis/types.ts

@@ -0,0 +1,50 @@
+/**
+ * 数据分析页的类型面(与 server/services/workshop/analysis/analysis.repo.ts 的
+ * AnalysisReportRow 驼峰投影一致;JSON 列已在服务端解析)。
+ */
+
+/** 分析类别(与 analysis_save 工具描述的建议档一致;自由面,未知类别按原文展示) */
+export type AnalysisCategory = 'quality' | 'oee' | 'alarm' | 'trend' | 'optimization' | 'general'
+
+export const ANALYSIS_CATEGORIES: AnalysisCategory[] = ['quality', 'oee', 'alarm', 'trend', 'optimization', 'general']
+
+/** 时间窗预设(前端算 fromMs;all = 不限) */
+export type AnalysisWindowPreset = '1h' | '24h' | '7d' | '30d' | 'all'
+
+export const ANALYSIS_WINDOW_PRESETS: { key: AnalysisWindowPreset, ms: number | null }[] = [
+  { key: '1h', ms: 3_600_000 },
+  { key: '24h', ms: 86_400_000 },
+  { key: '7d', ms: 7 * 86_400_000 },
+  { key: '30d', ms: 30 * 86_400_000 },
+  { key: 'all', ms: null },
+]
+
+export interface AnalysisReportView {
+  id: string
+  lineId: string
+  lineName: string
+  title: string
+  category: string
+  /** 一句话关键结论 */
+  summary: string
+  conclusions: string[]
+  report: string
+  metrics: Record<string, unknown>
+  recipeId: string
+  recipeVersion: string
+  windowFrom: string | null
+  windowTo: string | null
+  dataSources: string
+  context: Record<string, unknown>
+  channelId: string
+  channelName: string
+  actor: string
+  actorName: string
+  createdAt: string
+  /** v27 人工修订归因(未修订 = null/空) */
+  updatedAt: string | null
+  updatedBy: string
+  updatedByName: string
+  /** 编辑能力位(服务端按 admin/产线 operate 判定) */
+  canEdit?: boolean
+}