feat(新配置类): 图片缓存版本号文件，用于控制图片缓存的清除，取消之前完全由应用版本号控制缓存的方案，两者结合，现在应用号只有在大更新时才会清除缓存，其他情况由缓存版本号控制

src/config/imageCacheVersion.js

@@ -0,0 +1,18 @@
+// src/config/imageCacheVersion.js
+// 图片缓存版本号配置
+export const IMAGE_CACHE_VERSION = {
+  // 图片缓存版本号，仅在图片资源有重大变化时更新
+  version: '1.0.0', // 可以根据需要更新此版本号
+
+  // 缓存类型控制：'images'、'assets' 或 'all'
+  // 'images': 只清除图片缓存 (likei-images-v)
+  // 'assets': 只清除资产缓存 (likei-assets-v)
+  // 'all': 清除所有缓存
+  cacheType: 'all', // 默认清除所有缓存，可根据需要修改
+
+  // 版本更新说明（用于记录更新原因）
+  updateReason: 'Initial image cache version for major release',
+
+  // 更新时间戳
+  updateTime: new Date().toISOString(),
+}

src/main.js

@@ -1,3 +1,4 @@
+// src/main.js
 import './assets/main.css'
 import { logEnvInfo } from './utils/env.js'
 import { versionChecker } from './utils/versionChecker.js'

src/utils/imageCacheManager.js

@@ -1,11 +1,15 @@
 // src/utils/imageCacheManager.js
