agentworkshop 0.7.49 → 0.7.50

package/app/pages/dcw/composables/useDcwWrites.ts

@@ -1,81 +1,100 @@
-import { reactive, ref } from 'vue'
-import { useDcwStream } from '~/composables/workshop/useDcwStream'
-
-/**
- * 写路径(直写 / 手动读 / 逐节点控制开关)—— 在飞节点 id 与错误/成功回显的唯一副本。
- * 读写都经 server 门控(暂停/锁定由后端拒绝),本地只做即时收敛与提示。
- */
-export function useDcwWrites() {
-  const { t } = useI18n()
-  const dcw = useDcwStream()
-
-  // ---------- 直写 ----------
-  const setInputs = reactive<Record<string, number | ''>>({})
-  const writingId = ref('')
-  const writeError = ref('')
-  const writeOk = ref('')
-
-  async function doWrite(nodeId: string, value: number): Promise<void> {
-    writingId.value = nodeId
-    writeError.value = ''
-    writeOk.value = ''
-    try {
-      const outcome = await dcw.write(nodeId, value)
-      if (outcome.ok) {
-        writeOk.value = t('dcwDetail.k1alcbyu182', { p0: dcw.nodeById(nodeId)?.name ?? nodeId, p1: outcome.message })
-        setInputs[nodeId] = ''
-      }
-      else {
-        writeError.value = t('dcwDetail.kl1e9x9183', { p0: dcw.nodeById(nodeId)?.name ?? nodeId, p1: outcome.message })
-      }
-    }
-    catch (err) {
-      writeError.value = apiErrorMessage(err)
-    }
-    finally {
-      writingId.value = ''
-    }
-  }
-
-  // ---------- 读取(读写集成的读半边:手动读 PLC 当前值,周期读由服务端调度) ----------
-  const readingId = ref('')
-
-  async function doRead(nodeId: string): Promise<void> {
-    readingId.value = nodeId
-    writeError.value = ''
-    try {
-      await dcw.readNode(nodeId)
-    }
-    catch (err) {
-      writeError.value = apiErrorMessage(err)
-    }
-    finally {
-      readingId.value = ''
-    }
-  }
-
-  // ---------- 逐节点 控制开启/暂停 ----------
-  const togglingId = ref('')
-  /** 开启/暂停单个节点的控制:暂停后服务端拒绝一切下发(409 当前节点暂停),本地即时收敛状态 */
-  async function toggleControl(nodeId: string, enabled: boolean): Promise<void> {
-    togglingId.value = nodeId
-    writeError.value = ''
-    try {
-      await dcw.patchNode(nodeId, { enabled })
-      const n = dcw.nodeById(nodeId)
-      if (n) {
-        n.enabled = enabled
-        if (!enabled) n.state = 'offline'
-        else if (n.state === 'offline') n.state = 'idle'
-      }
-    }
-    catch (err) {
-      writeError.value = apiErrorMessage(err)
-    }
-    finally {
-      togglingId.value = ''
-    }
-  }
-
-  return { setInputs, writingId, writeError, writeOk, doWrite, readingId, doRead, togglingId, toggleControl }
-}
+import { reactive, ref } from 'vue'
+import { useDcwStream } from '~/composables/workshop/useDcwStream'
+
+/**
+ * 写路径(直写 / 手动读 / 逐节点控制开关)—— 在飞节点 id 与错误/成功回显的唯一副本。
+ * 读写都经 server 门控(暂停/锁定由后端拒绝),本地只做即时收敛与提示。
+ */
+export function useDcwWrites() {
+  const { t } = useI18n()
+  const dcw = useDcwStream()
+
+  // ---------- 直写 ----------
+  const setInputs = reactive<Record<string, number | ''>>({})
+  const writingId = ref('')
+  const writeError = ref('')
+  const writeOk = ref('')
+
+  async function doWrite(nodeId: string, value: number): Promise<void> {
+    writingId.value = nodeId
+    writeError.value = ''
+    writeOk.value = ''
+    try {
+      const outcome = await dcw.write(nodeId, value)
+      if (outcome.ok) {
+        writeOk.value = t('dcwDetail.k1alcbyu182', { p0: dcw.nodeById(nodeId)?.name ?? nodeId, p1: outcome.message })
+        setInputs[nodeId] = ''
+      }
+      else {
+        writeError.value = t('dcwDetail.kl1e9x9183', { p0: dcw.nodeById(nodeId)?.name ?? nodeId, p1: outcome.message })
+      }
+    }
+    catch (err) {
+      writeError.value = apiErrorMessage(err)
+    }
+    finally {
+      writingId.value = ''
+    }
+  }
+
+  // ---------- 读取(读写集成的读半边:手动读 PLC 当前值,周期读由服务端调度) ----------
+  const readingId = ref('')
+
+  async function doRead(nodeId: string): Promise<void> {
+    readingId.value = nodeId
+    writeError.value = ''
+    try {
+      await dcw.readNode(nodeId)
+    }
+    catch (err) {
+      writeError.value = apiErrorMessage(err)
+    }
+    finally {
+      readingId.value = ''
+    }
+  }
+
+  // ---------- 探索阶段单步上限(节点默认) ----------
+  const stepPatchingId = ref('')
+  async function patchStepLimit(nodeId: string, value: number | null): Promise<void> {
+    stepPatchingId.value = nodeId
+    writeError.value = ''
+    try {
+      await dcw.patchNode(nodeId, { stepLimit: value })
+      const n = dcw.nodeById(nodeId)
+      if (n) n.stepLimit = value
+      writeOk.value = `已保存「${n?.name ?? nodeId}」的探索单步上限${value == null ? '：未配置（探索写入将被拒绝）' : `：Δ≤${value}${n?.unit ?? ''}`}。`
+    }
+    catch (err) {
+      writeError.value = apiErrorMessage(err)
+    }
+    finally {
+      stepPatchingId.value = ''
+    }
+  }
+
+  // ---------- 逐节点 控制开启/暂停 ----------
+  const togglingId = ref('')
+  /** 开启/暂停单个节点的控制:暂停后服务端拒绝一切下发(409 当前节点暂停),本地即时收敛状态 */
+  async function toggleControl(nodeId: string, enabled: boolean): Promise<void> {
+    togglingId.value = nodeId
+    writeError.value = ''
+    try {
+      await dcw.patchNode(nodeId, { enabled })
+      const n = dcw.nodeById(nodeId)
+      if (n) {
+        n.enabled = enabled
+        if (!enabled) n.state = 'offline'
+        else if (n.state === 'offline') n.state = 'idle'
+      }
+    }
+    catch (err) {
+      writeError.value = apiErrorMessage(err)
+    }
+    finally {
+      togglingId.value = ''
+    }
+  }
+
+  return { setInputs, writingId, writeError, writeOk, doWrite, readingId, doRead, togglingId, toggleControl, stepPatchingId, patchStepLimit }
+}

