✨ feat!(ui): 重构图表组件架构，实现数据与样式分离 (#2035)

* ✨ feat!(ui): 重构图表组件架构，实现数据与样式分离

🏗️ **架构重构**
- 移除charts.py中所有硬编码样式参数(grid、tooltip、legend等)
- 将样式配置迁移至主题层style.json文件
- 统一图表模板消费样式文件的能力

📊 **图表组件优化**
- bar_chart: 移除grid和坐标轴show参数
- pie_chart: 移除tooltip、legend样式和series视觉参数
- line_chart: 移除tooltip、grid和坐标轴配置
- radar_chart: 移除tooltip硬编码

🎨 **主题系统增强**
- 新增pie_chart、line_chart、radar_chart的style.json配置
- 更新bar_chart/style.json，添加grid、xAxis、yAxis样式
- 所有图表模板支持deepMerge样式合并逻辑

🔧 **Breaking Changes**
- 图表工厂函数不再接受样式参数
- 主题开发者现可通过style.json完全定制图表外观
- 提升组件可维护性和主题灵活性

* 📦️ build(pyinstaller): 引入 resources.spec 并更新 .gitignore 规则

* 🚨 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/components/__init__.py

@@ -0,0 +1,25 @@
+"""
+小组件构建器模块
+包含各种UI小组件的构建器
+"""
+
+from .alert import AlertBuilder
+from .avatar import AvatarBuilder, AvatarGroupBuilder
+from .badge import BadgeBuilder
+from .divider import DividerBuilder
+from .kpi_card import KpiCardBuilder
+from .progress_bar import ProgressBarBuilder
+from .timeline import TimelineBuilder
+from .user_info_block import UserInfoBlockBuilder
+
+__all__ = [
+    "AlertBuilder",
+    "AvatarBuilder",
+    "AvatarGroupBuilder",
+    "BadgeBuilder",
+    "DividerBuilder",
+    "KpiCardBuilder",
+    "ProgressBarBuilder",
+    "TimelineBuilder",
+    "UserInfoBlockBuilder",
+]

zhenxun/ui/builders/components/alert.py

@@ -0,0 +1,23 @@
+from typing import Literal
+from typing_extensions import Self
+
+from ...models.components.alert import Alert
+from ..base import BaseBuilder
+
+
+class AlertBuilder(BaseBuilder[Alert]):
+    """链式构建提示/标注框组件的辅助类"""
+
+    def __init__(
+        self,
+        title: str,
+        content: str,
+        type: Literal["info", "success", "warning", "error"] = "info",
+    ):
+        data_model = Alert(title=title, content=content, type=type)
+        super().__init__(data_model, template_name="components/widgets/alert")
+
+    def hide_icon(self) -> Self:
+        """隐藏提示框的默认图标"""
+        self._data.show_icon = False
+        return self

zhenxun/ui/builders/components/avatar.py

@@ -0,0 +1,38 @@
+from typing import Literal
+from typing_extensions import Self
+
+from ...models.components.avatar import Avatar, AvatarGroup
+from ..base import BaseBuilder
+
+
+class AvatarBuilder(BaseBuilder[Avatar]):
+    """链式构建单个头像的辅助类"""
+
+    def __init__(self, src: str):
+        data_model = Avatar(src=src, shape="circle", size=50)
+        super().__init__(data_model, template_name="components/widgets/avatar")
+
+    def set_shape(self, shape: Literal["circle", "square"]) -> Self:
+        self._data.shape = shape
+        return self
+
+    def set_size(self, size: int) -> Self:
+        self._data.size = size
+        return self
+
+
+class AvatarGroupBuilder(BaseBuilder[AvatarGroup]):
+    """链式构建头像组的辅助类"""
+
+    def __init__(self):
+        data_model = AvatarGroup(avatars=[], spacing=-15, max_count=None)
+        super().__init__(data_model, template_name="components/widgets/avatar_group")
+
+    def add_avatar(self, avatar: Avatar | AvatarBuilder | str) -> Self:
+        if isinstance(avatar, str):
+            self._data.avatars.append(Avatar(src=avatar, shape="circle", size=50))
+        elif isinstance(avatar, AvatarBuilder):
+            self._data.avatars.append(avatar.build())
+        else:
+            self._data.avatars.append(avatar)
+        return self

zhenxun/ui/builders/components/badge.py

@@ -0,0 +1,25 @@
+from typing import Literal
+
+from ...models.components.badge import Badge
+from ..base import BaseBuilder
+
+
+class BadgeBuilder(BaseBuilder[Badge]):
+    """链式构建徽章组件的辅助类"""
+
+    def __init__(
+        self,
+        text: str,
+        color_scheme: Literal[
+            "primary", "success", "warning", "error", "info"
+        ] = "info",
+    ):
+        data_model = Badge(text=text, color_scheme=color_scheme)
+        super().__init__(data_model, template_name="components/widgets/badge")
+
+    def set_color_scheme(
+        self, color_scheme: Literal["primary", "success", "warning", "error", "info"]
+    ) -> "BadgeBuilder":
+        """设置徽章的颜色方案。"""
+        self._data.color_scheme = color_scheme
+        return self

zhenxun/ui/builders/components/divider.py

@@ -0,0 +1,20 @@
+from typing import Literal
+
+from ...models.components.divider import Divider
+from ..base import BaseBuilder
+
+
+class DividerBuilder(BaseBuilder[Divider]):
+    """链式构建分割线组件的辅助类"""
+
+    def __init__(
+        self,
+        margin: str = "2em 0",
+        color: str = "#f7889c",
+        style: Literal["solid", "dashed", "dotted"] = "solid",
+        thickness: str = "1px",
+    ):
+        data_model = Divider(
+            margin=margin, color=color, style=style, thickness=thickness
+        )
+        super().__init__(data_model, template_name="components/widgets/divider")

zhenxun/ui/builders/components/kpi_card.py

@@ -0,0 +1,31 @@
+from typing import Any, Literal
+from typing_extensions import Self
+
+from ...models.components.kpi_card import KpiCard
+from ..base import BaseBuilder
+
+
+class KpiCardBuilder(BaseBuilder[KpiCard]):
+    """链式构建统计卡片（KPI Card）的辅助类"""
+
+    def __init__(self, label: str, value: Any):
+        data_model = KpiCard(label=label, value=value)
+        super().__init__(data_model, template_name="components/widgets/kpi_card")
+
+    def with_unit(self, unit: str) -> Self:
+        """设置数值的单位"""
+        self._data.unit = unit
+        return self
+
+    def with_change(
+        self, change: str, type: Literal["positive", "negative", "neutral"] = "neutral"
+    ) -> Self:
+        """设置与上一周期的变化率"""
+        self._data.change = change
+        self._data.change_type = type
+        return self
+
+    def with_icon(self, svg_path: str) -> Self:
+        """设置卡片图标 (提供SVG path data)"""
+        self._data.icon_svg = svg_path
+        return self

zhenxun/ui/builders/components/progress_bar.py

@@ -0,0 +1,42 @@
+from typing import Literal
+
+from ...models.components.progress_bar import ProgressBar
+from ..base import BaseBuilder
+
+
+class ProgressBarBuilder(BaseBuilder[ProgressBar]):
+    """链式构建进度条组件的辅助类"""
+
+    def __init__(
+        self,
+        progress: float,
+        label: str | None = None,
+        color_scheme: Literal[
+            "primary", "success", "warning", "error", "info"
+        ] = "primary",
+        animated: bool = False,
+    ):
+        data_model = ProgressBar(
+            progress=progress,
+            label=label,
+            color_scheme=color_scheme,
+            animated=animated,
+        )
+        super().__init__(data_model, template_name="components/widgets/progress_bar")
+
+    def set_label(self, label: str) -> "ProgressBarBuilder":
+        """设置进度条上显示的文本。"""
+        self._data.label = label
+        return self
+
+    def set_color_scheme(
+        self, color_scheme: Literal["primary", "success", "warning", "error", "info"]
+    ) -> "ProgressBarBuilder":
+        """设置进度条的颜色方案。"""
+        self._data.color_scheme = color_scheme
+        return self
+
+    def set_animated(self, animated: bool = True) -> "ProgressBarBuilder":
+        """设置进度条是否显示动画效果。"""
+        self._data.animated = animated
+        return self

zhenxun/ui/builders/components/timeline.py

@@ -0,0 +1,28 @@
+from typing_extensions import Self
+
+from ...models.components.timeline import Timeline, TimelineItem
+from ..base import BaseBuilder
+
+
+class TimelineBuilder(BaseBuilder[Timeline]):
+    """链式构建时间轴组件的辅助类"""
+
+    def __init__(self):
+        data_model = Timeline(items=[])
+        super().__init__(data_model, template_name="components/widgets/timeline")
+
+    def add_item(
+        self,
+        timestamp: str,
+        title: str,
+        content: str,
+        *,
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> Self:
+        """向时间轴中添加一个事件点"""
+        item = TimelineItem(
+            timestamp=timestamp, title=title, content=content, icon=icon, color=color
+        )
+        self._data.items.append(item)
+        return self

zhenxun/ui/builders/components/user_info_block.py

@@ -0,0 +1,33 @@
+from ...models.components.user_info_block import UserInfoBlock
+from ..base import BaseBuilder
+
+
+class UserInfoBlockBuilder(BaseBuilder[UserInfoBlock]):
+    """链式构建用户信息块的辅助类"""
+
+    def __init__(
+        self,
+        name: str,
+        avatar_url: str,
+        subtitle: str | None = None,
+        tags: list[str] | None = None,
+    ):
+        data_model = UserInfoBlock(
+            name=name, avatar_url=avatar_url, subtitle=subtitle, tags=tags or []
+        )
+        super().__init__(data_model, template_name="components/widgets/user_info_block")
+
+    def set_subtitle(self, subtitle: str) -> "UserInfoBlockBuilder":
+        """设置副标题。"""
+        self._data.subtitle = subtitle
+        return self
+
+    def add_tag(self, tag: str) -> "UserInfoBlockBuilder":
+        """添加一个标签。"""
+        self._data.tags.append(tag)
+        return self
+
+    def add_tags(self, tags: list[str]) -> "UserInfoBlockBuilder":
+        """批量添加标签。"""
+        self._data.tags.extend(tags)
+        return self