Files
quality_analyse/web/src/AnalysisVisuals.tsx
T
lyun bc19475b29 修复:DSH 自主查询、图片直显与报告稳定性
允许 Agent 在循环中查目录、修正查询和提问,保留实时权限检查及模型原始回答。
统一相同查询证据与图表资源;排名补齐阶段指标,修正 OR 重量筛选,并限制模型明细输入。
增加运行恢复、图表自适应坐标轴与两位小数,修复报告主图选择、重复图及边缘标签。

验证:独立副本通过 162 项 Python、73 项前端及 21 项后端测试,前端构建通过。
线上已用原 8 题复测,并追加两轮双期对比;TOP100 与组合筛选分别核对 100 行和 20 行。
2026-11-12 16:14:20 +08:00

404 lines
19 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
import { Button, Dropdown, Modal, Table, Tag } from 'antd';
import type { ColumnsType } from 'antd/es/table';
import { DownloadOutlined, MoreOutlined, TableOutlined } from '@ant-design/icons';
import {
buildAnalysisVisualOption,
formatVisualValue,
isVisualCellInvalid,
loadAnalysisVisualECharts,
parseAnalysisVisuals,
combineStageDefectVisuals,
distinctAnalysisVisuals,
renderVisualPng,
visualCategoryLabel,
visualPeriodSummary,
visualScopeSummary,
visualUnitLabel,
} from './analysisVisualsModel';
import type { AnalysisVisual } from './analysisVisualsModel';
import { useDelayedIndicator } from './useDelayedBusy';
import { analysisVisualCumulativeShares, analysisVisualShares, analysisVisualTypeLabel } from './analysisVisualPresentation';
import './analysis-visuals.css';
export interface AnalysisVisualsProps {
visuals: unknown;
visualState?: unknown;
beforeExport?: () => Promise<void>;
embedded?: boolean;
hideEvidence?: boolean;
combineStages?: boolean;
quiet?: boolean;
excludeIds?: string[];
}
interface VisualTableRow {
key: string;
index: number;
label: string;
values: Array<number | null>;
}
function documentIsHidden(): boolean {
return document.visibilityState === 'hidden';
}
function visualTheme() {
const styles = getComputedStyle(document.documentElement);
return {
ink: styles.getPropertyValue('--ink').trim() || '#263c5a',
mutedInk: styles.getPropertyValue('--muted-ink').trim() || '#728198',
line: styles.getPropertyValue('--line').trim() || '#dfe5ef',
surface: styles.getPropertyValue('--surface').trim() || '#ffffff',
};
}
function visualStateName(value: unknown): string {
if (typeof value === 'string') return value;
if (typeof value === 'object' && value !== null) {
const record = value as Record<string, unknown>;
if (typeof record.status === 'string') return record.status;
if (typeof record.state === 'string') return record.state;
}
return '';
}
function ChartDataTable({ visual, compact = false }: { visual: AnalysisVisual; compact?: boolean }) {
const shares = analysisVisualShares(visual);
const cumulativeShares = analysisVisualCumulativeShares(visual);
const rows: VisualTableRow[] = visual.categories.map((category, index) => ({
key: category.key,
index: index + 1,
label: visualCategoryLabel(visual, index),
values: visual.series.map(series => series.values[index] ?? null),
}));
const columns: ColumnsType<VisualTableRow> = [
{ title: '序号', dataIndex: 'index', width: 68, align: 'center', fixed: 'left' },
{
title: '对象名称', dataIndex: 'label', width: 240, ellipsis: false, fixed: 'left',
render: (label: string, row) => <span className="analysis-visual-full-label" title={`${label}(${row.key})`}>{label}</span>,
},
...visual.series.map((series, seriesIndex) => ({
title: series.label,
key: series.key,
align: 'center' as const,
width: 150,
render: (_value: unknown, row: VisualTableRow) => {
const value = row.values[seriesIndex];
return isVisualCellInvalid(visual, seriesIndex, row.index - 1)
? <Tag color="error">无效值</Tag>
: <span className="analysis-visual-table-value">{formatVisualValue(value, visual.unit)}</span>;
},
})),
...(shares ? [{ title: visual.coverage.shareBasis === 'all_scope_weight' ? '占全部重量' : '占已列类别合计', key: 'compositionShare', align: 'center' as const, width: 160,
render: (_value: unknown, row: VisualTableRow) => `${(shares[row.index - 1] * 100).toFixed(2)}%` }] : []),
...(cumulativeShares ? [{ title: visual.coverage.shareBasis === 'all_scope_weight' ? '累计占全部重量' : '累计占已列类别合计', key: 'cumulativeShare', align: 'center' as const, width: 170,
render: (_value: unknown, row: VisualTableRow) => `${(cumulativeShares[row.index - 1] * 100).toFixed(2)}%` }] : []),
];
return <div className={compact ? 'analysis-visual-table is-compact' : 'analysis-visual-table'}>
<Table<VisualTableRow>
size="small"
bordered
columns={columns}
dataSource={rows}
pagination={false}
rowKey="key"
scroll={{ x: 'max-content', y: compact ? 290 : 440 }}
/>
</div>;
}
function safeFilename(title: string): string {
const base = title.replace(/[\\/:*?"<>|\u0000-\u001f]/g, '-').replace(/\s+/g, '-').slice(0, 64) || 'analysis-chart';
return `${base}.png`;
}
function chartSummary(visual: AnalysisVisual): string {
return `${visual.title}。${visual.subtitle}。期间:${visualPeriodSummary(visual)}。${visual.categories.length} 个对象,${visual.series.map(item => item.label).join('、')}。${visualScopeSummary(visual.scope)}`;
}
export function AnalysisVisualCard({ visual, beforeExport, loadRuntime = loadAnalysisVisualECharts, hideEvidence = false, quiet = false }: {
visual: AnalysisVisual;
beforeExport?: () => Promise<void>;
loadRuntime?: typeof loadAnalysisVisualECharts;
hideEvidence?: boolean;
quiet?: boolean;
}) {
const cardRef = useRef<HTMLElement>(null);
const chartNodeRef = useRef<HTMLDivElement>(null);
const chartRef = useRef<Awaited<ReturnType<typeof loadAnalysisVisualECharts>> extends never ? never : import('echarts/core').ECharts | null>(null);
const exportControllerRef = useRef<AbortController | null>(null);
const [nearViewport, setNearViewport] = useState(false);
const [chartReady, setChartReady] = useState(false);
const [chartLoading, setChartLoading] = useState(false);
const showChartLoading = useDelayedIndicator(chartLoading, 150);
const [chartError, setChartError] = useState('');
const [dataOpen, setDataOpen] = useState(false);
const [exporting, setExporting] = useState(false);
const showExporting = useDelayedIndicator(exporting, 150);
const [exportError, setExportError] = useState('');
const [themeRevision, setThemeRevision] = useState(0);
const [renderAttempt, setRenderAttempt] = useState(0);
const [retrying, setRetrying] = useState(false);
const [accessBlocked, setAccessBlocked] = useState(false);
const retryGeneration = useRef(0);
const retryPending = useRef(false);
const visualIdentity = JSON.stringify(visual);
const currentIdentity = useRef(visualIdentity);
currentIdentity.current = visualIdentity;
useEffect(() => {
setAccessBlocked(false); setRetrying(false); retryPending.current = false;
setExportError(''); setChartError(''); setDataOpen(false);
exportControllerRef.current?.abort(); exportControllerRef.current = null; setExporting(false);
retryGeneration.current += 1;
return () => { retryGeneration.current += 1; retryPending.current = false; };
}, [visualIdentity]);
const retryChart = useCallback(async () => {
if (retryPending.current) return;
const generation = ++retryGeneration.current;
const identity = visualIdentity;
const current = () => generation === retryGeneration.current && identity === currentIdentity.current;
retryPending.current = true; setRetrying(true);
try {
if (!beforeExport) throw new Error('请重新打开这条分析后再重试图表。');
await beforeExport();
if (!current()) return;
setAccessBlocked(false); setExportError(''); setChartReady(false);
setRenderAttempt(value => value + 1);
} catch (error) {
if (current()) {
setAccessBlocked(true); setChartReady(false); setDataOpen(false);
setExportError(error instanceof Error ? error.message : '无法验证此图表的访问权限,请重新打开分析。');
}
} finally {
if (current()) { retryPending.current = false; setRetrying(false); }
}
}, [beforeExport, visualIdentity]);
useEffect(() => {
const node = cardRef.current;
if (!node) return;
if (typeof IntersectionObserver === 'undefined') { setNearViewport(true); return; }
const observer = new IntersectionObserver(entries => {
const entry = entries[0];
if (entry) setNearViewport(entry.isIntersecting);
}, { rootMargin: '180px 0px', threshold: 0.01 });
observer.observe(node);
return () => observer.disconnect();
}, []);
useEffect(() => {
if (!nearViewport || !visual.chartable || accessBlocked) return;
let cancelled = false;
let resizeObserver: ResizeObserver | null = null;
let instance: (Awaited<ReturnType<typeof loadAnalysisVisualECharts>>['init'] extends (...args: never[]) => infer T ? T : never) | undefined;
const mount = async () => {
const node = chartNodeRef.current;
if (!node || documentIsHidden() || cancelled) return;
setChartLoading(true);
setChartReady(false);
try {
const echarts = await loadRuntime();
if (cancelled || !chartNodeRef.current || documentIsHidden()) return;
instance = echarts.init(chartNodeRef.current, undefined, { renderer: 'svg' });
chartRef.current = instance;
// Initializing a cached/offscreen card must draw even when React batches
// loading=true/false into one commit and no option-effect dependency changes.
instance.setOption(buildAnalysisVisualOption(visual, visualTheme()), { notMerge: true, lazyUpdate: false });
const resize = () => {
const chartNode = chartNodeRef.current;
if (cancelled || documentIsHidden() || !chartNode) return;
const bounds = chartNode.getBoundingClientRect();
if (bounds.width > 0 && bounds.height > 0) instance?.resize();
};
resizeObserver = new ResizeObserver(resize);
resizeObserver.observe(chartNodeRef.current);
setChartError('');
setChartReady(true);
} catch {
instance?.dispose();
if (chartRef.current === instance) chartRef.current = null;
if (!cancelled) { setChartReady(false); setChartError('图表渲染暂不可用,可以继续查看完整数据表。'); }
} finally {
if (!cancelled) setChartLoading(false);
}
};
const onVisibility = () => {
if (!documentIsHidden()) {
if (!instance) void mount();
else requestAnimationFrame(() => instance?.resize());
}
};
document.addEventListener('visibilitychange', onVisibility);
void mount();
return () => {
cancelled = true;
document.removeEventListener('visibilitychange', onVisibility);
resizeObserver?.disconnect();
instance?.dispose();
if (chartRef.current === instance) chartRef.current = null;
};
}, [nearViewport, visual.chartable, visual.id, visualIdentity, renderAttempt, accessBlocked, loadRuntime]);
useEffect(() => {
if (!nearViewport || !visual.chartable) return;
const observer = new MutationObserver(() => setThemeRevision(value => value + 1));
observer.observe(document.documentElement, { attributes: true, attributeFilter: ['data-workspace-theme'] });
return () => observer.disconnect();
}, [nearViewport, visual.chartable]);
useEffect(() => {
const chart = chartRef.current;
const node = chartNodeRef.current;
if (!chart || !node || !visual.chartable) return;
try {
chart.setOption(buildAnalysisVisualOption(visual, visualTheme()), { notMerge: true, lazyUpdate: false });
setChartReady(true);
} catch {
setChartError('图表渲染失败,可以继续查看完整数据表。');
setChartReady(false);
}
}, [visual, themeRevision, chartLoading]);
useEffect(() => () => { exportControllerRef.current?.abort(); }, []);
const openData = useCallback(async () => {
try { await beforeExport?.(); setDataOpen(true); setExportError(''); }
catch (error) { setExportError(error instanceof Error ? error.message : '无法读取当前图表数据。'); }
}, [beforeExport]);
const download = useCallback(async () => {
if (!visual.chartable || exporting) return;
const controller = new AbortController();
exportControllerRef.current?.abort();
exportControllerRef.current = controller;
setExporting(true);
setExportError('');
try {
await beforeExport?.();
const image = await renderVisualPng(visual, controller.signal);
if (controller.signal.aborted) return;
const link = document.createElement('a');
link.href = image;
link.download = safeFilename(visual.title);
link.click();
} catch (error) {
if (!controller.signal.aborted) setExportError(error instanceof Error ? error.message : '图表导出失败');
} finally {
if (exportControllerRef.current === controller) exportControllerRef.current = null;
if (!controller.signal.aborted) setExporting(false);
}
}, [beforeExport, exporting, visual]);
const period = visualPeriodSummary(visual);
const scope = visualScopeSummary(visual.scope);
const coverage = visual.coverage.truncated
? `本图展示 ${visual.coverage.returnedRows} / 共 ${visual.coverage.totalRows} 项`
: `共 ${visual.coverage.totalRows} 项`;
if (quiet && (accessBlocked || chartError || !visual.chartable)) return null;
if (accessBlocked) return <article className="analysis-visual-card" ref={cardRef}>
<p role="alert">{exportError || '无法验证此图表的访问权限,已隐藏原数据。'}</p>
<Button size="small" loading={retrying} onClick={() => void retryChart()}>重试图表</Button>
</article>;
return <article className={`analysis-visual-card analysis-visual-type-${visual.type}`} data-analysis-visual-id={visual.id} ref={cardRef} aria-label={visual.title}>
<header className="analysis-visual-heading">
<div className="analysis-visual-heading-copy">
<h3>{visual.title}</h3>
<p>{visual.subtitle}</p>
<div className="analysis-visual-context">
<span className="analysis-visual-type-label">{analysisVisualTypeLabel(visual.type)}</span>
<span>{period}</span>
{scope && <span>{scope}</span>}
<span>{coverage}</span>
{visual.stage && <Tag color={visual.stage === 'black' ? 'blue' : 'cyan'}>{visual.stage === 'black' ? '黑片' : '亮片'}</Tag>}
</div>
</div>
<div className="analysis-visual-actions">
<Button size="small" icon={<TableOutlined />} onClick={openData}>查看数据</Button>
<Dropdown
trigger={['click']}
menu={{ items: [{ key: 'png', icon: <DownloadOutlined />, label: showExporting ? '正在导出…' : '下载 PNG', disabled: !visual.chartable || exporting, onClick: () => { void download(); } }] }}
>
<Button size="small" aria-label="更多图表操作" icon={showExporting ? <span className="analysis-visual-spinner" aria-hidden="true" /> : <MoreOutlined />} />
</Dropdown>
</div>
</header>
{visual.note && <p className="analysis-visual-note">{visual.note}</p>}
{visual.chartable ? <>
<div
className="analysis-visual-chart-wrap"
role={chartError ? 'group' : 'button'}
tabIndex={chartError ? -1 : 0}
aria-label={`${chartSummary(visual)}。按 Enter 或空格查看数据。`}
aria-busy={chartLoading}
style={visual.type === 'bar' ? { height: Math.max(320, visual.categories.length * 38 + 48) } : undefined}
onClick={chartError ? undefined : openData}
onKeyDown={event => {
if (chartError) return;
if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); openData(); }
}}
>
<div className="analysis-visual-chart" ref={chartNodeRef} aria-hidden="true"
style={visual.type === 'heatmap' ? { minWidth: Math.max(380, visual.categories.length * 62 + 160) }
: visual.type === 'pareto' ? { minWidth: Math.max(600, visual.categories.length * 90 + 180) } : undefined} />
{!nearViewport && <div className="analysis-visual-placeholder">图表将在进入视口时加载</div>}
{nearViewport && showChartLoading && <div className="analysis-visual-placeholder" role="status">正在加载图表…</div>}
{chartError && <div className="analysis-visual-chart-error" role="status">{chartError}
<Button size="small" loading={retrying || chartLoading} onKeyDown={event => event.stopPropagation()}
onClick={event => { event.stopPropagation(); void retryChart(); }}>重试图表</Button>
</div>}
{!chartLoading && !chartError && !chartReady && nearViewport && <div className="analysis-visual-placeholder">图表准备中…</div>}
</div>
{visual.type === 'heatmap' && <p className="analysis-visual-scroll-hint">可横向滑动查看各期,或查看完整数据。</p>}
{visual.type === 'pareto' && <p className="analysis-visual-scroll-hint">窄屏可横向滑动查看,或查看完整数据。</p>}
<p className="analysis-visual-summary">{chartSummary(visual)}</p>
{chartError && <ChartDataTable visual={visual} compact />}
</> : <>
<p className="analysis-visual-chart-error" role="status">{visual.chartIssue || '此图表暂以数据表显示'}</p>
<ChartDataTable visual={visual} compact />
</>}
{!quiet && exportError && <p className="analysis-visual-export-error" role="alert">{exportError}</p>}
<Modal
className="analysis-visual-modal"
open={dataOpen}
title={visual.title}
onCancel={() => setDataOpen(false)}
footer={<Button onClick={() => setDataOpen(false)}>关闭</Button>}
width={920}
destroyOnHidden
>
<div className="analysis-visual-modal-context">
<span>{visual.subtitle}</span><span>期间:{period}</span>{scope && <span>范围:{scope}</span>}
<span>单位:{visualUnitLabel(visual)}</span>
</div>
<ChartDataTable visual={visual} />
{visual.note && <p className="analysis-visual-modal-note">{visual.note}</p>}
{!hideEvidence && visual.evidenceRefs.length > 0 && <div className="analysis-visual-evidence"><strong>证据引用</strong><ul>{visual.evidenceRefs.map(ref => <li key={ref}>{ref}</li>)}</ul></div>}
</Modal>
</article>;
}
/** A bad or old visual payload is confined to this module; it never interrupts the answer text. */
export function AnalysisVisuals({ visuals, visualState, beforeExport, embedded = false, hideEvidence = false, combineStages = true, quiet = false, excludeIds = [] }: AnalysisVisualsProps) {
const parsed = useMemo(() => {
const result = parseAnalysisVisuals(visuals);
return { ...result, visuals: combineStages ? combineStageDefectVisuals(result.visuals) : result.visuals };
}, [visuals, combineStages]);
if (!parsed.visuals.length) {
if (quiet) return null;
const state = visualStateName(visualState);
if (state === 'building') return <div className="analysis-visual-state" role="status">图表整理中</div>;
if (state === 'failed' || state === 'unavailable') return <div className="analysis-visual-state" role="status">图表暂不可用,已保留分析结果。</div>;
return null;
}
return <section className={`analysis-visuals${embedded ? ' is-embedded' : ''}`} aria-label="分析图表">
{distinctAnalysisVisuals(parsed.visuals).filter(visual => !excludeIds.includes(visual.id)).map(visual => <AnalysisVisualCard key={visual.id} visual={visual} beforeExport={beforeExport} hideEvidence={hideEvidence} quiet={quiet} />)}
</section>;
}
export { parseAnalysisVisuals };
export type { AnalysisVisual };