♻️ 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/ui/builders/core/notebook.py

@@ -78,10 +78,25 @@ class NotebookBuilder(BaseBuilder[NotebookData]):
         self.add_component(Divider(**kwargs))
         return self
 
-    def add_component(self, component: RenderableComponent) -> "NotebookBuilder":
-        """向 Notebook 中添加一个可渲染的自定义组件。"""
+    def add_component(
+        self, component: "RenderableComponent | BaseBuilder"
+    ) -> "NotebookBuilder":
+        """
+        向 Notebook 中添加一个可渲染的自定义组件。
+
+        """
+        component_data = (
+            component.data if isinstance(component, BaseBuilder) else component
+        )
+
+        if not isinstance(component_data, RenderableComponent):
+            raise TypeError(
+                f"add_component 只能接受 RenderableComponent 或其 Builder，"
+                f"但收到了 {type(component)}"
+            )
+
         self._elements.append(
-            NotebookElement(type="component", component_data=component)
+            NotebookElement(type="component", component=component_data)
         )
         return self
 
@@ -97,11 +112,9 @@ class NotebookBuilder(BaseBuilder[NotebookData]):
             self.quote(quote)
         return self
 
-    async def build(
-        self, use_cache: bool = False, frameless: bool = False, **render_options
-    ) -> bytes:
-        """构建Notebook图片"""
+    def build(self) -> NotebookData:
+        """
+        构建并返回 NotebookData 模型实例。
+        """
         self._data.elements = self._elements
-        return await super().build(
-            use_cache=use_cache, frameless=frameless, **render_options
-        )
+        return super().build()