---
url: /guide/changelog.md
---
# 更新日志

只记录 feat/fix 以及破坏性变更。

## v6.4.0

:::info [基础版](https://github.com/fantastic-admin/basic/releases/tag/v6.4.0)
🐞 Bug Fixes

* 修复 FaSwitch 组件激活样式  -  by @hooray [(09a17)](https://github.com/fantastic-admin/basic/commit/09a179cd)
* 修复应用运行时警告  -  by @hooray [(be4a2)](https://github.com/fantastic-admin/basic/commit/be4a274f)
  :::

:::tip [专业版](https://github.com/fantastic-admin/pro/releases/tag/v6.4.0)
🚀 Features

* FaCalendar\* 日历组件增加 `shortcuts` 快捷选择功能  -  by @hooray [(dac61)](https://github.com/fantastic-admin/pro/commit/dac61ea9)
* `FaDate` 增加时间选择功能  -  by @hooray [(d83e7)](https://github.com/fantastic-admin/pro/commit/d83e7873)

🐞 Bug Fixes

* 修复 FaSwitch 组件激活样式  -  by @hooray [(89955)](https://github.com/fantastic-admin/pro/commit/899558c2)
* 修复 FaMention 组件提及样式错位  -  by @hooray [(1833d)](https://github.com/fantastic-admin/pro/commit/1833d989)
* 修复应用运行时警告  -  by @hooray [(fc84c)](https://github.com/fantastic-admin/pro/commit/fc84c8cc)
  :::

## v6.3.0

:::info [基础版](https://github.com/fantastic-admin/basic/releases/tag/v6.3.0)
🚀 Features

* 新增 hotkeys 子包，统一维护全局快捷键  -  by @hooray [(5bbe2)](https://github.com/fantastic-admin/basic/commit/5bbe23df)
* 新增 FaForm 表单组件及示例，并更新登录注册相关页面  -  by @hooray [(29193)](https://github.com/fantastic-admin/basic/commit/29193e47)
* 增加 core-element-plus 应用，同时 core 应用将不再集成任何第三方组件库  -  by @hooray [(68698)](https://github.com/fantastic-admin/basic/commit/686988cc)

🐞 Bug Fixes

* 修复 Antdv Next 应用未和框架主题保持同步  -  by @hooray [(209cb)](https://github.com/fantastic-admin/basic/commit/209cb174)
  :::

:::tip [专业版](https://github.com/fantastic-admin/pro/releases/tag/v6.3.0)
🚀 Features

* 新增 locales 子包，统一维护全局语言包信息  -  by @hooray [(7b48b)](https://github.com/fantastic-admin/pro/commit/7b48bacf)
* 新增 hotkeys 子包，统一维护全局快捷键  -  by @hooray [(e5f32)](https://github.com/fantastic-admin/pro/commit/e5f3263a)
* 新增 FaForm 表单组件及示例，并更新登录注册相关页面  -  by @hooray [(e8312)](https://github.com/fantastic-admin/pro/commit/e831216d)
* 增加 core-element-plus 应用，同时 core 应用将不再集成任何第三方组件库  -  by @hooray [(dc988)](https://github.com/fantastic-admin/pro/commit/dc988a77)
  :::

## v6.2.0

:::info [基础版](https://github.com/fantastic-admin/basic/releases/tag/v6.2.0)
🚨 Breaking Changes

* 上游 vite-plugin-fake-server 插件问题修复，代码回滚  -  by @hooray [(474c1)](https://github.com/fantastic-admin/basic/commit/474c11d9)
* 重构多个子包  -  by @hooray [(749c5)](https://github.com/fantastic-admin/basic/commit/749c55ed)
* 回滚 vite-plugin-fake-server 插件配置  -  by @hooray [(f6516)](https://github.com/fantastic-admin/basic/commit/f6516782)

🚀 Features

* 内建组件内的固定中文文案，改为可替换  -  by @hooray [(f1c02)](https://github.com/fantastic-admin/basic/commit/f1c02586)
* **FaFileUpload**: 增加文件夹上传和自定义上传请求功能  -  by @hooray [(5f9a0)](https://github.com/fantastic-admin/basic/commit/5f9a01fd)
* **FaImageUpload**: 增加文件夹上传和自定义上传请求功能  -  by @hooray [(a7741)](https://github.com/fantastic-admin/basic/commit/a77416fb)
* **alert**: 添加 FaAlert 组件  -  by @hooray [(40cab)](https://github.com/fantastic-admin/basic/commit/40cab5ef)
* **antdv-next**: 添加 AApp 组件  -  by @hooray [(4e5bf)](https://github.com/fantastic-admin/basic/commit/4e5bfb92)
* **badge**: 新增徽章组件及示例  -  by @hooray [(410ce)](https://github.com/fantastic-admin/basic/commit/410ce626)
* **descriptions**: 新增 FaDescriptions 组件及示例  -  by @hooray [(c0cd2)](https://github.com/fantastic-admin/basic/commit/c0cd2ffc)
* **skill**: 更新 fa-crud-page-generator  -  by @hooray [(05e3e)](https://github.com/fantastic-admin/basic/commit/05e3e614)
* **table**: 新增表格组件及示例  -  by @hooray [(57f98)](https://github.com/fantastic-admin/basic/commit/57f98e7b)
* **tag**: 新增标签组件及示例  -  by @hooray [(574d0)](https://github.com/fantastic-admin/basic/commit/574d0fcc)

🐞 Bug Fixes

* 修复 Drawer 和 Modal 组件的 isClosed 状态初始化逻辑  -  by @hooray [(26469)](https://github.com/fantastic-admin/basic/commit/2646930f)
  :::

:::tip [专业版](https://github.com/fantastic-admin/pro/releases/tag/v6.2.0)
🚨 Breaking Changes

* 上游 vite-plugin-fake-server 插件问题修复，代码回滚  -  by @hooray [(e30aa)](https://github.com/fantastic-admin/pro/commit/e30aab22)
* 储物箱组件界面重构，移除国际化支持  -  by @hooray [(96601)](https://github.com/fantastic-admin/pro/commit/9660105e)
* 重构多个子包  -  by @hooray [(640f8)](https://github.com/fantastic-admin/pro/commit/640f8f3e)
* 回滚 vite-plugin-fake-server 插件配置  -  by @hooray [(b6dfa)](https://github.com/fantastic-admin/pro/commit/b6dfa5be)

🚀 Features

* 密码强度组件增加自定义规则和颜色阈值配置  -  by @hooray [(06a9a)](https://github.com/fantastic-admin/pro/commit/06a9a302)
* 新增 FaTable 组件  -  by @hooray [(9f271)](https://github.com/fantastic-admin/pro/commit/9f271f99)
* 添加文件管理示例页面  -  by @hooray [(be872)](https://github.com/fantastic-admin/pro/commit/be8723da)
* 内建组件内的固定中文文案，改为可替换  -  by @hooray [(aa7fb)](https://github.com/fantastic-admin/pro/commit/aa7fb4ed)
* 新增 FaCalendarDate / FaCalendarDateRange 组件  -  by @hooray [(cdae0)](https://github.com/fantastic-admin/pro/commit/cdae00ef)
* 新增 FaCalendarMonth / FaCalendarMonthRange / FaCalendarYear / FaCalendarYearRange 组件  -  by @hooray [(d4f95)](https://github.com/fantastic-admin/pro/commit/d4f95b31)
* FaCalendarDate / FaCalendarMonth / FaCalendarYear 增加多选支持  -  by @hooray [(8b7e9)](https://github.com/fantastic-admin/pro/commit/8b7e9d46)
* FaCalendarDate / FaCalendarDateRange / FaCalendarMonth / FaCalendarMonthRange / FaCalendarYear / FaCalendarYearRange 增加选择器支持  -  by @hooray [(ac8bd)](https://github.com/fantastic-admin/pro/commit/ac8bdc92)
* 移除日期选择器和日期范围选择器中的布局和年份范围属性  -  by @hooray [(7040c)](https://github.com/fantastic-admin/pro/commit/7040cb27)
* 新增 FaDate 组件  -  by @hooray [(cefe9)](https://github.com/fantastic-admin/pro/commit/cefe98c0)
* **FaFileUpload**:
  * 移除国际化，增加文件夹上传和自定义上传请求功能  -  by @hooray [(c39a1)](https://github.com/fantastic-admin/pro/commit/c39a1a81)
* **FaImageUpload**:
  * 移除国际化，增加文件夹上传和自定义上传请求功能  -  by @hooray [(50db4)](https://github.com/fantastic-admin/pro/commit/50db4bab)
* **alert**:
  * 添加 FaAlert 组件  -  by @hooray [(4e301)](https://github.com/fantastic-admin/pro/commit/4e301a6b)
* **antdv-next**:
  * 添加 AApp 组件  -  by @hooray [(6c920)](https://github.com/fantastic-admin/pro/commit/6c92088b)
* **descriptions**:
  * 新增 FaDescriptions 组件及示例  -  by @hooray [(db213)](https://github.com/fantastic-admin/pro/commit/db2134a1)
* **skill**:
  * 更新 fa-crud-page-generator  -  by @hooray [(d09bb)](https://github.com/fantastic-admin/pro/commit/d09bba81)
* **steps**:
  * 添加 FaSteps 组件  -  by @hooray [(4582c)](https://github.com/fantastic-admin/pro/commit/4582c740)
* **table**:
  * 添加列可见性功能和示例  -  by @hooray [(3e1a0)](https://github.com/fantastic-admin/pro/commit/3e1a0c4a)
  * 添加工具栏插槽和列可见性控制，更新文档  -  by @hooray [(aea0a)](https://github.com/fantastic-admin/pro/commit/aea0a0c8)
  * 添加排序功能及相关示例  -  by @hooray [(9e48d)](https://github.com/fantastic-admin/pro/commit/9e48d460)
  * 添加树型数据支持及相关示例  -  by @hooray [(4bfca)](https://github.com/fantastic-admin/pro/commit/4bfca62b)
* **tag**:
  * 新增标签组件及示例  -  by @hooray [(07f41)](https://github.com/fantastic-admin/pro/commit/07f415e1)

🐞 Bug Fixes

* 修复 Drawer 和 Modal 组件的 isClosed 状态初始化逻辑  -  by @hooray [(02b6d)](https://github.com/fantastic-admin/pro/commit/02b6d30c)
* **table**: 修复固定列边框消失的问题  -  by @hooray [(55470)](https://github.com/fantastic-admin/pro/commit/554705a9)
  :::

## v6.1.0

:::info [基础版](https://github.com/fantastic-admin/basic/releases/tag/v6.1.0)
🚨 Breaking Changes

* 移除 FaRadioGroup 组件的 orientation 属性  -  by @hooray [(c0bc3)](https://github.com/fantastic-admin/basic/commit/c0bc31f7)
* 因上游 vite-plugin-fake-server 插件问题，暂时移动 fake 文件目录  -  by @hooray [(1b0dc)](https://github.com/fantastic-admin/basic/commit/1b0dc3b9)

🚀 Features

* 增强 dev 脚本匹配逻辑，支持以 'dev:' 开头的脚本名称  -  by @hooray [(e55e9)](https://github.com/fantastic-admin/basic/commit/e55e9474)
* FaImageUpload / FaFileUpload 增加粘贴上传功能  -  by @hooray [(1c811)](https://github.com/fantastic-admin/basic/commit/1c811156)
* FaImageUpload 组件增加入场、出场、排序动画  -  by @hooray [(38e6a)](https://github.com/fantastic-admin/basic/commit/38e6abab)
* 将生成图标脚本提取到公用子包  -  by @hooray [(1ccbd)](https://github.com/fantastic-admin/basic/commit/1ccbd640)
* 主题色调整  -  by @hooray and **Copilot** [(1d86e)](https://github.com/fantastic-admin/basic/commit/1d86ef87)
* 添加 FaSelect 组件的定位模式支持  -  by @hooray and **Copilot** [(81bed)](https://github.com/fantastic-admin/basic/commit/81beda6e)
* 新增 FaRadioGroup 组件  -  by @hooray [(bb3bd)](https://github.com/fantastic-admin/basic/commit/bb3bd479)
* 新增 FaCheckboxGrou 组件，并重构 FaCheckbox API  -  by @hooray [(5ba6d)](https://github.com/fantastic-admin/basic/commit/5ba6d08d)
* 更新 FaDrawer 和 FaModal 组件，强制关闭自带遮罩  -  by @hooray [(fc2c8)](https://github.com/fantastic-admin/basic/commit/fc2c89fa)
* 扩展 FaInput 组件的 type 属性  -  by @hooray [(70b29)](https://github.com/fantastic-admin/basic/commit/70b29edb)

🐞 Bug Fixes

* 修复 FaDrawer 和 FaModal 组件开启时警告错误  -  by @hooray [(cf4a7)](https://github.com/fantastic-admin/basic/commit/cf4a7eae)
* 修复icon生成脚本错误  -  by @hooray [(84eb9)](https://github.com/fantastic-admin/basic/commit/84eb9b7a)
* 修复登录页“记住我”无法勾选  -  by @hooray [(244e6)](https://github.com/fantastic-admin/basic/commit/244e6cb4)
  :::

:::tip [专业版](https://github.com/fantastic-admin/pro/releases/tag/v6.1.0)
🚨 Breaking Changes

* 移除 FaRadioGroup 组件的 orientation 属性  -  by @hooray [(3fc28)](https://github.com/fantastic-admin/pro/commit/3fc28063)
* 因上游 vite-plugin-fake-server 插件问题，暂时移动 fake 文件目录  -  by @hooray [(05ade)](https://github.com/fantastic-admin/pro/commit/05ade0cf)

🚀 Features

* 增强 dev 脚本匹配逻辑，支持以 'dev:' 开头的脚本名称  -  by @hooray [(7cfaa)](https://github.com/fantastic-admin/pro/commit/7cfaa3bd)
* FaImageUpload / FaFileUpload 增加粘贴上传功能  -  by @hooray [(ff29d)](https://github.com/fantastic-admin/pro/commit/ff29de71)
* FaImageUpload 组件增加入场、出场、排序动画  -  by @hooray [(57211)](https://github.com/fantastic-admin/pro/commit/57211cf7)
* 新增 useTiks 交互音效  -  by @hooray [(1f1b4)](https://github.com/fantastic-admin/pro/commit/1f1b4939)
* 多账号弹窗增加自动聚焦  -  by @hooray [(f07e9)](https://github.com/fantastic-admin/pro/commit/f07e9381)
* 将生成图标脚本提取到公用子包  -  by @hooray [(5afd0)](https://github.com/fantastic-admin/pro/commit/5afd0ee4)
* 重构主题设计，并同步 shadcn-vue 的基础色和主题色  -  by @hooray [(5401b)](https://github.com/fantastic-admin/pro/commit/5401be42)
* 添加 FaSelect 组件的定位模式支持  -  by @hooray [(96006)](https://github.com/fantastic-admin/pro/commit/96006daa)
* 新增 FaRadioGroup 组件  -  by @hooray [(71b97)](https://github.com/fantastic-admin/pro/commit/71b97063)
* 新增 FaCheckboxGrou 组件，并重构 FaCheckbox API  -  by @hooray [(b8ccb)](https://github.com/fantastic-admin/pro/commit/b8ccb1e6)
* 更新 FaDrawer 和 FaModal 组件，强制关闭自带遮罩  -  by @hooray [(1dbb3)](https://github.com/fantastic-admin/pro/commit/1dbb3c8e)
* 扩展 FaInput 组件的 type 属性  -  by @hooray [(03dd7)](https://github.com/fantastic-admin/pro/commit/03dd7fcc)
* 添加 FaTree 组件的虚拟化支持，并使用 reka-ui 重构  -  by @hooray [(bc98d)](https://github.com/fantastic-admin/pro/commit/bc98df00)
* 新增 `FaCombobox` 组件  -  by @hooray [(55732)](https://github.com/fantastic-admin/pro/commit/55732fc5)

🐞 Bug Fixes

* 修复 FaDrawer 和 FaModal 组件开启时警告错误  -  by @hooray [(691dd)](https://github.com/fantastic-admin/pro/commit/691dd905)
* 修复icon生成脚本错误  -  by @hooray [(497fa)](https://github.com/fantastic-admin/pro/commit/497faad0)
* 修复 FaScrollingText 向下滚动时鼠标悬停时跳动  -  by @hooray [(34409)](https://github.com/fantastic-admin/pro/commit/34409eee)
* 修复工具栏布局条件判断  -  by @hooray [(50695)](https://github.com/fantastic-admin/pro/commit/50695260)
* 修复 `VITE_APP_SETTING` 关闭后导致偏好设置无响应  -  by @hooray [(5f286)](https://github.com/fantastic-admin/pro/commit/5f28686f)
* 为 FaButton 组件添加 type 属性以确保按钮行为一致  -  by @hooray [(e6abd)](https://github.com/fantastic-admin/pro/commit/e6abd179)
* 修复登录页“记住我”无法勾选  -  by @hooray [(af1c9)](https://github.com/fantastic-admin/pro/commit/af1c93ab)
* 修复默认语言如果为跟随浏览器语言时，未命中框架内语言包时报错，增加国际化回退语言  -  by @hooray [(5423a)](https://github.com/fantastic-admin/pro/commit/5423af28)
  :::

## v6.0.0

![](/v6-released.png)

如果你是从 v5.x 迁移到 v6.0 ，请先阅读《[从 v5 迁移](./migration-from-v5)》，以下是 v6.0 新特性概览：

* 采用 PNPM monorepo 架构
* 内置 AI Skills
* UnoCSS 预设从 `presetWind3` 升级为 `presetWind4`
* 提供 `setSettingsLegacy` 配置迁移函数，支持从 v5.x 配置快速过渡到 v6
* 偏好设置支持更细粒度的自定义开启方式
  * 可以按整个模块开放
  * 也可以只开放某几个子项
* 新增路由元信息能力
  * 支持 `layout` 路由级布局配置
  * 支持 `localeAuth` 区域权限配置
* 新增锁屏功能
* 新增多账号功能
* 工具栏消息通知全新设计
* RTL 模式支持跟随语言设置自动切换
* 新增布局顶部和底部插槽
* 新增内建组件
  * `FaEmpty`
  * `FaKbdGroup`
  * `FaNumberField`
  * `FaQrcode`
  * `FaScrollingText`
  * `FaCascader`
  * `FaTextShiny`
  * `FaMention`
* 大量内建组件进行了重构
