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

* ♻️ 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>

zhenxun/builtin_plugins/superuser/reload_setting.py

@@ -8,7 +8,6 @@ from nonebot_plugin_session import EventSession
 from zhenxun.configs.config import Config
 from zhenxun.configs.utils import PluginExtraData, RegisterConfig
 from zhenxun.services.log import logger
-from zhenxun.services.renderer import renderer_service
 from zhenxun.utils.enum import PluginType
 from zhenxun.utils.message import MessageUtils
 
@@ -56,9 +55,6 @@ _matcher = on_alconna(
 async def _(session: EventSession, arparma: Arparma):
     Config.reload()
     logger.debug("自动重载配置文件", arparma.header_result, session=session)
-
-    await renderer_service.reload_theme()
-
     await MessageUtils.build_message("重载完成!").send(reply_to=True)
 
 

zhenxun/builtin_plugins/superuser/ui_manager.py

@@ -0,0 +1,62 @@
+from nonebot.permission import SUPERUSER
+from nonebot.plugin import PluginMetadata
+from nonebot.rule import to_me
+from nonebot_plugin_alconna import Alconna, Arparma, on_alconna
+
+from zhenxun.configs.utils import PluginExtraData, RegisterConfig
+from zhenxun.services import renderer_service
+from zhenxun.services.log import logger
+from zhenxun.utils.enum import PluginType
+from zhenxun.utils.message import MessageUtils
+
+__plugin_meta__ = PluginMetadata(
+    name="UI管理",
+    description="管理UI、主题和渲染服务的相关配置",
+    usage="""
+    指令：
+        重载UI主题
+    """.strip(),
+    extra=PluginExtraData(
+        author="HibiKier",
+        version="0.1",
+        plugin_type=PluginType.SUPERUSER,
+        configs=[
+            RegisterConfig(
+                module="UI",
+                key="THEME",
+                value="default",
+                help="设置渲染服务使用的全局主题名称(对应 resources/themes/下的目录名)",
+                default_value="default",
+                type=str,
+            ),
+            RegisterConfig(
+                module="UI",
+                key="CACHE",
+                value=True,
+                help="是否为渲染服务生成的图片启用文件缓存",
+                default_value=True,
+                type=bool,
+            ),
+        ],
+    ).to_dict(),
+)
+
+
+_matcher = on_alconna(
+    Alconna("重载主题"),
+    rule=to_me(),
+    permission=SUPERUSER,
+    priority=1,
+    block=True,
+)
+
+
+@_matcher.handle()
+async def _(arparma: Arparma):
+    theme_name = await renderer_service.reload_theme()
+    logger.info(
+        f"UI主题已重载为: {theme_name}", "UI管理器", session=arparma.header_result
+    )
+    await MessageUtils.build_message(f"UI主题已成功重载为 '{theme_name}'！").send(
+        reply_to=True
+    )