♻️ refactor(ui): 重构 UI 渲染系统并优化资源管理 (#2094)

* ♻️ refactor(ui): 重构 UI 渲染系统并优化资源管理

- 【重构】重构 `RendererService` 架构,解耦模板引擎、主题管理与截图引擎
- 【重构】重构 `ui` 模块,采用组件注册机制与数据模型驱动,移除旧版 `builders`
- 【功能】新增 UI 热重载模式,支持在不重启的情况下实时预览 HTML/CSS 修改
- 【功能】增强启动项资源检查,支持基于 `resources.spec` 的版本校验与自动更新
- 【优化】统一内置插件的 UI 渲染逻辑,迁移至新的 `ui.table`、`ui.markdown` 等工厂接口
- 【优化】优化日志脱敏工具,支持自动折叠调试输出中冗长的样式标签
- 【优化】引入 `AssetResolutionService`,完善皮肤、组件、主题间的多级资源回退机制
- 【优化】新增组件生命周期钩子 `prepare`,支持渲染前的异步数据预处理

* 🚨 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
2026-02-06 20:13:40 +08:00
committed by GitHub
co-authored by webjoin111 pre-commit-ci[bot]
parent bc8e1659ae
commit 5e30694663
77 changed files with 3035 additions and 3258 deletions
+28
View File
@@ -1,3 +1,5 @@
from collections.abc import Callable
import random
import re
from typing import overload
@@ -5,6 +7,7 @@ from nonebot.adapters import Bot
from nonebot_plugin_uninfo import Session, SupportScope, Uninfo, get_interface
from zhenxun.configs.config import BotConfig
from zhenxun.configs.path_config import THEMES_PATH
from zhenxun.models.group_console import GroupConsole
from zhenxun.services.cache.runtime_cache import (
BanMemoryCache,
@@ -95,6 +98,31 @@ class CommonUtils:
elif isinstance(data, list):
return "".join(cls.format(item) for item in data)
@staticmethod
def get_random_asset_factory(sub_path: str) -> Callable[[], str | None]:
"""
创建一个从指定 assets 子目录随机选取资源的工厂函数。
用于 Pydantic 模型的 default_factory。
参数:
sub_path: 相对于 themes/default/assets/ 的子路径,例如 "ui/zhenxun/down"
"""
def _factory() -> str | None:
target_dir = THEMES_PATH / "default" / "assets" / sub_path
if not target_dir.exists():
return None
images = [
f.name
for f in target_dir.iterdir()
if f.is_file()
and f.suffix.lower() in [".png", ".jpg", ".jpeg", ".webp"]
]
return f"{sub_path}/{random.choice(images)}" if images else None
return _factory
class SqlUtils:
@classmethod