♻️ refactor(UI): 重构UI渲染服务为组件化分层架构 (#2025)
检查bot是否运行正常 / bot check (push) Waiting to run
Sequential Lint and Type Check / ruff-call (push) Waiting to run
Sequential Lint and Type Check / pyright-call (push) Blocked by required conditions
Release Drafter / Update Release Draft (push) Waiting to run
Force Sync to Aliyun / sync (push) Waiting to run
Update Version / update-version (push) Waiting to run
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, javascript-typescript) (push) Has been cancelled
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, python) (push) Has been cancelled

* ♻️ refactor(UI): 重构UI渲染服务为组件化分层架构

♻️ **架构重构**
- UI渲染服务重构为组件化分层架构
- 解耦主题管理、HTML生成、截图功能

✨ **新增功能**
- `zhenxun.ui` 统一入口,提供 `render`、`markdown`、`vstack` 等API
- `RenderableComponent` 基类和渲染协议抽象
- 新增主题管理器和截图引擎模块

⚙️ **配置优化**
- UI配置迁移至 `superuser/ui_manager.py`
- 新增"重载UI主题"管理指令

🔧 **性能改进**
- 优化渲染缓存,支持组件级透明缓存
- 所有UI组件适配新渲染流程

* 🚨 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>
This commit is contained in:
Rumio
2025-08-18 23:08:22 +08:00
committed by GitHub
co-authored by webjoin111 pre-commit-ci[bot]
parent 11524bcb04
commit 6124e217d0
43 changed files with 1334 additions and 928 deletions
+16 -15
View File
@@ -2,8 +2,8 @@ import os
from pathlib import Path
import random
from zhenxun.services import renderer_service
from zhenxun.utils._build_image import BuildImage
from zhenxun import ui
from zhenxun.ui.models import BarChartData
from .models import Barh
@@ -14,18 +14,19 @@ BACKGROUND_PATH = (
class ChartUtils:
@classmethod
async def barh(cls, data: Barh) -> BuildImage:
async def barh(cls, data: Barh) -> bytes:
"""横向统计图"""
background_image_name = random.choice(os.listdir(BACKGROUND_PATH))
render_data = {
"title": data.title,
"category_data": data.category_data,
"data": data.data,
"background_image": background_image_name,
"direction": "horizontal",
}
image_bytes = await renderer_service.render(
"components/charts/bar_chart", data=render_data
background_image_name = (
random.choice(os.listdir(BACKGROUND_PATH))
if BACKGROUND_PATH.exists()
else None
)
return BuildImage.open(image_bytes)
chart_component = BarChartData(
title=data.title,
category_data=data.category_data,
data=data.data,
background_image=background_image_name,
direction="horizontal",
)
return await ui.render(chart_component)
+5 -3
View File
@@ -6,12 +6,12 @@ import aiofiles
import nonebot
from pydantic import BaseModel
from zhenxun import ui
from zhenxun.configs.config import BotConfig, Config
from zhenxun.configs.path_config import DATA_PATH
from zhenxun.configs.utils.models import PluginExtraData
from zhenxun.models.statistics import Statistics
from zhenxun.models.user_console import UserConsole
from zhenxun.services import renderer_service
from zhenxun.services.log import logger
from zhenxun.utils.platform import PlatformUtils
from zhenxun.utils.pydantic_compat import model_dump
@@ -161,8 +161,10 @@ class BotProfileManager:
"tags": tags,
"title": f"{BotConfig.self_nickname}简介",
}
return await renderer_service.render(
"pages/builtin/bot_profile", data=profile_data
return await ui.render_template(
"pages/builtin/bot_profile",
data=profile_data,
use_cache=True,
)