mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-15 14:22:55 +08:00
689505294c
🎨 **渲染服务重构** - 统一图片渲染入口，引入主题系统支持 - 优化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模块
42 lines
1.3 KiB
Python
42 lines
1.3 KiB
Python
from typing import Generic, TypeVar
|
||
from typing_extensions import Self
|
||
|
||
from pydantic import BaseModel
|
||
|
||
from zhenxun.services import renderer_service
|
||
|
||
T_DataModel = TypeVar("T_DataModel", bound=BaseModel)
|
||
|
||
|
||
class BaseBuilder(Generic[T_DataModel]):
|
||
"""所有UI构建器的基类，提供通用的样式化和构建逻辑。"""
|
||
|
||
def __init__(self, data_model: T_DataModel, template_name: str):
|
||
self._data: T_DataModel = data_model
|
||
self._style_name: str | None = None
|
||
self._template_name = template_name
|
||
|
||
def with_style(self, style_name: str) -> Self:
|
||
"""
|
||
为组件应用一个特定的样式。
|
||
"""
|
||
self._style_name = style_name
|
||
return self
|
||
|
||
async def build(self, use_cache: bool = False, **render_options) -> bytes:
|
||
"""
|
||
通用的构建方法，将数据渲染为图片。
|
||
"""
|
||
if self._style_name and hasattr(self._data, "style_name"):
|
||
setattr(self._data, "style_name", self._style_name)
|
||
|
||
data_to_render = self._data
|
||
|
||
return await renderer_service.render(
|
||
template_name=self._template_name,
|
||
data=data_to_render,
|
||
use_cache=use_cache,
|
||
style_name=self._style_name,
|
||
**render_options,
|
||
)
|