serverRoom/art-design-pro-3.0.1/CHANGELOG.zh-CN.md

更新日志

所有重要的项目变更都将记录在此文件中。

格式基于 Keep a Changelog，版本号遵循 语义化版本。

[已发布]

v3.0.1 - 2025-11-15

修复

• 修复路由注册时不存在接口的重复请求问题
• 修复一键精简脚本打包失败的问题

优化

• 完善路由配置验证机制，自动检测并提示非一级菜单的路径配置错误
• 优化顶部进度条残影问题
• 优化 vite 预构建配置
• 优化圆角、边框统一性
• 重新设计锁屏页面，提升视觉体验
• 优化退出登录菜单提前消失造成的视觉体验不好问题

新增

• ArtForm 和 ArtSearchBar 组件的 label 支持自定义渲染函数，可实现带 tooltip 等复杂标签
• 菜单管理表单关键字段新增 Tooltip 提示，降低用户配置门槛
• iconify 新增离线图标加载模式
• 退出登录新增 redirect 属性，用于重新登录后跳转到对应页面
• 退出登录重新进入系统保留用户标签页，根据 userId 进行身份识别
• 双列菜单新增折叠按钮
• 完善菜单图标
• 多标签页增加图标显示
• 新增 WebSocket 连接示例
• 锁屏密码错误时增加输入框抖动动效

⚠️ 重要提示

此版本需要重新登录

---

v3.0.0 - 2025-11-09 🎉

重构

• 样式系统重构：Sass 全面迁移至 Tailwind CSS，提升开发效率与样式一致性
• 图标方案升级：Iconfont 替换为 Iconify，支持更丰富的图标库与按需加载
• 路由注册重构：全面重构路由注册系统，引入面向对象设计，提高代码的可维护性、可测试性和扩展能力
• 重构 ArtTextScroll 组件，提升性能与可维护性
• 重构颜色体系，统一 UI 视觉规范，提升界面一致性

优化

• 构建优化：完整包体积减少 1.3 MB，显著提升加载性能
• 架构优化：优化目录结构，职责划分更清晰，降低用户学习成本与上手难度
• 注释优化：统一模块注释规范，完善每一个组件介绍、功能说明与使用示例，降低用户理解成本与上手难度
• 性能提升：优化核心代码逻辑，提升系统运行效率
• 菜单优化：细化菜单样式，优化交互体验与视觉呈现
• 响应式优化：优化 ArtForm、ArtSearchBar 栅格布局，适配多种屏幕尺寸
• 配置管理优化：新增 setting.ts 配置文件，支持一键复制与重置系统默认设置

修复

• 修复 ArtForm、ArtSearchBar 自定义组件渲染异常

新增

• ArtForm、ArtSearchBar 新增 render 属性，支持自定义组件渲染
• 节日功能增强：礼花配置支持跨日期范围设置与自定义播放次数

升级

• 依赖更新：升级核心依赖至最新稳定版本

⚠️ 重要提示

本次升级涉及样式系统（Sass → Tailwind CSS）与图标库（Iconfont → Iconify）的底层重构，属于破坏性更新。建议新项目直接使用 v3.0，旧版本项目不建议升级。

---

v2.6.1 - 2025-10-19

修复

• 修复获取用户信息、获取菜单接口访问无效地址重复调用问题
• 修复 ElButton circle 模式样式
• 修复 ElSelect 无法通过键盘选择问题
• 修复带参数静态路由跳转登录页面问题

优化

• 升级部分依赖兼容 tailwindcss
• 优化外部链接菜单点击选中状态
• 授权页增加主题色切换功能

---

v2.6.0 - 2025-10-16

新增

• 扩展注册、密码重置页面顶部组件支持

优化

• 优化精简版本菜单数据结构，提升数据一致性
• 优化本地开发环境网络请求代理配置
• 优化 ElTree 组件默认样式
• 新增 VsCode 推荐插件相关配置
• 优化 ElDropdown 组件点击触发模式下的交互样式
• 优化菜单过滤逻辑
• 优化页面切换动画，提升加载速度
• 优化暗黑模式文字颜色

修复

• 修复静态路由自定义首页路径首次访问跳转登录页问题
• 修复退出登录时短暂跳转至 500 页的问题
• 修复 v2.5.9 版本首页路由跳转配置失效问题
• 修复 v2.5.9 自动导包机制导致的构建异常

⚠️ 重要提示

此版本需要重新登录

---

v2.5.9 - 2025-10-12