+import { IMAGE_CACHE_VERSION } from '@/config/imageCacheVersion'
+
 class ImageCacheManager {
   constructor() {
-    this.cacheVersionKey = 'likei-image-cache-version'
+    this.cacheVersionKey = 'h5_app_version'
     this.currentAppVersion = import.meta.env.VITE_APP_VERSION || '1.0.0'
+    this.currentImageVersion = IMAGE_CACHE_VERSION.version // 使用完整版本号
+    this.versionType = import.meta.env.VITE_VERSION_TYPE || 'patch' // major, minor, patch
 
-    this.imageCacheName = `likei-images-v${this.currentAppVersion}` // OSS图片
+    this.imageCacheName = `likei-images-v${this.currentImageVersion}` // OSS图片
-    this.assetCacheName = `likei-assets-v${this.currentAppVersion}` // 本地assets
+    this.assetCacheName = `likei-assets-v${this.currentImageVersion}` // 本地assets
 
     this.maxCacheItems = 100 // 最大缓存数量（100张）
     this.maxCacheSize = 100 * 1024 * 1024 // 最大缓存大小（100MB）
@@ -15,6 +19,23 @@ class ImageCacheManager {
     this.init()
   }
 
+  // 解析版本号为数组 [major, minor, patch]
+  parseVersion(version) {
+    return version.split('.').map(Number)
+  }
+
+  // 比较两个版本号，返回是否版本发生了变化（任何部分的变化）
+  isVersionChanged(cachedVersion, currentVersion) {
+    return cachedVersion !== currentVersion
+  }
+
+  // 检查是否是major版本更新
+  isMajorVersionUpdate(cachedVersion, currentVersion) {
+    const [cachedMajor] = this.parseVersion(cachedVersion)
+    const [currentMajor] = this.parseVersion(currentVersion)
+    return currentMajor > cachedMajor
+  }
+
   async getCacheForUrl(url) {
     // 规范化 URL
     const normalizedUrl = this.normalizeUrl(url)
@@ -80,15 +101,62 @@ class ImageCacheManager {
   // 版本检查逻辑
   async checkVersionAndUpdate() {
     const cachedVersion = localStorage.getItem(this.cacheVersionKey)
+    const cachedImageVersion = localStorage.getItem('likei-image-version')
 
     if (!cachedVersion) {
+      // 首次安装：保存当前版本和图片版本
       localStorage.setItem(this.cacheVersionKey, this.currentAppVersion)
+      localStorage.setItem('likei-image-version', IMAGE_CACHE_VERSION.version)
       return
     }
 
-    if (cachedVersion !== this.currentAppVersion) {
+    // 检查是否是major版本更新
-      await this.clearOldCaches()
+    const isMajorUpdate = this.isMajorVersionUpdate(cachedVersion, this.currentAppVersion)
-      localStorage.setItem(this.cacheVersionKey, this.currentAppVersion)
+
+    if (isMajorUpdate) {
+      // major版本更新：清除所有缓存
+      console.log(
+        `检测到major版本更新，从 ${cachedVersion} 更新到 ${this.currentAppVersion}，清除所有缓存`
+      )
+      await this.clearAllCaches()
+    } else {
+      // 非major版本更新：检查图片版本是否变化
+      const isImageVersionChanged = this.isVersionChanged(
+        cachedImageVersion || '1.0.0',
+        IMAGE_CACHE_VERSION.version
+      )
+
+      if (isImageVersionChanged) {
+        // 图片版本变化：根据配置清除指定类型的缓存
+        console.log(
+          `检测到图片版本变化，从 ${cachedImageVersion} 更新到 ${IMAGE_CACHE_VERSION.version}，根据配置清除缓存类型: ${IMAGE_CACHE_VERSION.cacheType}`
+        )
+        await this.clearCacheByType(IMAGE_CACHE_VERSION.cacheType)
+      }
+      // 如果图片版本未变化且不是major更新，则不执行任何清除操作
+    }
+
+    // 更新版本号
+    localStorage.setItem(this.cacheVersionKey, this.currentAppVersion)
+    localStorage.setItem('likei-image-version', IMAGE_CACHE_VERSION.version)
+  }
+
+  // 根据类型清除缓存
+  async clearCacheByType(cacheType) {
+    switch (cacheType) {
+      case 'images':
+        await this.clearOldImageCaches()
+        break
+      case 'assets':
+        await this.clearOldAssetCaches()
+        break
+      case 'all':
+        await this.clearAllCaches()
+        break
+      default:
+        // 默认只清除图片缓存
+        await this.clearOldImageCaches()
+        break
     }
   }
 
@@ -180,25 +248,59 @@ class ImageCacheManager {
     }
   }
 
-  // 清除全部旧图片缓存
+  // 清除全部旧图片缓存（仅在图片版本更新时调用）
-  async clearOldCaches() {
+  async clearOldImageCaches() {
     if (!('caches' in window)) return
 
     try {
       const cacheNames = await caches.keys()
-      const oldCaches = cacheNames.filter(
+      const oldImageCaches = cacheNames.filter(
         (name) =>
-          (name.startsWith('likei-images-v') || name.startsWith('likei-assets-v')) &&
+          name.startsWith('likei-images-v') && !name.includes(`v${this.currentImageVersion}`) // 排除当前版本的缓存
-          name !== this.imageCacheName &&
-          name !== this.assetCacheName
       )
 
-      await Promise.all(oldCaches.map((name) => caches.delete(name)))
+      console.log('正在清除旧图片缓存:', oldImageCaches)
+      await Promise.all(oldImageCaches.map((name) => caches.delete(name)))
     } catch (error) {
       console.warn('清理旧图片缓存失败:', error)
     }
   }
 
+  // 清除全部旧资产缓存（仅在图片版本更新时调用）
+  async clearOldAssetCaches() {
+    if (!('caches' in window)) return
+
+    try {
+      const cacheNames = await caches.keys()
+      const oldAssetCaches = cacheNames.filter(
+        (name) =>
+          name.startsWith('likei-assets-v') && !name.includes(`v${this.currentImageVersion}`) // 排除当前版本的缓存
+      )
+
+      console.log('正在清除旧资产缓存:', oldAssetCaches)
+      await Promise.all(oldAssetCaches.map((name) => caches.delete(name)))
+    } catch (error) {
+      console.warn('清理旧资产缓存失败:', error)
+    }
+  }
+
+  // 清除所有缓存（仅在major版本更新时调用）
+  async clearAllCaches() {
+    if (!('caches' in window)) return
+
+    try {
+      const cacheNames = await caches.keys()
+      const allCaches = cacheNames.filter(
+        (name) => name.startsWith('likei-images-v') || name.startsWith('likei-assets-v')
+      )
+
+      console.log('正在清除所有缓存:', allCaches)
+      await Promise.all(allCaches.map((name) => caches.delete(name)))
+    } catch (error) {
+      console.warn('清理所有缓存失败:', error)
+    }
+  }
+
   // 判断是否为适合缓存资源
   isBuildAsset(url) {
     try {

src/utils/versionChecker.js

@@ -1,3 +1,4 @@
+// src/utils/versionChecker.js
 // 版本检查工具
 
 import { imageCacheManager } from '@/utils/imageCacheManager'
@@ -71,8 +72,7 @@ export class VersionChecker {
     const versionResult = await this.checkServerVersion()
 
     if (versionResult.shouldUpdate) {
-      this.handleVersionUpdate()
+      await this.handleVersionUpdate(versionResult.versionType)
-      localStorage.setItem('likei-image-cache-version', this.currentVersion) // 同步 imageCacheManager 的版本信息
       return true
     }
 
@@ -82,7 +82,6 @@ export class VersionChecker {
     if (storedLocalVersion !== this.currentVersion) {
       // 本地版本变化，可能是首次加载或本地版本升级
       localStorage.setItem(this.storageKey, this.currentVersion)
-      localStorage.setItem('likei-image-cache-version', this.currentVersion)
       console.log(`本地版本更新到: ${this.currentVersion}`)
     }
 
@@ -96,15 +95,16 @@ export class VersionChecker {
     // 根据更新类型决定清除策略
     switch (updateType) {
       case 'major':
-        await this.clearCache() // 重大更新：清除所有缓存
+        // 重大更新：清除所有缓存（不管图片版本号是否更新）
+        await this.clearCache()
         break
       case 'minor':
-        await imageCacheManager.clearCacheSelective('all') // 一般更新：清除图片和assets缓存
-        this.clearSessionData() // 清除 session 数据
-        break
       case 'patch':
-        // 日常小更新：清除缓存
+        // minor或patch更新：检查图片版本号是否更新
-        await imageCacheManager.clearCacheSelective('all') // 小更新：清除图片和assets缓存
+        // 如果图片版本号更新，则按imageCacheVersion中的cacheType清除缓存
+        // 如果图片版本号未更新，则不做任何缓存清除处理
+        await imageCacheManager.checkVersionAndUpdate()
+        this.clearSessionData() // 清除 session 数据
         break
       default:
         // 默认：清除所有缓存
@@ -113,7 +113,6 @@ export class VersionChecker {
 
     localStorage.setItem(this.storageKey, this.currentVersion)
     localStorage.setItem(this.serverVersionKey, this.currentVersion)
-    localStorage.setItem('likei-image-cache-version', this.currentVersion)
 
     // 直接刷新页面
     this.forceReload()