♻️ 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/presets/__init__.py

@@ -0,0 +1,20 @@
+"""
+预设模型模块
+包含预定义的复合组件数据模型
+"""
+
+from .card import InfoCardData, InfoCardMetadataItem, InfoCardSection
+from .help_page import HelpCategory, HelpItem, PluginHelpPageData
+from .plugin_menu import PluginMenuCategory, PluginMenuData, PluginMenuItem
+
+__all__ = [
+    "HelpCategory",
+    "HelpItem",
+    "InfoCardData",
+    "InfoCardMetadataItem",
+    "InfoCardSection",
+    "PluginHelpPageData",
+    "PluginMenuCategory",
+    "PluginMenuData",
+    "PluginMenuItem",
+]

zhenxun/ui/models/presets/card.py

@@ -0,0 +1,37 @@
+from pydantic import BaseModel, Field
+
+from ..core.base import RenderableComponent
+
+__all__ = [
+    "InfoCardData",
+    "InfoCardMetadataItem",
+    "InfoCardSection",
+]
+
+
+class InfoCardMetadataItem(BaseModel):
+    """信息卡片元数据项"""
+
+    label: str
+    value: str | int
+
+
+class InfoCardSection(BaseModel):
+    """信息卡片内容区块"""
+
+    title: str
+    content: list[str] = Field(..., description="内容段落列表")
+
+
+class InfoCardData(RenderableComponent):
+    """通用信息卡片的数据模型"""
+
+    style_name: str | None = None
+    title: str = Field(..., description="卡片主标题")
+    metadata: list[InfoCardMetadataItem] = Field(default_factory=list)
+    sections: list[InfoCardSection] = Field(default_factory=list)
+
+    @property
+    def template_name(self) -> str:
+        """返回用于渲染此组件的Jinja2模板的路径。"""
+        return "components/presets/info_card/main.html"

zhenxun/ui/models/presets/help_page.py

@@ -0,0 +1,38 @@
+from pydantic import BaseModel
+
+from ..core.base import RenderableComponent
+
+__all__ = [
+    "HelpCategory",
+    "HelpItem",
+    "PluginHelpPageData",
+]
+
+
+class HelpItem(BaseModel):
+    """帮助菜单中的单个功能项"""
+
+    name: str
+    description: str
+    usage: str
+
+
+class HelpCategory(BaseModel):
+    """帮助菜单中的一个功能类别"""
+
+    title: str
+    icon_svg_path: str
+    items: list[HelpItem]
+
+
+class PluginHelpPageData(RenderableComponent):
+    """通用插件帮助页面的数据模型"""
+
+    style_name: str | None = None
+    bot_nickname: str
+    page_title: str
+    categories: list[HelpCategory]
+
+    @property
+    def template_name(self) -> str:
+        return "pages/core/help_page/main.html"

zhenxun/ui/models/presets/plugin_menu.py

@@ -0,0 +1,42 @@
+from pydantic import BaseModel, Field
+
+from ..core.base import RenderableComponent
+
+__all__ = [
+    "PluginMenuCategory",
+    "PluginMenuData",
+    "PluginMenuItem",
+]
+
+
+class PluginMenuItem(BaseModel):
+    """插件菜单中的单个插件项"""
+
+    id: str
+    name: str
+    status: bool
+    has_superuser_help: bool
+    commands: list[str] = Field(default_factory=list)
+
+
+class PluginMenuCategory(BaseModel):
+    """插件菜单中的一个分类"""
+
+    name: str
+    items: list[PluginMenuItem]
+
+
+class PluginMenuData(RenderableComponent):
+    """通用插件帮助菜单的数据模型"""
+
+    style_name: str | None = None
+    bot_name: str
+    bot_avatar_url: str
+    is_detail: bool
+    plugin_count: int
+    active_count: int
+    categories: list[PluginMenuCategory]
+
+    @property
+    def template_name(self) -> str:
+        return "pages/core/plugin_menu/main.html"