文档系统发布 v1.1
2026.9.10 v1.0基本功能完成（用户系统，内容发布功能）
2026.9.14 v1.1功能完成测试（包含独立消息系统，订单管理、系统配置等功能）
参考了国内主流控件及Ant Design UI，该控件库目前是最丰富的控件库之一（WinForm UI），支持按需定制。
文档管理系统 开发文档
集成目标：将文档系统作为独立模块集成到 网站后台管理系统（.NET 8 / ASP.NET Core MVC / Layui / SQLite）
版本：V1.0（2026-09-09） 技术栈：C# / .NET 8 / EntityFrameworkCore.Sqlite / Markdig / Vditor / Layui
- 项目概述
在现有 后台管理系统 中新增「文档系统」模块：
| 端 | 说明 |
|---|---|
| 后台 | 新增一级菜单「文档系统」，子菜单「用户管理」「内容发布」，沿用现有 Layui 布局与管理员认证 |
| 前台 | 独立入口/docs/*，布局参考 VitePress（上-导航菜单、左-内容导航、右-内容、下-版权） |
| 数据 | 独立 SQLite 数据库，与博客主库 完全隔离，主库只新增菜单与权限记录 |
| 收费 | 按年会员制（免费会员 / 文档会员 / VIP 会员），文档本身不设单价，只设置「所需阅读身份」 |
2. 需求说明
2.1 会员体系（三档 · 按年收费）
| 档位 | 等级值 | 年费 | 核心权益 |
|---|---|---|---|
| 免费会员 | 1 | ¥0（终身） | 注册登录后浏览「免费会员级」文档 |
| 文档会员 | 2 | ¥299 / 年 | 全年浏览所有文档（含文档会员级） |
| VIP 会员 | 3 | ¥1299 / 年 | 含文档会员全部权益 + 专属服务（人工服务，后台配置文案） |
等级由管理员在后台为每个用户指定并设置有效日期；到期自动降级为免费会员。 具体档位与价格在
DocMemberLevels表中配置，不硬编码。
2.2 阅读权限
文档控制身份：每篇文档设置
RequiredLevel（所需最低阅读身份），不设置单价。0公开：游客可看，无需登录1免费会员：需登录2文档会员：需开通文档会员3VIP：需开通 VIP判断规则：
当前用户等级 >= 文档 RequiredLevel即可阅读；等级不够时按文档提示「登录 / 开通会员」。
2.3 支付方式（无支付接口）
- 用户在前台选择档位 → 系统生成「开通/续费申请」订单（待确认）。
- 页面展示后台配置的微信 / 支付宝收款二维码，提示用户转账时备注自己的账号名。
- 用户付款后，管理员在后台核对转账记录 → 确认订单 → 系统自动将用户等级与有效日期更新（新开：即日起 +1 年；续费：在原到期日上叠加 1 年）。
- 全程无需对接任何支付接口。
控件列表（以最新更新为准）临时归类 不一定准确
布局与容器
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| PanelEx | 增强面板控件 | 支持圆角、光晕阴影、箭头指向、内部拖放、鼠标悬停效果、双重边距控制、主题适配 |
| CourseSchedule | 课程表/培训表控件 | 支持自定义标题、网格线、星期显示（中/英文）、时间段控制、课程数据绑定、主题适配 |
| StartScreen | 开始屏幕控件 | 支持分组管理、拖拽排序、悬停效果、滚动条、SVG图标、分组名称编辑、状态持久化 |
| LayoutEx | 布局控件(Frames) | 支持7种经典布局模式、圆角边框、自定义内边距、Ant Design主题 |
| FlexLayout | Flex弹性布局控件 | 参考Ant Design Flex设计，支持方向、对齐、间距、换行等设置 |
| Masonry | 瀑布流布局控件 | 参考Ant Design Masonry设计，用于展示不同高度的内容，按列均匀分布 |
| SplitterEx | 增强分割容器控件 | 支持折叠/展开、圆角按钮、智能比例保持、双击切换 |
| NavigationMenuEx | 导航菜单控件 | 横向/纵向布局、图标+文字多种组合、子菜单、圆角边框、分割线/间隙、层级颜色、宽度自适应 |
| MenuStripEx | 增强菜单控件 | 多级菜单、图标、快捷键、ToolTip、对齐方式、分割线、主题适配、DesignTime支持 |
| Collapse | 折叠面板控件 | 参考Ant Design Collapse设计，支持面板展开/折叠、手风琴模式、平滑动画、主题支持、FillRemaining铺满剩余空间、文本/控件内容 |
| Table | 表格控件 | 支持多种数据类型（文本、数字、布尔、图片、标签、进度条、链接、图标、图标+文本）、表头固定、复选框选择、斑马纹、排序、列宽调整、主题支持、滚动条悬停显示、自定义滚动条颜色、INotifyPropertyChanged 属性变更通知 |
| TableLayoutPanelEx | 增强表格布局面板 | 支持行列精确控制、单元格合并（RowSpan/ColumnSpan）、表头行/列、控件拉伸与对齐、网格线显示、设计时扩展属性（行号/列号/合并/拉伸/对齐）、表格在控件内9种对齐方式、独立边框与网格线设置 |
加载与反馈
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| SpinEx | 加载动画控件 | 支持多种动画类型、半透明遮罩、SVG图标、点击关闭、Layered Window技术 |
| WaitingBar | 等待进度条控件 | 滑块左右来回移动、平滑缓动动画、圆角样式、多种颜色主题、不阻塞线程 |
| TrackBar | 滑动条控件 | 支持横向/纵向、刻度显示、圆角样式、倒序排列、主题适配 |
基础控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ButtonEx | 按钮控件 | 支持多种形状、颜色类型、SVG图标（Ant Design 功能色） |
| FloatButtonEx | 悬浮按钮控件 | 支持多个按钮排列、SVG图标、徽标、加载状态 |
| LabelEx | 标签控件 | 支持横向/纵向布局、超链接、旋转、跑马灯 |
| LabelText | 标签值控件 | 无缝双部分设计、左侧标签+右侧值、SVG图标、圆角可调 |
| Alert | 警告提示控件 | 参考Ant Design Alert、四种类型(Success/Info/Warning/Error)、可关闭、图标显示、标题描述支持换行 |
| InputBox | 输入框控件 | 支持前缀后缀图标、占位符、清除按钮、边框样式 |
| NumberBox | 数字输入框控件 | 支持增减按钮、精度控制、范围限制 |
| ComboBoxEx | 下拉框控件 | 支持多种样式、圆角边框、自定义颜色 |
| DropdownInput | 下拉输入框控件 | 支持自动完成、搜索筛选、多种匹配模式、主题适配 |
| ButtonSpinner | 按钮旋转选择器控件 | 支持上下按钮切换选项、文本对齐、前缀后缀、水印、禁用状态 |
| ListBoxEx | 增强型列表框控件 | 支持图标、自定义颜色、禁用项、提示文本、滚动条 |
| CheckBoxEx | 复选框控件 | 支持多种样式、自定义颜色、圆角设置、半选状态 |
| CheckBoxGroup | 复选框组控件 | 支持多项选择、全选/半选功能、灵活布局 |
| RadioEx | 单选按钮控件 | 支持多种样式、分组管理、互斥选择 |
| RadioGroup | 单选框组控件 | 批量管理单选框、横向/纵向布局、快速取值、选项数据绑定、设计时设置默认值、顺序稳定 |
| SwitchEx | 开关控件 | 支持多种样式、形状、颜色自定义 |
| ThemeToggleButton | 主题切换按钮 | 支持亮/暗主题切换、Ant Design 功能色主题类型(Primary/Success/Warning/Error/Info)、滑块颜色自定义、属性变更通知 |
| RichtextboxEx | 增强型富文本框控件 | 支持行号、圆角边框、徽标显示 |
| DateTimePicker | 日期时间选择器控件 | 支持年份/月份/日期/时间四种模式、主题色、文本框绑定 |
| TaskDialog | 任务对话框控件 | 现代化对话框、图标支持、圆角边框、遮罩层、主题适配、可拖动 |
| InputDialog | 输入对话框控件 | 文本/密码/数字/单选/多选/颜色输入、使用InputBox/RadioEx/CheckBoxEx/ColorPicker控件、水印提示、遮罩层、主题适配、自定义主题色 |
| Popconfirm | 气泡确认框控件 | 轻量交互、12个弹出方向、箭头指向、SVG图标、异步关闭、透明度设置 |
| PopConfirmShadow | 带阴影气泡确认框控件 | Layered Window技术、真实半透明阴影、阴影包含箭头、4个弹出方向、SVG图标、异步关闭 |
| MessageBoxEx | 消息框控件 | 非模态悬浮消息提示，支持四种类型、七种位置、自动关闭 |
| MessageTip | 迷你消失提示框 | 在触发控件上方弹出，向上移动后淡出消失，支持四种消息类型 |
| MessagePanel | 消息面板控件 | 全部/未读筛选、已读红点标记、删除确认、鼠标滚轮滚动、悬停效果、Tooltip提示、主题适配 |
| TrafficLight | 红绿灯控件 | 支持垂直/水平布局、常亮/闪烁状态、光晕效果、标签显示、主题适配 |
| StatusStrip | 状态栏控件 | 底部停靠、支持9种子控件类型（LabelTimeEx/ProgressBar/ButtonEx/Signal/Battery/TrackBar/WaitingBar/SwitchEx/LabelEx）、Spring布局、设计时拖放限制、建议在PanelItems集合编辑器中调整顺序（不建议拖拽排序）、集合编辑器添加按钮会添加未知类型控件请不要使用 |
窗体与容器
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| UIForm | 自定义窗体基类 | 无边框窗体、自定义标题栏、阴影效果、圆角边框、亮暗主题切换、子控件递归主题传递 |
| UIFormSizable | 可调尺寸窗体基类 | 继承自 UIForm，支持运行时拖拽调整窗体大小，注意：存在圆角边框视觉瑕疵和主题色同步问题 |
| DrawerEx | 抽屉组件 | 四方向滑入面板、窗体/控件级显示、支持任意内容载体、可配置按钮位置、系统级关闭按钮样式、平滑动画、可拖拽调整大小 |
| GroupBox | 分组框控件 | 支持多种标题位置、折叠功能、闪烁提示 |
| ExplorerBar | 资源管理器栏控件 | 支持分组管理、展开/折叠、图标显示 |
| Transfer | 穿梭框控件 | 支持双向数据穿梭、搜索过滤、双击转移 |
| Grid4 | 四宫格控件 | 2x2网格布局，支持图标、文本、徽章 |
| Grid9 | 九宫格控件 | 3x3网格布局，支持图标、文本、徽章 |
| Grid16 | 十六宫格控件 | 4x4网格布局，支持图标、文本、徽章 |
| Grid32 | 三十二宫格控件 | 8×4或4×8网格布局，支持图标、文本、徽章、独立文本颜色、布局切换 |
| GridX | 通用宫格控件 | 支持任意数量宫格（1-100项）、两种布局模式（固定大小留空缺/平均填充）、自动计算行列布局 |
| MetroTilePanel | 磁贴面板容器 | 支持流式布局、自动换行、分组管理 |
| MetroTileItem | 磁贴项控件 | 支持标题、副标题、图标显示 |
| TabWorkspace | 标签工作区控件 | 类似 Edge 浏览器的标签页工作区，支持标签头、工具面板、内容区域 |
| TabHeaderEx | 标签页标题栏控件 | 支持多标签管理、添加/关闭标签、系统按钮、窗体拖动、双击关闭 |
| TabControl | 增强型标签控件 | 支持多标签管理、四种标签位置、分割线显示、激活指示线、滚动支持 |
| TabControlMenu | 菜单式标签控件 | 左侧菜单导航、多页面管理、设计时拖放、自动命名、关联删除 |
| ContextMenuEx | 内容菜单控件 | 智能位置检测、多级菜单、图标、快捷键、分割线、主题适配、圆角、动画 |
| RadialMenu | 径向菜单控件 | 圆形展开菜单、支持 Segment 和 Circular 两种模式、平滑动画、主题适配 |
数据显示控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Tree | 树形控件 | 层级结构展示、展开收起、单选/多选、复选框、SVG图标、连接线 |
| ComboTreeView | 下拉树控件 | 支持单选/多选模式、级联选择、自定义下拉尺寸 |
| Statistic | 统计数值控件 | 支持前缀/后缀、SVG图标、数值动画、倒计时/正计时、千分位分隔 |
| GaugeControl | 仪表盘控件 | 支持指针指示、刻度显示、数值标签、铭牌 |
| GaugeControl180 | 180度仪表盘控件 | 半圆仪表盘，支持多种样式 |
| CircleGauge | 圆形仪表盘控件 | 支持多种样式、刻度显示、动画效果 |
| SimpleGauge | 简单仪表盘控件 | 简洁的仪表盘显示 |
| CircularProgress | 圆形进度条控件 | 支持多种风格、填充方向、填充样式 |
| PercentageProgress | 百分比进度条控件 | 支持多种风格、填充方向、动画效果 |
| ProgressBar | 进度条控件 | 支持多种样式、状态显示、文本显示 |
| ProgressGear | 齿轮进度指示器控件 | 支持旋转动画、多种齿轮样式 |
| Battery | 电池电量控件 | 支持横向和纵向显示、自动颜色切换 |
| Signal | 信号强度控件 | 支持柱状图和线条两种样式、加载动画 |
| Thermometer | 温度计控件 | 支持刻度显示、动画效果、异常值颜色提示 |
| LCDDisplay | LCD数码管显示控件 | 支持七段显示、多种字符、时间模式 |
| LCDTime | LCD时间显示控件 | 液晶风格日期时间显示 |
| AlarmLight | 报警灯控件 | 支持三色切换、闪烁动画、声音指示 |
| Rate | 评分控件 | 支持半星效果、自定义长度、只读模式、自定义颜色 |
| StatusValueLabel | 状态数值标签控件 | 支持标题数值显示、圆角边框、对齐方式 |
| LabeledValue | 标签值控件 | 支持主副标题显示、预置颜色样式 |
| SideBySideLabel | 并排标签控件 | 支持左右对比显示、斜切柱状图 |
图表控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| PieChart | 饼状图控件 | 支持点击偏移动画、百分比显示、图例显示、主题适配 |
| BarPlot | 柱状图控件 | 参考 ScottPlot 设计、亮暗主题、色彩模式、值标签、对比柱状图、边距控制、主题适配 |
| ScatterPlot | 散点图/折线图控件 | 支持平滑曲线、多种X轴类型、网格线、值提示、图例位置控制、主题适配 |
| LinearGauge | 线性刻度计控件 | 可作为温度计、液位计、刻度进度条、进度仪表使用 |
| Timeline | 时间轴控件 | 支持横向和纵向显示、节点自定义、当前节点高亮 |
导航与分页
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Pagination | 分页器控件 | 支持标准/迷你/简易三种样式、亮暗主题、多种对齐方式、页码跳转 |
导航控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Breadcrumb | 面包屑控件 | 支持多种样式、图标显示、点击事件 |
| Steps | 步骤条控件 | 引导用户按照流程完成任务的导航条，支持水平/垂直方向、自定义状态、点击切换 |
| ImageCarousel | 图片轮播控件 | 支持多种切换效果、自动轮播、指示器自定义 |
| NavigationPad | 导航按钮控件 | 支持上下左右导航、点击事件 |
| NavigationMenuEx | 导航菜单控件 | 支持横向/纵向布局、图标+文字多种组合、子菜单、圆角边框、宽度自适应、主题适配 |
输入控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ColorPicker | 颜色选择器控件 | 支持Hex/RGB显示、预设颜色、饱和度/明度/色相选择、清除/重置功能、主题适配 |
| ColorPalette | 多彩主题选择控件 | 12种Ant Design主色、点击查看10个渐变等级、自动应用主题色、布局自定义 |
| IPInputBox | IP地址输入框控件 | 支持IP地址分段输入、自动跳转 |
| TimeInputBox | 时间输入框控件 | 支持时分秒输入、自动跳转 |
| NumpadTextBox | 数字键盘输入框控件 | 支持数字键盘输入、精度控制 |
| SelectNumber | 数字选择控件 | 支持增减按钮、数值选择 |
| NumPadEx | 数字键盘控件 | 4x4网格布局数字输入面板 |
图表控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| BarPlot | 柱状图控件 | 参考 ScottPlot 设计、亮暗主题、色彩模式、值标签、对比柱状图、边距控制 |
| ScatterPlot | 散点图/折线图控件 | 支持平滑曲线、多种X轴类型、网格线、值提示、图例位置控制 |
音频可视化
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| AudioSpectrumBar | 音频频谱柱状图控件 | 积木块效果、自由落体峰值保持、线程安全、32/64频段、渐变颜色、透明背景 |
| AudioSpectrumBarEx | 音频频谱柱状图(增强版) | 阻尼弹跳效果、可配置物理参数、与基础版API兼容，文档见AudioSpectrumBar.md |
工业控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| SpeedControl | 速度表控件 | 支持指针指示、刻度显示、颜色区域 |
| GearSwitch | 档位选择控件 | 支持多种档位、自动复位 |
| Fan | 风扇控制控件 | 支持旋转动画、速度控制 |
| OilTank | 油罐控件 | 支持液位显示、波浪动画 |
| ConveyorBelt | 传送带控件 | 支持流动动画、速度控制 |
| Pipe | 管道控件 | 支持流动动画、方向控制 |
| PipeValve | 管道阀门控件 | 支持开关状态、旋转动画 |
| Blower | 鼓风机控件 | 支持旋转动画、速度控制 |
| IndustrialButton | 工业按钮控件 | 支持指示灯、颜色自定义 |
| RockerSwitch | 船型开关控件 | 支持开关状态、颜色自定义 |
| KnobSwitch | 旋钮开关控件 | 支持旋转调节、多档位 |
| PowerButton | 电源按钮控件 | 支持发光效果、点击动画 |
| SwitchPanel | 86型开关面板控件 | 支持单开/双开、指示灯 |
按钮控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ShadowButton | 阴影按钮控件 | 支持倒影效果、多种形状 |
| MediaActionButton | 媒体播放器控制按钮 | 支持多种媒体控制图标 |
| ButtonsGroup | 按钮组控件 | 支持单选按钮组、多种排列方式 |
列表控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ImageTextList | 图文列表控件 | 支持图片、标题、副标题显示 |
| InfoVPanel | 竖版信息面板控件 | 适用于加油枪状态显示 |
| InfoHPanel | 横版信息面板控件 | 适用于加油枪状态显示 |
其他控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Preview | 图片预览控件 | 支持滚轮缩放、旋转、翻页、左右导航按钮、遮罩层、静态方法调用 |
| LabelTimeEx | 时间文本控件 | 实时显示当前时间和日期，支持秒显示切换、SVG图标、透明背景、自动尺寸 |
| CalendarEx | 日历控件 | 支持日期选择、农历显示、范围限制 |
| ClockEx | 时钟控件 | 支持模拟时钟显示、日历显示、声音提示 |
| Divider | 分割线控件 | 支持多种方向、线条类型、文本显示 |
| Arrow | 箭头控件 | 单/双向箭头、任意角度旋转、实心/空心样式、自定义尺寸 |
| OrgChart | 组织结构图控件 | 多种布局方向、展开收起、自定义节点样式、丰富连接线样式 |
| Tag | 标签控件 | 支持多种形状、动画效果、文本方向、SVG图标、主题适配 |
| RipplePanel | 涟漪面板控件 | 带点击涟漪动画效果的容器面板，可放置子控件，继承自 Panel |
| Captcha | 验证码控件 | 支持多种复杂度、干扰点、点击刷新 |
| ScratchCode | 刮刮卡/防伪码控件 | 支持鼠标擦除涂层、多种验证码类型、干扰线、擦除进度检测、校验功能 |
| SliderCaptcha | 滑动验证码控件 | 支持三种验证类型（拼图滑块、旋转验证、文字顺序点击）、多种拼图形状、自定义背景图片、右键刷新、主题适配 |
| ImageLockScreen | 手势图案锁屏控件 | 支持九宫格手势密码 |
| Avatar | 头像控件 | 支持圆形/方形形状、渐变发光效果、文本/图片/SVG图标内容、角标Badge显示 |
| Image3D | 3D翻转图片控件 | 支持圆角效果、多种图片显示模式、3D翻转动画（左右/上下翻转）、边框/阴影效果、水印显示、内边距支持 |
| MagicWaterDrop | 魔法水滴控件 | 支持点击涟漪动画效果（覆盖层方式，不建议使用） |
| TooltipEx | 文字提示气泡框控件 | 支持12个位置、颜色主题、箭头显示/隐藏、偏移量 |
| Watermark | 水印控件 | 支持文字/图片/SVG水印、平铺显示、旋转、透明度调节 |
| ScreenCapture | 屏幕截图工具 | 支持区域截图、全屏截图、滚动长图、剪贴板/文件保存 |
部分效果图
