diff --git a/ReportEngine/renderers/html_renderer.py b/ReportEngine/renderers/html_renderer.py
index 47225c6..13d126c 100644
--- a/ReportEngine/renderers/html_renderer.py
+++ b/ReportEngine/renderers/html_renderer.py
@@ -90,6 +90,9 @@ class HTMLRenderer:
validator=self.chart_validator,
llm_repair_fns=llm_repair_fns
)
+ # 记录修复失败的图表，避免多次触发LLM循环修复
+ self._chart_failure_notes: Dict[str, str] = {}
+ self._chart_failure_recorded: set[str] = set()
# 统计信息
self.chart_validation_stats = {
@@ -260,6 +263,8 @@ class HTMLRenderer:
'repaired_api': 0,
'failed': 0
}
+ # 每次渲染重新统计失败计数，但保留失败原因，避免重复LLM调用
+ self._chart_failure_recorded = set()
metadata = self.metadata
theme_tokens = metadata.get("themeTokens") or self.document.get("themeTokens", {})
@@ -1441,6 +1446,82 @@ class HTMLRenderer:
return True
+ def _chart_cache_key(self, block: Dict[str, Any]) -> str:
+ """使用修复器的缓存算法生成稳定的key，便于跨阶段共享结果"""
+ if hasattr(self, "chart_repairer") and block:
+ try:
+ return self.chart_repairer.build_cache_key(block)
+ except Exception:
+ pass
+ return str(id(block))
+
+ def _note_chart_failure(self, cache_key: str, reason: str) -> None:
+ """记录修复失败原因，后续渲染直接使用占位提示"""
+ if not cache_key:
+ return
+ if not reason:
+ reason = "LLM返回的图表信息格式有误，无法正常显示"
+ self._chart_failure_notes[cache_key] = reason
+
+ def _record_chart_failure_stat(self, cache_key: str | None = None) -> None:
+ """确保失败计数只统计一次"""
+ if cache_key and cache_key in self._chart_failure_recorded:
+ return
+ self.chart_validation_stats['failed'] += 1
+ if cache_key:
+ self._chart_failure_recorded.add(cache_key)
+
+ def _format_chart_error_reason(
+ self,
+ validation_result: ValidationResult | None = None,
+ fallback_reason: str | None = None
+ ) -> str:
+ """拼接友好的失败提示"""
+ base = "LLM返回的图表信息格式有误，已尝试本地与多模型修复但仍无法正常显示。"
+ detail = None
+ if validation_result:
+ if validation_result.errors:
+ detail = validation_result.errors[0]
+ elif validation_result.warnings:
+ detail = validation_result.warnings[0]
+ if not detail and fallback_reason:
+ detail = fallback_reason
+ if detail:
+ text = f"{base} 提示：{detail}"
+ return text[:180] + ("..." if len(text) > 180 else "")
+ return base
+
+ def _render_chart_error_placeholder(
+ self,
+ title: str | None,
+ reason: str,
+ widget_id: str | None = None
+ ) -> str:
+ """输出图表失败时的简洁占位提示，避免破坏HTML/PDF布局"""
+ safe_title = self._escape_html(title or "图表未能展示")
+ safe_reason = self._escape_html(reason)
+ widget_attr = f' data-widget-id="{self._escape_attr(widget_id)}"' if widget_id else ""
+ return f"""
+
+
+
!
+
+
{safe_title}
+
{safe_reason}
+
+
+