chore: update docs [deploy]

website/.vitepress/config.mts

@@ -247,8 +247,9 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
         // { link: 'in-depth/layout', text: '布局' },
         { link: 'in-depth/theme', text: '主题' },
         { link: 'in-depth/access', text: '权限' },
-        { link: 'in-depth/features', text: '功能' },
         { link: 'in-depth/locale', text: '国际化' },
+        { link: 'in-depth/features', text: '常用功能' },
+        { link: 'in-depth/check-updates', text: '检查更新' },
         { link: 'in-depth/loading', text: '全局loading' },
       ],
     },

website/src/guide/essentials/settings.md

@@ -174,7 +174,7 @@ const defaultPreferences: Preferences = {
   app: {
     accessMode: 'frontend',
     authPageLayout: 'panel-right',
-    checkUpdatesPollingTime: 1,
+    checkUpdatesInterval: 1,
     colorGrayMode: false,
     colorWeakMode: false,
     compact: false,
@@ -291,7 +291,7 @@ interface AppPreferences {
   /** 登录注册页面布局 */
   authPageLayout: AuthPageLayoutType;
   /** 检查更新轮询时间 */
-  checkUpdatesPollingTime: number;
+  checkUpdatesInterval: number;
   /** 是否开启灰色模式 */
   colorGrayMode: boolean;
   /** 是否开启色弱模式 */

website/src/guide/in-depth/check-updates.md

@@ -0,0 +1,48 @@
+# 检查更新
+
+## 介绍
+
+当网站更新时，你可能会想要检查更新，框架提供了这个能力，通过轮训检查更新，你可以在应用的 `preferences.ts` 文件中配置 `checkUpdatesInterval` 和 `enableCheckUpdates` 字段，用于开启和设置检查更新的时间间隔，单位为`分钟`。
+
+```ts
+import { defineOverridesPreferences } from '@vben/preferences';
+
+export const overridesPreferences = defineOverridesPreferences({
+  // overrides
+  app: {
+    // 是否开启检查更新
+    enableCheckUpdates: true,
+    // 检查更新的时间间隔，单位为分钟
+    checkUpdatesInterval: 1,
+  },
+});
+```
+
+## 效果
+
+当检测到更新时，会弹出提示框，提示用户是否刷新页面：
+
+![check-updates](/guide/update-notice.png)
+
+## 替换为检测
+
+如果你需要通过其他方式检查更新，比如通过接口，以便更灵活的控制更新的逻辑，可以做到强制刷新、显示更新内容等，你可以通过修改 `@vben/layouts` 下面的 `src/widgets/check-updates/check-updates.vue`文件来实现。
+
+```ts
+// 这里可以替换为你的检查更新逻辑
+async function getVersionTag() {
+  try {
+    const response = await fetch('/', {
+      cache: 'no-cache',
+      method: 'HEAD',
+    });
+
+    return (
+      response.headers.get('etag') || response.headers.get('last-modified')
+    );
+  } catch {
+    console.error('Failed to fetch version tag');
+    return null;
+  }
+}
+```

website/src/guide/in-depth/features.md

@@ -1,4 +1,4 @@
-# 功能
+# 常用功能
 
 一些常用的功能合集。
 
@@ -59,7 +59,7 @@ export const overridesPreferences = defineOverridesPreferences({
 
 - 默认值：`false`
 
-开启后网页会显示水印。在应用目录下的`preferences.ts`，开启或者关闭即可。
+开启后网页会显示水印，在应用目录下的`preferences.ts`，开启或者关闭即可。
 
 ```ts
 export const overridesPreferences = defineOverridesPreferences({
@@ -70,7 +70,7 @@ export const overridesPreferences = defineOverridesPreferences({
 });
 ```
 
-如果你想更新水印的内容，可以这么做,参数可以参考 [watermark-js-plus](https://zhensherlock.github.io/watermark-js-plus/)：
+如果你想更新水印的内容，可以这么做，参数可以参考 [watermark-js-plus](https://zhensherlock.github.io/watermark-js-plus/)：
 
 ```ts
 import { useWatermark } from '@vben/hooks';