代码优化

• views 文件目录、文件名、代码优化
• useTable 分页请求字段增加全局配置 tableConfig.ts
• 优化路由配置为模块化结构
• 获取菜单接口使用 apifox mock 数据（需在 .env 中将 VITE_ACCESS_MODE 设为 backend 模式）

---

v2.5.8 - 2025-09-29

升级

• vue、vite、element-plus 等核心库升级

修复

• 修复富文本编辑器全屏顶栏层级问题
• 修复表格列排序组件文字溢出问题
• 修复统计卡片条件判断
• 修复根路径 / 与 HOME_PAGE_PATH 同为 / 时出现的无限重定向

优化

• 优化 el-tag 样式
• 优化顶部进度条颜色
• 优化自定义主题配置
• 优化 ElementPlus 自定义主题问题

⚠️ 重要提示

由于项目依赖升级，node 版本需要升级到 v20.19.0 或以上

---

v2.5.7 - 2025-09-14

新增

• 新增 ArtForm 组件

修复

• 修复新版本谷歌浏览器切换主题闪烁问题

优化

• 优化表单 label 高度没有对齐问题
• 首屏启动性能优化

---

v2.5.6 - 2025-09-06

新增

• ArtTableHeader 新增搜索按钮，用于控制顶部搜索栏的显示与隐藏
• 新增权限演示示例
• 添加全局错误处理基础框架

优化

• useTable 类型推导优化，不需要手动传递类型即可实现类型提示
• useTable removeColumn 支持多数据删除
• useTable 自动识别响应体支持自定义配置 (src/utils/table/tableConfig.ts)
• useTable 空数据浏览器警告优化
• api 接口请求代码优化、api.d.ts 类型优化
• 优化 ArtTable 顶部按钮换行无法自适应问题（示例：功能示例 / 左右布局表格）
• ArtTable 分页组件选中样式优化
• ArtTable 空状态高度默认撑满
• ArtButtonMore 组件新增图标、颜色配置
• ArtSearchBar label 为空时不占空间
• 表格操作栏拖拽禁止固定列拖拽
• 角色管理页面接口对接、代码优化
• 菜单管理页面优化
• 优化设置中心滚动页面跟随滚动问题
• 一级路由是外链时，component 校验逻辑优化
• 优化地图右下角拖动问题
• 优化暗黑模式刷新页面白色背景问题
• 优化左侧菜单折叠按钮间距问题
• 移动端显示左侧菜单 logo
• 网络请求新增 showSuccessMessage，用于配置是否显示成功消息
• 全局组件采用异步加载策略，提升首屏加载性能

修复

• 修复批量删除整页数据没有返回上一页的bug
• 修复动态路由参数导致的问题
• 修复动态路由配置一级路由是 iframe 页面时，全屏问题

---

v2.5.5 - 2025-08-17

新增

• 新增 ArtSearchBar 组件示例
• useTable 新增 excludeParams，用于排除某些参数不参与请求

重构

• 重构 ArtSearchBar 组件，支持更多组件、表单校验等能力

优化

• useTable 列配置：支持动态更新能力
• 优化颜色选择器圆角
• el-radio、el-checkbox 统一大小
• art-stats-card 新增小数位、分隔符配置
• 路由配置示例优化
• 高级表格新增自定义获取数据示例（等待其他请求完成后执行 useTable 数据获取）
• 优化路径别名类型问题
• 本地开发跨域配置优化
• useTable 属性、方法命名优化
• 登录页UI升级
• 403、404、500 页面UI升级

修复

• 修复多个富文本编辑器图标不统一问题
• 修复 useTable 删除最后一整页数据没有返回上一页的问题
• 修复 echarts 图表数据初始化、更新数据浏览器报错
• 网络请求支持 http 状态码为 401 时退出登录
• 优化网络请求退出登录多次提示问题

移除

• 删除 art-chart-empty 组件

---

v2.5.4 - 2025-07-27

新增

• 网络请求 headers 支持自定义配置
• 展开行支持 formatter 渲染

优化

• 路由注册新增 component 校验

修复

• 修复获取用户信息接口时序问题导致路由注册菜单渲染错误bug
• 修复动态路由校验问题导致的 iframe 不显示bug
• 修复 reset 文件语法错误
• 修复 ArtTable 数据类型错误
• 修复地图滚轮滚动放大问题

---

v2.5.3 - 2025-07-20

新增

• 新增表格左右布局示例

重构

• ArtTable 组件重构

