♻️ refactor: 统一图片渲染架构并引入通用UI组件系统 (#2019)

* ♻️ refactor: 统一图片渲染架构并引入通用UI组件系统

🎨 **渲染服务重构**
- 统一图片渲染入口，引入主题系统支持
- 优化Jinja2环境管理，支持主题覆盖和插件命名空间
- 新增UI缓存机制和主题重载功能

✨ **通用UI组件系统**
- 新增 zhenxun.ui 模块，提供数据模型和构建器
- 引入BaseBuilder基类，支持链式调用
- 新增多种UI构建器：InfoCard, Markdown, Table, Chart, Layout等
- 新增通用组件：Divider, Badge, ProgressBar, UserInfoBlock

🔄 **插件迁移**
- 迁移9个内置插件至新渲染系统
- 移除各插件中分散的图片生成工具
- 优化数据处理和渲染逻辑

💥 **Breaking Changes**
- 移除旧的图片渲染接口和模板路径
- TEMPLATE_PATH 更名为 THEMES_PATH
- 插件需适配新的RendererService和zhenxun.ui模块

* ✅ test(check): 更新自检插件测试中的渲染服务模拟

* ♻️ refactor(renderer): 将缓存文件名哈希算法切换到 SHA256

* ♻️ refactor(shop): 移除商店HTML图片生成模块

* 🚨 auto fix by pre-commit hooks

---------

Co-authored-by: webjoin111 <455457521@qq.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

zhenxun/ui/models/core/__init__.py

@@ -0,0 +1,47 @@
+"""
+核心模型模块
+包含基础的数据模型类
+"""
+
+from .base import RenderableComponent
+from .layout import LayoutData, LayoutItem
+from .markdown import (
+    CodeElement,
+    HeadingElement,
+    ImageElement,
+    ListElement,
+    ListItemElement,
+    MarkdownData,
+    MarkdownElement,
+    QuoteElement,
+    RawHtmlElement,
+    TableElement,
+    TextElement,
+)
+from .notebook import NotebookData, NotebookElement
+from .table import BaseCell, ImageCell, StatusBadgeCell, TableCell, TableData, TextCell
+
+__all__ = [
+    "BaseCell",
+    "CodeElement",
+    "HeadingElement",
+    "ImageCell",
+    "ImageElement",
+    "LayoutData",
+    "LayoutItem",
+    "ListElement",
+    "ListItemElement",
+    "MarkdownData",
+    "MarkdownElement",
+    "NotebookData",
+    "NotebookElement",
+    "QuoteElement",
+    "RawHtmlElement",
+    "RenderableComponent",
+    "StatusBadgeCell",
+    "TableCell",
+    "TableData",
+    "TableElement",
+    "TextCell",
+    "TextElement",
+]

zhenxun/ui/models/core/base.py

@@ -0,0 +1,20 @@
+"""
+核心基础模型定义
+用于存放 RenderableComponent 基类
+"""
+
+from abc import ABC, abstractmethod
+
+from pydantic import BaseModel
+
+__all__ = ["RenderableComponent"]
+
+
+class RenderableComponent(BaseModel, ABC):
+    """所有可渲染UI组件的抽象基类。"""
+
+    @property
+    @abstractmethod
+    def template_name(self) -> str:
+        """返回用于渲染此组件的Jinja2模板的路径。"""
+        pass

zhenxun/ui/models/core/layout.py

@@ -0,0 +1,24 @@
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+__all__ = ["LayoutData", "LayoutItem"]
+
+
+class LayoutItem(BaseModel):
+    """布局中的单个项目，通常是一张图片"""
+
+    src: str = Field(..., description="图片的Base64数据URI")
+    metadata: dict[str, Any] | None = Field(None, description="传递给模板的额外元数据")
+
+
+class LayoutData(BaseModel):
+    """布局构建器的数据模型"""
+
+    style_name: str | None = None
+    items: list[LayoutItem] = Field(
+        default_factory=list, description="要布局的项目列表"
+    )
+    options: dict[str, Any] = Field(
+        default_factory=dict, description="传递给模板的布局选项"
+    )

zhenxun/ui/models/core/markdown.py

@@ -0,0 +1,124 @@
+from abc import ABC, abstractmethod
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+__all__ = [
+    "CodeElement",
+    "HeadingElement",
+    "ImageElement",
+    "ListElement",
+    "ListItemElement",
+    "MarkdownData",
+    "MarkdownElement",
+    "QuoteElement",
+    "RawHtmlElement",
+    "TableElement",
+    "TextElement",
+]
+
+
+class MarkdownElement(BaseModel, ABC):
+    @abstractmethod
+    def to_markdown(self) -> str:
+        """Serializes the element to its Markdown string representation."""
+        pass
+
+
+class TextElement(MarkdownElement):
+    text: str
+
+    def to_markdown(self) -> str:
+        return self.text
+
+
+class HeadingElement(MarkdownElement):
+    text: str
+    level: int = Field(..., ge=1, le=6)
+
+    def to_markdown(self) -> str:
+        return f"{'#' * self.level} {self.text}"
+
+
+class ImageElement(MarkdownElement):
+    src: str
+    alt: str = "image"
+
+    def to_markdown(self) -> str:
+        return f"![{self.alt}]({self.src})"
+
+
+class CodeElement(MarkdownElement):
+    code: str
+    language: str = ""
+
+    def to_markdown(self) -> str:
+        return f"```{self.language}\n{self.code}\n```"
+
+
+class RawHtmlElement(MarkdownElement):
+    html: str
+
+    def to_markdown(self) -> str:
+        return self.html
+
+
+class TableElement(MarkdownElement):
+    headers: list[str]
+    rows: list[list[str]]
+    alignments: list[Literal["left", "center", "right"]] | None = None
+
+    def to_markdown(self) -> str:
+        header_row = "| " + " | ".join(self.headers) + " |"
+
+        if self.alignments:
+            align_map = {"left": ":---", "center": ":---:", "right": "---:"}
+            separator_row = (
+                "| "
+                + " | ".join([align_map.get(a, "---") for a in self.alignments])
+                + " |"
+            )
+        else:
+            separator_row = "| " + " | ".join(["---"] * len(self.headers)) + " |"
+
+        data_rows = "\n".join(
+            "| " + " | ".join(map(str, row)) + " |" for row in self.rows
+        )
+        return f"{header_row}\n{separator_row}\n{data_rows}"
+
+
+class ContainerElement(MarkdownElement):
+    content: list[MarkdownElement] = Field(default_factory=list)
+
+
+class QuoteElement(ContainerElement):
+    def to_markdown(self) -> str:
+        inner_md = "\n".join(part.to_markdown() for part in self.content)
+        return "\n".join([f"> {line}" for line in inner_md.split("\n")])
+
+
+class ListItemElement(ContainerElement):
+    def to_markdown(self) -> str:
+        return "\n".join(part.to_markdown() for part in self.content)
+
+
+class ListElement(ContainerElement):
+    ordered: bool = False
+
+    def to_markdown(self) -> str:
+        lines = []
+        for i, item in enumerate(self.content):
+            if isinstance(item, ListItemElement):
+                prefix = f"{i + 1}." if self.ordered else "*"
+                item_content = item.to_markdown()
+                lines.append(f"{prefix} {item_content}")
+        return "\n".join(lines)
+
+
+class MarkdownData(BaseModel):
+    """Markdown转图片的数据模型"""
+
+    style_name: str | None = None
+    markdown: str
+    width: int = 800
+    css_path: str | None = None

zhenxun/ui/models/core/notebook.py

@@ -0,0 +1,38 @@
+from typing import Literal
+
+from pydantic import BaseModel
+
+from .base import RenderableComponent
+
+__all__ = ["NotebookData", "NotebookElement"]
+
+
+class NotebookElement(BaseModel):
+    """一个 Notebook 页面中的单个元素"""
+
+    type: Literal[
+        "heading",
+        "paragraph",
+        "image",
+        "blockquote",
+        "code",
+        "list",
+        "divider",
+        "component",
+    ]
+    text: str | None = None
+    level: int | None = None
+    src: str | None = None
+    caption: str | None = None
+    code: str | None = None
+    language: str | None = None
+    data: list[str] | None = None
+    ordered: bool | None = None
+    component_data: RenderableComponent | None = None
+
+
+class NotebookData(BaseModel):
+    """Notebook转图片的数据模型"""
+
+    style_name: str | None = None
+    elements: list[NotebookElement]

zhenxun/ui/models/core/table.py

@@ -0,0 +1,59 @@
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+__all__ = [
+    "BaseCell",
+    "ImageCell",
+    "StatusBadgeCell",
+    "TableCell",
+    "TableData",
+    "TextCell",
+]
+
+
+class BaseCell(BaseModel):
+    """单元格基础模型"""
+
+    type: str
+
+
+class TextCell(BaseCell):
+    """文本单元格"""
+
+    type: Literal["text"] = "text"  # type: ignore
+    content: str
+    bold: bool = False
+    color: str | None = None
+
+
+class ImageCell(BaseCell):
+    """图片单元格"""
+
+    type: Literal["image"] = "image"  # type: ignore
+    src: str
+    width: int = 40
+    height: int = 40
+    shape: Literal["square", "circle"] = "square"
+    alt: str = "image"
+
+
+class StatusBadgeCell(BaseCell):
+    """状态徽章单元格"""
+
+    type: Literal["badge"] = "badge"  # type: ignore
+    text: str
+    status_type: Literal["ok", "error", "warning", "info"] = "info"
+
+
+TableCell = TextCell | ImageCell | StatusBadgeCell | str | int | float | None
+
+
+class TableData(BaseModel):
+    """通用表格的数据模型"""
+
+    style_name: str | None = None
+    title: str = Field(..., description="表格主标题")
+    tip: str | None = Field(None, description="表格下方的提示信息")
+    headers: list[str] = Field(default_factory=list, description="表头列表")
+    rows: list[list[TableCell]] = Field(default_factory=list, description="数据行列表")