@fses/workbench-app 0.2.0 → 0.2.2

package/node_modules/@fses/workbench-card/src/renderers/reference-composite/referenceRiskAndStrategyBindings.ts

@@ -0,0 +1,1004 @@
+/**
+ * @fileoverview 引用复合风险与策略绑定 - 提供高密度风险、快捷工作台、策略 KPI 和运营健康预览 helper。
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { CSSProperties } from 'vue';
+import type { CustomCanvasData, CustomCanvasNestedBlock } from '../../types';
+
+type ReferenceRiskStrategyContext = Record<string, any>;
+type NestedBlockVisualKind =
+  | 'metric'
+  | 'table'
+  | 'list'
+  | 'chart'
+  | 'statusList'
+  | 'incidentList'
+  | 'resourceBars'
+  | 'securityScore'
+  | 'simpleList'
+  | 'progressList'
+  | 'todoGrid'
+  | 'quickLinks'
+  | 'donut'
+  | 'summary';
+type NestedBlockTone = 'healthy' | 'warning' | 'critical' | 'info' | 'violet' | 'neutral';
+type ReferenceOperationEfficiencyGroup = { id: string; title: string; items: Array<Record<string, unknown>> };
+
+export interface ReferenceStrategyKpiRiskDisplayTextInput {
+  label?: unknown;
+  detail?: unknown;
+  description?: unknown;
+  owner?: unknown;
+  subtitle?: unknown;
+  value?: unknown;
+  status?: unknown;
+  amount?: unknown;
+  ratio?: unknown;
+  progress?: unknown;
+  cells?: unknown;
+  needsHumanIntervention?: boolean;
+}
+
+export interface ReferenceStrategyKpiRiskDisplayText {
+  detail: string;
+  value: string;
+}
+
+/**
+ * Cleans visible detail/value copy for strategy-KPI risk child cards.
+ * @param input - Label, detail, value, and business-gap state for one risk item.
+ * @returns Display text with duplicate titles and internal ids removed.
+ */
+export function referenceStrategyKpiRiskDisplayText(
+  input: ReferenceStrategyKpiRiskDisplayTextInput,
+): ReferenceStrategyKpiRiskDisplayText {
+  const label = strategyKpiRiskString(input.label);
+  let detail = strategyKpiRiskFirstUsableText(
+    [input.detail, input.description, input.owner, input.subtitle],
+    label,
+  );
+  const value = strategyKpiRiskFirstUsableText(
+    [input.value, input.status, input.amount, input.ratio, input.progress, strategyKpiRiskCellValue(input.cells, 1)],
+    label,
+    detail,
+  );
+  if (!detail && input.needsHumanIntervention) detail = '待补口径';
+  return { detail, value };
+}
+
+/**
+ * Normalizes unknown item fields into trimmed display text.
+ * @param value - Candidate risk display value.
+ * @returns Trimmed string value.
+ */
+function strategyKpiRiskString(value: unknown): string {
+  if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+/**
+ * Picks the first visible risk field that is not duplicate title text or internal metadata.
+ * @param values - Candidate fields in renderer read order.
+ * @param label - Visible risk title.
+ * @param previous - Already selected sibling text, used to avoid duplicate detail/value.
+ * @returns Clean display text.
+ */
+function strategyKpiRiskFirstUsableText(values: unknown[], label: string, previous = ''): string {
+  for (const value of values) {
+    const text = strategyKpiRiskString(value);
+    if (strategyKpiRiskTextUnusable(text, label)) continue;
+    if (previous && strategyKpiRiskSameText(text, previous)) continue;
+    return text;
+  }
+  return '';
+}
+
+/**
+ * Reads a table-cell fallback without assuming the model used item.value.
+ * @param cells - Optional cells array from recognized table rows.
+ * @param index - Cell index used by the renderer fallback.
+ * @returns Cell value when present.
+ */
+function strategyKpiRiskCellValue(cells: unknown, index: number): unknown {
+  return Array.isArray(cells) ? cells[index] : undefined;
+}
+
+/**
+ * Checks whether a candidate risk detail/value should be hidden.
+ * @param value - Candidate risk text.
+ * @param label - Visible risk title.
+ * @returns True when the text is empty, duplicate, or internal metadata.
+ */
+function strategyKpiRiskTextUnusable(value: string, label: string): boolean {
+  if (!value) return true;
+  if (strategyKpiRiskSameText(value, label)) return true;
+  if (strategyKpiRiskRepeatedLabelText(value, label)) return true;
+  return /(?:parentBlockId|dataBindingId|bindingId|refreshApi|workbench\.v2\.image|recognized-\d+|qwen\d+|persisted-)/i.test(value);
+}
+
+/**
+ * Compares two short display strings after removing visual separators.
+ * @param left - First display string.
+ * @param right - Second display string.
+ * @returns True when both strings represent the same visible text.
+ */
+function strategyKpiRiskSameText(left: string, right: string): boolean {
+  if (!left || !right) return false;
+  return strategyKpiRiskComparableText(left) === strategyKpiRiskComparableText(right);
+}
+
+/**
+ * Detects text made only of the title repeated through common visual separators.
+ * @param value - Candidate visible text.
+ * @param label - Risk child title.
+ * @returns True when the text is a repeated title pair or triplet.
+ */
+function strategyKpiRiskRepeatedLabelText(value: string, label: string): boolean {
+  if (!value || !label) return false;
+  const labelToken = strategyKpiRiskComparableText(label);
+  if (!labelToken) return false;
+  const parts = value
+    .split(/[\s\-_/|:：·,，.。;；()[\]{}【】<>《》]+/g)
+    .map((part) => strategyKpiRiskComparableText(part))
+    .filter(Boolean);
+  return parts.length > 1 && parts.every((part) => part === labelToken);
+}
+
+/**
+ * Builds a comparable token for duplicate display text detection.
+ * @param value - Display text.
+ * @returns Lowercase text without whitespace and punctuation separators.
+ */
+function strategyKpiRiskComparableText(value: string): string {
+  return value
+    .toLowerCase()
+    .replace(/[\s\-_/|:：·,，.。;；()[\]{}【】<>《》]+/g, '');
+}
+
+/**
+ * Builds the item record consumed by the template after collapsing all display aliases.
+ * @param item - Source risk item from OCR/query data.
+ * @param displayText - Clean detail and value selected for the visible row.
+ * @returns Item record whose renderer-read fields cannot reintroduce duplicate title text.
+ */
+function referenceStrategyKpiRiskDisplayItem(
+  item: Record<string, unknown>,
+  displayText: ReferenceStrategyKpiRiskDisplayText,
+): Record<string, unknown> {
+  return {
+    ...item,
+    detail: displayText.detail,
+    description: '',
+    owner: '',
+    subtitle: '',
+    status: '',
+    value: displayText.value,
+    amount: '',
+    ratio: '',
+    progress: '',
+    cells: [item.label ?? item.name ?? item.title ?? '', displayText.value],
+  };
+}
+
+/**
+ * Creates helpers for the risk and strategy reference composite families.
+ * @param context - Shared reference and nested helper functions.
+ * @returns Risk, shortcut, strategy KPI, and operation reference helpers.
+ */
+export function createReferenceRiskAndStrategyBindings(context: ReferenceRiskStrategyContext) {
+  const {
+    textValue,
+    referenceNestedBlock,
+    referenceMetricItem,
+    referenceNestedMetricItem,
+    customCanvasTextElementValue,
+    nestedBlockClassifierText,
+    nestedBlockItemLabel,
+    nestedBlockItemValue,
+    nestedBlockItemDetail,
+    nestedBlockItemTitle,
+    nestedBlockRawItems,
+    nestedBlockItems,
+    nestedBlockItemsLookTooWeak,
+    nestedBlockItemsLookTooWeakForVisualKind,
+    nestedBlockOptionalNumber,
+    nestedBlockDisplayValue,
+    nestedBlockMetricValue,
+    nestedBlockDataSummary,
+    nestedBlockToneFromStatus,
+    nestedBlockDonutItems,
+    nestedBlockNeedsHumanIntervention,
+    nestedBlockNumber,
+  } = context;
+
+  function referenceExpenseRiskRows(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /费用超支|超支排行|费用.*排行/);
+    const rawItems = block ? nestedBlockRawItems(block) : [];
+    if (rawItems.length >= 3 && !nestedBlockItemsLookTooWeak(rawItems)) return rawItems.slice(0, 5);
+    return [
+      { label: '管理费用', value: '+12.8%', progress: 72, tone: 'critical' },
+      { label: '外包成本', value: '+10.6%', progress: 60, tone: 'critical' },
+      { label: '营销投放', value: '+8.4%', progress: 48, tone: 'warning' },
+      { label: '物流仓储', value: '+6.2%', progress: 38, tone: 'warning' },
+      { label: '差旅会议', value: '-3.1%', progress: 28, tone: 'healthy' },
+    ];
+  }
+  
+  /**
+   * Returns summary rows for the expense-overrun panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Expense summary rows.
+   */
+  function referenceExpenseSummaryItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /超阈值|冻结|审计/);
+    if (block && !nestedBlockItemsLookTooWeakForVisualKind(nestedBlockRawItems(block), 'simpleList')) return nestedBlockItems(block).slice(0, 2);
+    return [
+      { label: '3 项超阈值', detail: '管理费用、外包成本连续超预算。', value: '专项审计', tone: 'critical' },
+    ];
+  }
+  
+  /**
+   * Returns compact rows for the chairman deviation-insight side panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Insight rows preserving OCR text when available.
+   */
+  function referenceDeviationInsightItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const rows = nestedBlocks.flatMap((block) => {
+      const rawItems = nestedBlockRawItems(block);
+      if (rawItems.length > 0 && !nestedBlockItemsLookTooWeakForVisualKind(rawItems, 'simpleList')) return rawItems;
+      const title = textValue(block.title);
+      if (!/利润同比|费用环比|预算偏离|偏差|管理费用|新基地/.test(title)) return [];
+      return [{
+        label: title,
+        value: nestedBlockMetricValue(block),
+        detail: nestedBlockDataSummary(block),
+        tone: /下滑|偏离|超|异动/.test(title) ? 'critical' : 'warning',
+      }];
+    });
+    const fallbackRows = [
+      { label: '利润同比下滑：华东事业部', value: '-23.4%', tone: 'critical' },
+      { label: '费用环比异动：管理费用', value: '+12.8%', tone: 'critical' },
+      { label: '预算偏离：华南新基地', value: '+9.6%', tone: 'warning' },
+    ];
+    return (rows.length > 0 ? rows : fallbackRows).slice(0, 4);
+  }
+  
+  /**
+   * Returns metrics for the organization-risk panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Organization and efficiency metrics.
+   */
+  function referenceOrganizationRiskMetrics(data: CustomCanvasData): Array<Record<string, unknown>> {
+    return [
+      referenceMetricItem(data, '组织稳定分', /组织稳定|稳定分/, '71', 'warning'),
+      referenceMetricItem(data, '核心流失率', /核心流失|流失率/, '+0.7pp', 'critical'),
+      referenceMetricItem(data, '人效下滑', /人效下滑|人效风险/, '-8.6%', 'critical'),
+      referenceMetricItem(data, '超编部门', /超编/, '+16%', 'warning'),
+    ];
+  }
+  
+  /**
+   * Builds a conic-gradient donut for the chairman organization stability score.
+   * @param item - Organization score metric item.
+   * @returns CSS background style for the score donut.
+   */
+  function referenceOrganizationDonutStyle(item: Record<string, unknown>): CSSProperties {
+    const value = nestedBlockNumber(nestedBlockItemValue(item), 71);
+    const safeValue = Math.max(0, Math.min(100, value));
+    return {
+      background: `radial-gradient(circle at center, transparent 0 53%, transparent 54%), conic-gradient(#d12f2f 0 ${safeValue}%, #e28b12 ${safeValue}% 100%)`,
+    };
+  }
+  
+  /**
+   * Returns rows for investment/project-risk panels.
+   * @param data - Custom canvas renderer data.
+   * @returns Gantt-like project risk rows.
+   */
+  function referenceInvestmentRiskRows(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /项目风险排行|项目风险|投资.*风险/);
+    const rawItems = block ? nestedBlockRawItems(block) : [];
+    if (rawItems.length >= 3 && !nestedBlockItemsLookTooWeak(rawItems)) return rawItems.slice(0, 4);
+    return [
+      { label: '华南新基地', value: '超支', progress: 78, tone: 'critical' },
+      { label: '技改一期', value: '延期', progress: 62, tone: 'warning' },
+      { label: '合资项目', value: '回报低', progress: 54, tone: 'critical' },
+      { label: '数据中台', value: '产出偏', progress: 70, tone: 'warning' },
+    ];
+  }
+  
+  /**
+   * Returns project-risk summary rows.
+   * @param data - Custom canvas renderer data.
+   * @returns Project summary rows.
+   */
+  function referenceInvestmentSummaryItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /战略项目|落地滞后|延期|超支/);
+    if (block && !nestedBlockItemsLookTooWeakForVisualKind(nestedBlockRawItems(block), 'simpleList')) return nestedBlockItems(block).slice(0, 2);
+    return [
+      { label: '战略项目落地滞后', detail: '延期与超支叠加，投资回报周期拉长。', value: '重排里程碑', tone: 'warning' },
+    ];
+  }
+  
+  /**
+   * Returns approval rows for chairman/executive todo panels.
+   * @param data - Custom canvas renderer data.
+   * @returns Major approval rows.
+   */
+  function referenceExecutiveTodoItems(data: CustomCanvasData, minRows = 0): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const rows = nestedBlocks.flatMap((block) => {
+      if (!referenceExecutiveTodoBlockLooksUsable(block)) return [];
+      const rawItems = nestedBlockRawItems(block);
+      if (rawItems.length > 0 && !nestedBlockItemsLookTooWeak(rawItems)) return rawItems;
+      return /战略投资|资金支付|人事|任免|担保|预算|复核|签批|资金缺口|应收逾期|逾期应收/.test(block.title)
+        ? [{ label: block.title, value: nestedBlockMetricValue(block), detail: nestedBlockDataSummary(block), tone: /超期|逾期|未/.test(block.title) ? 'critical' : 'warning' }]
+        : [];
+    });
+    const reliableRows = rows.map((row, index) => referenceExecutiveTodoNormalizeRow(row, index));
+    if (reliableRows.length > 0) return minRows > 0
+      ? referenceExecutiveTodoPadRows(reliableRows, minRows)
+      : reliableRows.slice(0, 3);
+    const fallbackRows = [
+      { label: '待办事项', value: '待确认', detail: '业务口径待补充', tone: 'warning' },
+      { label: '待复核事项', value: '待复核', detail: '责任人与截止时间待确认', tone: 'warning' },
+      { label: '待审批事项', value: '待审批', detail: '审批链路待确认', tone: 'warning' },
+    ];
+    if (minRows <= 0) return fallbackRows.slice(0, 3);
+    return referenceExecutiveTodoPadRows(fallbackRows, minRows);
+  }
+  
+  /**
+   * Normalizes a recognized todo row without replacing it with screenshot-specific business text.
+   * @param row - Model OCR row or query-refreshed row.
+   * @param index - Row index for stable visual fallback labels.
+   * @returns Row with generic display fields for the compact todo template.
+   */
+  function referenceExecutiveTodoNormalizeRow(row: Record<string, unknown>, index: number): Record<string, unknown> {
+    const label = nestedBlockItemLabel(row, index);
+    const detail = nestedBlockItemDetail(row);
+    const impact = nestedBlockDisplayValue(row.impact ?? row.amount ?? row.primaryValue ?? row.value, '');
+    const deadline = nestedBlockDisplayValue(row.deadline ?? row.dueDate ?? row.date ?? row.time, '');
+    const progress = nestedBlockDisplayValue(row.progress ?? row.ratio ?? row.stage, '');
+    return {
+      ...row,
+      label,
+      title: label,
+      detail: detail || '业务口径待补充',
+      impact: impact || '待确认',
+      deadline: deadline || '待确认',
+      progress: progress || '待推进',
+      status: textValue(row.status, textValue(row.badge, '待处理')),
+    };
+  }
+  
+  /**
+   * Pads a compact todo panel with neutral placeholders when recognition returns too few rows.
+   * @param rows - Reliable rows from the image model or query setData result.
+   * @param minRows - Minimum visual row count requested by the template.
+   * @returns Rows padded with generic placeholders only.
+   */
+  function referenceExecutiveTodoPadRows(rows: Array<Record<string, unknown>>, minRows: number): Array<Record<string, unknown>> {
+    const placeholders = [
+      { label: '待办事项', value: '待确认', detail: '业务口径待补充', tone: 'warning' },
+      { label: '待复核事项', value: '待复核', detail: '责任人与截止时间待确认', tone: 'warning' },
+      { label: '待审批事项', value: '待审批', detail: '审批链路待确认', tone: 'warning' },
+    ];
+    return [...rows, ...placeholders]
+      .slice(0, Math.max(minRows, 3))
+      .map((row, index) => referenceExecutiveTodoNormalizeRow(row, index));
+  }
+  
+  /**
+   * Rejects non-approval business rows before extracting chairman todo content.
+   * @param block - Candidate nested card from the screenshot container.
+   * @returns True when the block belongs to approval/todo semantics.
+   */
+  function referenceExecutiveTodoBlockLooksUsable(block: CustomCanvasNestedBlock): boolean {
+    const text = [
+      block.title,
+      nestedBlockDataSummary(block),
+      ...nestedBlockRawItems(block).map((item: Record<string, unknown>, index: number) => nestedBlockItemTitle(item, index)),
+    ].filter(Boolean).join(' ');
+    if (/现金流|坏账/.test(text)) return false;
+    return /战略投资|资金支付|人事|任免|担保|预算|复核|签批|待审批|待复核|待签批|流程|资金缺口|应收逾期/.test(text);
+  }
+  
+  /**
+   * Returns the fixed status badge text for chairman approval rows.
+   * @param item - Approval row rendered in the reference panel.
+   * @param index - Row index used for stable fallback labels.
+   * @returns Short status badge text matching the source screenshot.
+   */
+  function referenceExecutiveTodoBadge(item: Record<string, unknown>, index: number): string {
+    const explicitStatus = textValue(item.status, textValue(item.badge));
+    if (explicitStatus && !/待签批|待复核/.test(explicitStatus)) return explicitStatus;
+    if (index === 0 || /逾期|超期|应收|缺口/.test(nestedBlockItemTitle(item, index))) return '逾期';
+    if (index === 1) return '整改中';
+    return '未整改';
+  }
+  
+  /**
+   * Builds fixed-size status badge classes for chairman approval rows.
+   * @param item - Approval row rendered in the reference panel.
+   * @param index - Row index used for fallback tone.
+   * @returns Tailwind classes for a compact, non-stretching badge.
+   */
+  function referenceExecutiveTodoBadgeClasses(item: Record<string, unknown>, index: number): string[] {
+    const badge = referenceExecutiveTodoBadge(item, index);
+    const base = ['inline-flex h-7 w-14 shrink-0 items-center justify-center truncate rounded border px-1.5 text-xs font-semibold leading-none'];
+    if (/逾期|未|超期/.test(badge)) return [...base, 'border-red-200 bg-red-50 text-red-600'];
+    if (/整改|复核|待/.test(badge)) return [...base, 'border-amber-200 bg-amber-50 text-amber-700'];
+    return [...base, 'border-slate-200 bg-slate-50 text-slate-600'];
+  }
+  
+  /**
+   * Reads impact text for a chairman approval row.
+   * @param item - Approval row rendered in the reference panel.
+   * @param index - Row index used for stable fallback values.
+   * @returns Impact value such as amount or risk level.
+   */
+  function referenceExecutiveTodoImpact(item: Record<string, unknown>, index: number): string {
+    return nestedBlockDisplayValue(
+      item.impact ?? item.amount ?? item.primaryValue ?? item.value,
+      index === 0 ? '待确认' : '待补充',
+    );
+  }
+  
+  /**
+   * Reads deadline text for a chairman approval row.
+   * @param item - Approval row rendered in the reference panel.
+   * @param index - Row index used for stable fallback values.
+   * @returns Deadline value.
+   */
+  function referenceExecutiveTodoDeadline(item: Record<string, unknown>, index: number): string {
+    return nestedBlockDisplayValue(
+      item.deadline ?? item.dueDate ?? item.date ?? item.time,
+      index === 0 ? '待确认' : '待补充',
+    );
+  }
+  
+  /**
+   * Reads progress text for a chairman approval row.
+   * @param item - Approval row rendered in the reference panel.
+   * @param index - Row index used for stable fallback values.
+   * @returns Progress percentage or short stage text.
+   */
+  function referenceExecutiveTodoProgress(item: Record<string, unknown>, index: number): string {
+    return nestedBlockDisplayValue(
+      item.progress ?? item.ratio ?? item.stage,
+      index === 0 ? '待推进' : '待补充',
+    );
+  }
+  
+  /**
+   * Returns shortcut tiles for chairman drill-through panels.
+   * @param data - Custom canvas renderer data.
+   * @returns Risk drill shortcut rows.
+   */
+  function referenceShortcutDrillItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const directRows = nestedBlocks.flatMap((block) => {
+      const rawItems = nestedBlockRawItems(block);
+      if (rawItems.length > 0 && !nestedBlockItemsLookTooWeak(rawItems)) return rawItems;
+      return /亏损主体|资金风险|违规|延期|费用超支|组织隐患|逾期应收|现金流|坏账/.test(block.title)
+        ? [{ label: block.title, value: nestedBlockMetricValue(block), tone: /资金|亏损|违规|延期/.test(block.title) ? 'critical' : 'warning' }]
+        : [];
+    });
+    const usableRows = directRows.filter((item) => {
+      const label = nestedBlockItemLabel(item, 0);
+      return /亏损主体|资金风险|违规|延期|费用超支|组织隐患|逾期应收|现金流|坏账/.test(label);
+    });
+    if (usableRows.length >= 4) return usableRows.slice(0, 6);
+    return [
+      { label: '亏损主体', value: '8', tone: 'critical' },
+      { label: '资金风险', value: '14', tone: 'critical' },
+      { label: '违规事项', value: '6', tone: 'critical' },
+      { label: '延期项目', value: '5', tone: 'critical' },
+      { label: '费用超支', value: '3', tone: 'warning' },
+      { label: '组织隐患', value: '4', tone: 'warning' },
+    ];
+  }
+  
+  type QuickWorkbenchGroup = {
+    id: 'todo' | 'report' | 'entry' | 'message';
+    title: string;
+    visualKind: NestedBlockVisualKind;
+    fallbackItems: Array<Record<string, unknown>>;
+  };
+  
+  /**
+   * Returns source-like shortcut groups for a quick workbench sidebar.
+   * @returns Stable group definitions used by the quick workbench preview template.
+   */
+  function referenceQuickWorkbenchGroups(): QuickWorkbenchGroup[] {
+    return [
+      {
+        id: 'todo',
+        title: '待办审批',
+        visualKind: 'todoGrid',
+        fallbackItems: [
+          { label: '预算追加审批', value: '5', tone: 'critical' },
+          { label: '重大合同签批', value: '4', tone: 'warning' },
+          { label: '人事任免确认', value: '3', tone: 'info' },
+        ],
+      },
+      {
+        id: 'report',
+        title: '常用报表',
+        visualKind: 'quickLinks',
+        fallbackItems: [
+          { label: '财务月报', value: '打开', tone: 'neutral' },
+          { label: '经营分析会材料', value: '打开', tone: 'neutral' },
+          { label: '行业报告', value: '打开', tone: 'neutral' },
+        ],
+      },
+      {
+        id: 'entry',
+        title: '系统入口',
+        visualKind: 'quickLinks',
+        fallbackItems: [
+          { label: '财务' },
+          { label: '供应链' },
+          { label: 'HR' },
+          { label: 'BI' },
+        ],
+      },
+      {
+        id: 'message',
+        title: '消息中心',
+        visualKind: 'incidentList',
+        fallbackItems: [
+          { label: '现金流预警推送', value: '09:20', tone: 'critical' },
+          { label: '经营会提醒', value: '14:00', tone: 'warning' },
+          { label: '区域订单异动', value: '刚刚', tone: 'info' },
+        ],
+      },
+    ];
+  }
+  
+  /**
+   * Returns quick-workbench rows from OCR/model data, falling back to dense preview rows.
+   * @param data - Custom canvas renderer data.
+   * @param group - Target shortcut group.
+   * @returns Rows for one shortcut/sidebar group.
+   */
+  function referenceQuickWorkbenchGroupItems(data: CustomCanvasData, group: QuickWorkbenchGroup): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const patternMap: Record<QuickWorkbenchGroup['id'], RegExp> = {
+      todo: /待办|审批|签批|任免|预算|urgent|todo/i,
+      report: /报表|月报|分析|材料|报告|report/i,
+      entry: /系统|入口|财务|供应链|HR|BI|平台|quick/i,
+      message: /消息|提醒|预警|通知|异动|message|notice|alert/i,
+    };
+    const rows = nestedBlocks.flatMap((block) => {
+      const blockText = [
+        block.title,
+        nestedBlockDataSummary(block),
+        ...nestedBlockRawItems(block).map((item: Record<string, unknown>, index: number) => nestedBlockItemTitle(item, index)),
+      ].join(' ');
+      if (!patternMap[group.id].test(blockText)) return [];
+      const rawItems = nestedBlockRawItems(block);
+      if (rawItems.length > 0 && !nestedBlockItemsLookTooWeakForVisualKind(rawItems, group.visualKind)) return rawItems;
+      return [{ label: block.title, value: nestedBlockMetricValue(block), detail: nestedBlockDataSummary(block), tone: nestedBlockToneFromStatus(blockText) }];
+    });
+    const elementRows = rows.length > 0 ? [] : referenceCustomCanvasElementRows(data, patternMap[group.id]);
+    const usableRows = rows.length > 0 ? rows : elementRows;
+    return (usableRows.length > 0 ? usableRows : group.fallbackItems).slice(0, group.id === 'entry' ? 4 : 3);
+  }
+  
+  /**
+   * Reads text elements from sparse customCanvas OCR output for a semantic group.
+   * @param data - Custom canvas renderer data.
+   * @param pattern - Semantic matcher for the target group.
+   * @returns Item rows derived from OCR elements.
+   */
+  function referenceCustomCanvasElementRows(data: CustomCanvasData, pattern: RegExp): Array<Record<string, unknown>> {
+    const elements = Array.isArray(data.elements) ? data.elements : [];
+    return elements
+      .map((element) => customCanvasTextElementValue(element))
+      .filter((text) => text && pattern.test(text))
+      .map((text) => ({ label: text, value: '', tone: nestedBlockToneFromStatus(text) }));
+  }
+  
+  /**
+   * Returns the badge text shown on the first quick-workbench group.
+   * @param data - Custom canvas renderer data.
+   * @returns Urgent count badge.
+   */
+  function referenceQuickWorkbenchUrgentBadge(data: CustomCanvasData): string {
+    const todoItems = referenceQuickWorkbenchGroupItems(data, referenceQuickWorkbenchGroups()[0]);
+    const urgent = todoItems
+      .map((item) => nestedBlockOptionalNumber(nestedBlockItemValue(item)))
+      .filter((value): value is number => value !== undefined)
+      .reduce((sum, value) => sum + Math.max(0, value), 0);
+    return urgent > 0 ? `${urgent} 急` : '待处理';
+  }
+  
+  /**
+   * Returns KPI metric tiles for the strategy-KPI reference panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Six KPI rows plus a leading revenue tile when available.
+   */
+  function referenceStrategyKpiMetrics(data: CustomCanvasData): Array<Record<string, unknown>> {
+    return [
+      referenceStrategyKpiMetricItem(data, '营业收入', /营业收入|营收|收入|revenue/i, '¥ 8,642 万', '目标完成率 72%', 'info'),
+      referenceStrategyKpiMetricItem(data, '净利率', /净利率|利润|profit/i, '12.8%', '实际 / 目标', 'healthy'),
+      referenceStrategyKpiMetricItem(data, '现金流', /现金流|cash/i, '¥ 1.28 亿', '经营净流 -820 万', 'critical'),
+      referenceStrategyKpiMetricItem(data, '核心用户 / 订单', /核心用户|订单|客户|user|order/i, '42,860 单', '转化 6.8%', 'healthy'),
+      referenceStrategyKpiMetricItem(data, '本月营收完成', /本月营收|完成率|目标完成|target/i, '72%', '同比 +18.4%', 'info'),
+      referenceStrategyKpiMetricItem(data, '重点项目', /重点项目|项目|project/i, '8 / 11', '2 个延期风险', 'warning'),
+      referenceStrategyKpiMetricItem(data, '市场份额', /市场份额|份额|share/i, '21.6%', '较竞品 A +2.4pp', 'healthy'),
+    ];
+  }
+  
+  /**
+   * Builds compact operation-efficiency groups from recovered nested previews.
+   * @param data - Custom canvas renderer data.
+   * @returns Three business groups for delivery, resource, and milestone previews.
+   */
+  function referenceOperationEfficiencyGroups(data: CustomCanvasData): ReferenceOperationEfficiencyGroup[] {
+    const semanticGroups: ReferenceOperationEfficiencyGroup[] = [
+      {
+        id: 'delivery',
+        title: '交付 / 履约',
+        items: referenceOperationEfficiencyGroupItems(data, /交付|履约|订单准时|生产良率/),
+      },
+      {
+        id: 'resource',
+        title: '资源利用',
+        items: referenceOperationEfficiencyGroupItems(data, /资源利用|人均产值|服务响应|设备利用|库存周转/),
+      },
+      {
+        id: 'milestone',
+        title: '重点项目里程碑',
+        items: referenceOperationEfficiencyGroupItems(data, /重点项目里程碑|里程碑|数字化工厂|成本专项|渠道升级|新品上市/),
+      },
+    ];
+    const populatedGroups = semanticGroups.filter((group) => group.items.length > 0);
+    return populatedGroups.length > 0 ? populatedGroups : referenceOperationEfficiencyFallbackGroups(data);
+  }
+
+  /**
+   * Builds display groups from available child cards when semantic buckets are sparse.
+   * @param data - Custom canvas renderer data.
+   * @returns Non-empty visual groups based on recognized child cards.
+   */
+  function referenceOperationEfficiencyFallbackGroups(data: CustomCanvasData): ReferenceOperationEfficiencyGroup[] {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const sourceItems = nestedBlocks
+      .filter((block) => nestedBlockClassifierText(block) || nestedBlockDataSummary(block) || nestedBlockMetricValue(block))
+      .map((block, index) => ({
+        label: block.title || `识别子卡 ${index + 1}`,
+        value: nestedBlockMetricValue(block),
+        detail: nestedBlockDataSummary(block),
+        tone: nestedBlockNeedsHumanIntervention(block) ? 'warning' : nestedBlockToneFromStatus(nestedBlockClassifierText(block)),
+        nestedBlock: block,
+      }))
+      .slice(0, 6);
+    if (sourceItems.length === 0) {
+      return [{
+        id: 'recognized',
+        title: '识别子卡',
+        items: [{ label: '等待业务口径', value: '待补充', detail: '识别到的区域将作为子卡补充问数。', tone: 'warning' }],
+      }];
+    }
+    const groupCount = Math.min(3, Math.max(1, sourceItems.length));
+    return Array.from({ length: groupCount }, (_, groupIndex) => ({
+      id: `recognized-${groupIndex + 1}`,
+      title: groupCount === 1 ? '识别子卡' : `识别子卡 ${groupIndex + 1}`,
+      items: sourceItems.filter((_, itemIndex) => itemIndex % groupCount === groupIndex),
+    })).filter((group) => group.items.length > 0);
+  }
+
+  /**
+   * Computes operation-efficiency panel columns from populated groups.
+   * @param data - Custom canvas renderer data.
+   * @returns CSS grid style that avoids empty right-side columns.
+   */
+  function referenceOperationEfficiencyPanelStyle(data: CustomCanvasData): CSSProperties {
+    const columnCount = Math.min(3, Math.max(1, referenceOperationEfficiencyGroups(data).length));
+    return {
+      gridTemplateColumns: `repeat(${columnCount}, minmax(0, 1fr))`,
+    };
+  }
+  
+  /**
+   * Builds target progress rows for the ordinary operation-health panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Progress rows preserving OCR/query labels and values.
+   */
+  function referenceOperationHealthProgressItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /目标进度|进度条|目标完成|完成进度/);
+    const rawItems = block ? nestedBlockRawItems(block) : [];
+    if (rawItems.length > 0 && !nestedBlockItemsLookTooWeakForVisualKind(rawItems, 'progressList')) return rawItems.slice(0, 4);
+    return [
+      { label: '营收目标', value: '72%', progress: 72, tone: 'info' },
+      { label: '利润目标', value: '64%', progress: 64, tone: 'warning' },
+      { label: '现金流目标', value: '58%', progress: 58, tone: 'critical' },
+    ];
+  }
+  
+  /**
+   * Builds trend bars for the ordinary operation-health panel.
+   * @param data - Custom canvas renderer data.
+   * @returns Six compact month bars.
+   */
+  function referenceOperationHealthTrendItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const block = referenceNestedBlock(data, /近\s*6\s*个月|核心指标|趋势|同比|预算线|业务线|区域/);
+    const rawItems = block ? nestedBlockRawItems(block) : [];
+    if (rawItems.length >= 4 && !nestedBlockItemsLookTooWeak(rawItems)) return rawItems.slice(0, 6);
+    return [
+      { label: '1月', value: '62', progress: 52, tone: 'info' },
+      { label: '2月', value: '68', progress: 60, tone: 'info' },
+      { label: '3月', value: '74', progress: 68, tone: 'healthy' },
+      { label: '4月', value: '71', progress: 64, tone: 'warning' },
+      { label: '5月', value: '79', progress: 76, tone: 'healthy' },
+      { label: '6月', value: '83', progress: 84, tone: 'healthy' },
+    ];
+  }
+  
+  /**
+   * Finds the structure-ratio child card for ordinary operation-health panels.
+   * @param data - Custom canvas renderer data.
+   * @returns Structure chart child or generic fallback.
+   */
+  function referenceOperationHealthStructureBlock(data: CustomCanvasData): CustomCanvasNestedBlock {
+    return referenceNestedBlock(data, /结构占比|收入结构|业务结构|渠道结构|区域结构/) ?? {
+      id: 'reference-operation-health-structure',
+      title: '结构占比',
+      kind: 'chart',
+      slot: 'body',
+      dataBindingStatus: 'none',
+      data: {
+        visualKind: 'donut',
+        items: [
+          { label: '核心业务', value: '46%', share: 46, tone: 'info' },
+          { label: '增量业务', value: '28%', share: 28, tone: 'healthy' },
+          { label: '创新业务', value: '16%', share: 16, tone: 'warning' },
+          { label: '其他', value: '10%', share: 10, tone: 'neutral' },
+        ],
+      },
+    };
+  }
+  
+  /**
+   * Returns structure-ratio legend rows for ordinary operation-health panels.
+   * @param data - Custom canvas renderer data.
+   * @returns Donut legend rows.
+   */
+  function referenceOperationHealthStructureItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    return nestedBlockDonutItems(referenceOperationHealthStructureBlock(data));
+  }
+  
+  /**
+   * Extracts metric-like rows for one operation-efficiency group.
+   * @param data - Custom canvas renderer data.
+   * @param pattern - Group classifier pattern.
+   * @returns Display rows preserving screenshot or query data values.
+   */
+  function referenceOperationEfficiencyGroupItems(data: CustomCanvasData, pattern: RegExp): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    return nestedBlocks
+      .filter((block) => pattern.test(nestedBlockClassifierText(block)))
+      .map((block, index) => ({
+        label: block.title || `指标 ${index + 1}`,
+        value: nestedBlockMetricValue(block),
+        detail: nestedBlockDataSummary(block),
+        tone: nestedBlockNeedsHumanIntervention(block) ? 'warning' : 'healthy',
+        nestedBlock: block,
+      }))
+      .slice(0, 4);
+  }
+
+  /**
+   * Finds a metric row and keeps the child card it came from.
+   * @param data - Custom canvas renderer data.
+   * @param pattern - Pattern matched against metric labels and row text.
+   * @returns Matched row with its source nested child card.
+   */
+  function referenceStrategyNestedMetricMatch(
+    data: CustomCanvasData,
+    pattern: RegExp,
+  ): { item: Record<string, unknown>; sourceBlock: CustomCanvasNestedBlock } | undefined {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    for (const sourceBlock of nestedBlocks) {
+      const item = nestedBlockRawItems(sourceBlock).find((candidate: Record<string, unknown>, index: number) => {
+        const text = [
+          nestedBlockItemLabel(candidate, index),
+          nestedBlockItemValue(candidate),
+          nestedBlockItemDetail(candidate),
+        ].filter(Boolean).join(' ');
+        return pattern.test(text);
+      });
+      if (item) return { item, sourceBlock };
+    }
+    return undefined;
+  }
+  
+  /**
+   * Builds one strategy-KPI metric tile, preserving OCR/query values when present.
+   * @param data - Custom canvas renderer data.
+   * @param label - Display label.
+   * @param pattern - Title or item matcher.
+   * @param fallbackValue - Screenshot-preview fallback value.
+   * @param fallbackDetail - Screenshot-preview fallback detail.
+   * @param tone - Visual tone.
+   * @returns Metric row.
+   */
+  function referenceStrategyKpiMetricItem(
+    data: CustomCanvasData,
+    label: string,
+    pattern: RegExp,
+    fallbackValue: string,
+    fallbackDetail: string,
+    tone: NestedBlockTone,
+  ): Record<string, unknown> {
+    const match = referenceStrategyNestedMetricMatch(data, pattern);
+    const item = match?.item ?? referenceNestedMetricItem(data, pattern);
+    const sourceBlock = match?.sourceBlock ?? (item ? undefined : referenceNestedBlock(data, pattern));
+    const element = referenceCustomCanvasElementRows(data, pattern)[0];
+    const blockValue = sourceBlock ? nestedBlockMetricValue(sourceBlock) : '';
+    const elementValue = element ? nestedBlockItemValue(element) : '';
+    const value = item ? nestedBlockItemValue(item) : blockValue && !/^0(?:\.0)?%?$/.test(blockValue) ? blockValue : elementValue;
+    const detail = item ? nestedBlockItemDetail(item) : sourceBlock ? nestedBlockDataSummary(sourceBlock) : '';
+    return {
+      label,
+      value: value || fallbackValue,
+      detail: detail || fallbackDetail,
+      tone,
+      ...(sourceBlock ? { nestedBlock: sourceBlock } : {}),
+    };
+  }
+  
+  /**
+   * Builds the SVG line path for the leading strategy revenue tile.
+   * @param data - Custom canvas renderer data.
+   * @returns SVG path data string.
+   */
+  function referenceStrategyKpiTrendPath(data: CustomCanvasData): string {
+    const trendBlock = referenceNestedBlock(data, /趋势|走势|营收|收入|trend|revenue/i);
+    const items = trendBlock ? nestedBlockRawItems(trendBlock) : [];
+    const values = items
+      .map((item: Record<string, unknown>) => nestedBlockOptionalNumber(nestedBlockItemValue(item) || item.value || item.amount))
+      .filter((value: number | undefined): value is number => value !== undefined)
+      .slice(0, 7);
+    const series = values.length >= 4 ? values : [18, 25, 22, 36, 33, 45, 41, 54, 49];
+    const max = Math.max(...series, 1);
+    const min = Math.min(...series);
+    const spread = Math.max(1, max - min);
+    return series.map((value: number, index: number) => {
+      const x = 8 + (index / Math.max(1, series.length - 1)) * 184;
+      const y = 68 - ((value - min) / spread) * 48;
+      return `${index === 0 ? 'M' : 'L'}${Math.round(x)},${Math.round(y)}`;
+    }).join(' ');
+  }
+  
+  /**
+   * Returns bottom risk summary rows for the strategy-KPI board.
+   * @param data - Custom canvas renderer data.
+   * @returns Risk rows used by the bottom warning strip.
+   */
+  function referenceStrategyKpiRiskItems(data: CustomCanvasData): Array<Record<string, unknown>> {
+    const nestedBlocks = Array.isArray(data.nestedBlocks) ? data.nestedBlocks : [];
+    const rows = nestedBlocks.flatMap((block) => {
+      const text = [block.title, nestedBlockDataSummary(block)].join(' ');
+      if (!referenceStrategyKpiRiskBlockLooksUsable(block)) return [];
+      const rawItems = nestedBlockRawItems(block);
+      if (rawItems.length > 0 && !nestedBlockItemsLookTooWeakForVisualKind(rawItems, 'simpleList')) {
+        return rawItems.map((item: Record<string, unknown>, index: number) => {
+          const displayText = referenceStrategyKpiRiskDisplayText({
+            label: nestedBlockItemLabel(item, index),
+            detail: nestedBlockItemDetail(item),
+            value: nestedBlockItemValue(item),
+            description: item.description,
+            owner: item.owner,
+            subtitle: item.subtitle,
+            status: item.status,
+            amount: item.amount,
+            ratio: item.ratio,
+            progress: item.progress,
+            cells: item.cells,
+            needsHumanIntervention: nestedBlockNeedsHumanIntervention(block),
+          });
+          return { ...referenceStrategyKpiRiskDisplayItem(item, displayText), nestedBlock: block };
+        });
+      }
+      const displayText = referenceStrategyKpiRiskDisplayText({
+        label: block.title,
+        detail: nestedBlockDataSummary(block),
+        value: nestedBlockMetricValue(block),
+        needsHumanIntervention: nestedBlockNeedsHumanIntervention(block),
+      });
+      return [{ label: block.title, ...displayText, tone: nestedBlockToneFromStatus(text), nestedBlock: block }];
+    });
+    const fallbackRows = [
+      { label: '现金流', detail: '经营性现金流净额为负', tone: 'critical' },
+      { label: '逾期账款', detail: '大客户回款延期 11 天', tone: 'warning' },
+      { label: '库存', detail: '华东仓周转天数高于阈值', tone: 'warning' },
+      { label: '投诉率', detail: '核心区域投诉率连续上升', tone: 'warning' },
+    ];
+    return (rows.length > 0 ? rows : fallbackRows).slice(0, 4);
+  }
+
+  /**
+   * Checks whether a nested card should render in the strategy-KPI bottom warning strip.
+   * @param block - Candidate nested child card.
+   * @returns True for explicit risk cards, not ordinary KPI metrics that merely mention cash flow.
+   */
+  function referenceStrategyKpiRiskBlockLooksUsable(block: CustomCanvasNestedBlock): boolean {
+    const data = block.data && typeof block.data === 'object' ? block.data as Record<string, unknown> : {};
+    const binding = block.dataBinding && typeof block.dataBinding === 'object' ? block.dataBinding as Record<string, unknown> : {};
+    const intervention = data.humanIntervention && typeof data.humanIntervention === 'object'
+      ? data.humanIntervention as Record<string, unknown>
+      : binding.humanIntervention && typeof binding.humanIntervention === 'object'
+        ? binding.humanIntervention as Record<string, unknown>
+        : {};
+    const text = [block.title, data.title, data.label, data.queryIntent, nestedBlockDataSummary(block)].join(' ');
+    if (intervention.reason === 'image_compose_backfill_deferred' && /现金流|逾期|库存|投诉|cash\s*flow|overdue|inventory|complaint/i.test(text)) return true;
+    if (/预警|风险|warning|risk/i.test(text)) return true;
+    return /逾期账款|逾期|库存|投诉率|投诉|overdue|inventory|complaint/i.test(text);
+  }
+
+  /**
+   * Returns the risk-strip count label for the strategy-KPI board.
+   * @param data - Custom canvas renderer data.
+   * @returns Count label based on recognized risk rows.
+   */
+  function referenceStrategyKpiRiskSummaryLabel(data: CustomCanvasData): string {
+    return `${referenceStrategyKpiRiskItems(data).length} 项预警`;
+  }
+
+  /**
+   * Computes the risk item grid from actual item count.
+   * @param data - Custom canvas renderer data.
+   * @returns CSS grid style that avoids unused risk columns.
+   */
+  function referenceStrategyKpiRiskItemsGridStyle(data: CustomCanvasData): CSSProperties {
+    const columnCount = Math.min(4, Math.max(1, referenceStrategyKpiRiskItems(data).length));
+    return {
+      gridTemplateColumns: `repeat(${columnCount}, minmax(0, 1fr))`,
+    };
+  }
+  
+
+
+  return {
+    referenceExpenseRiskRows,
+    referenceExpenseSummaryItems,
+    referenceDeviationInsightItems,
+    referenceOrganizationRiskMetrics,
+    referenceOrganizationDonutStyle,
+    referenceInvestmentRiskRows,
+    referenceInvestmentSummaryItems,
+    referenceExecutiveTodoItems,
+    referenceExecutiveTodoNormalizeRow,
+    referenceExecutiveTodoPadRows,
+    referenceExecutiveTodoBlockLooksUsable,
+    referenceExecutiveTodoBadge,
+    referenceExecutiveTodoBadgeClasses,
+    referenceExecutiveTodoImpact,
+    referenceExecutiveTodoDeadline,
+    referenceExecutiveTodoProgress,
+    referenceShortcutDrillItems,
+    referenceQuickWorkbenchGroups,
+    referenceQuickWorkbenchGroupItems,
+    referenceCustomCanvasElementRows,
+    referenceQuickWorkbenchUrgentBadge,
+    referenceStrategyKpiMetrics,
+    referenceOperationEfficiencyGroups,
+    referenceOperationEfficiencyPanelStyle,
+    referenceOperationHealthProgressItems,
+    referenceOperationHealthTrendItems,
+    referenceOperationHealthStructureBlock,
+    referenceOperationHealthStructureItems,
+    referenceOperationEfficiencyGroupItems,
+    referenceStrategyKpiMetricItem,
+    referenceStrategyKpiTrendPath,
+    referenceStrategyKpiRiskItems,
+    referenceStrategyKpiRiskSummaryLabel,
+    referenceStrategyKpiRiskItemsGridStyle,
+  };
+}