升级

• Element Plus 升级到 v2.10.2

优化

• 优化 useTable 分页参数问题
• 优化网络请求示例：初始化参数、分页携带参数问题
• 优化搜索日期范围参数处理
• 优化 el-date-picker 组件圆角问题
• 优化 el-select 组件 hover 样式
• 搜索组件、分页组件高度降低
• 优化登录页面滑块动画间隔时长
• 优化菜单没有子菜单显示的问题

修复

• 修复 ArtTable 切换分页大小时执行两次请求bug

---

v2.5.2 - 2025-07-13

新增

• 新增一键精简脚本，快速准备开发环境
• useTable hooks 支持分页字段名自定义映射
• 水平菜单、混合菜单、双列菜单支持徽章显示
• 快速入口支持配置文件模式
• 顶栏功能支持配置文件模式
• 支持自定义首页路径
• 路由支持配置 redirect 等属性

优化

• 全局事件总线 mittBus 类型安全优化
• 优化移动端设置中容器宽度样式
• 优化登录页验证滑块文字居中效果

修复

• 修复表格无数据时表头不显示问题
• 修复 v2.5.0 顶部进度条不显示问题
• 修复左侧菜单遮罩异常显示问题
• 修复隐藏所有子菜单时仍显示父级菜单的问题
• 修复 stylelint 导致的登录页滑块样式异常
• 修复老旧移动端设备 loading 定位问题

---

v2.5.1 - 2025-07-08

优化

• el-card、el-table 背景色跟系统保持一致

修复

• 修复首次登录系统时 loading 提前关闭bug
• 修复 v2.5.0 版本引起的全屏页样式层级过低bug
• 修复 v2.5.0 版本引起的表格展开行折叠bug

---

v2.5.0 - 2025-07-06 🎉

新增

• 新增 useTable hooks 表格封装，支持数据获取、转换、响应适配、智能缓存（基于 LRU 算法）、错误处理、列配置与插槽、分页控制、刷新策略等核心功能，全面提升开发效率与用户体验

重构

• 重构 ArtTable、ArtTableHeader、ArtNotification 组件

升级

• Echarts 版本升级到 5.6.0

移除

• 移除 CountTo 插件，替换为 ArtCountTo 组件

修复

• 修复菜单管理搜索直接修改 pinia 数据的问题
• 修复路由守卫 loading 闪烁问题

⚠️ 重要提示

建议升级，带来更高效、更智能的表格开发体验

---

v2.4.2.9 - 2025-07-02

重构

• 菜单布局、顶部导航代码重构

优化

• 优化移动端菜单滚动用户体验
• 优化顶部菜单样式问题
• 顶部菜单宽度自适应，可显示更多内容，混合菜单支持鼠标滚动
• asyncRoutes 路由配置 auth_mark 字段改为 authMark
• 去除重复的 components.d.ts 文件，components.d.ts、auto-imports.d.ts 忽略提交
• 优化国际化语言文件加载方式，异步改成同步模式
• 优化 el-pagination 大小不一致问题

修复

• 修复移动端锁屏页部分浏览器无法解锁bug

---

v2.4.2.8 - 2025-06-26

修复

• 修复 v2.4.2.7 版本访问 / 路径时显示 404 的问题

---

v2.4.2.7 - 2025-06-25

新增

• 路由支持配置全屏模式
• 路由支持自动跳转到菜单的第一个有效路由
• 动态路由新增 removeAllDynamicRoutes 方法，可用于彻底清除所有动态路由
• 权限自定义指令优化、新增角色权限指令 v-roles、可用于控制元素的显示与隐藏
• 新增标签页操作示例

优化

• 跨域请求携带 cookie 配置从环境变量中获取，默认关闭
• 针对SEO、可访问性做一些优化

修复

• 修复登录页面拖拽组件 ArtDragVerify 宽度、颜色异常bug
• 修复 iframe 页面混合模式、双列模式异常bug
• 优化锁屏页面被 el-loading 穿透bug

---

v2.4.2.6 - 2025-06-23

重构

• 重构 components/core/forms 文件夹下的表单相关组件，提升可维护性与一致性
• 重构 ArtBreadcrumb 面包屑导航组件，优化逻辑结构与样式
• 重构 ArtFireworksEffect 烟花效果组件，显著提升渲染性能与动画流畅度

优化

• 优化 ArtChatWindow 与 ArtFastEnter 组件代码，提升可读性与性能

新增

