新增通用HTML模板渲染器并将机器人菜单改为模板驱动输出

utils/html_template_renderer.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+"""通用 HTML 模板渲染工具。
+
+目标：
+1. 把页面结构/样式从 Python 代码中抽离到 .html 模板文件；
+2. Python 只负责组装数据，模板负责展示；
+3. 后续改 UI 时只改模板文件，不改业务代码。
+"""
+
+from pathlib import Path
+from typing import Any, Dict
+
+from jinja2 import Environment, FileSystemLoader, TemplateNotFound, select_autoescape
+
+
+class HtmlTemplateRenderer:
+    """基于 Jinja2 的 HTML 模板渲染器。"""
+
+    def __init__(self, template_root: Path = None):
+        # 默认以仓库根目录作为模板根路径，确保可通过相对路径定位模板文件。
+        root = template_root or Path(__file__).resolve().parents[1]
+        self.template_root = Path(root).resolve()
+        self.env = Environment(
+            loader=FileSystemLoader(str(self.template_root)),
+            autoescape=select_autoescape(enabled_extensions=("html", "xml")),
+            trim_blocks=True,
+            lstrip_blocks=True,
+        )
+
+    def render(self, template_path: str, context: Dict[str, Any]) -> str:
+        """渲染模板并返回完整 HTML 字符串。"""
+        normalized = str(template_path or "").replace("\\", "/").strip()
+        if not normalized:
+            raise ValueError("template_path 不能为空")
+        try:
+            template = self.env.get_template(normalized)
+        except TemplateNotFound as e:
+            raise FileNotFoundError(
+                f"模板文件不存在: {normalized} (root={self.template_root})"
+            ) from e
+        return template.render(**(context or {}))
+