package/app/pages/monitor/composables/useMonitorData.ts

@@ -1,124 +1,125 @@
-/**
- * 监控页的数据面:快照轮询、自动刷新定时器、终止动作。
- *
- * 副作用只在这里注册一次 —— 快照(ref)与 5s 定时器都是**唯一副本**,页面调一次、
- * 子组件只消费 props,所以拆组件不会多出第二份实时数据或第二个定时器;
- * onMounted 建定时器与 onBeforeUnmount 拆定时器仍成对出现在同一个 composable 里
- * (子组件不碰任何订阅/清理,调用方也无须再造一遍清理逻辑)。
- */
-import { message } from 'ant-design-vue'
-import type { AgentView, ApiEnvelope, MonitorSnapshot, ProcessView } from '../types'
-import { narrowFetch } from '../../../stores/workshop/narrow-fetch'
-import { useUserStore } from '../../../stores/workshop/user'
-
-export interface MonitorDataHooks {
-  /** 首次拉取完成后的回调(?agentId=&channelId= 深链自动开终端;只有 onMounted 那次拉取会触发) */
-  onInitialPoll?: () => void
-}
-
-export function useMonitorData(hooks: MonitorDataHooks = {}) {
-  const { t } = useI18n()
-  const userStore = useUserStore()
-
-  const snapshot = ref<MonitorSnapshot | null>(null)
-  const loading = ref(false)
-  const autoRefresh = ref(true)
-  const lastUpdated = ref('')
-
-  const poll = async (): Promise<void> => {
-    if (!userStore.token) return
-    loading.value = true
-    try {
-      const res = await narrowFetch<ApiEnvelope<MonitorSnapshot>>('/api/system/monitor', {
-        headers: { authorization: `Bearer ${userStore.token}` },
-      })
-      snapshot.value = res.data
-      lastUpdated.value = new Date().toLocaleTimeString()
-    }
-    catch (e) {
-      message.error(e instanceof Error ? e.message : t('monitor.loadFailed'))
-    }
-    finally {
-      loading.value = false
-    }
-  }
-
-  // 自动刷新(默认 5s;仅在已登录且有 token 时轮询)
-  let timer: ReturnType<typeof setInterval> | null = null
-  const applyTimer = (): void => {
-    if (timer) {
-      clearInterval(timer)
-      timer = null
-    }
-    if (autoRefresh.value && userStore.token) {
-      timer = setInterval(() => void poll(), 5000)
-    }
-  }
-  watch(autoRefresh, () => applyTimer())
-  watch(() => userStore.token, () => {
-    if (userStore.token) void poll()
-    else snapshot.value = null
-    applyTimer()
-  })
-
-  onMounted(() => {
-    if (userStore.token) {
-      void poll().then(() => hooks.onInitialPoll?.())
-    }
-    applyTimer()
-  })
-  onBeforeUnmount(() => {
-    if (timer) clearInterval(timer)
-  })
-
-  // ===== 终止动作 =====
-  const terminating = ref(false)
-  const doTerminateAgent = async (a: AgentView): Promise<void> => {
-    terminating.value = true
-    try {
-      const res = await narrowFetch<ApiEnvelope<{ agentId: string, stopped: boolean }>>('/api/system/monitor/terminate', {
-        method: 'POST',
-        headers: { authorization: `Bearer ${userStore.token}` },
-        body: { channelId: a.channelId, agentId: a.agentId },
-      })
-      message.success(res.code === 0 ? `${a.name} ${t('monitor.terminated')}` : (res.message ?? t('monitor.failed')))
-      await poll()
-    }
-    catch (e) {
-      message.error(e instanceof Error ? e.message : t('monitor.failed'))
-    }
-    finally {
-      terminating.value = false
-    }
-  }
-
-  const doTerminatePid = async (p: ProcessView): Promise<void> => {
-    terminating.value = true
-    try {
-      const res = await narrowFetch<ApiEnvelope<{ pid: number, killed: boolean }>>('/api/system/monitor/terminate', {
-        method: 'POST',
-        headers: { authorization: `Bearer ${userStore.token}` },
-        body: { pid: p.pid },
-      })
-      message.success(res.code === 0 ? `PID ${p.pid} ${t('monitor.terminated')}` : (res.message ?? t('monitor.failed')))
-      await poll()
-    }
-    catch (e) {
-      message.error(e instanceof Error ? e.message : t('monitor.failed'))
-    }
-    finally {
-      terminating.value = false
-    }
-  }
-
-  return {
-    snapshot,
-    loading,
-    autoRefresh,
-    lastUpdated,
-    terminating,
-    poll,
-    doTerminateAgent,
-    doTerminatePid,
-  }
-}
+/**
+ * 监控页的数据面:快照轮询、自动刷新定时器、终止动作。
+ *
+ * 副作用只在这里注册一次 —— 快照(ref)与 5s 定时器都是**唯一副本**,页面调一次、
+ * 子组件只消费 props,所以拆组件不会多出第二份实时数据或第二个定时器;
+ * onMounted 建定时器与 onBeforeUnmount 拆定时器仍成对出现在同一个 composable 里
+ * (子组件不碰任何订阅/清理,调用方也无须再造一遍清理逻辑)。
+ */
+import { message } from 'ant-design-vue'
+import type { AgentView, ApiEnvelope, MonitorSnapshot, ProcessView } from '../types'
+import { narrowFetch } from '../../../stores/workshop/narrow-fetch'
+import { useUserStore } from '../../../stores/workshop/user'
+import { formatLocalClock } from '@/app/composables/workshop/useLocalTime'
+
+export interface MonitorDataHooks {
+  /** 首次拉取完成后的回调(?agentId=&channelId= 深链自动开终端;只有 onMounted 那次拉取会触发) */
+  onInitialPoll?: () => void
+}
+
+export function useMonitorData(hooks: MonitorDataHooks = {}) {
+  const { t } = useI18n()
+  const userStore = useUserStore()
+
+  const snapshot = ref<MonitorSnapshot | null>(null)
+  const loading = ref(false)
+  const autoRefresh = ref(true)
+  const lastUpdated = ref('')
+
+  const poll = async (): Promise<void> => {
+    if (!userStore.token) return
+    loading.value = true
+    try {
+      const res = await narrowFetch<ApiEnvelope<MonitorSnapshot>>('/api/system/monitor', {
+        headers: { authorization: `Bearer ${userStore.token}` },
+      })
+      snapshot.value = res.data
+      lastUpdated.value = formatLocalClock(new Date().toISOString())
+    }
+    catch (e) {
+      message.error(e instanceof Error ? e.message : t('monitor.loadFailed'))
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  // 自动刷新(默认 5s;仅在已登录且有 token 时轮询)
+  let timer: ReturnType<typeof setInterval> | null = null
+  const applyTimer = (): void => {
+    if (timer) {
+      clearInterval(timer)
+      timer = null
+    }
+    if (autoRefresh.value && userStore.token) {
+      timer = setInterval(() => void poll(), 5000)
+    }
+  }
+  watch(autoRefresh, () => applyTimer())
+  watch(() => userStore.token, () => {
+    if (userStore.token) void poll()
+    else snapshot.value = null
+    applyTimer()
+  })
+
+  onMounted(() => {
+    if (userStore.token) {
+      void poll().then(() => hooks.onInitialPoll?.())
+    }
+    applyTimer()
+  })
+  onBeforeUnmount(() => {
+    if (timer) clearInterval(timer)
+  })
+
+  // ===== 终止动作 =====
+  const terminating = ref(false)
+  const doTerminateAgent = async (a: AgentView): Promise<void> => {
+    terminating.value = true
+    try {
+      const res = await narrowFetch<ApiEnvelope<{ agentId: string, stopped: boolean }>>('/api/system/monitor/terminate', {
+        method: 'POST',
+        headers: { authorization: `Bearer ${userStore.token}` },
+        body: { channelId: a.channelId, agentId: a.agentId },
+      })
+      message.success(res.code === 0 ? `${a.name} ${t('monitor.terminated')}` : (res.message ?? t('monitor.failed')))
+      await poll()
+    }
+    catch (e) {
+      message.error(e instanceof Error ? e.message : t('monitor.failed'))
+    }
+    finally {
+      terminating.value = false
+    }
+  }
+
+  const doTerminatePid = async (p: ProcessView): Promise<void> => {
+    terminating.value = true
+    try {
+      const res = await narrowFetch<ApiEnvelope<{ pid: number, killed: boolean }>>('/api/system/monitor/terminate', {
+        method: 'POST',
+        headers: { authorization: `Bearer ${userStore.token}` },
+        body: { pid: p.pid },
+      })
+      message.success(res.code === 0 ? `PID ${p.pid} ${t('monitor.terminated')}` : (res.message ?? t('monitor.failed')))
+      await poll()
+    }
+    catch (e) {
+      message.error(e instanceof Error ? e.message : t('monitor.failed'))
+    }
+    finally {
+      terminating.value = false
+    }
+  }
+
+  return {
+    snapshot,
+    loading,
+    autoRefresh,
+    lastUpdated,
+    terminating,
+    poll,
+    doTerminateAgent,
+    doTerminatePid,
+  }
+}

package/app/pages/monitor/composables/useMonitorFormat.ts

@@ -1,39 +1,41 @@
-/**
- * 监控页的展示辅助(与 app/pages/logs/composables/useLogsFormat 同构)。
- *
- * 拆组件后最容易出的回归是"每个组件各记一份状态";这里给的是一组**纯函数**,
- * 三个表格 + 概要卡各调各的,拿到的仍是同一套口径,不存在第二份数据。
- */
-
-/** 短 id / 状态色 / 运行时长 / 进程启动时刻(无 i18n 依赖,纯格式化) */
-export function useMonitorFormat() {
-  const shortId = (id: string | null | undefined): string => (id && id.length > 8 ? `${id.slice(0, 8)}…` : (id ?? '-'))
-  const uptimeText = (ms: number): string => {
-    const s = Math.floor(ms / 1000)
-    const h = Math.floor(s / 3600)
-    const m = Math.floor((s % 3600) / 60)
-    const sec = s % 60
-    return h > 0 ? `${h}h ${m}m` : m > 0 ? `${m}m ${sec}s` : `${sec}s`
-  }
-  const startedAtText = (ts: number): string => new Date(ts).toLocaleTimeString()
-
-  return { shortId, uptimeText, startedAtText }
-}
-
-/**
- * Agent 状态徽标的色/文案(idle/busy/stopped)。
- *
- * 单独一个是因为要 i18n:文案在 setup 期取值一次 —— 与拆分前同语义
- * (原来的 stateText 也是在页面 setup 期算一次的普通对象,语言切换不重算)。
- */
-export function useAgentStateLabels() {
-  const { t } = useI18n()
-  const stateColor: Record<string, string> = { idle: 'success', busy: 'processing', stopped: 'error' }
-  const stateText: Record<string, string> = {
-    idle: t('monitor.stateIdle'),
-    busy: t('monitor.stateBusy'),
-    stopped: t('monitor.stateStopped'),
-  }
-
-  return { stateColor, stateText }
-}
+/**
+ * 监控页的展示辅助(与 app/pages/logs/composables/useLogsFormat 同构)。
+ *
+ * 拆组件后最容易出的回归是"每个组件各记一份状态";这里给的是一组**纯函数**,
+ * 三个表格 + 概要卡各调各的,拿到的仍是同一套口径,不存在第二份数据。
+ */
+
+import { formatLocalClock } from '@/app/composables/workshop/useLocalTime'
+
+/** 短 id / 状态色 / 运行时长 / 进程启动时刻(无 i18n 依赖,纯格式化) */
+export function useMonitorFormat() {
+  const shortId = (id: string | null | undefined): string => (id && id.length > 8 ? `${id.slice(0, 8)}…` : (id ?? '-'))
+  const uptimeText = (ms: number): string => {
+    const s = Math.floor(ms / 1000)
+    const h = Math.floor(s / 3600)
+    const m = Math.floor((s % 3600) / 60)
+    const sec = s % 60
+    return h > 0 ? `${h}h ${m}m` : m > 0 ? `${m}m ${sec}s` : `${sec}s`
+  }
+  const startedAtText = (ts: number): string => formatLocalClock(new Date(ts).toISOString())
+
+  return { shortId, uptimeText, startedAtText }
+}
+
+/**
+ * Agent 状态徽标的色/文案(idle/busy/stopped)。
+ *
+ * 单独一个是因为要 i18n:文案在 setup 期取值一次 —— 与拆分前同语义
+ * (原来的 stateText 也是在页面 setup 期算一次的普通对象,语言切换不重算)。
+ */
+export function useAgentStateLabels() {
+  const { t } = useI18n()
+  const stateColor: Record<string, string> = { idle: 'success', busy: 'processing', stopped: 'error' }
+  const stateText: Record<string, string> = {
+    idle: t('monitor.stateIdle'),
+    busy: t('monitor.stateBusy'),
+    stopped: t('monitor.stateStopped'),
+  }
+
+  return { stateColor, stateText }
+}

package/app/pages/operations/composables/useOperationsFeed.ts

@@ -0,0 +1,137 @@
+/**
+ * 产线操作页的数据面:统一操作流水(REST 快照为底 + WS 实时帧合并)与操作分类。
+ *
+ * 数据权威在 server audit_log:GET /api/workshop/ops-logs 按维度查询(useOpsLog.fetchLogs);
+ * 实时面是 WS ops.log 帧(useOpsLog.recent 环形缓冲)—— 按当前筛选前插进流水,与快照
+ * 以 at+actor+action+summary 去重。分类语义与 workshop 操作面板(operation-events)同源:
+ * 写控 / 数采 / 建模 / 配方 / 回退 / 告警 / 产线 / 人工 / 系统。
+ */
+import { computed, reactive, ref, watch } from 'vue'
+import { useOpsLog, type OpsLogRow } from '@/app/composables/workshop/useOpsLog'
+
+/** 流水分类(渲染配色/图标的唯一键;文案走 operations.cat.*) */
+export type OperationCategory = 'write' | 'daq' | 'aml' | 'recipe' | 'rollback' | 'alarm' | 'line' | 'manual' | 'system'
+
+export const OPERATION_KINDS: OperationCategory[] = ['write', 'recipe', 'rollback', 'daq', 'alarm', 'aml', 'line', 'manual', 'system']
+
+/** REST kind 筛选值:与 audit_log.kind 对齐(aml 是建模动作的 kind,其余按 kind 直查) */
+export const OPERATION_KIND_FILTERS = ['write', 'recipe', 'rollback', 'daq', 'alarm', 'aml', 'manual', 'line', 'system'] as const
+
+/** 行 → 分类:kind 优先,action 前缀兜底(audit_log 的 kind 与 action 是两套自由面) */
+export function classifyOpsRow(row: OpsLogRow): OperationCategory {
+  if (row.kind === 'write' || row.action.startsWith('dcw.write')) return 'write'
+  if (row.kind === 'alarm' || row.action.startsWith('daq.alarm')) return 'alarm'
+  if (row.kind === 'aml' || row.action.startsWith('aml.')) return 'aml'
+  if (row.kind === 'rollback' || row.action.startsWith('rollback')) return 'rollback'
+  if (row.kind === 'recipe' || row.action.startsWith('recipe')) return 'recipe'
+  if (row.kind === 'daq' || row.action.startsWith('daq.')) return 'daq'
+  if (row.kind === 'line' || row.action.startsWith('line.')) return 'line'
+  if (row.kind === 'manual') return 'manual'
+  return 'system'
+}
+
+/** 分类 → 图标(tabler);与 workshop 面板的图标语义保持一族 */
+export const CATEGORY_ICONS: Record<OperationCategory, string> = {
+  write: 'i-tabler-bolt',
+  daq: 'i-tabler-activity',
+  aml: 'i-tabler-flask',
+  recipe: 'i-tabler-clipboard-list',
+  rollback: 'i-tabler-arrow-back-up',
+  alarm: 'i-tabler-alert-triangle',
+  line: 'i-tabler-player-play',
+  manual: 'i-tabler-user',
+  system: 'i-tabler-server',
+}
+
+export interface OperationDiff {
+  prev: number | null
+  next: number | null
+  ok: boolean
+  message: string
+}
+
+/** 写控行的结构化变更(detailJson.eng/prevValue;其余动作无 diff) */
+export function diffOf(row: OpsLogRow): OperationDiff | null {
+  if (!row.detailJson) return null
+  try {
+    const d = JSON.parse(row.detailJson) as Record<string, unknown>
+    const eng = Number(d.eng)
+    const prev = Number(d.prevValue)
+    if (!Number.isFinite(eng) && !Number.isFinite(prev)) return null
+    return {
+      prev: Number.isFinite(prev) ? prev : null,
+      next: Number.isFinite(eng) ? eng : null,
+      ok: d.ok !== false,
+      message: String(d.message ?? ''),
+    }
+  }
+  catch {
+    return null
+  }
+}
+
+export function useOperationsFeed() {
+  const opsLog = useOpsLog()
+
+  const q = reactive({ lineId: '', kind: '', actorKind: '', text: '' })
+  const hasFilter = computed(() => Boolean(q.lineId || q.kind || q.actorKind || q.text.trim()))
+
+  /** 统一流水(新→旧):REST 快照为底,WS 实时帧按当前筛选合并前插 */
+  const rows = ref<OpsLogRow[]>([])
+  const rowKey = (r: OpsLogRow) => `${r.at}|${r.actor}|${r.action}|${r.summary}`
+  let seen = new Set<string>()
+
+  function reindex(): void {
+    seen = new Set(rows.value.map(rowKey))
+  }
+
+  /** 实时帧入流水:过当前筛选;容量封顶防长跑膨胀 */
+  function acceptFrame(r: OpsLogRow): void {
+    const key = rowKey(r)
+    if (seen.has(key)) return
+    if (q.lineId && r.lineId !== q.lineId) return
+    if (q.kind && r.kind !== q.kind) return
+    if (q.actorKind && r.actorKind !== q.actorKind) return
+    const needle = q.text.trim().toLowerCase()
+    if (needle && !`${r.summary} ${r.action} ${r.actorName}`.toLowerCase().includes(needle)) return
+    seen.add(key)
+    rows.value.unshift(r)
+    if (rows.value.length > 300) rows.value.splice(300)
+  }
+
+  watch(() => opsLog.recent.length, () => {
+    for (const r of opsLog.recent) acceptFrame(r)
+  })
+
+  async function doQuery(): Promise<void> {
+    await opsLog.fetchLogs({
+      lineId: q.lineId || undefined,
+      kind: q.kind || undefined,
+      actorKind: q.actorKind || undefined,
+      q: q.text.trim() || undefined,
+      limit: 200,
+    })
+    rows.value.splice(0, rows.value.length, ...opsLog.results)
+    reindex()
+  }
+
+  function resetFilters(): void {
+    q.lineId = ''
+    q.kind = ''
+    q.actorKind = ''
+    q.text = ''
+    void doQuery()
+  }
+
+  /** 分类计数(当前流水;统计条用) */
+  const stats = computed(() => {
+    const out = {} as Record<OperationCategory, number>
+    for (const r of rows.value) {
+      const c = classifyOpsRow(r)
+      out[c] = (out[c] ?? 0) + 1
+    }
+    return out
+  })
+
+  return { q, hasFilter, rows, stats, doQuery, resetFilters, acceptFrame }
+}