agentworkshop 0.7.58 → 0.7.60

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentworkshop-prod",
-  "version": "0.7.58",
+  "version": "0.7.60",
   "type": "module",
   "private": true,
   "dependencies": {

package/README-zh.md

@@ -797,6 +797,23 @@ Windows 用 `nssm install AgentWorkShop "C:\Program Files\nodejs\node.exe" scrip
 开关在模块加载时读取,必须在进程启动前确认未设置(误配时启动日志会告警)。
 `AW_RATE_LIMIT_OFF=1` 只关 API 限流、不影响写控联锁,生产同样必须不设。
 
+## 研究论文
+
+平台的治理机制已写成投稿级论文——**《Grading Machine-Originated Plant Writes: Separately
+Inspectable Evidence for Industrial Agent Teams》**(IEEE Transactions on Industrial
+Informatics 匿名评审稿,IEEEtran 双栏 10 页)。源文件、编译稿与五席评审记录在
+[`paper/tii/SUBMISSION-IEEE-TII/`](./paper/tii/SUBMISSION-IEEE-TII/)。论文中的每一条机制
+主张都由仓库内归档证据支撑:
+
+- [`docs/benchmarks/`](./docs/benchmarks)——2026-10 部署级回归战役:7 次流水线执行、
+  600 项检查零失败(每次运行归档 `report.md` / `benchmark.json` / `timeline.jsonl`),
+  另含准入消融伴随运行;
+- [`docs/experiments/`](./docs/experiments)——铸膜闭环实验计划与结果(论文 Q3 确定性闭环);
+- [`docs/audit/`](./docs/audit)——评估节引用的验收波次(约 1400+ 条真实断言)。
+
+本地复跑论文流水线:设置 `AW_BENCH_MODE=1` 并按
+[`bench/PIPELINE.md`](./bench/PIPELINE.md) 执行。
+
 ## 路线图
 
 | 能力 | 状态 |

package/README.md

@@ -818,6 +818,26 @@ load — confirm it is absent **before** the process starts (a misconfiguration
 boot). `AW_RATE_LIMIT_OFF=1` only disables the API rate guard (write-control interlocks
 stay on) and must likewise remain unset in production.
 
+## Research paper
+
+The platform's governance mechanisms are documented in a submission-ready manuscript —
+**"Grading Machine-Originated Plant Writes: Separately Inspectable Evidence for Industrial
+Agent Teams"** (IEEE Transactions on Industrial Informatics, anonymous review draft,
+10 pages, IEEEtran). Source, compiled PDF and the five-seat review trail live in
+[`paper/tii/SUBMISSION-IEEE-TII/`](./paper/tii/SUBMISSION-IEEE-TII/). Every mechanism
+claim in the paper is backed by archives in this repository:
+
+- [`docs/benchmarks/`](./docs/benchmarks) — the October 2026 deployment-scale regression
+  campaign: 7 pipeline executions, 600 checks, zero failed (per-run `report.md` /
+  `benchmark.json` / `timeline.jsonl`), plus the admission-ablation companion run;
+- [`docs/experiments/`](./docs/experiments) — cast-film closed-loop experiment plan and
+  results (the paper's Q3 deterministic loop);
+- [`docs/audit/`](./docs/audit) — acceptance waves (~1400+ real assertions) referenced
+  by the evaluation section.
+
+Re-run the paper pipeline locally: set `AW_BENCH_MODE=1` and follow
+[`bench/PIPELINE.md`](./bench/PIPELINE.md).
+
 ## Roadmap
 
 | Capability | Status |

package/app/components/AppSidebar.vue

@@ -53,6 +53,7 @@ const menuGroups = computed<MenuGroup[]>(() => [
     label: t('menu.groups.ops'),
     items: [
       { key: '/operations', icon: 'i-tabler-broadcast', label: t('menu.operations'), motion: 'im-pop' },
+      { key: '/analysis', icon: 'i-tabler-report-analytics', label: t('menu.analysis'), motion: 'im-pop' },
       { key: '/monitor', icon: 'i-tabler-cpu', label: t('menu.monitor'), motion: 'im-pulse' },
       { key: '/logs', icon: 'i-tabler-list-details', label: t('menu.logs'), motion: 'im-pop' },
     ],

package/app/components/analysis/AnalysisFilterCard.vue

@@ -0,0 +1,160 @@
+<script setup lang="ts">
+/**
+ * 数据分析筛选卡:产线 / 类别 / 时间窗 / 关键词 + 查询/重置。
+ * 筛选态由页面持有(useAnalysisFeed),这里只做双向绑定;
+ * 产线选项与日志页同一份权威目录(useLogsScope → DCW 流单例)。
+ */
+import { ANALYSIS_CATEGORIES } from '@/app/pages/analysis/types'
+import { ANALYSIS_WINDOW_PRESETS } from '@/app/pages/analysis/types'
+import { useLogsScope } from '@/app/pages/logs/composables/useLogsScope'
+
+defineProps<{
+  /** 是否已设任一筛选维度(决定"重置"按钮显隐) */
+  hasFilter: boolean
+  /** 查询中(查询按钮置灰) */
+  loading: boolean
+}>()
+
+defineEmits<{
+  query: []
+  reset: []
+}>()
+
+const lineId = defineModel<string>('lineId', { required: true })
+const category = defineModel<string>('category', { required: true })
+const preset = defineModel<string>('preset', { required: true })
+const text = defineModel<string>('text', { required: true })
+
+const { lines } = useLogsScope()
+</script>
+
+<template>
+  <section class="filter-card">
+    <label class="flt">
+      <span>{{ $t('analysis.fLine') }}</span>
+      <select
+        v-model="lineId"
+        class="inp-sel"
+      >
+        <option value="">
+          {{ $t('analysis.all') }}
+        </option>
+        <option
+          v-for="l in lines"
+          :key="l.id"
+          :value="l.id"
+        >
+          {{ l.name }}
+        </option>
+      </select>
+    </label>
+    <label class="flt">
+      <span>{{ $t('analysis.fCat') }}</span>
+      <select
+        v-model="category"
+        class="inp-sel"
+      >
+        <option value="">
+          {{ $t('analysis.all') }}
+        </option>
+        <option
+          v-for="c in ANALYSIS_CATEGORIES"
+          :key="c"
+          :value="c"
+        >
+          {{ $t(`analysis.cat.${c}`) }}
+        </option>
+      </select>
+    </label>
+    <label class="flt">
+      <span>{{ $t('analysis.fWindow') }}</span>
+      <select
+        v-model="preset"
+        class="inp-sel"
+      >
+        <option
+          v-for="p in ANALYSIS_WINDOW_PRESETS"
+          :key="p.key"
+          :value="p.key"
+        >
+          {{ $t(`analysis.win.${p.key}`) }}
+        </option>
+      </select>
+    </label>
+    <label class="flt flt-grow">
+      <span>{{ $t('analysis.fKeyword') }}</span>
+      <input
+        v-model="text"
+        class="inp-sel"
+        type="search"
+        :placeholder="$t('analysis.fKeywordPh')"
+        @keydown.enter="$emit('query')"
+      >
+    </label>
+    <button
+      class="pill-btn"
+      :disabled="loading"
+      @click="$emit('query')"
+    >
+      <span class="i-tabler-search" />
+      {{ $t('analysis.query') }}
+    </button>
+    <button
+      v-if="hasFilter"
+      class="mini-btn"
+      @click="$emit('reset')"
+    >
+      {{ $t('analysis.reset') }}
+    </button>
+  </section>
+</template>
+
+<style scoped>
+.filter-card {
+  display: flex; flex-wrap: wrap; gap: 10px; align-items: flex-end;
+  padding: 10px 14px;
+  background: var(--surface-glass);
+  border: 1px solid var(--glass-line);
+  border-radius: 10px;
+  backdrop-filter: var(--aurora-blur) saturate(1.15);
+}
+@media (max-width: 640px) {
+  .filter-card {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 8px;
+    align-items: end;
+  }
+  .filter-card .flt-grow,
+  .filter-card > button {
+    grid-column: 1 / -1;
+  }
+}
+.flt { display: flex; flex-direction: column; gap: 4px; font-size: 11.5px; color: var(--ink-faint); }
+.flt-grow { flex: 1 1 180px; }
+/* 输入框工具类:与 LogsFilterCard 同名规则逐字复制(样式随标记走,不抽公共 css) */
+.inp-sel {
+  min-width: 0; padding: 6px 9px; font-size: 13px; color: var(--ink);
+  background: var(--frost-bg);
+  border: 1px solid var(--glass-line); border-radius: 7px; outline: none;
+}
+.inp-sel:focus { border-color: color-mix(in srgb, var(--tone-info-dot) 55%, transparent); }
+@media (max-width: 899px) {
+  .filter-card .mini-btn,
+  .filter-card .pill-btn {
+    min-height: 40px;
+    padding: 8px 14px;
+  }
+  .filter-card {
+    padding: 10px;
+    gap: 8px;
+  }
+  .flt,
+  .flt-grow,
+  .flt .inp-sel {
+    flex: 1 1 100%;
+    width: 100%;
+    min-width: 0;
+  }
+}
+</style>

package/app/components/analysis/AnalysisPageHead.vue

@@ -0,0 +1,47 @@
+<script setup lang="ts">
+/**
+ * 数据分析页页头:aw-page-head 规范(kicker + 大标题 + 描述)+ 实时轨计数。
+ * 计数 = 本会话收到的 analysis 留痕 WS 帧(useAnalysisFeed.liveCount)。
+ */
+defineProps<{
+  /** 实时轨当前帧数 */
+  liveCount: number
+}>()
+</script>
+
+<template>
+  <header class="aw-page-head">
+    <div>
+      <p class="aw-kicker">
+        agentworkshop / data analysis
+      </p>
+      <h1>{{ $t('analysis.title') }}</h1>
+      <p class="sub">
+        {{ $t('analysis.sub') }}
+      </p>
+    </div>
+    <div class="head-actions">
+      <span
+        class="live-dot"
+        :title="$t('analysis.liveHint')"
+      /><span class="live-txt mono">{{ $t('analysis.live') }} {{ liveCount }}</span>
+    </div>
+  </header>
+</template>
+
+<style scoped>
+.head-actions { display: flex; gap: 10px; align-items: center; padding-bottom: 4px; }
+.sub { margin: 8px 0 0; font-size: 13px; color: var(--ink-faint); }
+.live-dot {
+  width: 8px; height: 8px; border-radius: 50%;
+  background: var(--tone-success-dot);
+  box-shadow: 0 0 0 0 color-mix(in srgb, var(--tone-success-dot) 45%, transparent);
+  animation: analysisLivePulse 2s ease-out infinite;
+}
+@keyframes analysisLivePulse {
+  0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--tone-success-dot) 45%, transparent); }
+  70% { box-shadow: 0 0 0 8px transparent; }
+  100% { box-shadow: 0 0 0 0 transparent; }
+}
+.live-txt { font-size: 11.5px; color: var(--ink-faint); }
+</style>

package/app/components/analysis/AnalysisTable.vue

@@ -0,0 +1,306 @@
+<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]
+}>()
+
+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>
+              <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 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 }
+}