whistle.mockbubu 1.0.0-dev.4 → 2.0.0

package/lib/uiServer/router/index.js

@@ -1,10 +1,10 @@
 const {
   updateFile,
   removeFile,
-  writeFile,
   readFile,
-  setProperty,
+  readSession,
   getProperty,
+  getPropertyAttr,
   getApiListUpdated,
   setApiListUpdated,
 } = require('../../utils')
@@ -12,21 +12,37 @@ const {
   createErrorResponse,
   createSuccessResponse,
   handleFilterList,
+  filterGroupConfig,
   getFullDataList,
 } = require('../util')
+const {
+  validateFilename,
+  validateMockData,
+  validateBoolean,
+  validateRuleValue,
+  validate,
+} = require('../validator')
 const versionRouter = require('./version-router')
+const groupRouter = require('./group-router')
 
 module.exports = (router) => {
   // 文件版本路由
   versionRouter(router)
+  // 组管理路由
+  groupRouter(router)
 
   // 获取列表数据接口
   router.post('/cgi-bin/mockbubu/api-list', async (ctx) => {
     try {
       const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      // 获取当前激活的组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
 
+      // 从当前组读取数据
       const filteredList = handleFilterList(
-        getFullDataList(localStorage),
+        getFullDataList(localStorage, groupManager, currentGroupId),
         ctx.request.body,
       )
 
@@ -49,17 +65,23 @@ module.exports = (router) => {
   })
 
   // 更新文件详情接口
-  router.post('/cgi-bin/mockbubu/update-api-data', (ctx) => {
+  router.post('/cgi-bin/mockbubu/update-api-data', validate({
+    name: validateFilename,
+    data: validateMockData,
+  }), (ctx) => {
     try {
       const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, data } = ctx.request.body
 
-      updateFile(localStorage, name, data)
-      const file = readFile(localStorage, name)
-      const props = getProperty(localStorage, name) || {}
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      updateFile(localStorage, name, data, currentGroupId)
+      const file = readFile(localStorage, name, currentGroupId)
+      const config = groupManager.getGroupFileConfig(currentGroupId, name)
 
       ctx.body = createSuccessResponse({
-        ...props,
+        ...config,
         name,
         data: file,
       })
@@ -69,18 +91,25 @@ module.exports = (router) => {
   })
 
   // 获取文件详情接口
-  router.post('/cgi-bin/mockbubu/get-api-data', (ctx) => {
+  router.post('/cgi-bin/mockbubu/get-api-data', validate({
+    name: validateFilename,
+  }), (ctx) => {
     try {
       const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name } = ctx.request.body
 
-      const file = readFile(localStorage, name)
-      const props = getProperty(localStorage, name) || {}
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      const file = readFile(localStorage, name, currentGroupId)
+      const session = readSession(localStorage, name, currentGroupId)
+      const config = groupManager.getGroupFileConfig(currentGroupId, name)
 
       ctx.body = createSuccessResponse({
-        ...props,
+        ...config,
         name,
         data: file,
+        session, // 包含完整的 req 和 res 数据
       })
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -88,17 +117,54 @@ module.exports = (router) => {
   })
 
   // 新增mock接口
-  router.post('/cgi-bin/mockbubu/create-api-data', (ctx) => {
+  router.post('/cgi-bin/mockbubu/create-api-data', validate({
+    name: validateFilename,
+    content: validateMockData,
+    ruleValue: validateRuleValue,
+  }), (ctx) => {
     try {
       const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, content, ruleValue } = ctx.request.body
 
-      writeFile({
-        storage: localStorage,
-        filename: name,
-        body: content,
-        properties: { ruleValue, mock: true },
-      })
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      // 完全隔离架构：检查当前组的文件是否存在
+      const filePath = `${currentGroupId}/${name}`
+      const fileExists = !!localStorage.readFile(filePath)
+
+      // 创建文件到当前组目录
+      if (!fileExists) {
+        console.log(`[mockbubu] 创建文件: ${filePath}`)
+        const session = {
+          req: {
+            method: 'GET',
+            url: name,
+            headers: {},
+          },
+          res: {
+            statusCode: 200,
+            headers: { 'content-type': 'application/json' },
+            body: content, // content 是 JSON 字符串
+          },
+        }
+        localStorage.writeFile(filePath, JSON.stringify(session))
+        console.log('  - 已写入 storage')
+      } else {
+        console.log(`[mockbubu] 文件已存在，跳过创建: ${filePath}`)
+      }
+
+      // 在当前组配置中添加记录
+      const groupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+      groupConfig.ruleValue = ruleValue
+      groupConfig.mock = true
+      groupConfig.mockTime = Date.now()
+      groupConfig.url = name
+      groupConfig.method = 'GET'
+      groupConfig.date = Date.now()
+      groupConfig.status = 200
+      groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
 
       ctx.body = createSuccessResponse(null, '创建成功')
     } catch (error) {
@@ -107,12 +173,24 @@ module.exports = (router) => {
   })
 
   // 修改接口mock开关
-  router.post('/cgi-bin/mockbubu/update-api-mock', (ctx) => {
+  router.post('/cgi-bin/mockbubu/update-api-mock', validate({
+    name: validateFilename,
+    mock: (val) => validateBoolean(val, 'mock'),
+  }), (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, mock } = ctx.request.body
 
-      setProperty(localStorage, name, { mock })
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+      // 获取当前组配置
+      const groupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+      // 更新 mock 状态
+      groupConfig.mock = mock
+      groupConfig.mockTime = Date.now()
+      // 写回组配置
+      groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
+
       ctx.body = createSuccessResponse(null, '更新成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -120,50 +198,1327 @@ module.exports = (router) => {
   })
 
   // 修改接口lock开关
-  router.post('/cgi-bin/mockbubu/update-api-lock', (ctx) => {
+  router.post('/cgi-bin/mockbubu/update-api-lock', validate({
+    name: validateFilename,
+    locked: (val) => validateBoolean(val, 'locked'),
+  }), (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, locked } = ctx.request.body
 
-      setProperty(localStorage, name, { locked })
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+      // 获取当前组配置
+      const groupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+      // 更新 locked 状态
+      groupConfig.locked = locked
+      // 写回组配置
+      groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
+
       ctx.body = createSuccessResponse(null, '更新成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
     }
   })
 
-  // 删除接口数据
-  router.post('/cgi-bin/mockbubu/delete-api', (ctx) => {
+  // 删除接口数据（智能删除）
+  router.post('/cgi-bin/mockbubu/delete-api', validate({
+    name: validateFilename,
+  }), (ctx) => {
     try {
       const { localStorage } = ctx.req
-      const { name } = ctx.request.body
+      const { groupManager } = ctx
+      const { name, groupId } = ctx.request.body
+
+      // 优先使用传入的 groupId，否则使用当前组ID
+      const targetGroupId = groupId || groupManager.getCurrentGroupId()
+
+      // 完全隔离架构：直接删除物理文件 + 组配置
+      removeFile(localStorage, name, targetGroupId)
+      groupManager.removeGroupFileConfig(targetGroupId, name)
 
-      removeFile(localStorage, name)
       ctx.body = createSuccessResponse(null, '删除成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
     }
   })
 
-  // 批量删除接口
+  // 批量删除接口（按范围）
   router.post('/cgi-bin/mockbubu/batch-delete-api', (ctx) => {
     try {
       const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      const filteredList = handleFilterList(
+        getFullDataList(localStorage, groupManager, currentGroupId),
+        {
+          ...ctx.request.body,
+          locked: 'unlocked', // 锁定的文件不可批量删除
+        },
+      )
+
+      if (filteredList.length === 0) {
+        ctx.body = createErrorResponse('没有符合条件的文件', 400)
+        return
+      }
+
+      // 完全隔离架构：直接批量删除
+      const result = {
+        total: filteredList.length,
+        success: 0,
+        failed: 0,
+        errors: [],
+      }
 
-      const filteredList = handleFilterList(getFullDataList(localStorage), {
-        ...ctx.request.body,
-        locked: 'unlocked', // 锁定的文件不可批量删除
-      })
-      // 批量删除
       filteredList.forEach((item) => {
         try {
-          removeFile(localStorage, item.name)
+          // 直接删除物理文件 + 组配置
+          removeFile(localStorage, item.name, currentGroupId)
+          groupManager.removeGroupFileConfig(currentGroupId, item.name)
+          result.success++
         } catch (error) {
-          console.error(`删除文件 ${item.name} 失败:`, error.message)
+          result.failed++
+          result.errors.push({
+            name: item.name,
+            error: error.message,
+          })
+          if (process.env.NODE_ENV === 'development') {
+            console.error(`[mockbubu] 删除文件 ${item.name} 失败:`, error.message)
+          }
         }
       })
 
-      ctx.body = createSuccessResponse(null, '删除成功')
+      if (result.failed > 0) {
+        ctx.body = createSuccessResponse(
+          result,
+          `删除完成: 成功 ${result.success}/${result.total}，失败 ${result.failed}`,
+        )
+      } else {
+        ctx.body = createSuccessResponse(
+          { total: result.total, success: result.success },
+          `成功删除 ${result.success} 个文件`,
+        )
+      }
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 批量删除预检接口
+  router.post('/cgi-bin/mockbubu/batch-delete-preview', validate({
+    names: (val) => {
+      if (!Array.isArray(val)) {
+        throw new Error('names 必须是数组')
+      }
+      if (val.length === 0) {
+        throw new Error('names 不能为空')
+      }
+      val.forEach(name => validateFilename(name))
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { groupManager } = ctx
+      const { names } = ctx.request.body
+
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      const stats = {
+        total: names.length,
+        completeDelete: 0,
+        configOnlyDelete: 0,
+        details: [],
+      }
+
+      names.forEach(name => {
+        const isUsedByOthers = groupManager.isFileUsedByOtherGroups(currentGroupId, name)
+        const usingGroups = groupManager.getGroupsUsingFile(name)
+
+        if (isUsedByOthers) {
+          stats.configOnlyDelete++
+          stats.details.push({
+            name,
+            deleteMode: 'config-only',
+            usingGroups: usingGroups.filter(g => g.id !== currentGroupId),
+          })
+        } else {
+          stats.completeDelete++
+          stats.details.push({
+            name,
+            deleteMode: 'complete',
+            usingGroups: [],
+          })
+        }
+      })
+
+      ctx.body = createSuccessResponse(stats, '预检完成')
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 批量删除接口（按名称数组） - 智能删除
+  router.post('/cgi-bin/mockbubu/batch-delete-by-names', validate({
+    names: (val) => {
+      if (!Array.isArray(val)) {
+        throw new Error('names 必须是数组')
+      }
+      if (val.length === 0) {
+        throw new Error('names 不能为空')
+      }
+      val.forEach(name => validateFilename(name))
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+      const { names } = ctx.request.body
+
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+
+      const result = {
+        total: names.length,
+        success: 0,
+        failed: 0,
+        locked: 0,
+        errors: [],
+      }
+
+      names.forEach((name) => {
+        try {
+          // 从当前组配置检查文件是否锁定
+          const groupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+          if (groupConfig.locked) {
+            result.locked++
+            result.errors.push({ name, error: '文件已锁定' })
+            return
+          }
+
+          // 完全隔离架构：直接删除物理文件 + 组配置
+          removeFile(localStorage, name, currentGroupId)
+          groupManager.removeGroupFileConfig(currentGroupId, name)
+
+          result.success++
+        } catch (error) {
+          result.failed++
+          result.errors.push({ name, error: error.message })
+          console.error(`[mockbubu] 删除文件 ${name} 失败:`, error.message)
+        }
+      })
+
+      // 返回结果
+      if (result.locked > 0 && result.success === 0) {
+        ctx.body = createErrorResponse('所有文件都已锁定，无法删除', 403)
+        return
+      }
+
+      if (result.failed > 0 || result.locked > 0) {
+        const messages = []
+        if (result.success > 0) {
+          messages.push(`成功 ${result.success}`)
+        }
+        if (result.locked > 0) {
+          messages.push(`锁定 ${result.locked}`)
+        }
+        if (result.failed > 0) {
+          messages.push(`失败 ${result.failed}`)
+        }
+        ctx.body = createSuccessResponse(
+          result,
+          `删除完成: ${messages.join('，')}`,
+        )
+        return
+      }
+
+      ctx.body = createSuccessResponse(
+        { total: result.total, success: result.success },
+        `成功删除 ${result.success} 个文件`,
+      )
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 批量更新 mock 状态
+  router.post('/cgi-bin/mockbubu/batch-update-mock', validate({
+    names: (val) => {
+      if (!Array.isArray(val)) {
+        throw new Error('names 必须是数组')
+      }
+      if (val.length === 0) {
+        throw new Error('names 不能为空')
+      }
+      val.forEach(name => validateFilename(name))
+      return null
+    },
+    mock: (val) => validateBoolean(val, 'mock'),
+  }), (ctx) => {
+    try {
+      const { groupManager } = ctx
+      const { names, mock } = ctx.request.body
+
+      // 获取当前组ID
+      const currentGroupId = groupManager.getCurrentGroupId()
+      const errors = []
+      const mockTime = Date.now()
+
+      names.forEach((name) => {
+        try {
+          // 获取当前组配置
+          const groupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+          // 更新 mock 状态
+          groupConfig.mock = mock
+          groupConfig.mockTime = mockTime
+          // 写回组配置
+          groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
+        } catch (error) {
+          errors.push({ name, error: error.message })
+          if (process.env.NODE_ENV === 'development') {
+            console.error(`[mockbubu] 更新文件 ${name} 的 mock 状态失败:`, error.message)
+          }
+        }
+      })
+
+      if (errors.length > 0) {
+        ctx.body = createSuccessResponse({ errors }, `更新完成，${errors.length} 个文件更新失败`)
+        return
+      }
+
+      const action = mock ? '开启' : '关闭'
+      ctx.body = createSuccessResponse(null, `成功${action} ${names.length} 个文件的 Mock 状态`)
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // ==================== 分组导出功能 ====================
+
+  // 导出当前组的配置和数据
+  router.post('/cgi-bin/mockbubu/export-group', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const currentGroupId = groupManager.getCurrentGroupId()
+      const currentGroup = groupManager.getCurrentGroup()
+      const fileList = getFullDataList(localStorage, groupManager, currentGroupId)
+
+      const exportData = {
+        exportTime: new Date().toISOString(),
+        version: '2.0.0',
+        exportType: 'single-group',
+        group: {
+          id: currentGroup.id,
+          name: currentGroup.name,
+          description: currentGroup.description,
+          createTime: currentGroup.createTime,
+          updateTime: currentGroup.updateTime,
+          isDefault: currentGroup.isDefault,
+        },
+        files: fileList.map((item) => {
+          const session = readSession(localStorage, item.name)
+          const rawGroupConfig = groupManager.getGroupFileConfig(currentGroupId, item.name)
+          const groupConfig = filterGroupConfig(rawGroupConfig)
+
+          return {
+            name: item.name,
+            session, // 原始抓包数据
+            groupConfig, // 组级别的配置（已过滤）
+          }
+        }),
+      }
+
+      ctx.body = createSuccessResponse(exportData, `成功导出组【${currentGroup.name}】`)
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 导出所有组的配置和数据
+  router.post('/cgi-bin/mockbubu/export-all-groups', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const groupsData = groupManager.getGroupsData()
+      const allFileNames = localStorage.getFileList().map(item => item.name)
+
+      const exportData = {
+        exportTime: new Date().toISOString(),
+        version: '2.0.0',
+        exportType: 'all-groups',
+        groupsData: {
+          groups: groupsData.groups,
+          currentGroupId: groupsData.currentGroupId,
+        },
+        files: allFileNames.map((filename) => {
+          const session = readSession(localStorage, filename)
+          const groupConfigs = {}
+
+          // 收集所有组对该文件的配置
+          groupsData.groups.forEach(group => {
+            const rawConfig = groupManager.getGroupFileConfig(group.id, filename)
+            const filteredConfig = filterGroupConfig(rawConfig)
+            // 只导出有实际配置的组
+            if (Object.keys(filteredConfig).length > 0) {
+              groupConfigs[group.id] = filteredConfig
+            }
+          })
+
+          return {
+            name: filename,
+            session, // 原始数据（所有组共享）
+            groupConfigs, // 各组的配置（已过滤）
+          }
+        }),
+      }
+
+      ctx.body = createSuccessResponse(exportData, `成功导出所有组（${groupsData.groups.length} 个组）`)
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 导出所有 mock 数据（旧版本格式，保持兼容）
+  router.post('/cgi-bin/mockbubu/export-all', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const fileList = getFullDataList(localStorage)
+
+      const exportData = {
+        exportTime: new Date().toISOString(),
+        version: '1.0',
+        count: fileList.length,
+        data: fileList.map((item) => {
+          // 读取完整的 session 数据（包含 req 和 res）
+          const session = readSession(localStorage, item.name)
+          const props = getProperty(localStorage, item.name) || {}
+
+          return {
+            name: item.name,
+            session, // 导出完整的 session 数据
+            properties: props,
+          }
+        }),
+      }
+
+      ctx.body = createSuccessResponse(exportData, '导出成功（旧版格式）')
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // ==================== 分组导入功能 ====================
+
+  // 导入到当前组
+  router.post('/cgi-bin/mockbubu/import-to-current-group', validate({
+    data: (val) => {
+      if (!val || typeof val !== 'object') {
+        throw new Error('data 必须是对象')
+      }
+      if (val.exportType !== 'single-group') {
+        throw new Error('导入数据格式不正确，必须是单组导出的数据')
+      }
+      return null
+    },
+    confirmed: (val) => {
+      // confirmed 参数可选，必须是 boolean 或 undefined
+      if (val !== undefined && typeof val !== 'boolean') {
+        throw new Error('confirmed 参数必须是 boolean 类型')
+      }
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+      const { data, confirmed } = ctx.request.body
+
+      const currentGroupId = groupManager.getCurrentGroupId()
+      const currentGroup = groupManager.getCurrentGroup()
+
+      // 统计结果
+      const result = {
+        total: data.files.length,
+        newFiles: 0,
+        existingFiles: 0,
+        existingDetails: [],
+        imported: 0,
+        merged: 0,
+        errors: [],
+      }
+
+      // 1. 检测同名文件（检查当前组是否已配置该文件）
+      data.files.forEach((item) => {
+        const groupConfig = groupManager.getGroupFileConfig(currentGroupId, item.name)
+        if (groupConfig) {
+          // 当前组已有该文件的配置
+          result.existingFiles++
+          result.existingDetails.push({
+            name: item.name,
+            url: item.session?.req?.url || '',
+          })
+        } else {
+          result.newFiles++
+        }
+      })
+
+      // 2. 如果有同名文件且未确认，返回统计信息
+      if (result.existingFiles > 0 && !confirmed) {
+        ctx.body = {
+          code: 200,
+          needConfirm: true,
+          msg: '检测到同名文件，请确认导入',
+          data: result,
+        }
+        return
+      }
+
+      // 3. 执行智能导入
+      // 生成版本名称：优先使用导入组名称
+      const versionName = data.group?.name || `导入_${new Date().toLocaleString('zh-CN').replace(/[/:]/g, '-').replace(/\s/g, '_')}`
+
+      data.files.forEach((item) => {
+        try {
+          const { name, session, groupConfig, versions } = item
+          const existingGroupConfig = groupManager.getGroupFileConfig(currentGroupId, name)
+
+          if (!existingGroupConfig) {
+            // 3.1 新文件（当前组没有配置）：直接导入
+
+            // 如果物理文件不存在，创建物理文件
+            const existingFile = localStorage.readFile(name)
+            if (!existingFile && session) {
+              localStorage.writeFile(name, JSON.stringify(session))
+            }
+
+            // 写入到当前组的配置
+            if (groupConfig) {
+              groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
+            }
+
+            // 导入版本数据（跳过 source 版本）
+            if (versions && Array.isArray(versions)) {
+              versions.forEach((version) => {
+                if (version.name && version.content && version.name !== 'source') {
+                  groupManager.addGroupVersion(
+                    currentGroupId,
+                    name,
+                    version.name,
+                    version.content,
+                    version.description || '',
+                  )
+                }
+              })
+            }
+
+            result.imported++
+          } else {
+            // 3.2 同名文件：智能合并
+            // - 保留原始数据（Layer 1 不变）
+            // - 导入所有版本数据（跳过 source）
+            // - 如果有组名，激活组名版本；否则保持当前版本
+
+            // 导入版本数据（跳过 source 版本）
+            let hasImportedVersions = false
+            if (versions && Array.isArray(versions)) {
+              versions.forEach((version) => {
+                if (version.name && version.content && version.name !== 'source') {
+                  groupManager.addGroupVersion(
+                    currentGroupId,
+                    name,
+                    version.name,
+                    version.content,
+                    version.description || '从导入文件创建',
+                  )
+                  hasImportedVersions = true
+                }
+              })
+            }
+
+            // 更新组配置
+            if (hasImportedVersions) {
+              // 如果导入了版本数据，激活导入组名称的版本（如果存在）
+              const targetVersion = versionName // 使用导入组名称
+              groupManager.setGroupFileConfig(currentGroupId, name, {
+                ...existingGroupConfig,
+                mockVersion: targetVersion,
+                mock: groupConfig?.mock ?? existingGroupConfig.mock,
+                locked: groupConfig?.locked ?? existingGroupConfig.locked,
+              })
+            } else {
+              // 如果没有版本数据，保持原有配置不变
+              // 不做任何更新
+            }
+
+            result.merged++
+          }
+        } catch (error) {
+          result.errors.push({
+            name: item.name,
+            error: error.message,
+          })
+          if (process.env.NODE_ENV === 'development') {
+            console.error(`[mockbubu] 导入文件 ${item.name} 失败:`, error.message)
+          }
+        }
+      })
+
+      // 4. 返回结果
+      const messages = []
+      messages.push(`成功导入到组【${currentGroup.name}】`)
+      if (result.imported > 0) {
+        messages.push(`新文件 ${result.imported} 个`)
+      }
+      if (result.merged > 0) {
+        messages.push(`合并 ${result.merged} 个`)
+      }
+      if (result.errors.length > 0) {
+        messages.push(`失败 ${result.errors.length} 个`)
+      }
+
+      ctx.body = {
+        code: 200,
+        needConfirm: false,
+        msg: messages.join('，'),
+        data: result,
+      }
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 导入为新组
+  router.post('/cgi-bin/mockbubu/import-as-new-group', validate({
+    data: (val) => {
+      if (!val || typeof val !== 'object') {
+        throw new Error('data 必须是对象')
+      }
+      if (val.exportType !== 'single-group') {
+        throw new Error('导入数据格式不正确，必须是单组导出的数据')
+      }
+      return null
+    },
+    groupName: (val) => {
+      if (!val || !val.trim()) {
+        throw new Error('组名不能为空')
+      }
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+      const { data, groupName, groupDescription = '' } = ctx.request.body
+
+      // 创建新组
+      const newGroup = groupManager.createGroup({
+        name: groupName,
+        description: groupDescription || data.group.description || '',
+      })
+
+      const errors = []
+      let imported = 0
+
+      // 导入数据到新组
+      data.files.forEach((item) => {
+        try {
+          const { name, session, groupConfig, versions } = item
+
+          // 写入原始 session 数据（如果不存在）
+          if (session && !localStorage.readFile(name)) {
+            localStorage.writeFile(name, JSON.stringify(session))
+          }
+
+          // 写入到新组的配置
+          if (groupConfig) {
+            groupManager.setGroupFileConfig(newGroup.id, name, groupConfig)
+          }
+
+          // 导入版本数据（跳过 source 版本，因为 source 对应 Layer 1 的物理文件）
+          if (versions && Array.isArray(versions)) {
+            versions.forEach((version) => {
+              // 跳过 source 版本，source 应该对应原始物理文件
+              if (version.name && version.content && version.name !== 'source') {
+                groupManager.addGroupVersion(
+                  newGroup.id,
+                  name,
+                  version.name,
+                  version.content,
+                  version.description || '',
+                )
+              }
+            })
+          }
+
+          imported++
+        } catch (error) {
+          errors.push({ name: item.name, error: error.message })
+          if (process.env.NODE_ENV === 'development') {
+            console.error(`[mockbubu] 导入文件 ${item.name} 失败:`, error.message)
+          }
+        }
+      })
+
+      // 返回结果
+      const messages = []
+      messages.push(`成功创建新组【${newGroup.name}】并导入 ${imported} 个文件`)
+      if (errors.length > 0) {
+        messages.push(`${errors.length} 个文件导入失败`)
+        // 添加首个错误详情,便于快速定位问题
+        if (errors[0]) {
+          messages.push(`首个错误: ${errors[0].error}`)
+        }
+      }
+
+      ctx.body = createSuccessResponse({
+        newGroup,
+        imported,
+        errors,
+      }, messages.join('，'))
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 导入所有组（全量恢复）
+  router.post('/cgi-bin/mockbubu/import-all-groups', validate({
+    data: (val) => {
+      if (!val || typeof val !== 'object') {
+        throw new Error('data 必须是对象')
+      }
+      if (val.exportType !== 'all-groups') {
+        throw new Error('导入数据格式不正确，必须是所有组导出的数据')
+      }
+      return null
+    },
+    mode: (val) => {
+      // mode 参数可选，默认为 merge
+      if (val && !['merge', 'overwrite'].includes(val)) {
+        throw new Error('mode 必须是 merge 或 overwrite')
+      }
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+      const { data, mode } = ctx.request.body
+      const importMode = mode || 'merge' // 默认为 merge
+
+      const errors = []
+      const result = {
+        groups: { imported: 0, skipped: 0 },
+        files: { imported: 0, skipped: 0 },
+      }
+
+      // 1. overwrite 模式：删除所有非默认组
+      if (importMode === 'overwrite') {
+        const existingGroups = groupManager.getGroups()
+        existingGroups.forEach(group => {
+          if (!group.isDefault && group.id !== groupManager.DEFAULT_GROUP_ID) {
+            try {
+              groupManager.deleteGroup(group.id)
+            } catch (error) {
+              errors.push({ group: group.name, error: `删除组失败: ${error.message}` })
+            }
+          }
+        })
+      }
+
+      // 2. 导入组元数据
+      if (data.groupsData && data.groupsData.groups) {
+        const existingGroupIds = groupManager.getGroups().map(g => g.id)
+
+        data.groupsData.groups.forEach(group => {
+          try {
+            // 跳过默认组
+            if (group.id === groupManager.DEFAULT_GROUP_ID || group.isDefault) {
+              result.groups.skipped++
+              return
+            }
+
+            if (existingGroupIds.includes(group.id)) {
+              if (importMode === 'merge') {
+                // merge 模式：更新组信息
+                groupManager.updateGroup(group.id, {
+                  name: group.name,
+                  description: group.description,
+                })
+                result.groups.imported++
+              } else {
+                // overwrite 模式：组已在上面删除，这里跳过
+                result.groups.skipped++
+              }
+            } else {
+              // 新组：创建
+              const newGroup = {
+                id: group.id,
+                name: group.name,
+                description: group.description,
+                createTime: group.createTime,
+                updateTime: Date.now(),
+                isDefault: false,
+              }
+              const groupsData = groupManager.getGroupsData()
+              groupsData.groups.push(newGroup)
+              groupManager.setGroupsData(groupsData)
+              result.groups.imported++
+            }
+          } catch (error) {
+            errors.push({ group: group.name, error: error.message })
+          }
+        })
+      }
+
+      // 3. 导入文件和组配置
+      if (data.files) {
+        data.files.forEach(item => {
+          try {
+            const { name, session, groupConfigs } = item
+            const existingFile = localStorage.readFile(name)
+
+            // 处理文件数据
+            if (!existingFile) {
+              // 新文件：写入
+              if (session) {
+                localStorage.writeFile(name, JSON.stringify(session))
+              }
+              result.files.imported++
+            } else {
+              // 已存在文件
+              if (importMode === 'overwrite') {
+                // overwrite 模式：覆盖原始数据
+                if (session) {
+                  localStorage.writeFile(name, JSON.stringify(session))
+                }
+                result.files.imported++
+              } else {
+                // merge 模式：保留原始数据，跳过
+                result.files.skipped++
+              }
+            }
+
+            // 写入各组的配置
+            if (groupConfigs) {
+              Object.keys(groupConfigs).forEach(groupId => {
+                const config = groupConfigs[groupId]
+                if (importMode === 'merge') {
+                  const existingConfig = groupManager.getGroupFileConfig(groupId, name)
+                  // merge 模式：只导入当前没有配置的组
+                  if (!existingConfig.mock && !existingConfig.locked && !existingConfig.mockVersion) {
+                    groupManager.setGroupFileConfig(groupId, name, config)
+                  }
+                } else {
+                  // overwrite 模式：覆盖所有配置
+                  groupManager.setGroupFileConfig(groupId, name, config)
+                }
+              })
+            }
+          } catch (error) {
+            errors.push({ name: item.name, error: error.message })
+            if (process.env.NODE_ENV === 'development') {
+              console.error(`[mockbubu] 导入文件 ${item.name} 失败:`, error.message)
+            }
+          }
+        })
+      }
+
+      // 返回结果
+      const messages = []
+      messages.push('成功导入')
+      if (result.groups.imported > 0) {
+        messages.push(`${result.groups.imported} 个组`)
+      }
+      if (result.files.imported > 0) {
+        messages.push(`${result.files.imported} 个文件`)
+      }
+      if (errors.length > 0) {
+        messages.push(`${errors.length} 个错误`)
+      }
+
+      ctx.body = createSuccessResponse({
+        ...result,
+        errors,
+      }, messages.join('，'))
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 导入 mock 数据（旧版本格式，保持兼容）
+  router.post('/cgi-bin/mockbubu/import-data', validate({
+    data: (val) => {
+      if (!Array.isArray(val)) {
+        throw new Error('data 必须是数组')
+      }
+      if (val.length === 0) {
+        throw new Error('data 不能为空')
+      }
+      return null
+    },
+    mode: (val) => {
+      if (!['merge', 'overwrite'].includes(val)) {
+        throw new Error('mode 必须是 merge 或 overwrite')
+      }
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+      const { data, mode } = ctx.request.body
+
+      const currentGroupId = groupManager.getCurrentGroupId()
+      const errors = []
+      const skipped = []
+      let imported = 0
+
+      data.forEach((item) => {
+        try {
+          const { name, session, properties } = item
+
+          // merge 模式下，如果文件已存在则跳过
+          if (mode === 'merge' && localStorage.readFile(name)) {
+            skipped.push(name)
+            return
+          }
+
+          // 直接写入完整的 session 数据
+          if (session) {
+            localStorage.writeFile(name, JSON.stringify(session))
+          }
+
+          // 将旧格式的 properties 迁移到当前组
+          if (properties) {
+            groupManager.setGroupFileConfig(currentGroupId, name, properties)
+          }
+
+          imported++
+        } catch (error) {
+          errors.push({ name: item.name, error: error.message })
+          if (process.env.NODE_ENV === 'development') {
+            console.error(`[mockbubu] 导入文件 ${item.name} 失败:`, error.message)
+          }
+        }
+      })
+
+      // 返回结果
+      const messages = []
+      if (imported > 0) {
+        messages.push(`成功导入 ${imported} 个文件到当前组`)
+      }
+      if (skipped.length > 0) {
+        messages.push(`跳过 ${skipped.length} 个已存在的文件`)
+      }
+      if (errors.length > 0) {
+        messages.push(`${errors.length} 个文件导入失败`)
+      }
+
+      ctx.body = createSuccessResponse({
+        imported,
+        skipped: skipped.length,
+        errors,
+      }, messages.join('，'))
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // ==================== 存储管理功能 ====================
+
+  // 获取存储统计信息
+  router.get('/cgi-bin/mockbubu/storage-stats', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      // 获取所有物理文件
+      const allFiles = localStorage.getFileList()
+      const groups = groupManager.getGroups()
+
+      // 初始化统计数据
+      let totalSize = 0
+      let originalDataSize = 0
+      let versionDataSize = 0
+
+      const stats = {
+        mockEnabled: 0,
+        mockDisabled: 0,
+        locked: 0,
+        orphanFiles: 0,
+        unusedFiles: 0,
+      }
+
+      const groupsFileCount = {}
+      groups.forEach(group => {
+        groupsFileCount[group.id] = 0
+      })
+
+      // 遍历所有文件统计
+      allFiles.forEach(item => {
+        const filename = item.name
+        let hasConfig = false
+
+        // 读取文件大小
+        const file = localStorage.readFile(filename)
+        if (file) {
+          const fileSize = Buffer.byteLength(file, 'utf8')
+          totalSize += fileSize
+          originalDataSize += fileSize
+        }
+
+        // 检查各组配置
+        groups.forEach(group => {
+          // 使用 hasGroupConfig 直接检查配置是否存在
+          const hasActualConfig = groupManager.hasGroupConfig(group.id, filename)
+
+          if (hasActualConfig) {
+            hasConfig = true
+            groupsFileCount[group.id]++
+
+            // 获取配置详情用于统计
+            const config = groupManager.getGroupFileConfig(group.id, filename)
+
+            // 统计 mock 状态
+            if (config.mock) {
+              stats.mockEnabled++
+            } else {
+              stats.mockDisabled++
+            }
+
+            // 统计锁定状态
+            if (config.locked) {
+              stats.locked++
+            }
+
+            // 统计版本数据大小
+            const versions = groupManager.getGroupVersions(group.id, filename)
+            versions.forEach(version => {
+              if (version.content) {
+                const versionSize = Buffer.byteLength(JSON.stringify(version.content), 'utf8')
+                versionDataSize += versionSize
+              }
+            })
+          }
+        })
+
+        // 统计孤儿文件
+        if (!hasConfig) {
+          stats.orphanFiles++
+        }
+
+        // 统计未使用文件
+        if (hasConfig) {
+          let allMockDisabled = true
+          let allLocked = false
+          let hasCustomVersions = false
+
+          groups.forEach(group => {
+            if (groupManager.hasGroupConfig(group.id, filename)) {
+              const config = groupManager.getGroupFileConfig(group.id, filename)
+
+              if (config.mock) {
+                allMockDisabled = false
+              }
+
+              if (config.locked) {
+                allLocked = true
+              }
+
+              const versions = groupManager.getGroupVersions(group.id, filename)
+              const customVersions = versions.filter(v => v.filename !== 'source')
+              if (customVersions.length > 0) {
+                hasCustomVersions = true
+              }
+            }
+          })
+
+          // 未使用文件：所有组未开启mock + 所有组未锁定 + 所有组无自定义版本
+          if (allMockDisabled && !allLocked && !hasCustomVersions) {
+            stats.unusedFiles++
+          }
+        }
+      })
+
+      // 构造响应数据
+      const groupsData = groups.map(group => ({
+        id: group.id,
+        name: group.name,
+        fileCount: groupsFileCount[group.id],
+      }))
+
+      ctx.body = createSuccessResponse({
+        totalFiles: allFiles.length,
+        totalSize,
+        originalDataSize,
+        versionDataSize,
+        groups: groupsData,
+        stats,
+      })
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 预览孤儿文件
+  router.get('/cgi-bin/mockbubu/preview-orphan-files', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const allFiles = localStorage.getFileList()
+      const orphanFiles = []
+      let totalSize = 0
+
+      allFiles.forEach(item => {
+        const filename = item.name
+        let hasConfig = false
+
+        // 检查是否有任何组配置
+        const groups = groupManager.getGroups()
+        for (const group of groups) {
+          if (groupManager.hasGroupConfig(group.id, filename)) {
+            hasConfig = true
+            break
+          }
+        }
+
+        // 是孤儿文件
+        if (!hasConfig) {
+          const file = localStorage.readFile(filename)
+          const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+          orphanFiles.push({
+            name: filename,
+            url: getPropertyAttr(localStorage, filename, 'url') || 'N/A',
+            method: getPropertyAttr(localStorage, filename, 'method') || 'N/A',
+            size: fileSize,
+            date: getPropertyAttr(localStorage, filename, 'date') || 'N/A',
+          })
+
+          totalSize += fileSize
+        }
+      })
+
+      ctx.body = createSuccessResponse({
+        files: orphanFiles,
+        totalSize,
+        count: orphanFiles.length,
+      })
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 清理孤儿文件
+  router.post('/cgi-bin/mockbubu/cleanup-orphan-files', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const allFiles = localStorage.getFileList()
+      let deleted = 0
+      let freedSpace = 0
+
+      allFiles.forEach(item => {
+        const filename = item.name
+        let hasConfig = false
+
+        // 检查是否有任何组配置
+        const groups = groupManager.getGroups()
+        for (const group of groups) {
+          if (groupManager.hasGroupConfig(group.id, filename)) {
+            hasConfig = true
+            break
+          }
+        }
+
+        // 删除孤儿文件
+        if (!hasConfig) {
+          const file = localStorage.readFile(filename)
+          const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+          // 删除物理文件
+          removeFile(localStorage, filename)
+
+          deleted++
+          freedSpace += fileSize
+        }
+      })
+
+      const freedSpaceMB = (freedSpace / (1024 * 1024)).toFixed(2)
+      ctx.body = createSuccessResponse({
+        deleted,
+        freedSpace,
+      }, `成功清理 ${deleted} 个孤儿文件，释放 ${freedSpaceMB} MB 存储空间`)
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 预览未使用文件
+  router.get('/cgi-bin/mockbubu/preview-unused-files', (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const allFiles = localStorage.getFileList()
+      const unusedFiles = []
+      let totalSize = 0
+
+      allFiles.forEach(item => {
+        const filename = item.name
+        const groups = groupManager.getGroups()
+
+        let hasConfig = false
+        let allMockDisabled = true
+        let allLocked = false
+        let allNoCustomVersions = true
+        const groupsStatus = []
+
+        // 检查所有组的配置
+        groups.forEach(group => {
+          if (groupManager.hasGroupConfig(group.id, filename)) {
+            hasConfig = true
+
+            const config = groupManager.getGroupFileConfig(group.id, filename)
+
+            // 检查 mock 状态
+            if (config.mock) {
+              allMockDisabled = false
+            }
+
+            // 检查锁定状态
+            if (config.locked) {
+              allLocked = true
+            }
+
+            // 检查是否有自定义版本
+            const versions = groupManager.getGroupVersions(group.id, filename)
+            const customVersions = versions.filter(v => v.filename !== 'source')
+            const hasCustomVersions = customVersions.length > 0
+
+            if (hasCustomVersions) {
+              allNoCustomVersions = false
+            }
+
+            groupsStatus.push({
+              id: group.id,
+              name: group.name,
+              mock: config.mock,
+              locked: config.locked,
+              hasCustomVersions,
+            })
+          }
+        })
+
+        // 判断是否为未使用文件：所有组未开启mock + 所有组未锁定 + 所有组无自定义版本
+        if (hasConfig && allMockDisabled && !allLocked && allNoCustomVersions) {
+          const file = localStorage.readFile(filename)
+          const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+          unusedFiles.push({
+            name: filename,
+            url: getPropertyAttr(localStorage, filename, 'url') || 'N/A',
+            method: getPropertyAttr(localStorage, filename, 'method') || 'N/A',
+            size: fileSize,
+            date: getPropertyAttr(localStorage, filename, 'date') || 'N/A',
+            groupsStatus,
+          })
+
+          totalSize += fileSize
+        }
+      })
+
+      ctx.body = createSuccessResponse({
+        files: unusedFiles,
+        totalSize,
+        count: unusedFiles.length,
+      })
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 清理未使用文件
+  router.post('/cgi-bin/mockbubu/cleanup-unused-files', validate({
+    confirmation: (val) => {
+      if (val !== 'DELETE') {
+        throw new Error('必须输入 DELETE 确认删除操作')
+      }
+      return null
+    },
+  }), (ctx) => {
+    try {
+      const { localStorage } = ctx.req
+      const { groupManager } = ctx
+
+      const allFiles = localStorage.getFileList()
+      const groups = groupManager.getGroups()
+      let deleted = 0
+      let freedSpace = 0
+
+      allFiles.forEach(item => {
+        const filename = item.name
+
+        let hasConfig = false
+        let allMockDisabled = true
+        let allLocked = false
+        let allNoCustomVersions = true
+
+        // 检查所有组的配置
+        groups.forEach(group => {
+          if (groupManager.hasGroupConfig(group.id, filename)) {
+            hasConfig = true
+
+            const config = groupManager.getGroupFileConfig(group.id, filename)
+
+            if (config.mock) {
+              allMockDisabled = false
+            }
+
+            if (config.locked) {
+              allLocked = true
+            }
+
+            const versions = groupManager.getGroupVersions(group.id, filename)
+            const customVersions = versions.filter(v => v.filename !== 'source')
+            if (customVersions.length > 0) {
+              allNoCustomVersions = false
+            }
+          }
+        })
+
+        // 删除未使用文件：所有组未开启mock + 所有组未锁定 + 所有组无自定义版本
+        if (hasConfig && allMockDisabled && !allLocked && allNoCustomVersions) {
+          const file = localStorage.readFile(filename)
+          const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+          // 删除物理文件（Layer 1）
+          removeFile(localStorage, filename)
+
+          // 删除所有组的配置（Layer 3）
+          groups.forEach(group => {
+            groupManager.removeGroupFileConfig(group.id, filename)
+          })
+
+          deleted++
+          freedSpace += fileSize
+        }
+      })
+
+      const freedSpaceMB = (freedSpace / (1024 * 1024)).toFixed(2)
+      ctx.body = createSuccessResponse({
+        deleted,
+        freedSpace,
+      }, `成功清理 ${deleted} 个未使用文件，释放 ${freedSpaceMB} MB 存储空间`)
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
     }