• README 文档新增官方网站链接，便于用户查看项目文档

---

v2.4.2.5 - 2025-06-22

重构

• 重构图表组件，优化代码结构与可维护性
• 精细调整图表动画与主题配色方案，提升视觉一致性

---

v2.4.2.4 - 2025-06-18

重构

• ArtMenuRight 组件重构
• components/core/cards 下面的组件重构，代码优化

优化

• ArtWatermark 增加类型注释

---

v2.4.2.3 - 2025-06-18

重构

• ArtResultPage 组件重构

优化

• ArtTextScroll 组件代码优化
• ArtException 组件增加类型提示
• ArtCutterImg 组件样式优化、增加类型定义
• ArtVideoPlayer 组件增加类型定义

---

v2.4.2.2 - 2025-06-16

重构

• 返回顶部组件重构
• 图标选择器组件重构

修改

• 系统Logo组件属性变更

---

v2.4.2.1 - 2025-06-16

重构

• 横幅组件重构以及优化

修复

• 修复混合菜单下第一个菜单是嵌套菜单跳转bug

---

v2.4.2 - 2025-06-14

重构

• 重构网络请求模块，增强错误处理、类型安全与多语言支持

新增

• 路由配置新增 activePath 激活菜单路径属性

优化

• 引导、列设置多语言完善
• 去除用户列表、菜单管理页面无效代码
• 更新技术支持链接

修复

• 修复移动端搜索栏无法滚动、iPad端页面滚动异常问题
• 修复 el-dialog 启用 draggable 属性后，自定义动画失效的问题
• 修复 2.3.0 版本本地存储重构后，导致登录、注册等页面多语言设置无法持久化的问题
• 修复表格固定列不起作用bug
• 修复根路径 / 与 HOME_PAGE_PATH 同为 / 时出现的无限重定向

⚠️ 重要提示

此版本需要重新登录

---

v2.4.1.1 - 2025-06-07

优化

• 优化角色管理页面代码
• el-dialog视觉效果优化，支持配置线条
• 系统主题模式从Light改成跟随系统模式

修复

• 修复菜单管理折叠 bug
• 修复表格数据为空高度无限变大bug

---

v2.4.1 - 2025-06-07

新增

• 锁屏状态下禁止使用开发者工具破解锁屏

优化

• 提升菜单操作跟手感
• 页面入场动画时间减少0.04s
• Echarts 图表性能优化，新增可视区域初始化、内存泄漏防护、防抖处理

修复

• 修复 Echarts 图表组件在弹窗中不显示的 bug

---

v2.4.0 - 2025-06-06 🎉

重构

• 全局 TypeScript 类型体系重构，提升类型准确性与可维护性
• 重构 utils 工具包，统一工具方法结构，增强可读性与复用性

新增

• utils 新增表单验证与 Cookie 操作相关工具函数
• 页面组件增加 defineOptions，明确组件命名
• HTTP 请求增加 token 过期自动处理逻辑，提升安全性与用户体验

优化

• 删除未使用的工具模块与无效资源，精简项目体积
• 优化 views 页面结构，移除冗余页面文件
• 异常页面多语言支持, 提升国际化体验
• 图片资源统一转换为 webp 格式，整体资源体积减少约 50%
• 打包产物减少约 1MB，提高加载效率

⚠️ 重要提示

此版本需要重新登录

---

版本说明

版本号规则

本项目遵循 语义化版本 2.0.0 规范：

• 主版本号（Major）：当你做了不兼容的 API 修改
• 次版本号（Minor）：当你做了向下兼容的功能性新增
• 修订号（Patch）：当你做了向下兼容的问题修正

变更类型

• 新增（Added）：新功能
• 修改（Changed）：对现有功能的变更
• 弃用（Deprecated）：即将移除的功能
• 移除（Removed）：已移除的功能
• 修复（Fixed）：Bug 修复
• 安全（Security）：安全相关的修复
• 优化（Optimized）：性能优化或体验优化
• 重构（Refactored）：代码重构
• 升级（Upgraded）：依赖升级

重要提示标记

• 🎉 重大更新：包含重要新特性的版本
• ⚠️ 破坏性变更：需要特别注意的不兼容更新
• 🔒 安全更新：修复安全漏洞的版本

---

贡献指南

如果你想为项目做出贡献，请查看 CONTRIBUTING.md。

许可证

MIT License

---

注意：本更新日志从 v2.4.0 版本开始记录。更早的版本历史请查看 Git 提交记录。

---

English Version