import { useContext, useEffect, useRef, useState } from 'react' import { fetchMonitorOverview, fetchRunMetrics } from './monitor' import type { MonitorOverview, RunMetrics, ServiceHealth } from './monitor' import { fetchMonitorTasks, defaultMonitorFilters, canRetryTask, actionLabels, stageLabels, taskStatusLabels, } from './monitorTasks' import type { MonitorFilters, MonitorTask, MonitorTaskPage } from './monitorTasks' import { requeueJobFailure, retryPublicationsBatch } from './testPublications' import { fetchActiveUISettings, settingsRefreshDelays } from './uiSettings' import { useOptionalAuth } from './auth' import { WorkspaceContextTabsSetter } from './workspaceContext' import './monitorWorkbench.css' const emptyPage: MonitorTaskPage = { items: [], total: 0, limit: 20, offset: 0, sources: [], targets: [], retryable: 0 } const time = (value: string) => (value ? new Date(value).toLocaleString('zh-CN', { hour12: false }) : '—') const percent = (value: number | null | undefined) => (value == null ? '—' : `${value}%`) const seconds = (value: number | null | undefined) => (value == null ? '—' : `${Number(value.toFixed(1))} 秒`) const gb = (n: number) => Number((n / 1073741824).toFixed(1)) export function healthLabel(service: ServiceHealth) { if (!service.applicable) return '不适用' if (!service.configured || service.readiness === 'not_configured') return '未配置' return ( ( { ready: '可接单', degraded: '降级', blocked: '阻断', down: '不可达', unknown: '未确认' } as Record< string, string > )[service.readiness] || '未确认' ) } interface ViewProps { overview: MonitorOverview | null metrics: RunMetrics | null page: MonitorTaskPage filters: MonitorFilters selected: MonitorTask[] loading: boolean busy: boolean error: string message: string canOperate: boolean onFilters: (value: MonitorFilters) => void onPage: (offset: number) => void onSelection: (rows: MonitorTask[]) => void onSelectAll: () => void onRetry: (rows: MonitorTask[]) => void onDetail: (row: MonitorTask) => void onRefresh: () => void } export function WeKnoraMonitorView(p: ViewProps) { const { overview, metrics, page, filters, selected, busy, loading } = p const patchFilter = (key: keyof MonitorFilters, value: string) => p.onFilters({ ...filters, [key]: value }) const toggle = (item: MonitorTask) => p.onSelection( selected.some((r) => r.id === item.id) ? selected.filter((r) => r.id !== item.id) : [...selected, item] ) const eligible = page.items.filter(canRetryTask) const selectedIDs = new Set(selected.map((r) => r.id)) const allPage = eligible.length > 0 && eligible.every((r) => selectedIDs.has(r.id)) const kbName = (id: string) => overview?.knowledge_bases.find((k) => k.id === id)?.name || id return (

解析监控

运行概况与文件处理进度

{overview ? `快照 ${time(overview.observed_at)}` : '等待运行快照'}
{p.error ? (
{p.error}
) : null} {overview?.simulated || metrics?.worker_source === 'simulation' ? (
运行指标含模拟数据;下方文件状态来自治理数据库。
) : null}

任务成功率 全部任务口径

{percent(metrics?.short_window.success_rate)} 最近 1 小时
{percent(metrics?.long_window.success_rate)} 最近 24 小时

处理耗时 最近 1 小时

{seconds(metrics?.short_window.duration_p50_seconds)} p50 · 中位耗时
{seconds(metrics?.short_window.duration_p95_seconds)} p95 · 处理耗时

任务队列 全部任务口径

{metrics?.active_workers ?? '—'} 活跃 Worker
{metrics?.queue.pending ?? '—'} 等待
{metrics?.queue.running ?? '—'} 运行
{metrics?.queue.failed ?? '—'} 失败

主机资源 当前

{overview ? `${overview.host.cpu_percent.toFixed(0)}%` : '—'} CPU 使用率
{overview ? `${gb(overview.host.memory_used_bytes)} / ${gb(overview.host.memory_total_bytes)}` : '—'} 内存 · GB

服务与依赖

展开查看状态原因
{overview?.health.length ? ( overview.health.map((s) => (
{s.name} ● {healthLabel(s)}

{s.reason || '未提供状态说明'}

检测:{time(s.observed_at)} · {s.latency_ms} ms
)) ) : (

尚未取得服务状态

)}

文件处理

生产发布授权在「发布管理」
patchFilter('q', e.target.value)} />
时间范围{filters.since || filters.until ? ' · 已筛选' : ''}
{p.canOperate ? (
已选 {selected.length} 项 只重试可恢复项,沿用原处理动作
) : null} {p.message ? (
{p.message}
) : null}
{page.items.map((item) => ( ))} {!page.items.length ? ( ) : null}
{p.canOperate ? ( p.onSelection( allPage ? selected.filter((r) => !eligible.some((e) => e.id === r.id)) : [...selected, ...eligible.filter((e) => !selectedIDs.has(e.id))] ) } /> ) : null} 文件名称 / 目录 来源 目标知识库 处理动作 当前阶段 处理状态 状态说明 更新时间 操作
{canRetryTask(item) && p.canOperate ? ( toggle(item)} /> ) : null} {item.title || '未命名文件'} {item.path || '未提供目录'} {item.source_name} {item.target_scope === 'internal' ? '对内' : '对外'} {kbName(item.target_kb)} {actionLabels[item.action]} {stageLabels[item.stage]} {taskStatusLabels[item.status]} {item.detail} {time(item.updated_at)} {canRetryTask(item) && p.canOperate ? ( ) : null}
{loading ? '正在读取文件状态…' : '当前筛选没有文件,可清除筛选查看全部。'}
) } function TaskDetail({ item, onClose }: { item: MonitorTask; onClose: () => void }) { const ref = useRef(null) useEffect(() => { ref.current?.showModal() }, []) return (

文件处理详情

{item.title}

{[ ['来源', item.source_name], ['目录', item.path], ['目标知识库', item.target_kb], ['处理动作', actionLabels[item.action]], ['当前阶段', stageLabels[item.stage]], ['处理状态', taskStatusLabels[item.status]], ['状态说明', item.detail], ['更新时间', time(item.updated_at)], ['累计重试', String(item.retry_count)], ['版本标识', item.version_id], ].map(([label, value]) => (
{label}
{value || '—'}
))}
{item.history?.length ? (

版本与重试记录

最近 50 条已登记记录,不推断未记录的处理步骤。

{item.history.map((event, i) => (
{event.kind} {time(event.at)}

{event.detail}

))}
) : null}

新增、更新完成表示测试库处理完成;移除完成表示测试库内容移除,不代表生产发布。

{item.status === 'attention' ? (

请先确认配置、权限或依赖已恢复。 {canRetryTask(item) ? '重试将沿用原处理动作。' : '当前记录不满足安全重试条件,需先修复前置条件。'}

) : null}
) } export function WeKnoraMonitor() { const auth = useOptionalAuth() const canOperate = auth?.identity?.role === 'admin' || auth?.identity?.role === 'engineer' const [overview, setOverview] = useState(null), [metrics, setMetrics] = useState(null) const [page, setPage] = useState(emptyPage), [filters, setFilters] = useState(defaultMonitorFilters), [offset, setOffset] = useState(0) const [selected, setSelected] = useState([]), [detail, setDetail] = useState(null) const [loading, setLoading] = useState(true), [busy, setBusy] = useState(false), [message, setMessage] = useState('') const [errors, setErrors] = useState({ files: '', overview: '', metrics: '', settings: '' }) const [docRev, setDocRev] = useState(0), [resRev, setResRev] = useState(0), [delays, setDelays] = useState({ documentMs: 15000, resourceMs: 30000 }) const setTabs = useContext(WorkspaceContextTabsSetter) useEffect(() => { setTabs([]) return () => setTabs([]) }, [setTabs]) useEffect(() => { const c = new AbortController() void fetchActiveUISettings(c.signal) .then((s) => { if (!c.signal.aborted) setDelays(settingsRefreshDelays(s)) }) .catch((e) => { if (!c.signal.aborted) setErrors((x) => ({ ...x, settings: String(e) })) }) return () => c.abort() }, []) useEffect(() => { const t = window.setTimeout(() => setDocRev((x) => x + 1), delays.documentMs) return () => clearTimeout(t) }, [docRev, delays.documentMs]) useEffect(() => { const t = window.setTimeout(() => setResRev((x) => x + 1), delays.resourceMs) return () => clearTimeout(t) }, [resRev, delays.resourceMs]) useEffect(() => { const c = new AbortController() setLoading(true) const timer = window.setTimeout(() => { void fetchMonitorTasks(filters, offset, 20, c.signal) .then((p) => { if (c.signal.aborted) return setPage(p) setErrors((e) => ({ ...e, files: '' })) setSelected((old) => old.flatMap((r) => { const fresh = p.items.find((i) => i.id === r.id) return fresh ? (canRetryTask(fresh) ? [fresh] : []) : [r] }) ) }) .catch((e) => { if (!c.signal.aborted) { setPage({ ...emptyPage, offset }) setErrors((x) => ({ ...x, files: e instanceof Error ? e.message : '读取文件状态失败' })) } }) .finally(() => { if (!c.signal.aborted) setLoading(false) }) }, 200) return () => { clearTimeout(timer) c.abort() } }, [filters, offset, docRev]) useEffect(() => { const c = new AbortController() void fetchMonitorOverview(c.signal) .then((r) => { if (!c.signal.aborted) { setOverview(r) setErrors((e) => ({ ...e, overview: '' })) } }) .catch((e) => { if (!c.signal.aborted) { setOverview(null) setErrors((x) => ({ ...x, overview: e instanceof Error ? e.message : '读取服务状态失败' })) } }) void fetchRunMetrics(c.signal) .then((r) => { if (!c.signal.aborted) { setMetrics(r) setErrors((e) => ({ ...e, metrics: '' })) } }) .catch((e) => { if (!c.signal.aborted) { setMetrics(null) setErrors((x) => ({ ...x, metrics: e instanceof Error ? e.message : '读取运行指标失败' })) } }) return () => c.abort() }, [resRev]) const refresh = () => { setDocRev((x) => x + 1) setResRev((x) => x + 1) } const selectAll = async () => { if (busy) return setBusy(true) setMessage('') try { const found = new Map() for (let at = 0; ; at += 100) { const p = await fetchMonitorTasks(filters, at, 100) if (p.total > 10000) throw new Error('筛选结果超过 10000 项,请缩小范围后再选择') p.items.filter(canRetryTask).forEach((r) => found.set(r.id, r)) if (at + p.items.length >= p.total || !p.items.length) break } setSelected([...found.values()]) setMessage(`已选择 ${found.size} 项;提交前会重新核验状态。`) } catch (e) { setMessage(e instanceof Error ? e.message : '跨页选择失败') } finally { setBusy(false) } } const retry = async (rows: MonitorTask[]) => { if (busy || !rows.length) return const removals = rows.filter((r) => r.action === 'remove').length if ( !window.confirm( `重试 ${rows.length} 项:新增/更新 ${rows.length - removals} 项,测试库移除 ${removals} 项。\n不会删除来源文件或操作生产知识库。是否继续?` ) ) return setBusy(true) setMessage('') let accepted = 0, skipped = 0, failed = 0 const notes: string[] = [] for (const row of rows) { try { const fresh = (await fetchMonitorTasks({ id: row.id }, 0, 1)).items[0] if (!fresh || !canRetryTask(fresh) || fresh.action !== row.action) { skipped++ notes.push(`${row.title}:状态已变化,跳过`) continue } if (fresh.retry_kind === 'fetch') { const r = await requeueJobFailure(fresh.failure_id, '解析监控重试') if (r.already_queued) { skipped++ continue } } else if (fresh.retry_kind === 'upload') { const r = await retryPublicationsBatch([fresh.id], '解析监控重试') if (!r.started) { skipped++ notes.push(`${row.title}:${r.outcomes[0]?.detail || '处理中或不可重试'}`) continue } } else { const r = await fetch(`/api/v1/test-publications/${encodeURIComponent(fresh.id)}/removal-retry`, { method: 'POST', headers: { Accept: 'application/json', 'X-Governance-Action': 'monitor-removal-retry' }, }) if (!r.ok) throw new Error(`测试库移除重试失败(HTTP ${r.status})`) } accepted++ try { await fetchMonitorTasks({ id: fresh.id }, 0, 1) } catch { notes.push(`${row.title}:已受理,状态读回失败,请刷新确认`) } } catch (e) { failed++ notes.push(`${row.title}:${e instanceof Error ? e.message : '请求失败'}`) } } setMessage( `已受理 ${accepted} 项,已跳过 ${skipped} 项,失败 ${failed} 项。受理不代表处理完成。${notes.length ? ' ' + notes.join(';') : ''}` ) setSelected([]) setBusy(false) refresh() } return ( <> { setFilters(v) setOffset(0) setSelected([]) setMessage('') setLoading(true) }} onPage={setOffset} onSelection={setSelected} onSelectAll={() => void selectAll()} onRetry={(r) => void retry(r)} onDetail={(row) => { void fetchMonitorTasks({ id: row.id }, 0, 1) .then((p) => { if (p.items[0]) setDetail(p.items[0]) else setMessage('该条记录已被新版本替换,请刷新列表') }) .catch((e) => setMessage(e instanceof Error ? e.message : '读取详情失败')) }} onRefresh={refresh} /> {detail ? setDetail(null)} /> : null} ) }