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

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
+68 -23
View File
@@ -1,9 +1,10 @@
import { useMemo, useRef, useState } from 'react';
import { useEffect, useMemo, useRef, useState } from 'react';
import { Alert, App, Button, Modal } from 'antd';
import { DownloadOutlined } from '@ant-design/icons';
import { toPng } from 'html-to-image';
import { AiMarkdown } from './AiMarkdown';
import { analysisDisplayTextRemovalRanges, sanitizeAnalysisDisplayText } from './analysisDisplayText';
import { ReportVisualSections, reportVisualHtml, useReportVisualImages, type ReportVisualImage } from './AnalysisReportVisuals';
type Row = Record<string, unknown>;
const record = (value: unknown): Row => value && typeof value === 'object' && !Array.isArray(value) ? value as Row : {};
@@ -17,11 +18,12 @@ const metricName = (value: unknown) => ({ BLACK_RATE: '黑片合格率', BRIGHT_
const escape = (value: string) => value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;');
const reportCss = `
.q-report{box-sizing:border-box;width:900px;padding:52px;background:#fff;color:#202b3c;font:15px/1.85 -apple-system,BlinkMacSystemFont,"PingFang SC","Microsoft YaHei",sans-serif;overflow-wrap:anywhere}
.q-report .ai-markdown-table-wrap{height:auto!important;max-height:none!important;overflow:visible!important;border:0;border-radius:0;background:#fff;margin:10px 0 14px}.q-report .ai-markdown{color:inherit;font:inherit}.q-report .ai-markdown pre{white-space:pre-wrap;overflow-wrap:anywhere}
.q-report{--surface:#fff;--blue-soft:#eef1ff;--line:#dfe5ef;--ink:#202b3c;--muted-ink:#738197;box-sizing:border-box;width:900px;padding:52px;background:#fff;color:#202b3c;font:15px/1.85 -apple-system,BlinkMacSystemFont,"PingFang SC","Microsoft YaHei",sans-serif;overflow-wrap:anywhere}
.q-report *{box-sizing:border-box}.q-report header{padding-bottom:26px;border-bottom:2px solid #355f9b}.q-report .q-eyebrow{font-size:12px;letter-spacing:2px;color:#53739c}.q-report h1{font-size:27px;line-height:1.5;margin:10px 0}.q-report .q-subtitle{font-size:12px;color:#69778b}.q-report h2{font-size:18px;margin:30px 0 12px}.q-report p{margin:10px 0}.q-report .q-prose{white-space:pre-wrap}.q-report .q-kpis{display:flex;gap:12px;margin:22px 0}.q-report .q-kpi{flex:1;padding:17px 18px;background:#f2f6fb;border-radius:6px}.q-report .q-kpi span{display:block;font-size:12px;color:#66778d}.q-report .q-kpi strong{display:block;font-size:27px;font-variant-numeric:tabular-nums;color:#254f87}.q-report table{width:100%;border:1px solid #dfe5ef;border-collapse:collapse;font-size:13px;table-layout:fixed}.q-report th{background:#f2f6fb;color:#53657c;text-align:center;font-weight:650}.q-report th,.q-report td{padding:10px 12px;border:1px solid #dfe5ef;text-align:center;vertical-align:middle}.q-report tbody tr:nth-child(even){background:#f8fafd}.q-report th:first-child,.q-report td:first-child{width:62px;color:#738197;font-variant-numeric:tabular-nums}.q-report .q-note{font-size:12px;color:#69778b}.q-report footer{margin-top:34px;padding-top:16px;border-top:1px solid #dde5ef;font-size:11px;color:#738197}.q-report .q-partial{color:#996b20}@media print{body{margin:0}.q-report{width:100%;padding:20px}tr{break-inside:avoid}}
`;
function ReportDocument({ turn, stamp }: { turn: Row; stamp: string }) {
function ReportDocument({ turn, stamp, visualImages }: { turn: Row; stamp: string; visualImages: ReportVisualImage[] }) {
const result = Object.keys(record(turn.result)).length ? record(turn.result) : turn;
const results = rows(result.results || turn.results);
const comparisons = results.filter(item => item.current && item.comparison && item.delta);
@@ -43,7 +45,8 @@ function ReportDocument({ turn, stamp }: { turn: Row; stamp: string }) {
<div className="q-kpi"><span>黑片合格率</span><strong>{coverage.blackRows === 0 ? '—' : rate(black.rate)}</strong></div>
<div className="q-kpi"><span>{adjusted ? '亮片合格率(不含本部报废)' : '亮片合格率'}</span><strong>{coverage.brightRows === 0 ? '—' : rate(adjusted ? bright.rateWithoutHeadquartersScrap : bright.rate)}</strong></div>
</div>}
<section><h2>分析结论</h2><div className="q-prose">{answer}</div></section>
<section><h2>分析结论</h2><AiMarkdown content={answer} /></section>
<ReportVisualSections turn={turn} images={visualImages} />
{comparisons.map((item, index) => {
const current = record(item.current), comparison = record(item.comparison), delta = record(item.delta), comparable = record(item.comparability);
const value = (side: Row) => { const s = record(side.summary); switch (item.metric) { case 'BLACK_RATE': return rate(record(s.black).rate); case 'BRIGHT_RATE': return rate(record(s.bright).rate); case 'BRIGHT_RATE_WITHOUT_HEADQUARTERS_SCRAP': return rate(record(s.bright).rateWithoutHeadquartersScrap); case 'COMPOSITE_RATE_WITHOUT_HEADQUARTERS_SCRAP': return rate(s.compositeRateWithoutHeadquartersScrap); default: return rate(s.compositeRate); } };
@@ -190,30 +193,49 @@ export function AnalysisReportExport({ turn }: { turn: Row }) {
const [open, setOpen] = useState(false);
const [exporting, setExporting] = useState(false);
const [stamp, setStamp] = useState('');
const exportGeneration = useRef(0);
useEffect(() => { exportGeneration.current += 1; setExporting(false); return () => { exportGeneration.current += 1; }; }, [open, turn.id]);
const node = useRef<HTMLDivElement>(null);
const visualReport = useReportVisualImages(turn, open);
const title = String(turn.question || '质量分析报告').replace(/[\\/:*?"<>|\n\r]/g, '').slice(0, 60);
const saveHtml = () => {
const saveHtml = async () => {
if (!node.current) return;
const generation = ++exportGeneration.current;
setExporting(true);
try {
await visualReport.authorize();
if (generation !== exportGeneration.current || !node.current) return;
const html = `<!doctype html><html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; img-src data:"><title>${escape(title)}</title><style>body{margin:0;background:#edf1f5}.q-report{margin:0 auto}</style></head><body>${node.current.innerHTML}</body></html>`;
const url = URL.createObjectURL(new Blob([html], { type: 'text/html;charset=utf-8' }));
download(url, `${title}.html`); setTimeout(() => URL.revokeObjectURL(url), 10000);
message.success(visualReport.failed ? 'HTML 已生成,未能绘制的图表已保留数据表。' : 'HTML 报告已生成');
} catch (error) { if (generation === exportGeneration.current) message.error(error instanceof Error ? error.message : '报告导出失败,请重试。'); }
finally { if (generation === exportGeneration.current) setExporting(false); }
};
const saveImage = async () => {
const report = node.current?.querySelector<HTMLElement>('.q-report');
if (!report) return;
const generation = ++exportGeneration.current;
setExporting(true);
try {
await visualReport.authorize();
if (generation !== exportGeneration.current) return;
await document.fonts.ready;
if (report.scrollHeight > 16000) throw new Error('报告较长,请下载 HTML 查看完整图文。');
const png = await toPng(report, { pixelRatio: 2, backgroundColor: '#ffffff', skipFonts: true });
if (generation !== exportGeneration.current) return;
download(png, `${title}.png`);
message.success('报告图片已生成');
} catch { message.error('图片生成失败,请重试或下载 HTML 报告。'); }
finally { setExporting(false); }
message.success(visualReport.failed ? '报告图片已生成,未能绘制的图表已保留数据表。' : '报告图片已生成');
} catch (error) { if (generation === exportGeneration.current) message.error(error instanceof Error ? error.message : '图片生成失败,请重试或下载 HTML 报告。'); }
finally { if (generation === exportGeneration.current) setExporting(false); }
};
return <>
<Button type="text" size="small" icon={<DownloadOutlined />} onClick={() => { setStamp(new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai', hour12: false })); setOpen(true); }}>生成报告</Button>
<Modal title="分析报告" open={open} onCancel={() => { if (!exporting) setOpen(false); }} width={980} footer={<><Button disabled={exporting} onClick={saveHtml}>下载 HTML</Button><Button type="primary" loading={exporting} onClick={() => void saveImage()}>下载图片</Button></>}>
<div className="analysis-report-preview" ref={node}><ReportDocument turn={turn} stamp={stamp} /></div>
<Modal title="分析报告" open={open} onCancel={() => setOpen(false)} width={980} footer={<><Button disabled={exporting || visualReport.loading || !visualReport.authorized} onClick={() => void saveHtml()}>下载 HTML</Button><Button type="primary" loading={exporting} disabled={visualReport.loading || !visualReport.authorized} onClick={() => void saveImage()}>下载图片</Button></>}>
{visualReport.loading && <p role="status">{visualReport.progress || '正在准备报告图表…'}</p>}
{visualReport.failed && <Alert type="warning" showIcon title="部分图表未生成,报告保留相应数据表。" />}
{visualReport.authorizationError && <Alert type="error" showIcon title={visualReport.authorizationError} />}
{visualReport.authorized && <div className="analysis-report-preview" ref={node}><ReportDocument turn={turn} stamp={stamp} visualImages={visualReport.images} /></div>}
</Modal>
</>;
}
@@ -228,20 +250,35 @@ export function NativeAnalysisReport({ turn, reportMarkdown, reportHtml }: {
const [exporting, setExporting] = useState(false);
const [frameHeight, setFrameHeight] = useState(1);
const [frameReady, setFrameReady] = useState(false);
const exportGeneration = useRef(0);
useEffect(() => { exportGeneration.current += 1; setExporting(false); return () => { exportGeneration.current += 1; }; }, [open, turn.id]);
const iframe = useRef<HTMLIFrameElement>(null);
const fallbackNode = useRef<HTMLElement>(null);
const safeHtml = useMemo(() => reportHtml?.trim() ? safeNativeHtml(reportHtml) : '', [reportHtml]);
const visualReport = useReportVisualImages(turn, open);
const safeHtml = useMemo(() => {
const html = reportHtml?.trim() ? safeNativeHtml(reportHtml) : '';
if (!html) return '';
return html.replace(/<\/body>/i, `${reportVisualHtml(turn, visualReport.images)}</body>`);
}, [reportHtml, turn, visualReport.images]);
const title = useMemo(() => {
const nativeTitle = safeHtml ? new DOMParser().parseFromString(safeHtml, 'text/html').title : '';
const heading = reportMarkdown.match(/^#\s+(.+)$/m)?.[1];
return String(nativeTitle || heading || turn.question || '质量分析报告').replace(/[\\/:*?"<>|\n\r]/g, '').slice(0, 60) || '质量分析报告';
}, [safeHtml, reportMarkdown, turn.question]);
const saveHtml = () => {
const saveHtml = async () => {
if (!safeHtml) return;
const generation = ++exportGeneration.current;
setExporting(true);
try {
await visualReport.authorize();
if (generation !== exportGeneration.current) return;
const url = URL.createObjectURL(new Blob([safeHtml], { type: 'text/html;charset=utf-8' }));
download(url, `${title}.html`);
setTimeout(() => URL.revokeObjectURL(url), 10000);
message.success(visualReport.failed ? 'HTML 已生成,未能绘制的图表已保留数据表。' : 'HTML 报告已生成');
} catch (error) { if (generation === exportGeneration.current) message.error(error instanceof Error ? error.message : '报告导出失败,请重试。'); }
finally { if (generation === exportGeneration.current) setExporting(false); }
};
const handleFrameLoad = () => {
@@ -256,8 +293,11 @@ export function NativeAnalysisReport({ turn, reportMarkdown, reportHtml }: {
};
const saveImage = async () => {
const generation = ++exportGeneration.current;
setExporting(true);
try {
await visualReport.authorize();
if (generation !== exportGeneration.current) return;
let png: string;
if (safeHtml) {
const doc = iframe.current?.contentDocument;
@@ -265,35 +305,40 @@ export function NativeAnalysisReport({ turn, reportMarkdown, reportHtml }: {
await doc.fonts?.ready;
await new Promise<void>(resolve => requestAnimationFrame(() => resolve()));
const height = Math.max(frameContentHeight(doc), frameHeight);
if (height > 16000) throw new Error('报告较长,请下载 HTML 查看完整图文。');
png = await toPng(doc.body, { width: 900, height, pixelRatio: 1, backgroundColor: '#ffffff', fontEmbedCSS: frameFontCss(doc) });
} else {
const report = fallbackNode.current;
if (!report) throw new Error('Markdown 报告尚未载入');
await document.fonts.ready;
const height = Math.max(report.scrollHeight, report.offsetHeight);
if (height > 16000) throw new Error('报告较长,请下载 HTML 查看完整图文。');
png = await toPng(report, { width: 900, height, pixelRatio: 1, backgroundColor: '#ffffff', skipFonts: true });
}
if (generation !== exportGeneration.current) return;
download(png, `${title}.png`);
message.success('报告图片已生成');
} catch {
message.error('图片生成失败,请重试。');
message.success(visualReport.failed ? '报告图片已生成,未能绘制的图表已保留数据表。' : '报告图片已生成');
} catch (error) {
if (generation === exportGeneration.current) message.error(error instanceof Error ? error.message : '图片生成失败,请重试。');
} finally {
setExporting(false);
if (generation === exportGeneration.current) setExporting(false);
}
};
return <>
<Button type="text" size="small" icon={<DownloadOutlined />} onClick={() => setOpen(true)}>查看报告</Button>
<Modal title="分析报告" open={open} onCancel={() => { if (!exporting) setOpen(false); }} width={980} footer={<>
<Button disabled={exporting || !safeHtml} onClick={saveHtml}>下载 HTML</Button>
<Button type="primary" loading={exporting} disabled={Boolean(safeHtml) && !frameReady} onClick={() => void saveImage()}>下载图片</Button>
<Modal title="分析报告" open={open} onCancel={() => setOpen(false)} width={980} footer={<>
<Button disabled={exporting || !safeHtml || visualReport.loading || !visualReport.authorized} onClick={() => void saveHtml()}>下载 HTML</Button>
<Button type="primary" loading={exporting} disabled={visualReport.loading || !visualReport.authorized || Boolean(safeHtml) && !frameReady} onClick={() => void saveImage()}>下载图片</Button>
</>}>
{!safeHtml && <Alert type="info" showIcon message="未提供原生 HTML" description="当前预览和 PNG 使用 Markdown 报告内容。" />}
<div className="analysis-report-preview">
{visualReport.loading && <p role="status">{visualReport.progress || '正在准备报告图表…'}</p>}
{visualReport.failed && <Alert type="warning" showIcon title="部分图表未生成,报告保留相应数据表。" />}
{visualReport.authorizationError && <Alert type="error" showIcon title={visualReport.authorizationError} />}
{visualReport.authorized && <div className="analysis-report-preview">
{safeHtml
? <iframe ref={iframe} className="native-analysis-report-frame" title="原生分析报告预览" sandbox="allow-same-origin" srcDoc={safeHtml} width={900} height={frameHeight} onLoad={handleFrameLoad} />
: <article className="native-analysis-report" ref={fallbackNode}><AiMarkdown content={reportMarkdown} /></article>}
</div>
: <article className="native-analysis-report" ref={fallbackNode}><AiMarkdown content={reportMarkdown} /><ReportVisualSections turn={turn} images={visualReport.images} /></article>}
</div>}
</Modal>
</>;
}
+114
View File
@@ -0,0 +1,114 @@
import { useEffect, useMemo, useRef, useState } from 'react';
import { parseAnalysisVisuals, renderVisualPng, visualPeriodSummary, visualScopeSummary, visualCategoryLabel } from './analysisVisualsModel';
import { analysisSnapshotResult, authorizeAnalysisSnapshot, reportSnapshotIdentity } from './analysisSnapshot';
import { analysisVisualCumulativeShares, analysisVisualShares, analysisVisualTypeLabel } from './analysisVisualPresentation';
type Row = Record<string, unknown>;
export type ReportVisualImage = { id: string; png?: string; failed?: boolean };
export function reportVisuals(turn: Row) {
const result = analysisSnapshotResult(turn);
return result.visualSchemaVersion === 1 ? parseAnalysisVisuals(result.visuals, 1).visuals : [];
}
export function useReportVisualImages(turn: Row, open: boolean) {
const signature = `${String(turn.id || turn.turnId || '')}:${reportSnapshotIdentity(turn)}`;
const visualsSignature = JSON.stringify(reportVisuals(turn));
const visuals = useMemo(() => reportVisuals(turn), [visualsSignature]);
const [images, setImages] = useState<ReportVisualImage[]>([]);
const [loading, setLoading] = useState(false);
const [progress, setProgress] = useState('');
const cycle = useRef({ open: false, revision: 0 });
if (cycle.current.open !== open) cycle.current = { open, revision: cycle.current.revision + 1 };
const revision = cycle.current.revision;
const [authorization, setAuthorization] = useState<{ revision: number; signature: string; allowed: boolean; error: string }>({ revision: -1, signature: '', allowed: false, error: '' });
useEffect(() => {
if (!open) { setImages([]); setLoading(false); setProgress(''); return; }
const controller = new AbortController();
setLoading(true); setImages([]);
void (async () => {
const next: ReportVisualImage[] = [];
try {
await authorizeAnalysisSnapshot(turn);
if (controller.signal.aborted) return;
setAuthorization({ revision, signature, allowed: true, error: '' });
} catch (error) {
if (!controller.signal.aborted) {
setAuthorization({ revision, signature, allowed: false, error: error instanceof Error ? error.message : '无法验证此报告的访问权限,请重新打开分析。' });
setLoading(false); setProgress('');
}
return;
}
try {
for (const [index, visual] of visuals.entries()) {
if (controller.signal.aborted) return;
setProgress(`正在准备图表 ${index + 1}/${visuals.length}`);
try { next.push({ id: visual.id, png: await renderVisualPng(visual, controller.signal) }); }
catch { if (controller.signal.aborted) return; next.push({ id: visual.id, failed: true }); }
}
if (!controller.signal.aborted) setImages(next);
} catch {
if (!controller.signal.aborted) setImages(visuals.map(visual => ({ id: visual.id, failed: true })));
} finally {
if (!controller.signal.aborted) { setLoading(false); setProgress(''); }
}
})();
return () => controller.abort();
}, [open, revision, signature, String(turn.id || turn.turnId || '')]);
const current = open && authorization.revision === revision && authorization.signature === signature;
const authorize = async () => {
try { await authorizeAnalysisSnapshot(turn); }
catch (error) {
if (cycle.current.revision === revision) {
setImages([]);
setAuthorization({ revision, signature, allowed: false, error: error instanceof Error ? error.message : '无法验证此报告的访问权限,请重新打开分析。' });
}
throw error;
}
};
return { images, loading, progress, authorized: current && authorization.allowed,
authorizationError: current ? authorization.error : '', failed: images.some(image => image.failed), authorize };
}
function shown(value: number | null, unit: string): string {
if (value === null) return '—';
return `${(unit === 'ratio' ? value * 100 : value).toLocaleString('zh-CN', { maximumFractionDigits: 2 })}${unit === 'ratio' ? '%' : unit === 'pp' ? ' pp' : unit === 'kg' ? ' kg' : ''}`;
}
export function ReportVisualSections({ turn, images }: { turn: Row; images: ReportVisualImage[] }) {
const visuals = reportVisuals(turn);
return <>{visuals.map(visual => {
const image = images.find(item => item.id === visual.id);
const shares = analysisVisualShares(visual);
const cumulativeShares = analysisVisualCumulativeShares(visual);
return <section key={visual.id} className="q-report-visual">
<h2>{visual.title}</h2>
<p className="q-note">{analysisVisualTypeLabel(visual.type)}</p>
<p className="q-note">{visual.subtitle}</p>
<p className="q-note">期间:{visualPeriodSummary(visual)}{visualScopeSummary(visual.scope) ? ` · 范围:${visualScopeSummary(visual.scope)}` : ''}</p>
{image?.png && <img src={image.png} alt={visual.title} style={{ width: '100%', height: 'auto', display: 'block' }} />}
{image?.failed && <p className="q-partial">此图未能生成,以下保留同一份结果的数据表。</p>}
<table><thead><tr><th>序号</th><th>对象 / 期间</th>{visual.series.map(series => <th key={series.key}>{series.label}</th>)}{shares && <th>占已列类别合计</th>}{cumulativeShares && <th>累计占已列类别合计</th>}</tr></thead>
<tbody>{visual.categories.map((category, index) => <tr key={category.key}><td>{index + 1}</td><td>{visualCategoryLabel(visual, index)}</td>{visual.series.map(series => <td key={series.key}>{shown(series.values[index] ?? null, visual.unit)}</td>)}{shares && <td>{(shares[index] * 100).toFixed(2)}%</td>}{cumulativeShares && <td>{(cumulativeShares[index] * 100).toFixed(2)}%</td>}</tr>)}</tbody>
</table>
{visual.note && <p className="q-note">{visual.note}</p>}
<p className="q-note">数据依据:{visual.evidenceRefs.join('、')}</p>
</section>;
})}</>;
}
const escapeHtml = (value: string) => value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&#39;');
/** Only platform-generated raster data and escaped business text enter native HTML. */
export function reportVisualHtml(turn: Row, images: ReportVisualImage[]): string {
return reportVisuals(turn).map(visual => {
const image = images.find(item => item.id === visual.id);
const shares = analysisVisualShares(visual);
const cumulativeShares = analysisVisualCumulativeShares(visual);
const headers = visual.series.map(series => `<th>${escapeHtml(series.label)}</th>`).join('') + (shares ? '<th>占已列类别合计</th>' : '') + (cumulativeShares ? '<th>累计占已列类别合计</th>' : '');
const rows = visual.categories.map((_category, index) => `<tr><td>${index + 1}</td><td>${escapeHtml(visualCategoryLabel(visual, index))}</td>${visual.series.map(series => `<td>${escapeHtml(shown(series.values[index] ?? null, visual.unit))}</td>`).join('')}${shares ? `<td>${(shares[index] * 100).toFixed(2)}%</td>` : ''}${cumulativeShares ? `<td>${(cumulativeShares[index] * 100).toFixed(2)}%</td>` : ''}</tr>`).join('');
const png = image?.png && /^data:image\/png;base64,[A-Za-z0-9+/=]+$/.test(image.png) ? image.png : '';
const context = `期间:${visualPeriodSummary(visual)}${visualScopeSummary(visual.scope) ? ` · 范围:${visualScopeSummary(visual.scope)}` : ''}`;
return `<section class="platform-report-visual" style="break-inside:avoid;padding:20px 0;color:#202b3c;background:white"><h2>${escapeHtml(visual.title)}</h2><p>${escapeHtml(visual.subtitle || '')}</p><p>${escapeHtml(context)}</p>${png ? `<img alt="${escapeHtml(visual.title)}" src="${png}" style="display:block;width:100%;height:auto">` : image?.failed ? '<p>此图未能生成,以下保留同一份结果的数据表。</p>' : ''}<table style="width:100%;border-collapse:collapse" border="1"><thead><tr><th>序号</th><th>对象 / 期间</th>${headers}</tr></thead><tbody>${rows}</tbody></table><p>${escapeHtml(visual.note || '')}</p><p>数据依据:${escapeHtml(visual.evidenceRefs.join('、'))}</p></section>`;
}).join('');
}
+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 };
+43 -19
View File
@@ -23,7 +23,7 @@ import {
} from 'antd';
import type { ColumnsType } from 'antd/es/table';
import { QualityTable as Table } from './QualityTable';
import { DeleteOutlined, DownloadOutlined, EditOutlined, MoreOutlined, ReloadOutlined, RobotOutlined } from '@ant-design/icons';
import { DeleteOutlined, EditOutlined, MoreOutlined, ReloadOutlined, RobotOutlined } from '@ant-design/icons';
import { ApiError, api, collectionItems, decodeQueryValueList } from './api';
import type { AuthUser, Collection, OptionsResponse, QueryParams, SourceItem, ViewKind } from './types';
import type { DataWorkflowStatus } from './NoCodeDataTypes';
@@ -33,6 +33,8 @@ import './management-alignment.css';
import { TargetVersionAdmin } from './AnalyticsCompletion';
import { AnalysisReportExport, NativeAnalysisReport } from './AnalysisReportExport';
import { AiMarkdown } from './AiMarkdown';
import { AnalysisVisuals } from './AnalysisVisuals';
import { authorizeAnalysisSnapshot } from './analysisSnapshot';
import { AnalysisApiSettings } from './AnalysisApiSettings';
import { acceptAnalysisEvent, analysisScrollFollows, partialAnalysisNotice, partialAnswerIsOnlyProgress } from './analysisConversationState';
import { AnalysisProcess } from './AnalysisProcess';
@@ -75,15 +77,6 @@ type LinkedSessionRequest = { key: string; promise: ReturnType<typeof api.create
type AnalysisPageWindow = Window & { __qualityAnalysisLinkedSessionRequest?: LinkedSessionRequest };
const ANALYSIS_FINAL_STATUSES = new Set(['COMPLETED', 'PARTIAL', 'FAILED', 'CANCELLED', 'NEEDS_CLARIFICATION']);
function generateReportPrompt(turn: Record<string, unknown>): string {
const result = isObjectRecord(turn.result) ? turn.result : turn;
const question = (typeof turn.question === 'string' ? turn.question : '').trim().slice(0, 240);
const answer = partialAnswerIsOnlyProgress(turn) ? '' : typeof result.answer === 'string' ? result.answer : typeof turn.answer === 'string' ? turn.answer : '';
const partial = String(turn.status || result.status).toUpperCase() === 'PARTIAL';
const prefix = `请将关于「${question || '本次质量分析'}」的这次分析生成报告,沿用该分析的期间与范围。${partial ? '本次分析部分完成,报告须保留这个状态和未完成范围,不得写成已全部核验。' : ''}\n\n本次分析结论供参考,请忠于已有数据,不要补造指标或数字:\n`;
return `${prefix}${answer.slice(0, Math.max(0, 1600 - prefix.length))}`;
}
function decodeAnalysisLinkContext(encoded: string | null): AnalysisLinkContext {
if (!encoded) return { present: false };
try {
@@ -983,17 +976,40 @@ function AnalysisPage({ onUnauthorized, user }: { onUnauthorized: (error: unknow
const followOutput = useRef(true);
const previousScrollTop = useRef(0);
const readingPosition = useRef(0);
const [hasNewContent, setHasNewContent] = useState(false);
useEffect(() => {
const element = conversation.current;
if (active && element) element.scrollTop = followOutput.current ? element.scrollHeight : readingPosition.current;
}, [active]);
useEffect(() => { followOutput.current = true; previousScrollTop.current = 0; }, [sessionId]);
useEffect(() => { followOutput.current = true; previousScrollTop.current = 0; setHasNewContent(false); }, [sessionId]);
useEffect(() => {
const element = conversation.current;
if (!element || !active) return;
let frame = 0;
const resize = new ResizeObserver(() => {
cancelAnimationFrame(frame);
frame = requestAnimationFrame(() => {
if (!activePage.current) return;
if (followOutput.current) {
element.scrollTop = element.scrollHeight;
previousScrollTop.current = element.scrollTop;
readingPosition.current = element.scrollTop;
}
});
});
const observe = () => { resize.disconnect(); [...element.children].forEach(child => resize.observe(child)); };
observe();
const mutation = new MutationObserver(observe);
mutation.observe(element, { childList: true });
return () => { cancelAnimationFrame(frame); resize.disconnect(); mutation.disconnect(); };
}, [active, sessionId]);
useEffect(() => {
const element = conversation.current;
if (active && element && followOutput.current) {
element.scrollTop = element.scrollHeight;
previousScrollTop.current = element.scrollTop;
}
setHasNewContent(false);
} else if (active && element) setHasNewContent(true);
}, [lastTurn, busy, turns, sessionId, active]);
const loadSessions = async () => {
@@ -1464,12 +1480,18 @@ function AnalysisPage({ onUnauthorized, user }: { onUnauthorized: (error: unknow
element.scrollHeight - element.clientHeight - element.scrollTop, followOutput.current);
previousScrollTop.current = element.scrollTop;
readingPosition.current = element.scrollTop;
if (followOutput.current) setHasNewContent(false);
}}>
{turns.map((turn, index) => <AnalysisTurn key={String(turn.id || index)} turn={turn} onRetry={(id) => void retryTurn(turns.find(item => String(item.id || '') === id) || turn)} onResume={id => { if (!historyLoading) void followTurn(id, String(turn.question || '')); }} onGenerateReport={() => void submit(generateReportPrompt(turn))} retryDisabled={busy || historyLoading} />)}
{lastTurn && <AnalysisTurn turn={lastTurn} onRetry={() => void retryTurn(lastTurn)} onResume={id => { if (!historyLoading) void followTurn(id, String(lastTurn.question || '')); }} onGenerateReport={() => void submit(generateReportPrompt(lastTurn))} retryDisabled={busy || historyLoading} />}
{turns.map((turn, index) => <AnalysisTurn key={String(turn.id || index)} turn={turn} onRetry={(id) => void retryTurn(turns.find(item => String(item.id || '') === id) || turn)} onResume={id => { if (!historyLoading) void followTurn(id, String(turn.question || '')); }} retryDisabled={busy || historyLoading} />)}
{lastTurn && <AnalysisTurn turn={lastTurn} onRetry={() => void retryTurn(lastTurn)} onResume={id => { if (!historyLoading) void followTurn(id, String(lastTurn.question || '')); }} retryDisabled={busy || historyLoading} />}
{busy && <div className="analysis-progress"><span>{streamProgress || '正在分析…'}</span><Button size="small" danger onClick={() => void cancelTurn()}>停止分析</Button></div>}
{!turns.length && !lastTurn && !busy && <div className="analysis-empty"><RobotOutlined /><strong>想了解哪些质量情况?</strong><span>例如:9月汽车交通的合格率为什么下降?</span></div>}
</div>
{hasNewContent && <Button size="small" type="text" className="analysis-new-content" onClick={() => {
const element = conversation.current;
followOutput.current = true; setHasNewContent(false);
if (element) { element.scrollTop = element.scrollHeight; previousScrollTop.current = element.scrollTop; readingPosition.current = element.scrollTop; }
}}>回到最新内容 ↓</Button>}
<div className="analysis-composer">
<Input.TextArea id="analysis-query" disabled={historyLoading} value={query} onChange={event => setQuery(event.target.value)} autoSize={{ minRows: 2, maxRows: 5 }} maxLength={1600} aria-label="质量问题" placeholder="直接描述问题,或继续追问…" onPressEnter={event => { if (!event.shiftKey && !event.nativeEvent.isComposing) { event.preventDefault(); void submit(); } }} />
<div className="ai-actions"><span>Enter 发送 · Shift + Enter 换行</span><div className="analysis-composer-buttons">{user.roles.includes('SYSTEM_ADMIN') && <AnalysisApiSettings onUnauthorized={onUnauthorized} />}<Button type="primary" aria-label="发送" loading={busy} disabled={!query.trim() || busy || historyLoading} onClick={() => void submit()}>发送</Button></div></div>
@@ -1482,12 +1504,12 @@ function AnalysisPage({ onUnauthorized, user }: { onUnauthorized: (error: unknow
</div>;
}
function AnalysisTurn({ turn, onResume, onRetry, onGenerateReport, retryDisabled = false }: { turn: Record<string, unknown>; onResume?: (turnId: string) => void; onRetry?: (turnId: string) => void; onGenerateReport?: () => void; retryDisabled?: boolean }) {
function AnalysisTurn({ turn, onResume, onRetry, retryDisabled = false }: { turn: Record<string, unknown>; onResume?: (turnId: string) => void; onRetry?: (turnId: string) => void; retryDisabled?: boolean }) {
const question = typeof turn.question === 'string' ? turn.question : '';
const result = isObjectRecord(turn.result) ? turn.result : turn;
const answer = partialAnswerIsOnlyProgress(turn) ? '' : typeof result.answer === 'string' ? result.answer : typeof turn.answer === 'string' ? turn.answer : '';
const status = String(turn.status || result.status || '').toUpperCase();
const engine = String(result.engine || turn.engine || '').toUpperCase();
const visuals = result.visualSchemaVersion === 1 ? result.visuals : undefined;
const reportMarkdown = typeof result.reportMarkdown === 'string' ? result.reportMarkdown : typeof turn.reportMarkdown === 'string' ? turn.reportMarkdown : '';
const reportHtml = typeof result.reportHtml === 'string' ? result.reportHtml : typeof turn.reportHtml === 'string' ? turn.reportHtml : undefined;
const resumable = ['QUEUED', 'RUNNING', 'PROCESSING', 'PLANNING', 'TOOL_RUNNING'].includes(status);
@@ -1502,12 +1524,14 @@ function AnalysisTurn({ turn, onResume, onRetry, onGenerateReport, retryDisabled
<AnalysisTurnMetadata turn={turn} status={status} />
<AnalysisProcess turn={turn} />
{(!resumable || !Array.isArray(turn.timeline || (isObjectRecord(turn.plan) ? turn.plan.timeline : undefined))) && (answer || !resumable || !retryDisabled) && <div className="analysis-answer">
{answer ? <AiMarkdown content={answer} className="ai-answer" /> : <p className={resumable ? 'analysis-chat-notice' : undefined}>{resumable ? '分析任务仍在运行,尚未返回完整回答。' : emptyStatus}</p>}
{answer ? <>
<AiMarkdown content={answer} className="ai-answer" />
{!resumable && <AnalysisVisuals visuals={visuals} visualState={result.visualState} beforeExport={() => authorizeAnalysisSnapshot(turn)} />}
</> : <p className={resumable ? 'analysis-chat-notice' : undefined}>{resumable ? '分析任务仍在运行,尚未返回完整回答。' : emptyStatus}</p>}
{status === 'PARTIAL' && answer && <p className="analysis-chat-notice">{partialAnalysisNotice(result.stopReason || turn.stopReason || (isObjectRecord(turn.plan) ? turn.plan.stopReason : ''))}</p>}
<div className="analysis-message-actions">
{reportMarkdown.trim() && <NativeAnalysisReport turn={turn} reportMarkdown={reportMarkdown} reportHtml={reportHtml} />}
{!reportMarkdown.trim() && engine === 'NAO' && ['COMPLETED', 'PARTIAL'].includes(status) && answer && onGenerateReport && <Button type="text" size="small" icon={<DownloadOutlined />} disabled={retryDisabled} onClick={onGenerateReport}>生成报告</Button>}
{!reportMarkdown.trim() && engine !== 'NAO' && answer && ['COMPLETED', 'PARTIAL'].includes(status) && <AnalysisReportExport turn={turn} />}
{!reportMarkdown.trim() && answer && ['COMPLETED', 'PARTIAL'].includes(status) && <AnalysisReportExport turn={turn} />}
{['FAILED', 'CANCELLED', 'PARTIAL'].includes(status) && typeof turn.id === 'string' && onRetry && <Button size="small" type="text" disabled={retryDisabled} onClick={() => onRetry(String(turn.id))}>重新分析</Button>}
{resumable && !retryDisabled && typeof turn.id === 'string' && onResume && <Button size="small" type="text" onClick={() => onResume(String(turn.id))}>继续分析</Button>}
</div>
+1
View File
@@ -3,6 +3,7 @@
.page-heading.page-actions-only{min-height:0;margin:0;justify-content:flex-end}
.analysis-composer-buttons{display:flex;align-items:center;gap:8px}
.analysis-simple-page .analysis-chat-panel{min-height:0;overflow:hidden;background:#fff}
.analysis-simple-page .analysis-new-content{align-self:center;flex:none;margin:2px 0;color:var(--primary-color,#1677ff)}
.analysis-simple-page .analysis-session-panel{min-height:0;overflow:hidden}
.analysis-simple-page .analysis-session-list{flex:1;overflow:auto}
.analysis-simple-page .analysis-session-item{padding:14px 12px;gap:5px}
+59
View File
@@ -0,0 +1,59 @@
.analysis-visuals{display:grid;gap:14px;margin:14px 0 18px;min-width:0;color:var(--ink,#263c5a)}
.analysis-visual-card{min-width:0;padding:15px 16px 13px;border:1px solid var(--line,#dfe5ef);border-radius:10px;background:var(--surface,#fff);box-shadow:0 2px 8px rgba(32,51,79,.035);color:var(--ink,#263c5a)}
.analysis-visual-heading{display:flex;align-items:flex-start;justify-content:space-between;gap:14px;min-width:0}
.analysis-visual-heading-copy{min-width:0;flex:1}
.analysis-visual-heading h3{margin:0;color:var(--ink,#263c5a);font-size:15px;line-height:1.55;font-weight:650;overflow-wrap:anywhere}
.analysis-visual-heading-copy>p{margin:3px 0 0;color:var(--muted-ink,#728198);font-size:12px;line-height:1.65;overflow-wrap:anywhere}
.analysis-visual-context{display:flex;flex-wrap:wrap;align-items:center;gap:5px 12px;margin-top:7px;color:var(--muted-ink,#728198);font-size:11px;line-height:1.6}
.analysis-visual-context .ant-tag{margin-inline-end:0}
.analysis-visual-type-label{font-weight:600;color:var(--ink,#405570)}
.analysis-visual-type-donut .analysis-visual-chart-wrap{height:360px}
.analysis-visual-type-pareto .analysis-visual-chart-wrap{height:360px;overflow-x:auto;overflow-y:hidden}
.analysis-visual-type-column .analysis-visual-chart-wrap{height:330px}
.analysis-visual-type-heatmap .analysis-visual-chart-wrap{height:240px;overflow-x:auto;overflow-y:hidden}
.analysis-visual-type-heatmap .analysis-visual-chart{min-height:220px}
.analysis-visual-scroll-hint{margin:5px 0 0;color:var(--muted-ink,#728198);font-size:11px}
.analysis-visual-actions{display:flex;flex:0 0 auto;gap:6px}
.analysis-visual-actions .ant-btn{min-height:30px;color:var(--ink,#405570)}
.analysis-visual-note{margin:8px 0 0;padding:7px 9px;border-left:2px solid var(--blue,#607ae1);background:var(--surface-subtle,#f7f9fc);color:var(--muted-ink,#63758b);font-size:12px;line-height:1.7;overflow-wrap:anywhere}
.analysis-visual-chart-wrap{position:relative;min-width:0;height:300px;margin-top:7px;outline:none;border-radius:6px;cursor:pointer}
.analysis-visual-chart-wrap:focus-visible{outline:2px solid var(--blue,#607ae1);outline-offset:2px}
.analysis-visual-chart{width:100%;height:100%;min-height:260px}
.analysis-visual-placeholder,.analysis-visual-chart-error{display:flex;align-items:center;justify-content:center;min-height:86px;padding:12px;color:var(--muted-ink,#728198);font-size:12px;text-align:center}
.analysis-visual-placeholder{position:absolute;inset:0;pointer-events:none}
.analysis-visual-chart-error{border:1px dashed var(--line,#dfe5ef);border-radius:6px;background:var(--surface-subtle,#f8fafd)}
.analysis-visual-summary{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}
.analysis-visual-table{min-width:0;max-width:100%;margin-top:10px;overflow:hidden;border-radius:6px;color:var(--ink,#263c5a)}
.analysis-visual-table .ant-table{color:var(--ink,#263c5a);font-size:12px}
.analysis-visual-table .ant-table-cell{padding:7px 9px!important;text-align:center;vertical-align:middle;white-space:normal;overflow-wrap:anywhere;word-break:break-word}
.analysis-visual-table .ant-table-thead>tr>th{background:var(--surface-subtle,#f4f7fb);color:var(--ink,#405570);font-weight:650}
.analysis-visual-table .ant-table-tbody>tr>td{color:var(--ink,#405570)}
.analysis-visual-table .analysis-visual-full-label{display:block;text-align:left;white-space:normal;overflow-wrap:anywhere;word-break:break-word}
.analysis-visual-table-value{font-variant-numeric:tabular-nums;white-space:nowrap}
.analysis-visual-table.is-compact{margin-top:8px}
.analysis-visual-export-error{margin:7px 0 0;color:#b42318;font-size:12px;overflow-wrap:anywhere}
.analysis-visual-modal .ant-modal-content{max-width:calc(100vw - 24px)}
.analysis-visual-modal-context{display:flex;flex-wrap:wrap;gap:5px 14px;margin:0 0 10px;color:var(--muted-ink,#65748b);font-size:12px}
.analysis-visual-modal-note{margin:10px 0 0;padding:8px 10px;border:1px solid var(--line,#dfe5ef);border-radius:6px;color:var(--muted-ink,#65748b);font-size:12px;line-height:1.7}
.analysis-visual-evidence{margin-top:12px;color:var(--muted-ink,#65748b);font-size:12px}
.analysis-visual-evidence ul{display:flex;flex-wrap:wrap;gap:5px 16px;margin:5px 0 0;padding-left:20px}
.analysis-visual-evidence li{overflow-wrap:anywhere;word-break:break-word}
.analysis-visual-spinner{display:inline-block;width:13px;height:13px;border:2px solid currentColor;border-right-color:transparent;border-radius:50%;animation:analysis-visual-spin .7s linear infinite}
.analysis-visual-state{margin:8px 0;color:var(--muted-ink,#728198);font-size:12px}
@keyframes analysis-visual-spin{to{transform:rotate(360deg)}}
:root[data-workspace-theme='dark'] .analysis-visual-card{box-shadow:none}
:root[data-workspace-theme='dark'] .analysis-visual-note,
:root[data-workspace-theme='dark'] .analysis-visual-chart-error,
:root[data-workspace-theme='dark'] .analysis-visual-table .ant-table-thead>tr>th{background:var(--surface-subtle,#1d2a3d);color:var(--ink,#eaf0fa)}
:root[data-workspace-theme='dark'] .analysis-visual-table .ant-table-tbody>tr>td{background:var(--surface,#172234);color:var(--ink,#eaf0fa)}
:root[data-workspace-theme='dark'] .analysis-visual-table .ant-table-tbody>tr:hover>td{background:var(--hover,#202b3e)!important}
@media(max-width:640px){
.analysis-visual-card{padding:12px 11px}
.analysis-visual-heading{gap:8px}
.analysis-visual-heading h3{font-size:14px}
.analysis-visual-actions{gap:3px}
.analysis-visual-actions .ant-btn{padding-inline:7px;font-size:11px}
.analysis-visual-chart-wrap{height:270px}
.analysis-visual-context{gap:4px 8px}
}
@media(prefers-reduced-motion:reduce){.analysis-visual-spinner{animation:none}}
+37
View File
@@ -0,0 +1,37 @@
import { api } from './api';
type Row = Record<string, unknown>;
const object = (value: unknown): Row => value && typeof value === 'object' && !Array.isArray(value) ? value as Row : {};
export function analysisSnapshotResult(turn: Row): Row {
return turn.result && typeof turn.result === 'object' && !Array.isArray(turn.result) ? object(turn.result) : turn;
}
function canonical(value: unknown): string {
if (Array.isArray(value)) return `[${value.map(canonical).join(',')}]`;
if (value && typeof value === 'object') {
return `{${Object.entries(value as Row).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(',')}}`;
}
return JSON.stringify(value ?? null);
}
export function reportSnapshotIdentity(turn: Row): string {
const result = analysisSnapshotResult(turn);
const value = (key: string, fallback: unknown) => result[key] ?? turn[key] ?? fallback;
return canonical({ answer: value('answer', ''), visuals: value('visuals', []),
results: value('results', []), reportMarkdown: value('reportMarkdown', ''),
reportHtml: value('reportHtml', ''), question: turn.question || '' });
}
/** A download rechecks the same stored turn, rather than silently querying new data. */
export async function authorizeAnalysisSnapshot(turn: Row): Promise<void> {
const id = String(turn.id || turn.turnId || '');
if (!id) throw new Error('分析结果尚未保存,请稍后再试。');
const current = await api.analysisTurnSnapshot(id);
if (!['COMPLETED', 'PARTIAL', 'CANCELLED'].includes(String(current.status || '').toUpperCase())) {
throw new Error('分析结果仍在更新,请完成后再生成报告。');
}
if (reportSnapshotIdentity(current) !== reportSnapshotIdentity(turn)) {
throw new Error('分析结果或访问权限已变化,请重新打开这条分析后再导出。');
}
}
+19
View File
@@ -0,0 +1,19 @@
import type { AnalysisVisual } from './analysisVisualsModel';
import { visualDonutShares, visualParetoPoints } from './analysisVisualsModel';
export function analysisVisualTypeLabel(type: string): string {
return ({ bar: '条形图', line: '折线图', column: '柱状图', area: '面积图', heatmap: '热力图', donut: '环状图', pareto: '柏拉图' } as Record<string, string>)[type] || '数据图';
}
/** Share values use the same validated calculation as the chart renderer. */
export function analysisVisualShares(visual: AnalysisVisual): Array<number> | null {
if (!visual.chartable) return null;
const points = visual.type === 'pareto' ? visualParetoPoints(visual) : visualDonutShares(visual);
return points.length ? points.map(point => point.share) : null;
}
export function analysisVisualCumulativeShares(visual: AnalysisVisual): Array<number> | null {
if (visual.type !== 'pareto') return null;
const points = visualParetoPoints(visual);
return points.length ? points.map(point => point.cumulativeShare) : null;
}
+8
View File
@@ -0,0 +1,8 @@
import * as echarts from 'echarts/core';
import { BarChart, LineChart, PieChart, HeatmapChart } from 'echarts/charts';
import { GridComponent, LegendComponent, TooltipComponent, AriaComponent, TitleComponent, GraphicComponent, VisualMapComponent } from 'echarts/components';
import { SVGRenderer } from 'echarts/renderers';
// A single lazy module keeps unused chart families out of the analysis download.
echarts.use([BarChart, LineChart, PieChart, HeatmapChart, GridComponent, LegendComponent, TooltipComponent, AriaComponent, TitleComponent, GraphicComponent, VisualMapComponent, SVGRenderer]);
export { echarts };
File diff suppressed because it is too large Load Diff
+3
View File
@@ -408,6 +408,9 @@ export const api = {
analysisTurn(id: string) {
return request<Record<string, unknown>>(`/api/analysis/turns/${encodeURIComponent(id)}`);
},
analysisTurnSnapshot(id: string) {
return request<Record<string, unknown>>(`/api/analysis/turns/${encodeURIComponent(id)}/snapshot`, {}, 8000);
},
analysisSettings() {
return request<import('./AnalysisApiSettings').AnalysisModelSettings>('/api/analysis/settings');
},
+513
View File
@@ -0,0 +1,513 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import {
buildAnalysisVisualOption,
buildAnalysisVisualExportOption,
formatVisualValue,
parseAnalysisVisuals,
renderVisualTableHtml,
visualCategoryLabel,
visualDonutShares,
visualParetoPoints,
} from '../src/analysisVisualsModel.ts';
function visual(overrides = {}) {
return {
id: 'visual-1',
type: 'line',
title: '月度合格率',
subtitle: '正式综合率',
unit: 'ratio',
categories: [{ key: '2026-08', label: '2026-08' }, { key: '2026-09', label: '2026-09' }],
series: [{ key: 'overall', label: '综合', values: [0.82, 0.84] }],
evidenceRefs: ['evidence-1'],
requiredFields: ['quality.combined_rate'],
scope: { department: '工业电机' },
period: { start: '2026-08', end: '2026-09' },
comparisonPeriod: { label: '2026-08' },
metric: 'combined_rate',
coverage: { totalRows: 2, returnedRows: 2, truncated: false },
originTurnId: 'turn-1',
...overrides,
};
}
function donut(overrides = {}) {
return visual({
type: 'donut',
title: '黑片正式报废类别重量构成',
subtitle: '按已列正式类别展示',
unit: 'kg',
categories: [
{ key: 'black_responsibility_scrap', label: '责废' },
{ key: 'black_material_scrap', label: '料废' },
{ key: 'black_external_scrap', label: '外废' },
],
series: [{ key: 'source_defect_weight', label: '类别重量', values: [0, 2, 8] }],
stage: 'black',
scope: { department: '工业电机', stage: 'black' },
metric: 'source_defect_weight',
coverage: { totalRows: 3, returnedRows: 3, truncated: false, shareBasis: 'displayed_categories' },
...overrides,
});
}
function pareto(overrides = {}) {
return donut({
type: 'pareto',
title: '正式报废类别柏拉图',
series: [{ key: 'source_defect_weight', label: '类别重量', values: [8, 2, 0] }],
...overrides,
});
}
test('parser preserves zero and null as different values', () => {
const parsed = parseAnalysisVisuals([visual({ series: [{ key: 'a', label: 'A', values: [null, 0] }] })]);
assert.equal(parsed.visuals.length, 1);
assert.deepEqual(parsed.visuals[0].series[0].values, [null, 0]);
const option = buildAnalysisVisualOption(parsed.visuals[0]);
assert.deepEqual(option.series[0].data, [null, 0]);
assert.equal(option.series[0].connectNulls, false);
assert.equal(option.animation, false);
});
test('ratio charts use 0 to 100 percent and convert raw ratios only for plotting', () => {
const parsed = parseAnalysisVisuals([visual()]);
const option = buildAnalysisVisualOption(parsed.visuals[0]);
assert.equal(option.yAxis.min, 0);
assert.equal(option.yAxis.max, 100);
assert.deepEqual(option.series[0].data, [82, 84]);
assert.equal(formatVisualValue(0.8425, 'ratio'), '84.25%');
});
test('empty subtitle and extra-filter maps survive strict parsing', () => {
const parsed = parseAnalysisVisuals([visual({ subtitle: ' ', scope: { extraFilters: { quality_type: ['A级', 'B级'] } } })]);
assert.equal(parsed.visuals.length, 1);
assert.equal(parsed.visuals[0].subtitle, '');
assert.deepEqual(parsed.visuals[0].scope.extraFilters, { quality_type: ['A级', 'B级'] });
});
test('negative percentage point changes remain signed and keep a zero baseline', () => {
const parsed = parseAnalysisVisuals([visual({
type: 'bar', unit: 'pp', comparisonPeriod: undefined,
categories: [{ key: 'p1', label: '规格一' }, { key: 'p2', label: '规格二' }],
series: [{ key: 'delta', label: '变化', values: [-2.75, 0] }],
})]);
const option = buildAnalysisVisualOption(parsed.visuals[0]);
assert.deepEqual(option.series[0].data, [-2.75, 0]);
assert.equal(option.xAxis.scale, false);
assert.equal(option.xAxis.max, undefined);
assert.equal(formatVisualValue(-2.75, 'pp'), '-2.75 pp');
assert.equal(formatVisualValue(0.5, 'pp'), '+0.5 pp');
});
test('non-finite and out-of-range ratio values degrade to a table while retaining zero and null', () => {
const parsed = parseAnalysisVisuals([visual({ series: [{ key: 'r', label: '率', values: [0, Number.NaN] }] })]);
assert.equal(parsed.visuals.length, 1);
assert.equal(parsed.visuals[0].chartable, false);
assert.deepEqual(parsed.visuals[0].series[0].values, [0, null]);
assert.deepEqual(parsed.visuals[0].invalidValueCells, ['0:1']);
const outOfRange = parseAnalysisVisuals([visual({ series: [{ key: 'r', label: '率', values: [1.02, null] }] })]);
assert.equal(outOfRange.visuals[0].chartable, false);
assert.deepEqual(outOfRange.visuals[0].series[0].values, [1.02, null]);
});
test('business labels remain plain text in tooltip output and data options', () => {
const hostile = '<img src=x onerror=alert(1)> {style|name}';
const parsed = parseAnalysisVisuals([visual({
categories: [{ key: 'x', label: hostile }, { key: 'y', label: '第二项' }],
series: [{ key: 's', label: '<script>alert(1)</script>', values: [0.2, 0.3] }],
})]);
const option = buildAnalysisVisualOption(parsed.visuals[0]);
assert.equal(option.xAxis.data[0], hostile);
assert.equal(option.tooltip.renderMode, 'richText');
const tooltip = option.tooltip.formatter([{ dataIndex: 0, seriesIndex: 0 }]);
assert.equal(tooltip.includes('<script>alert(1)</script>'), true);
assert.equal(tooltip.includes('<br'), false);
assert.equal(tooltip.includes('<strong>'), false);
});
test('duplicate category labels append keys everywhere while unique labels stay clean', () => {
const parsed = parseAnalysisVisuals([visual({
type: 'bar',
categories: [
{ key: 'part-a', label: '同名规格' },
{ key: 'part-b', label: '同名规格' },
{ key: 'part-c', label: '独立规格' },
],
series: [{ key: 's', label: '重量', values: [3, 2, 1] }],
})]);
const model = parsed.visuals[0];
const expected = ['同名规格 · part-a', '同名规格 · part-b', '独立规格'];
const option = buildAnalysisVisualOption(model);
assert.deepEqual(option.yAxis.data, expected);
assert.deepEqual(model.categories.map((_, index) => visualCategoryLabel(model, index)), expected);
const tooltip = option.tooltip.formatter([{ dataIndex: 1, seriesIndex: 0 }]);
assert.match(tooltip, /同名规格 · part-b/);
const table = renderVisualTableHtml(model);
assert.match(table, /同名规格 · part-a/);
assert.match(table, /同名规格 · part-b/);
assert.match(table, /独立规格/);
assert.doesNotMatch(table, /独立规格 · part-c/);
});
test('static export option includes wrapped title, period, scope, unit, note, evidence and all series', () => {
const parsed = parseAnalysisVisuals([visual({
title: '这是一条用于静态导出标题换行检查的较长业务图表标题,完整保留原文并确认不会遗漏任何业务上下文',
subtitle: '黑片与亮片合格率对比',
note: '说明文本需要进入图片,作为图表下方的静态脚注。',
evidenceRefs: ['evidence-black-1', 'evidence-bright-2'],
series: [
{ key: 'black', label: '黑片', values: [0.82, 0.84] },
{ key: 'bright', label: '亮片', values: [0.91, 0.93] },
],
})]);
const visualModel = parsed.visuals[0];
const { option, width, height } = buildAnalysisVisualExportOption(visualModel);
assert.equal(width, 1280);
assert.ok(height > 540);
assert.match(option.title.text, /\n/);
assert.match(option.title.text, /静态导出标题/);
assert.match(option.title.subtext, /期间:2026-08 → 2026-08 至 2026-09/);
assert.match(option.title.subtext, /范围:产业部:工业电机/);
assert.match(option.title.subtext, /单位:合格率(%)/);
assert.equal(option.series.length, 2);
assert.deepEqual(option.series.map(series => series.data), [[82, 84], [91, 93]]);
assert.deepEqual(Object.values(option.legend.selected), [true, true]);
assert.equal(option.tooltip.show, false);
const footerText = option.graphic.elements[0].style.text;
assert.match(footerText, /说明:说明文本需要进入图片/);
assert.match(footerText, /证据引用:evidence-black-1 · evidence-bright-2/);
});
test('static export wraps long category labels and keeps the complete value table', () => {
const label = '很长的产品规格名称'.repeat(12);
const parsed = parseAnalysisVisuals([visual({ categories: [{ key: 'long', label }, { key: 'short', label: '短名称' }] })]);
const { option } = buildAnalysisVisualExportOption(parsed.visuals[0]);
assert.match(option.xAxis.data[0], /\n/);
assert.ok(option.grid.top > 80);
assert.match(renderVisualTableHtml(parsed.visuals[0]), new RegExp(label));
});
test('report table markup escapes hostile labels and scripts', () => {
const hostile = '<img src=x onerror=alert(1)>&"';
const parsed = parseAnalysisVisuals([visual({
categories: [{ key: 'x', label: hostile }, { key: 'y', label: '二' }],
series: [{ key: 's', label: '<script>alert(1)</script>', values: [0, null] }],
})]);
const html = renderVisualTableHtml(parsed.visuals[0]);
assert.match(html, /&lt;img src=x onerror=alert\(1\)&gt;&amp;&quot;/);
assert.match(html, /&lt;script&gt;alert\(1\)&lt;\/script&gt;/);
assert.equal(html.includes('<img src='), false);
assert.equal(html.includes('<script>'), false);
});
test('unknown chart type and schema versions are safely rejected or shown as data tables', () => {
const unsupported = parseAnalysisVisuals([visual({ type: 'pie' })]);
assert.equal(unsupported.visuals[0].chartable, false);
assert.match(unsupported.visuals[0].chartIssue, /数据表/);
const unknownVersion = parseAnalysisVisuals({ visualSchemaVersion: 2, visuals: [visual()] });
assert.deepEqual(unknownVersion.visuals, []);
assert.match(unknownVersion.issues[0], /版本/);
});
test('duplicate ids, malformed values, and over-size payloads do not break neighboring results', () => {
const duplicate = parseAnalysisVisuals([visual(), visual({ title: '重复编号' })]);
assert.equal(duplicate.visuals.length, 1);
assert.ok(duplicate.issues.some(issue => issue.includes('编号重复')));
const malformed = parseAnalysisVisuals([visual({ series: [{ key: 'bad', label: '坏', values: [1] }] }), visual({ id: 'visual-2' })]);
assert.equal(malformed.visuals.length, 1);
assert.equal(malformed.visuals[0].id, 'visual-2');
const oversized = parseAnalysisVisuals([visual({ title: 'x'.repeat(270_000) })]);
assert.deepEqual(oversized.visuals, []);
assert.match(oversized.issues[0], /大小限制/);
});
test('only three visuals are admitted to a chat render', () => {
const result = parseAnalysisVisuals([visual(), visual({ id: 'visual-2' }), visual({ id: 'visual-3' }), visual({ id: 'visual-4' })]);
assert.equal(result.visuals.length, 3);
assert.ok(result.issues.some(issue => issue.includes('前 3 张')));
});
test('column is vertical, preserves zero and places negative values below their endpoints', () => {
const fullLabel = '特长规格名称用于检查轴标签缩短但数据仍保留完整名称'.repeat(2);
const model = parseAnalysisVisuals([visual({
type: 'column',
unit: 'pp',
categories: [{ key: 'negative', label: fullLabel }, { key: 'zero', label: '零变化' }],
series: [{ key: 'change', label: '变化', values: [-3.25, 0] }],
})]).visuals[0];
assert.equal(model.chartable, true);
const option = buildAnalysisVisualOption(model);
assert.equal(option.xAxis.type, 'category');
assert.equal(option.yAxis.type, 'value');
assert.equal(option.yAxis.scale, false);
assert.deepEqual(option.series[0].data.map(item => item.value), [-3.25, 0]);
assert.equal(option.series[0].data[0].label.position, 'bottom');
assert.equal(option.series[0].data[1].label.position, 'top');
assert.doesNotMatch(option.xAxis.data[0], new RegExp(fullLabel));
const tooltip = option.tooltip.formatter([{ dataIndex: 0, seriesIndex: 0 }]);
assert.ok(tooltip.includes(fullLabel));
assert.ok(renderVisualTableHtml(model).includes(fullLabel));
const exported = buildAnalysisVisualExportOption(model);
assert.equal(exported.option.xAxis.type, 'category');
assert.equal(exported.option.yAxis.type, 'value');
assert.match(exported.option.xAxis.data[0], /\n/);
});
test('area is a single filled line series and retains null gaps without stacking', () => {
const model = parseAnalysisVisuals([visual({
type: 'area',
categories: [{ key: 'a', label: '一月' }, { key: 'b', label: '二月' }, { key: 'c', label: '三月' }],
series: [{ key: 'rate', label: '合格率', values: [0.8, null, 0.9] }],
})]).visuals[0];
const option = buildAnalysisVisualOption(model);
assert.equal(model.chartable, true);
assert.equal(option.series[0].type, 'line');
assert.equal(option.series[0].areaStyle.opacity, 0.18);
assert.equal(option.series[0].stack, undefined);
assert.deepEqual(option.series[0].data, [80, null, 90]);
assert.equal(option.series[0].connectNulls, false);
const exported = buildAnalysisVisualExportOption(model);
assert.equal(exported.option.series[0].type, 'line');
assert.ok(exported.option.series[0].areaStyle);
const invalid = parseAnalysisVisuals([visual({ type: 'area', series: [
{ key: 'a', label: 'A', values: [0.1, 0.2] }, { key: 'b', label: 'B', values: [0.2, 0.3] },
] })]).visuals[0];
assert.equal(invalid.chartable, false);
assert.match(invalid.chartIssue, /单一序列/);
});
test('heatmap omits null cells, plots actual zero, and uses a sign-neutral diverging palette', () => {
const model = parseAnalysisVisuals([visual({
type: 'heatmap', unit: 'pp',
categories: [{ key: 'missing', label: '缺失期' }, { key: 'zero', label: '零变化' }, { key: 'up', label: '改善' }],
series: [{ key: 'delta', label: '百分点变化', values: [null, 0, 2.5] }],
})]).visuals[0];
const option = buildAnalysisVisualOption(model);
assert.equal(model.chartable, true);
assert.equal(option.series[0].type, 'heatmap');
assert.deepEqual(option.series[0].data, [[1, 0, 0], [2, 0, 2.5]]);
assert.equal(option.grid.backgroundColor, '#eef1f5');
assert.equal(option.visualMap.min, 0);
assert.deepEqual(option.visualMap.inRange.color, ['#e8ebef', '#557fb3']);
assert.equal(option.series[0].label.formatter({ data: [1, 0, 0] }), '0.00');
assert.equal(option.series[0].label.formatter({ data: [2, 0, 2.5] }), '2.50');
const signed = parseAnalysisVisuals([visual({
type: 'heatmap', unit: 'pp',
series: [{ key: 'delta', label: '变化', values: [-2, 0] }],
})]).visuals[0];
const signedOption = buildAnalysisVisualOption(signed);
assert.equal(signedOption.visualMap.min, -2);
assert.equal(signedOption.visualMap.max, 2);
assert.deepEqual(signedOption.visualMap.inRange.color, ['#557fb3', '#f1f3f5', '#c66565']);
const exported = buildAnalysisVisualExportOption(signed);
assert.equal(exported.option.series[0].type, 'heatmap');
assert.equal(exported.option.visualMap.right, 18);
assert.equal(exported.option.xAxis.data[0], '2026-08');
const ratio = parseAnalysisVisuals([visual({ type: 'heatmap' })]).visuals[0];
const ratioOption = buildAnalysisVisualOption(ratio);
assert.match(ratioOption.tooltip.formatter({ data: [1, 0, 84] }), /84%/);
assert.doesNotMatch(ratioOption.tooltip.formatter({ data: [1, 0, 84] }), /8400/);
});
test('heatmap static export suppresses crowded cell labels but preserves all cells and table values', () => {
const categories = Array.from({ length: 36 }, (_, index) => ({ key: `2026-${index + 1}`, label: `2026-${String(index + 1).padStart(2, '0')}` }));
const model = parseAnalysisVisuals([visual({
type: 'heatmap', unit: 'kg', categories,
series: [{ key: 'weight', label: '重量', values: categories.map((_item, index) => index) }],
})]).visuals[0];
const exported = buildAnalysisVisualExportOption(model);
assert.equal(exported.option.series[0].label.show, false);
assert.equal(exported.option.series[0].data.length, 36);
assert.ok(exported.height < 900, 'a single indicator stays compact when more months are shown horizontally');
assert.match(renderVisualTableHtml(model), /2026-36/);
});
test('donut accepts only a complete official mutually-exclusive category set and uses listed-weight denominator', () => {
const parsed = parseAnalysisVisuals([donut()]);
const model = parsed.visuals[0];
assert.equal(model.chartable, true);
assert.deepEqual(visualDonutShares(model).map(item => item.share), [0, 0.2, 0.8]);
const option = buildAnalysisVisualOption(model);
assert.equal(option.series[0].type, 'pie');
assert.deepEqual(option.series[0].data.map(item => item.value), [0, 2, 8]);
assert.match(option.graphic[0].style.text, /10 kg/);
assert.match(option.graphic[1].style.text, /不代表正式总报废占比/);
assert.match(option.series[0].label.formatter({ dataIndex: 1 }), /20%/);
const table = renderVisualTableHtml(model);
assert.match(table, /占比以本图所列类别重量合计为分母/);
assert.match(table, /20%/);
const exported = buildAnalysisVisualExportOption(model);
assert.equal(exported.option.series[0].type, 'pie');
assert.equal(exported.option.grid, undefined);
assert.equal(exported.option.legend.show, true);
assert.match(exported.option.title.subtext, /不代表正式总报废占比/);
assert.match(exported.option.graphic.elements.map(item => item.style.text || '').join('\n'), /责废:0 kg/);
assert.match(exported.option.graphic.elements[0].style.text, /10 kg/);
assert.equal(exported.option.series[0].center[0], 640);
assert.ok(exported.height > 600);
const bright = parseAnalysisVisuals([donut({
stage: 'bright', scope: { stage: 'bright' },
categories: [
{ key: 'bright_plating_scrap', label: '镀废' },
{ key: 'bright_material_scrap', label: '材料废' },
{ key: 'bright_processing_scrap', label: '加工废' },
{ key: 'bright_diffusion_scrap', label: '扩散废' },
],
series: [{ key: 'source_defect_weight', label: '类别重量', values: [1, 1, 1, 1] }],
coverage: { totalRows: 4, returnedRows: 4, truncated: false, shareBasis: 'displayed_categories' },
})]).visuals[0];
assert.equal(bright.chartable, true);
});
test('donut rejects source details, ranking, missing values, negative and all-zero denominators', () => {
const badCases = [
donut({ categories: [{ key: 'source-defect-crack', label: '裂纹' }, { key: 'black_material_scrap', label: '料废' }, { key: 'black_external_scrap', label: '外废' }] }),
donut({ categories: [{ key: 'spec-a', label: '规格甲' }, { key: 'spec-b', label: '规格乙' }, { key: 'spec-c', label: '规格丙' }] }),
donut({ stage: undefined, scope: {} }),
donut({ stage: 'bright' }),
donut({ metric: 'current_scrap_weight' }),
donut({ unit: 'count' }),
donut({ coverage: { totalRows: 3, returnedRows: 3, truncated: false, shareBasis: 'formal_total' } }),
donut({ coverage: { totalRows: 4, returnedRows: 3, truncated: false, shareBasis: 'displayed_categories' } }),
donut({ coverage: { totalRows: 3, returnedRows: 3, truncated: true, shareBasis: 'displayed_categories' } }),
donut({ scope: { stage: 'bright' } }),
donut({ scope: { category: '责废' } }),
donut({ series: [{ key: 'source_defect_weight', label: '类别重量', values: [0, null, 8] }] }),
donut({ series: [{ key: 'source_defect_weight', label: '类别重量', values: [-1, 2, 8] }] }),
donut({ series: [{ key: 'source_defect_weight', label: '类别重量', values: [0, 0, 0] }] }),
donut({ series: [{ key: 'source_defect_weight', label: '类别重量', values: [1e308, 1e308, 0] }] }),
donut({ series: [{ key: 'source_defect_weight', label: '类别重量', values: [2, 8, 0] }, { key: 'other', label: '其他', values: [1, 2, 3] }] }),
];
for (const malformed of badCases) {
const parsed = parseAnalysisVisuals([malformed]);
assert.equal(parsed.visuals.length, 1);
assert.equal(parsed.visuals[0].chartable, false, JSON.stringify(malformed));
assert.match(parsed.visuals[0].chartIssue, /以下展示原始数据表/);
assert.deepEqual(visualDonutShares(parsed.visuals[0]), []);
}
});
test('all supported chart types export through their own chart family with safe special labels', () => {
const cases = [
visual({ type: 'bar' }),
visual({ type: 'line' }),
visual({ type: 'column', unit: 'count', categories: [{ key: 'x', label: '产品甲' }, { key: 'y', label: '产品乙' }] }),
visual({ type: 'area', categories: [{ key: 'x', label: '一月' }, { key: 'y', label: '二月' }] }),
visual({ type: 'heatmap', categories: [{ key: 'x', label: '一月' }, { key: 'y', label: '二月' }] }),
donut({ title: '<img src=x onerror=alert(1)> {danger|title}' }),
pareto(),
];
const expectedTypes = ['bar', 'line', 'bar', 'line', 'heatmap', 'pie', 'bar'];
cases.forEach((item, index) => {
const model = parseAnalysisVisuals([item]).visuals[0];
assert.equal(model.chartable, true);
const option = buildAnalysisVisualOption(model);
const exported = buildAnalysisVisualExportOption(model);
assert.ok(exported.option.title.text.length > 0);
assert.ok(exported.option.title.subtext.includes('期间:'));
assert.equal(exported.option.series[0].type, expectedTypes[index]);
assert.equal(exported.option.tooltip.show, false);
assert.equal(exported.option.animation, false);
});
const hostile = parseAnalysisVisuals([donut({ title: '<img src=x onerror=alert(1)> {danger|title}' })]).visuals[0];
const exported = buildAnalysisVisualExportOption(hostile);
assert.match(exported.option.title.text.replace(/\n/g, ''), /{danger\|title}/);
assert.match(exported.option.title.text, /<img src=x onerror=alert\(1\)>/);
assert.equal(hostile.chartable, true);
});
test('Pareto is an official-category dual-axis chart with computed listed-category shares', () => {
const parsed = parseAnalysisVisuals([pareto({
series: [{ key: 'source_defect_weight', label: '报废重量', values: [8, 2, 0] }],
})]);
const model = parsed.visuals[0];
assert.equal(model.chartable, true);
assert.deepEqual(visualParetoPoints(model), [
{ categoryIndex: 0, valueKg: 8, share: 0.8, cumulativeShare: 0.8 },
{ categoryIndex: 1, valueKg: 2, share: 0.2, cumulativeShare: 1 },
{ categoryIndex: 2, valueKg: 0, share: 0, cumulativeShare: 1 },
]);
const option = buildAnalysisVisualOption(model);
assert.deepEqual(option.yAxis.map(axis => axis.type), ['value', 'value']);
assert.equal(option.yAxis[0].name, '重量(kg)');
assert.equal(option.yAxis[1].max, 100);
assert.equal(option.series[0].type, 'bar');
assert.equal(option.series[0].yAxisIndex, 0);
assert.deepEqual(option.series[0].data, [8, 2, 0]);
assert.equal(option.series[1].type, 'line');
assert.equal(option.series[1].yAxisIndex, 1);
assert.deepEqual(option.series[1].data, [80, 100, 100]);
assert.equal(option.series[1].label.formatter({ data: 87.571488 }), '87.57%');
const darkOption = buildAnalysisVisualOption(model, { ink: '#eaf0fa' });
assert.equal(darkOption.series[1].lineStyle.color, '#eaf0fa');
assert.match(option.legend.data[1], /累计占本图已列类别合计/);
const tooltip = option.tooltip.formatter([
{ dataIndex: 1, seriesIndex: 0 }, { dataIndex: 1, seriesIndex: 1 },
]);
assert.match(tooltip, /报废重量:2 kg/);
assert.match(tooltip, /本图类别占比:20%/);
assert.match(tooltip, /累计占本图已列类别合计:100%/);
assert.doesNotMatch(tooltip, /正式总报废/);
const exported = buildAnalysisVisualExportOption(model);
assert.equal(exported.option.series[0].type, 'bar');
assert.equal(exported.option.series[1].type, 'line');
assert.deepEqual(exported.option.yAxis.map(axis => axis.max), [undefined, 100]);
assert.match(exported.option.title.subtext, /不代表正式总报废累计占比/);
assert.match(exported.option.graphic.elements[0].style.text, /柏拉图累计占比=累计重量/);
assert.equal(exported.option.tooltip.show, false);
});
test('Pareto rejects incomplete, negative, ascending, or non-official category data', () => {
const badCases = [
pareto({ series: [{ key: 'source_defect_weight', label: '重量', values: [2, 8, 0] }] }),
pareto({ series: [{ key: 'source_defect_weight', label: '重量', values: [8, null, 0] }] }),
pareto({ series: [{ key: 'source_defect_weight', label: '重量', values: [8, -2, 0] }] }),
pareto({ series: [{ key: 'source_defect_weight', label: '重量', values: [0, 0, 0] }] }),
pareto({ series: [{ key: 'source_defect_weight', label: '重量', values: [1e308, 1e308, 0] }] }),
pareto({ categories: [{ key: 'specific-crack', label: '裂纹' }, { key: 'b', label: '材料废' }, { key: 'c', label: '外废' }] }),
pareto({ coverage: { totalRows: 4, returnedRows: 3, truncated: false, shareBasis: 'displayed_categories' } }),
pareto({ coverage: { totalRows: 3, returnedRows: 3, truncated: false, shareBasis: 'formal_total' } }),
pareto({ metric: 'current_scrap_weight' }),
pareto({ unit: 'count' }),
pareto({ stage: undefined, scope: {} }),
];
for (const malformed of badCases) {
const parsed = parseAnalysisVisuals([malformed]);
assert.equal(parsed.visuals[0].chartable, false, JSON.stringify(malformed));
assert.match(parsed.visuals[0].chartIssue, /以下展示原始数据表/);
assert.deepEqual(visualParetoPoints(parsed.visuals[0]), []);
}
});
test('composition legends cannot change the denominator and authorized category subsets remain chartable', () => {
const categories = [{ key: 'black_responsibility_scrap', label: '责废' }, { key: 'black_material_scrap', label: '料废' }];
for (const type of ['donut', 'pareto']) {
const model = parseAnalysisVisuals([donut({ type, categories,
series: [{ key: 'source_defect_weight', label: '类别重量', values: [3, 2] }],
coverage: { totalRows: 2, returnedRows: 2, truncated: false, shareBasis: 'displayed_categories' },
})]).visuals[0];
assert.equal(model.chartable, true);
assert.equal(buildAnalysisVisualOption(model).legend.selectedMode, false);
const points = type === 'donut' ? visualDonutShares(model) : visualParetoPoints(model);
assert.deepEqual(points.map(point => point.share), [0.6, 0.4]);
}
});
test('negative area data is shown as a table rather than filled as a valid trend', () => {
const model = parseAnalysisVisuals([visual({ type: 'area', unit: 'kg',
series: [{ key: 'current_scrap_weight', label: '重量', values: [10, -2] }],
})]).visuals[0];
assert.equal(model.chartable, false);
assert.match(model.chartIssue, /负值/);
});