@sugarat/theme 0.5.6 → 0.5.8

package/node.d.ts

@@ -186,6 +186,27 @@ declare namespace Theme {
          * @default false
          */
         blogInfoCollapsible?: boolean;
+        /**
+         * 旋转的配置
+         */
+        hoverSpin?: boolean | HoverSpinConfig;
+    }
+    interface HoverSpinConfig {
+        /**
+         * 旋转的加速度
+         * @default 180
+         */
+        accel?: number;
+        /**
+         * 旋转的最大角速度
+         * @default 2160
+         */
+        maxVel?: number;
+        /**
+         * 缓停时长
+         * @default 1500
+         */
+        decelDuration?: number;
     }
     interface ArticleConfig {
         /**
@@ -382,7 +403,7 @@ declare namespace Theme {
         works?: UserWorks;
         /**
          * https://mermaid.js.org/config/setup/modules/mermaidAPI.html#mermaidapi-configuration-defaults for options
-         * @default true
+         * @default false
          */
         mermaid?: any;
         /**

package/node.js

@@ -41,7 +41,7 @@ module.exports = __toCommonJS(node_exports);
 // src/utils/node/mdPlugins.ts
 var import_module = require("module");
 
-// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.2.0_vitepress@1.6.3_@algolia+client-search@5.20.0_@types+node@2_89d33a1149fc4afc3a4b1eeb07b93bba/node_modules/vitepress-plugin-tabs/dist/index.js
+// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.2.0_vitepress@https+++pkg.pr.new+vitepress@3d61619_@types+node@_fc84fc5ced1bdf672a18932976f96d0a/node_modules/vitepress-plugin-tabs/dist/index.js
 var tabsMarker = "=tabs";
 var tabsMarkerLen = tabsMarker.length;
 var ruleBlockTabs = (state, startLine, endLine, silent) => {
@@ -386,8 +386,9 @@ function patchDefaultThemeSideBar(cfg) {
   } : void 0;
 }
 var defaultTimeZoneOffset = (/* @__PURE__ */ new Date()).getTimezoneOffset() / -60;
-async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset, baseContent) {
-  const fileContent = baseContent || await import_node_fs.default.promises.readFile(filepath, "utf-8");
+async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset, ops) {
+  const fileContent = ops?.baseContent || await import_node_fs.default.promises.readFile(filepath, "utf-8");
+  const cacheDir = ops?.cacheDir;
   const { data: frontmatter, excerpt, content } = (0, import_theme_shared2.grayMatter)(fileContent, {
     excerpt: true
   });
@@ -398,7 +399,7 @@ async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset,
     meta.title = (0, import_theme_shared2.getDefaultTitle)(content);
   }
   const utcValue = timeZone >= 0 ? `+${timeZone}` : `${timeZone}`;
-  const date = await (meta.date && /* @__PURE__ */ new Date(`${new Date(meta.date).toUTCString()}${utcValue}`) || (0, import_theme_shared2.getFileLastModifyTime)(filepath));
+  const date = await (meta.date && /* @__PURE__ */ new Date(`${new Date(meta.date).toUTCString()}${utcValue}`) || (0, import_theme_shared2.getFileLastModifyTime)(filepath, cacheDir));
   meta.date = formatDate(date || /* @__PURE__ */ new Date(), "yyyy/MM/dd hh:mm:ss");
   meta.categories = typeof meta.categories === "string" ? [meta.categories] : meta.categories;
   meta.tags = typeof meta.tags === "string" ? [meta.tags] : meta.tags;
