mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2026-09-29 00:32:06 +08:00
0f91ce03e4
* ♻️ refactor(plugin_switch): 重构功能开关与帮助系统并优化 UI 报表渲染 - 引入策略模式 (Strategy Pattern) 统一插件与被动任务的开关逻辑 - 新增超级用户强制管控功能，支持系统级禁用且群管无法自行开启 - 新增全服群组活跃状态报表与功能全局覆盖率可视化统计图表 - 优化指令解析系统，支持多功能批量开关及更智能的快捷词映射 - 重构帮助系统，支持在帮助页区分展示管理员与超级用户指令 - 细化插件列表状态显示，区分群控、系统管控与全局禁用状态 - UI 组件 UserInfoBlock 新增 extra 扩展插槽支持 - 更新 resources.spec 资源版本要求至 1.1.1 * 🚨 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>
107 lines
3.7 KiB
Python
107 lines
3.7 KiB
Python
from typing import Literal
|
|
|
|
from pydantic import Field
|
|
|
|
from ..core.base import RenderableComponent
|
|
|
|
__all__ = ["Avatar", "AvatarGroup", "Divider", "Rectangle", "UserInfoBlock"]
|
|
|
|
|
|
class Avatar(RenderableComponent):
|
|
"""单个头像组件。"""
|
|
|
|
component_type: Literal["avatar"] = "avatar"
|
|
"""组件类型"""
|
|
src: str = Field(..., description="头像的URL或Base64数据URI")
|
|
"""头像的URL或Base64数据URI"""
|
|
shape: Literal["circle", "square"] = Field("circle", description="头像形状")
|
|
"""头像形状"""
|
|
size: int = Field(50, description="头像尺寸（像素）")
|
|
"""头像尺寸（像素）"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/avatar"
|
|
|
|
|
|
class AvatarGroup(RenderableComponent):
|
|
"""一组堆叠的头像组件。"""
|
|
|
|
component_type: Literal["avatar_group"] = "avatar_group"
|
|
"""组件类型"""
|
|
avatars: list[Avatar] = Field(default_factory=list, description="头像列表")
|
|
"""头像列表"""
|
|
spacing: int = Field(-15, description="头像间的间距（负数表示重叠）")
|
|
"""头像间的间距（负数表示重叠）"""
|
|
max_count: int | None = Field(
|
|
None, description="最多显示的头像数量，超出部分会显示为'+N'"
|
|
)
|
|
"""最多显示的头像数量，超出部分会显示为'+N'"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/avatar"
|
|
|
|
|
|
class Divider(RenderableComponent):
|
|
"""一个简单的分割线组件。"""
|
|
|
|
component_type: Literal["divider"] = "divider"
|
|
"""组件类型"""
|
|
margin: str = Field("2em 0", description="CSS margin属性，控制分割线上下的间距")
|
|
"""CSS margin属性，控制分割线上下的间距"""
|
|
color: str = Field("#f7889c", description="分割线颜色")
|
|
"""分割线颜色"""
|
|
style: Literal["solid", "dashed", "dotted"] = Field("solid", description="线条样式")
|
|
"""线条样式"""
|
|
thickness: str = Field("1px", description="线条粗细")
|
|
"""线条粗细"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/divider"
|
|
|
|
|
|
class Rectangle(RenderableComponent):
|
|
"""一个矩形背景块组件。"""
|
|
|
|
component_type: Literal["rectangle"] = "rectangle"
|
|
"""组件类型"""
|
|
height: str = Field("50px", description="矩形的高度 (CSS value)")
|
|
"""矩形的高度 (CSS value)"""
|
|
background_color: str = Field("#fdf1f5", description="背景颜色")
|
|
"""背景颜色"""
|
|
border: str = Field("1px solid #fce4ec", description="CSS border属性")
|
|
"""CSS border属性"""
|
|
border_radius: str = Field("8px", description="CSS border-radius属性")
|
|
"""CSS border-radius属性"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/rectangle"
|
|
|
|
|
|
class UserInfoBlock(RenderableComponent):
|
|
"""一个带头像、名称和副标题的用户信息块组件。"""
|
|
|
|
component_type: Literal["user_info_block"] = "user_info_block"
|
|
"""组件类型"""
|
|
avatar_url: str = Field(..., description="用户头像的URL")
|
|
"""用户头像的URL"""
|
|
name: str = Field(..., description="用户的名称")
|
|
"""用户的名称"""
|
|
subtitle: str | None = Field(
|
|
default=None, description="显示在名称下方的副标题 (如UID或角色)"
|
|
)
|
|
"""显示在名称下方的副标题 (如UID或角色)"""
|
|
tags: list[str] = Field(default_factory=list, description="附加的标签列表")
|
|
"""附加的标签列表"""
|
|
extra: RenderableComponent | None = Field(
|
|
default=None, description="附加扩展插槽，支持传入任意UI组件(如徽章、按钮)"
|
|
)
|
|
"""附加扩展插槽"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/user_info_block"
|