mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2026-10-19 11:10:10 +08:00
♻️ 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模块
This commit is contained in:
@@ -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",
|
||||
]
|
||||
@@ -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"
|
||||
@@ -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"
|
||||
@@ -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"
|
||||
Reference in New Issue
Block a user