@@ -417,7 +418,12 @@ async function getArticles(cfg, vpConfig) {
   const pages = (0, import_theme_shared2.getVitePressPages)(vpConfig);
   const metaResults = pages.reduce((prev, value) => {
     const { page, route, originRoute, filepath, isDynamic, dynamicRoute } = value;
-    const metaPromise = isDynamic && dynamicRoute ? getArticleMeta(filepath, originRoute, cfg?.timeZone, (0, import_theme_shared2.renderDynamicMarkdown)(filepath, dynamicRoute.params, dynamicRoute.content)) : getArticleMeta(filepath, originRoute, cfg?.timeZone);
+    const metaPromise = isDynamic && dynamicRoute ? getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+      baseContent: (0, import_theme_shared2.renderDynamicMarkdown)(filepath, dynamicRoute.params, dynamicRoute.content),
+      cacheDir: vpConfig.cacheDir
+    }) : getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+      cacheDir: vpConfig.cacheDir
+    });
     prev[page] = {
       route,
       metaPromise
@@ -542,6 +548,7 @@ function themeReloadPlugin() {
 // src/utils/node/vitePlugins.ts
 function getVitePlugins(cfg = {}) {
   const plugins = [];
+  plugins.push(cacheAllGitTimestampsPlugin());
   plugins.push(coverImgTransform());
   if (cfg.themeColor) {
     plugins.push(setThemeScript(cfg.themeColor));
@@ -723,6 +730,15 @@ function providePageData(cfg) {
     }
   };
 }
+function cacheAllGitTimestampsPlugin() {
+  return {
+    name: "@sugarat/theme-plugin-cache-all-git-timestamps",
+    async config(config) {
+      const { srcDir } = config.vitepress;
+      await (0, import_theme_shared4.cacheAllGitTimestamps)(srcDir);
+    }
+  };
+}
 function setThemeScript(themeColor) {
   let resolveConfig;
   const pluginOps = {
@@ -759,13 +775,13 @@ function getThemeConfig(cfg = {}) {
   const extraVPConfig = {
     vite: {
       // see https://sass-lang.com/documentation/breaking-changes/legacy-js-api/
-      css: {
-        preprocessorOptions: {
-          scss: {
-            api: "modern"
-          }
-        }
-      },
+      // css: {
+      //   preprocessorOptions: {
+      //     scss: {
+      //       api: 'modern',
+      //     },
+      //   },
+      // },
       build: {
         // https://vite.dev/config/build-options.html#build-chunksizewarninglimit
         chunkSizeWarningLimit: 2048

package/node.mjs

@@ -9,7 +9,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/utils/node/mdPlugins.ts
 import { createRequire } from "module";
 
-// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.2.0_vitepress@1.6.3_@algolia+client-search@5.20.0_@types+node@2_89d33a1149fc4afc3a4b1eeb07b93bba/node_modules/vitepress-plugin-tabs/dist/index.js
+// ../../node_modules/.pnpm/vitepress-plugin-tabs@0.2.0_vitepress@https+++pkg.pr.new+vitepress@3d61619_@types+node@_fc84fc5ced1bdf672a18932976f96d0a/node_modules/vitepress-plugin-tabs/dist/index.js
 var tabsMarker = "=tabs";
 var tabsMarkerLen = tabsMarker.length;
 var ruleBlockTabs = (state, startLine, endLine, silent) => {
@@ -352,8 +352,9 @@ function patchDefaultThemeSideBar(cfg) {
   } : void 0;
 }
 var defaultTimeZoneOffset = (/* @__PURE__ */ new Date()).getTimezoneOffset() / -60;
-async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset, baseContent) {
-  const fileContent = baseContent || await fs.promises.readFile(filepath, "utf-8");
+async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset, ops) {
+  const fileContent = ops?.baseContent || await fs.promises.readFile(filepath, "utf-8");
+  const cacheDir = ops?.cacheDir;
   const { data: frontmatter, excerpt, content } = grayMatter(fileContent, {
     excerpt: true
   });
@@ -364,7 +365,7 @@ async function getArticleMeta(filepath, route, timeZone = defaultTimeZoneOffset,
     meta.title = getDefaultTitle(content);
   }
   const utcValue = timeZone >= 0 ? `+${timeZone}` : `${timeZone}`;
-  const date = await (meta.date && /* @__PURE__ */ new Date(`${new Date(meta.date).toUTCString()}${utcValue}`) || getFileLastModifyTime(filepath));
+  const date = await (meta.date && /* @__PURE__ */ new Date(`${new Date(meta.date).toUTCString()}${utcValue}`) || getFileLastModifyTime(filepath, cacheDir));
   meta.date = formatDate(date || /* @__PURE__ */ new Date(), "yyyy/MM/dd hh:mm:ss");
   meta.categories = typeof meta.categories === "string" ? [meta.categories] : meta.categories;
   meta.tags = typeof meta.tags === "string" ? [meta.tags] : meta.tags;
@@ -383,7 +384,12 @@ async function getArticles(cfg, vpConfig) {
   const pages = getVitePressPages(vpConfig);
   const metaResults = pages.reduce((prev, value) => {
     const { page, route, originRoute, filepath, isDynamic, dynamicRoute } = value;
-    const metaPromise = isDynamic && dynamicRoute ? getArticleMeta(filepath, originRoute, cfg?.timeZone, renderDynamicMarkdown(filepath, dynamicRoute.params, dynamicRoute.content)) : getArticleMeta(filepath, originRoute, cfg?.timeZone);
+    const metaPromise = isDynamic && dynamicRoute ? getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+      baseContent: renderDynamicMarkdown(filepath, dynamicRoute.params, dynamicRoute.content),
+      cacheDir: vpConfig.cacheDir
+    }) : getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+      cacheDir: vpConfig.cacheDir
+    });
     prev[page] = {
       route,
       metaPromise
@@ -426,7 +432,7 @@ import {
   pagefindPlugin
 } from "vitepress-plugin-pagefind";
 import { RssPlugin } from "vitepress-plugin-rss";
-import { joinPath as joinPath2 } from "@sugarat/theme-shared";
+import { cacheAllGitTimestamps, joinPath as joinPath2 } from "@sugarat/theme-shared";
 import { AnnouncementPlugin } from "vitepress-plugin-announcement";
 import { groupIconVitePlugin } from "vitepress-plugin-group-icons";
 
@@ -510,6 +516,7 @@ function themeReloadPlugin() {
 // src/utils/node/vitePlugins.ts
 function getVitePlugins(cfg = {}) {
   const plugins = [];
+  plugins.push(cacheAllGitTimestampsPlugin());
   plugins.push(coverImgTransform());
   if (cfg.themeColor) {
     plugins.push(setThemeScript(cfg.themeColor));
@@ -691,6 +698,15 @@ function providePageData(cfg) {
     }
   };
 }
+function cacheAllGitTimestampsPlugin() {
+  return {
+    name: "@sugarat/theme-plugin-cache-all-git-timestamps",
+    async config(config) {
+      const { srcDir } = config.vitepress;
+      await cacheAllGitTimestamps(srcDir);
+    }
+  };
+}
 function setThemeScript(themeColor) {
   let resolveConfig;
   const pluginOps = {
@@ -727,13 +743,13 @@ function getThemeConfig(cfg = {}) {
   const extraVPConfig = {
     vite: {
       // see https://sass-lang.com/documentation/breaking-changes/legacy-js-api/
-      css: {
-        preprocessorOptions: {
-          scss: {
-            api: "modern"
-          }
-        }
-      },
+      // css: {
+      //   preprocessorOptions: {
+      //     scss: {
+      //       api: 'modern',
+      //     },
+      //   },
+      // },
       build: {
         // https://vite.dev/config/build-options.html#build-chunksizewarninglimit
         chunkSizeWarningLimit: 2048

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sugarat/theme",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "简约风的 Vitepress 博客主题，sugarat vitepress blog theme",
   "author": "sugar",
   "license": "MIT",
@@ -53,10 +53,10 @@
     "vitepress-plugin-group-icons": "1.2.4",
     "vitepress-plugin-mermaid": "2.0.13",
     "vitepress-plugin-tabs": "0.2.0",
-    "@sugarat/theme-shared": "0.0.5",
-    "vitepress-plugin-announcement": "0.1.5",
-    "vitepress-plugin-pagefind": "0.4.14",
-    "vitepress-plugin-rss": "0.3.1"
+    "vitepress-plugin-rss": "0.3.3",
+    "@sugarat/theme-shared": "0.0.6",
+    "vitepress-plugin-pagefind": "0.4.16",
+    "vitepress-plugin-announcement": "0.1.5"
   },
   "devDependencies": {
     "@element-plus/icons-vue": "^2.3.1",
@@ -66,7 +66,7 @@
     "sass": "^1.80.6",
     "typescript": "^5.4.5",
     "vite": "^5.4.9",
-    "vitepress": "1.6.3",
+    "vitepress": "https://pkg.pr.new/vitepress@3d61619",
     "vue": "^3.5.12",
     "vitepress-plugin-51la": "0.1.0"
   },

package/src/components/BlogAuthor.vue

@@ -1,7 +1,8 @@
 <script setup>
 import { useData, withBase } from 'vitepress'
-import { computed } from 'vue'
-import { useBlogConfig, useGlobalAuthor, useHomeConfig } from '../composables/config/blog'
+import { computed, ref } from 'vue'
+import { useGlobalAuthor, useHomeConfig } from '../composables/config/blog'
+import { useHoverSpin } from '../hooks/useHoverSpin'
 
 const home = useHomeConfig()
 const { frontmatter, site } = useData()
@@ -20,11 +21,15 @@ const logo = computed(() =>
   ?? '/logo.png'
 )
 const show = computed(() => author.value || logo.value)
+
+const imgRef = ref(null)
+
+useHoverSpin(imgRef, home?.value?.hoverSpin)
 </script>
 
 <template>
   <div v-if="show" class="blog-author">
-    <img v-if="logo" :src="withBase(logo)" alt="avatar">
+    <img v-if="logo" ref="imgRef" :src="withBase(logo)" alt="avatar">
     <p v-if="author">
       {{ author }}
     </p>
@@ -42,12 +47,7 @@ const show = computed(() => author.value || logo.value)
     height: 100px;
     border-radius: 50%;
     background-color: rgba(var(--bg-gradient-home));
-  }
-
-  img:hover {
-    transform: rotate(666turn);
-    transition-duration: 59s;
-    transition-timing-function: cubic-bezier(.34, 0, .84, 1)
+    cursor: pointer;
   }
 
   p {

package/src/components/BlogHomeHeaderAvatar.vue

@@ -1,7 +1,8 @@
 <script  setup lang="ts">
 import { useData, withBase } from 'vitepress'
-import { computed } from 'vue'
+import { computed, ref } from 'vue'
 import { useHomeConfig } from '../composables/config/blog'
+import { useHoverSpin } from '../hooks/useHoverSpin'
 
 const home = useHomeConfig()
 const { frontmatter, site } = useData()
@@ -13,11 +14,14 @@ const logo = computed(() =>
     ?? '/logo.png'
 )
 const alwaysHide = computed(() => frontmatter.value.blog?.minScreenAvatar === false)
+
+const imgRef = ref(null)
+useHoverSpin(imgRef, home?.value?.hoverSpin)
 </script>
 
 <template>
   <div v-show="!alwaysHide" class="blog-home-header-avatar">
-    <img :src="withBase(logo)" alt="avatar">
+    <img ref="imgRef" :src="withBase(logo)" alt="avatar">
   </div>
 </template>
 
@@ -36,13 +40,14 @@ const alwaysHide = computed(() => frontmatter.value.blog?.minScreenAvatar === fa
         background-color: transparent;
         border: 5px solid rgba(var(--bg-gradient-home));
         box-sizing: border-box;
+        cursor: pointer;
     }
 
-    img:hover {
-        transform: rotate(666turn);
-        transition-duration: 59s;
-        transition-timing-function: cubic-bezier(.34, 0, .84, 1)
-    }
+    // img:hover {
+    //     transform: rotate(666turn);
+    //     transition-duration: 59s;
+    //     transition-timing-function: cubic-bezier(.34, 0, .84, 1)
+    // }
 }
 
 @media screen and (min-width: 768px) {

package/src/composables/config/index.ts

@@ -191,6 +191,28 @@ export namespace Theme {
      * @default false
      */
     blogInfoCollapsible?: boolean
+    /**
+     * 旋转的配置
+     */
+    hoverSpin?: boolean | HoverSpinConfig
+  }
+
+  export interface HoverSpinConfig {
+    /**
+     * 旋转的加速度
+     * @default 180
+     */
+    accel?: number
+    /**
+     * 旋转的最大角速度
+     * @default 2160
+     */
+    maxVel?: number
+    /**
+     * 缓停时长
+     * @default 1500
+     */
+    decelDuration?: number
   }
 
   export interface ArticleConfig {
@@ -408,7 +430,7 @@ export namespace Theme {
     works?: UserWorks
     /**
      * https://mermaid.js.org/config/setup/modules/mermaidAPI.html#mermaidapi-configuration-defaults for options
-     * @default true
+     * @default false
      */
     mermaid?: any
     /**

package/src/hooks/useHoverSpin.ts

@@ -0,0 +1,114 @@
+import { type Ref, onMounted, onUnmounted } from 'vue'
+import type { Theme } from '../composables/config/index'
+
+/**
+ * 元素悬停旋转
+ * @param elRef 元素引用
+ * @param accel 加速度
+ * @param maxVel 最大角速度
+ * @param decelDuration 缓停时长
+ */
+export function useHoverSpin(elRef: Ref<HTMLElement | null>, hoverSpinConfig?: Theme.HoverSpinConfig | boolean) {
+  const { accel = 180, maxVel = 2160, decelDuration = 1500 } = hoverSpinConfig === true ? {} : hoverSpinConfig || {}
+  let rafId = 0
+  let lastTs = 0
+  let rotation = 0
+  let velocity = 0
+  let decelStart = 0
+  let decelStartRotation = 0
+  let decelTargetRotation = 0
+  let decelBias = 0
+  let isDecel = false
+  let hovering = false
+
+  function animate(ts: number) {
+    if (!lastTs)
+      lastTs = ts
+    const dt = (ts - lastTs) / 1000
+    lastTs = ts
+
+    if (hovering) {
+      isDecel = false
+      decelStart = 0
+      velocity = Math.min(velocity + accel * dt, maxVel)
+      rotation += velocity * dt
+    }
+    else if (isDecel) {
+      const t = Math.min((ts - decelStart) / decelDuration, 1)
+      const durSec = decelDuration / 1000
+      const base = velocity * durSec * (t - t * t / 2)
+      const smooth = 3 * t * t - 2 * t * t * t
+      rotation = decelStartRotation + base + decelBias * smooth
+      if (t >= 1) {
+        decelTargetRotation = 0
+        decelStartRotation = 0
+        decelBias = 0
+        rotation = decelTargetRotation
+        velocity = 0
+        isDecel = false
+        if (rafId) {
+          cancelAnimationFrame(rafId)
+          rafId = 0
+        }
+        const el2 = elRef.value as HTMLElement | null
+        if (el2)
+          el2.style.transform = `rotate(${rotation}deg)`
+        return
+      }
+    }
+
+    const el = elRef.value as HTMLElement | null
+    if (el)
+      el.style.transform = `rotate(${rotation}deg)`
+    if (hovering || isDecel) {
+      rafId = requestAnimationFrame(animate)
+    }
+    else if (rafId) {
+      cancelAnimationFrame(rafId)
+      rafId = 0
+    }
+  }
+
+  function onEnter() {
+    hovering = true
+    if (!rafId) {
+      lastTs = 0
+      rafId = requestAnimationFrame(animate)
+    }
+  }
+
+  function onLeave() {
+    hovering = false
+    isDecel = true
+    decelStart = performance.now()
+    decelStartRotation = rotation
+    const durSec = decelDuration / 1000
+    const S = velocity * durSec / 2
+    const minTarget = decelStartRotation + S
+    decelTargetRotation = Math.ceil(minTarget / 360) * 360
+    decelBias = (decelTargetRotation - decelStartRotation) - S
+    lastTs = 0
+  }
+
+  onMounted(() => {
+    if (hoverSpinConfig === false)
+      return
+    const el = elRef.value
+    if (!el)
+      return
+    el.addEventListener('mouseenter', onEnter)
+    el.addEventListener('mouseleave', onLeave)
+  })
+
+  onUnmounted(() => {
+    if (hoverSpinConfig === false)
+      return
+    const el = elRef.value
+    if (el) {
+      el.removeEventListener('mouseenter', onEnter)
+      el.removeEventListener('mouseleave', onLeave)
+    }
+    if (rafId)
+      cancelAnimationFrame(rafId)
+  })
+}

package/src/node.ts

@@ -25,13 +25,13 @@ export function getThemeConfig(cfg: Partial<Theme.BlogConfig> = {}) {
   const extraVPConfig: any = {
     vite: {
       // see https://sass-lang.com/documentation/breaking-changes/legacy-js-api/
-      css: {
-        preprocessorOptions: {
-          scss: {
-            api: 'modern',
-          },
-        },
-      },
+      // css: {
+      //   preprocessorOptions: {
+      //     scss: {
+      //       api: 'modern',
+      //     },
+      //   },
+      // },
       build: {
         // https://vite.dev/config/build-options.html#build-chunksizewarninglimit
         chunkSizeWarningLimit: 2048

package/src/utils/node/theme.ts

@@ -26,9 +26,12 @@ export function getPageRoute(filepath: string, srcDir: string) {
 }
 
 const defaultTimeZoneOffset = new Date().getTimezoneOffset() / -60
-export async function getArticleMeta(filepath: string, route: string, timeZone = defaultTimeZoneOffset, baseContent?: string) {
-  const fileContent = baseContent || await fs.promises.readFile(filepath, 'utf-8')
-
+export async function getArticleMeta(filepath: string, route: string, timeZone = defaultTimeZoneOffset, ops?: {
+  baseContent?: string
+  cacheDir?: string
+}) {
+  const fileContent = ops?.baseContent || await fs.promises.readFile(filepath, 'utf-8')
+  const cacheDir = ops?.cacheDir
   const { data: frontmatter, excerpt, content } = grayMatter(fileContent, {
     excerpt: true,
   })
@@ -44,7 +47,7 @@ export async function getArticleMeta(filepath: string, route: string, timeZone =
   const date = await (
     (meta.date
       && new Date(`${new Date(meta.date).toUTCString()}${utcValue}`))
-    || getFileLastModifyTime(filepath)
+    || getFileLastModifyTime(filepath, cacheDir)
   )
   // 无法获取时兜底当前时间
   meta.date = formatDate(date || new Date(), 'yyyy/MM/dd hh:mm:ss')
@@ -86,8 +89,13 @@ export async function getArticles(cfg: Partial<Theme.BlogConfig>, vpConfig: Site
     const { page, route, originRoute, filepath, isDynamic, dynamicRoute } = value
 
     const metaPromise = (isDynamic && dynamicRoute)
-      ? getArticleMeta(filepath, originRoute, cfg?.timeZone, renderDynamicMarkdown(filepath, dynamicRoute.params, dynamicRoute.content))
-      : getArticleMeta(filepath, originRoute, cfg?.timeZone)
+      ? getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+        baseContent: renderDynamicMarkdown(filepath, dynamicRoute.params, dynamicRoute.content),
+        cacheDir: vpConfig.cacheDir
+      })
+      : getArticleMeta(filepath, originRoute, cfg?.timeZone, {
+        cacheDir: vpConfig.cacheDir
+      })
 
     // 提前获取，有缓存取缓存
     prev[page] = {

package/src/utils/node/vitePlugins.ts

@@ -4,7 +4,7 @@ import {
 } from 'vitepress-plugin-pagefind'
 import { RssPlugin } from 'vitepress-plugin-rss'
 import type { PluginOption } from 'vite'
-import { joinPath } from '@sugarat/theme-shared'
+import { cacheAllGitTimestamps, joinPath } from '@sugarat/theme-shared'
 import { AnnouncementPlugin } from 'vitepress-plugin-announcement'
 import { groupIconVitePlugin } from 'vitepress-plugin-group-icons'
 import type { Theme } from '../../composables/config/index'
@@ -15,6 +15,9 @@ import { getArticles } from './theme'
 export function getVitePlugins(cfg: Partial<Theme.BlogConfig> = {}) {
   const plugins: any[] = []
 
+  // 缓存所有文章的 git 提交时间
+  plugins.push(cacheAllGitTimestampsPlugin())
+
   // 处理 cover image 的路径（暂只支持自动识别的文章首图）
   plugins.push(coverImgTransform())
 
@@ -266,6 +269,16 @@ export function providePageData(cfg: Partial<Theme.BlogConfig>) {
   } as PluginOption
 }
 
+export function cacheAllGitTimestampsPlugin() {
+  return {
+    name: '@sugarat/theme-plugin-cache-all-git-timestamps',
+    async config(config: any) {
+      const { srcDir } = config.vitepress
+      await cacheAllGitTimestamps(srcDir)
+    },
+  } as PluginOption
+}
+
 export function setThemeScript(
   themeColor: Theme.ThemeColor
 ) {