新增:智能分析图表与报告快照,支持环状图和柏拉图

This commit is contained in:
2026-10-23 20:25:12 +08:00
parent 8684ce1a4d
commit 13695da433
23 changed files with 5252 additions and 57 deletions
+330
View File
@@ -0,0 +1,330 @@
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,
renderVisualPng,
visualCategoryLabel,
visualPeriodSummary,
visualScopeSummary,
} from './analysisVisualsModel';
import type { AnalysisVisual } from './analysisVisualsModel';
import { analysisVisualCumulativeShares, analysisVisualShares, analysisVisualTypeLabel } from './analysisVisualPresentation';
import './analysis-visuals.css';
export interface AnalysisVisualsProps {
visuals: unknown;
visualState?: unknown;
beforeExport?: () => Promise<void>;
}
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: '占已列类别合计', key: 'compositionShare', align: 'center' as const, width: 160,
render: (_value: unknown, row: VisualTableRow) => `${(shares[row.index - 1] * 100).toFixed(2)}%` }] : []),
...(cumulativeShares ? [{ title: '累计占已列类别合计', 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)}`;
}
function AnalysisVisualCard({ visual, beforeExport }: { visual: AnalysisVisual; beforeExport?: () => Promise<void> }) {
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 [chartError, setChartError] = useState('');
const [dataOpen, setDataOpen] = useState(false);
const [exporting, setExporting] = useState(false);
const [exportError, setExportError] = useState('');
const [themeRevision, setThemeRevision] = useState(0);
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) return;
let cancelled = false;
let resizeObserver: ResizeObserver | null = null;
let instance: Awaited<ReturnType<typeof loadAnalysisVisualECharts>>['init'] extends (...args: never[]) => infer T ? T : never;
const mount = async () => {
const node = chartNodeRef.current;
if (!node || documentIsHidden() || cancelled) return;
setChartLoading(true);
try {
const echarts = await loadAnalysisVisualECharts();
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 {
if (!cancelled) 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]);
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} 项`;
return <article className={`analysis-visual-card analysis-visual-type-${visual.type}`} 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: exporting ? '正在导出…' : '下载 PNG', disabled: !visual.chartable || exporting, onClick: () => { void download(); } }] }}
>
<Button size="small" aria-label="更多图表操作" icon={exporting ? <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="button"
tabIndex={0}
aria-label={`${chartSummary(visual)}。按 Enter 或空格查看数据。`}
aria-busy={chartLoading}
onClick={openData}
onKeyDown={event => {
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 && chartLoading && <div className="analysis-visual-placeholder" role="status">正在加载图表…</div>}
{chartError && <div className="analysis-visual-chart-error" role="status">{chartError}</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 />
</>}
{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>单位:{visual.unit === 'ratio' ? '合格率' : visual.unit === 'kg' ? 'kg' : visual.unit === 'pp' ? '百分点' : '数量'}</span>
</div>
<ChartDataTable visual={visual} />
{visual.note && <p className="analysis-visual-modal-note">{visual.note}</p>}
{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 }: AnalysisVisualsProps) {
const parsed = useMemo(() => parseAnalysisVisuals(visuals), [visuals]);
if (!parsed.visuals.length) {
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" aria-label="分析图表">
{parsed.visuals.slice(0, 3).map(visual => <AnalysisVisualCard key={visual.id} visual={visual} beforeExport={beforeExport} />)}
</section>;
}
export { parseAnalysisVisuals };
export type { AnalysisVisual };