whistle.mockbubu 1.0.0-dev.4 → 2.0.0-beta.0

package/lib/uiServer/router/index.js

@@ -1,10 +1,7 @@
 const {
   updateFile,
-  removeFile,
-  writeFile,
   readFile,
-  setProperty,
-  getProperty,
+  readSession,
   getApiListUpdated,
   setApiListUpdated,
 } = require('../../utils')
@@ -14,23 +11,46 @@ const {
   handleFilterList,
   getFullDataList,
 } = require('../util')
+const {
+  validateFilename,
+  validateMockData,
+  validateBoolean,
+  validateRuleValue,
+  validate,
+} = require('../validator')
 const versionRouter = require('./version-router')
+const groupRouter = require('./group-router')
+const {
+  createTarGz,
+  extractTarGz,
+  parseMultipartFile,
+  sanitizeFilename,
+} = require('../../archive-utils')
+const fs = require('fs').promises
+const path = require('path')
+const os = require('os')
 
 module.exports = (router) => {
   // 文件版本路由
   versionRouter(router)
+  // 组管理路由
+  groupRouter(router)
 
   // 获取列表数据接口
   router.post('/cgi-bin/mockbubu/api-list', async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { storageAdapter, groupManager } = ctx
 
+      // 获取当前激活的组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+
+      // 从当前组读取数据
       const filteredList = handleFilterList(
-        getFullDataList(localStorage),
+        await getFullDataList(storageAdapter, groupManager, currentGroupId),
         ctx.request.body,
       )
 
-      setApiListUpdated(localStorage, false)
+      await setApiListUpdated(storageAdapter, false)
       ctx.body = createSuccessResponse(filteredList || [])
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -38,10 +58,10 @@ module.exports = (router) => {
   })
 
   // 检测接口是否更新
-  router.get('/cgi-bin/mockbubu/check-api-list', (ctx) => {
+  router.get('/cgi-bin/mockbubu/check-api-list', async (ctx) => {
     try {
-      const { localStorage } = ctx.req
-      const updated = getApiListUpdated(localStorage)
+      const { storageAdapter } = ctx
+      const updated = await getApiListUpdated(storageAdapter)
       ctx.body = createSuccessResponse(updated)
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -49,17 +69,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,
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { storageAdapter } = ctx
+      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 = await groupManager.getCurrentGroupId()
+
+      updateFile(storageAdapter, name, data, currentGroupId)
+      const file = await readFile(storageAdapter, name, currentGroupId)
+      const config = await groupManager.getGroupFileConfig(currentGroupId, name)
 
       ctx.body = createSuccessResponse({
-        ...props,
+        ...config,
         name,
         data: file,
       })
@@ -69,18 +95,25 @@ module.exports = (router) => {
   })
 
   // 获取文件详情接口
-  router.post('/cgi-bin/mockbubu/get-api-data', (ctx) => {
+  router.post('/cgi-bin/mockbubu/get-api-data', validate({
+    name: validateFilename,
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
       const { name } = ctx.request.body
 
-      const file = readFile(localStorage, name)
-      const props = getProperty(localStorage, name) || {}
+      const currentGroupId = await groupManager.getCurrentGroupId()
+
+      const file = await readFile(storageAdapter, name, currentGroupId)
+      const session = await readSession(storageAdapter, name, currentGroupId)
+      const config = await groupManager.getGroupFileConfig(currentGroupId, name)
 
       ctx.body = createSuccessResponse({
-        ...props,
+        ...config,
         name,
         data: file,
+        session, // 包含完整的 req 和 res 数据
       })
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -88,17 +121,50 @@ 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,
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
       const { name, content, ruleValue } = ctx.request.body
 
-      writeFile({
-        storage: localStorage,
-        filename: name,
-        body: content,
-        properties: { ruleValue, mock: true },
-      })
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+
+      // 完全隔离架构：检查当前组的文件是否存在
+      const filePath = `${currentGroupId}/${name}`
+      const fileExists = !!await storageAdapter.readFile(filePath)
+
+      // 创建文件到当前组目录
+      if (!fileExists) {
+        const session = {
+          req: {
+            method: 'GET',
+            url: name,
+            headers: {},
+          },
+          res: {
+            statusCode: 200,
+            headers: { 'content-type': 'application/json' },
+            body: content, // content 是 JSON 字符串
+          },
+        }
+        await storageAdapter.writeFile(filePath, JSON.stringify(session))
+      }
+
+      // 在当前组配置中添加记录
+      const groupConfig = await 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
+      await 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'),
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, mock } = ctx.request.body
 
-      setProperty(localStorage, name, { mock })
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+      // 获取当前组配置
+      const groupConfig = await groupManager.getGroupFileConfig(currentGroupId, name)
+      // 更新 mock 状态
+      groupConfig.mock = mock
+      groupConfig.mockTime = Date.now()
+      // 写回组配置
+      await groupManager.setGroupFileConfig(currentGroupId, name, groupConfig)
+
       ctx.body = createSuccessResponse(null, '更新成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
@@ -120,50 +198,995 @@ 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'),
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { groupManager } = ctx
       const { name, locked } = ctx.request.body
 
-      setProperty(localStorage, name, { locked })
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+      // 获取当前组配置
+      const groupConfig = await groupManager.getGroupFileConfig(currentGroupId, name)
+      // 更新 locked 状态
+      groupConfig.locked = locked
+      // 写回组配置
+      await 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,
+  }), async (ctx) => {
     try {
-      const { localStorage } = ctx.req
-      const { name } = ctx.request.body
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+      const { name, groupId } = ctx.request.body
+
+      // 优先使用传入的 groupId，否则使用当前组ID
+      const targetGroupId = groupId || await groupManager.getCurrentGroupId()
+
+      // [mockbubu] 单文件删除日志 (delete-api)
+      console.log('[mockbubu] delete-api 开始', new Date().toLocaleString('zh-CN', { hour12: false }))
+      console.log('[mockbubu] 待删除文件:', name)
+      console.log('[mockbubu] 目标组ID:', targetGroupId)
+
+      // ✅ 检查文件是否被锁定
+      const fileConfig = await groupManager.getGroupFileConfig(targetGroupId, name)
+      if (fileConfig && fileConfig.locked) {
+        console.log('[mockbubu] delete-api 失败: 文件已锁定', name)
+        ctx.body = createErrorResponse('文件已锁定，无法删除')
+        return
+      }
+
+      // 完全隔离架构：直接删除物理文件 + 组配置
+      // 注意：storageAdapter.removeFile 是 async 方法，必须 await
+      await storageAdapter.removeFile(`${targetGroupId}/${name}`)
+      await groupManager.removeGroupFileConfig(targetGroupId, name)
+
+      console.log('[mockbubu] delete-api 删除成功:', name)
 
-      removeFile(localStorage, name)
       ctx.body = createSuccessResponse(null, '删除成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
     }
   })
 
-  // 批量删除接口
-  router.post('/cgi-bin/mockbubu/batch-delete-api', (ctx) => {
+  // 批量删除接口（按范围）
+  router.post('/cgi-bin/mockbubu/batch-delete-api', async (ctx) => {
     try {
-      const { localStorage } = ctx.req
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+
+      const filteredList = handleFilterList(
+        await getFullDataList(storageAdapter, 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', // 锁定的文件不可批量删除
+      // [mockbubu] 批量删除日志
+      console.log('[mockbubu] 批量删除开始', new Date().toLocaleString('zh-CN', { hour12: false }))
+      console.log('[mockbubu] 待删除文件数量:', filteredList.length)
+      console.log('[mockbubu] 待删除文件列表:', filteredList.map(f => f.name))
+
+      for (const item of filteredList) {
+        try {
+          console.log('[mockbubu] 正在删除:', item.name)
+          // 直接删除物理文件 + 组配置
+          // 注意：storageAdapter.removeFile 是 async 方法，必须 await
+          await storageAdapter.removeFile(`${currentGroupId}/${item.name}`)
+          await groupManager.removeGroupFileConfig(currentGroupId, item.name)
+          result.success++
+          console.log('[mockbubu] 删除成功:', item.name)
+        } catch (error) {
+          result.failed++
+          result.errors.push({
+            name: item.name,
+            error: error.message,
+          })
+          console.error(`[mockbubu] 删除文件 ${item.name} 失败:`, error.message, error.stack)
+        }
+      }
+
+      console.log('[mockbubu] 批量删除结束', new Date().toLocaleString('zh-CN', { hour12: false }), {
+        total: result.total,
+        success: result.success,
+        failed: result.failed,
       })
-      // 批量删除
-      filteredList.forEach((item) => {
+
+      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-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
+    },
+  }), async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+      const { names } = ctx.request.body
+
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+
+      const result = {
+        total: names.length,
+        success: 0,
+        failed: 0,
+        locked: 0,
+        errors: [],
+      }
+
+      // [mockbubu] 批量删除日志 (batch-delete-by-names)
+      console.log('[mockbubu] batch-delete-by-names 开始', new Date().toLocaleString('zh-CN', { hour12: false }))
+      console.log('[mockbubu] 待删除文件数量:', names.length)
+      console.log('[mockbubu] 待删除文件列表:', names)
+
+      for (const name of names) {
         try {
-          removeFile(localStorage, item.name)
+          console.log('[mockbubu] 正在处理:', name)
+          // 从当前组配置检查文件是否锁定
+          const groupConfig = await groupManager.getGroupFileConfig(currentGroupId, name)
+          if (groupConfig.locked) {
+            console.log('[mockbubu] 文件已锁定，跳过:', name)
+            result.locked++
+            result.errors.push({ name, error: '文件已锁定' })
+            continue
+          }
+
+          // 完全隔离架构：直接删除物理文件 + 组配置
+          // 注意：storageAdapter.removeFile 是 async 方法，必须 await
+          await storageAdapter.removeFile(`${currentGroupId}/${name}`)
+          await groupManager.removeGroupFileConfig(currentGroupId, name)
+
+          result.success++
+          console.log('[mockbubu] 删除成功:', name)
         } catch (error) {
-          console.error(`删除文件 ${item.name} 失败:`, error.message)
+          result.failed++
+          result.errors.push({ name, error: error.message })
+          console.error(`[mockbubu] 删除文件 ${name} 失败:`, error.message, error.stack)
         }
+      }
+
+      console.log('[mockbubu] batch-delete-by-names 结束', new Date().toLocaleString('zh-CN', { hour12: false }), {
+        total: result.total,
+        success: result.success,
+        failed: result.failed,
+        locked: result.locked,
       })
 
-      ctx.body = createSuccessResponse(null, '删除成功')
+      // 返回结果
+      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'),
+  }), async (ctx) => {
+    try {
+      const { groupManager } = ctx
+      const { names, mock } = ctx.request.body
+
+      // 获取当前组ID
+      const currentGroupId = await groupManager.getCurrentGroupId()
+      const errors = []
+      const mockTime = Date.now()
+
+      for (const name of names) {
+        try {
+          // 获取当前组配置
+          const groupConfig = await groupManager.getGroupFileConfig(currentGroupId, name)
+          // 更新 mock 状态
+          groupConfig.mock = mock
+          groupConfig.mockTime = mockTime
+          // 写回组配置
+          await 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)
+    }
+  })
+
+  // ==================== 压缩包导出/导入功能 ====================
+
+  /**
+   * 导出当前组为压缩包（仅导出含版本的文件）
+   * POST /cgi-bin/mockbubu/export-group-archive
+   */
+  router.post('/cgi-bin/mockbubu/export-group-archive', async (ctx) => {
+    console.log('[mockbubu 2025/11/19 16:30:00] 开始导出压缩包')
+
+    try {
+      const { groupManager, storageAdapter } = ctx
+      const currentGroupId = await groupManager.getCurrentGroupId()
+      const currentGroup = await groupManager.getCurrentGroup()
+      const v3Storage = storageAdapter.v3Storage
+
+      console.log(`[mockbubu 2025/11/19 16:30:00] 当前组: ${currentGroup.name} (${currentGroupId})`)
+
+      // 1. 读取索引
+      const index = await v3Storage.getIndex(currentGroupId)
+      console.log(`[mockbubu 2025/11/19 16:30:00] 索引文件总数: ${index.files.length}`)
+
+      // 2. 筛选含版本的文件
+      const filesWithVersions = []
+      for (const fileEntry of index.files) {
+        const versions = await v3Storage.listVersions(currentGroupId, fileEntry.id)
+        if (versions.length > 0) {
+          filesWithVersions.push({
+            ...fileEntry,
+            versionCount: versions.length,
+          })
+        }
+      }
+
+      console.log(`[mockbubu 2025/11/19 16:30:00] 含版本的文件数: ${filesWithVersions.length}`)
+
+      if (filesWithVersions.length === 0) {
+        ctx.body = createErrorResponse('当前组没有包含版本的文件，无法导出')
+        return
+      }
+
+      // 3. 创建临时目录
+      const tmpDir = path.join(os.tmpdir(), `mockbubu-export-${Date.now()}-${Math.random().toString(36).slice(2)}`)
+      const exportDir = path.join(tmpDir, 'export')
+      const filesDir = path.join(exportDir, 'files')
+      await fs.mkdir(filesDir, { recursive: true })
+
+      console.log(`[mockbubu 2025/11/19 16:30:00] 临时目录: ${tmpDir}`)
+
+      try {
+        // 4. 复制文件
+        for (const fileEntry of filesWithVersions) {
+          const sourceFileDir = path.join(v3Storage.groupsDir, currentGroupId, 'files', fileEntry.id)
+          const targetFileDir = path.join(filesDir, fileEntry.id)
+
+          // 递归复制文件目录（包括 file.json 和 versions/）
+          await v3Storage._copyDirectory(sourceFileDir, targetFileDir)
+          console.log(`[mockbubu 2025/11/19 16:30:00] 已复制文件: ${fileEntry.url} (${fileEntry.id})`)
+        }
+
+        // 5. 创建导出元数据
+        const exportMeta = {
+          exportTime: new Date().toISOString(),
+          exportVersion: '3.0.0',
+          groupName: currentGroup.name,
+          groupDescription: currentGroup.description || '',
+          fileCount: filesWithVersions.length,
+          files: filesWithVersions.map(f => ({
+            id: f.id,
+            url: f.url,
+            method: f.method,
+            versionCount: f.versionCount,
+          })),
+        }
+
+        await fs.writeFile(
+          path.join(exportDir, 'export-meta.json'),
+          JSON.stringify(exportMeta, null, 2),
+          'utf8',
+        )
+
+        console.log('[mockbubu 2025/11/19 16:30:00] 元数据已写入')
+
+        // 6. 创建压缩包
+        const archiveName = sanitizeFilename(`${currentGroup.name}-${Date.now()}.tar.gz`)
+        const archivePath = path.join(tmpDir, archiveName)
+
+        await createTarGz(exportDir, archivePath)
+        console.log(`[mockbubu 2025/11/19 16:30:00] 压缩包已创建: ${archivePath}`)
+
+        // 7. 读取压缩包内容
+        const archiveBuffer = await fs.readFile(archivePath)
+        console.log(`[mockbubu 2025/11/19 16:30:00] 压缩包大小: ${(archiveBuffer.length / 1024).toFixed(2)} KB`)
+
+        // 8. 返回压缩包
+        ctx.set('Content-Type', 'application/gzip')
+        ctx.set('Content-Disposition', `attachment; filename="${encodeURIComponent(archiveName)}"`)
+        ctx.body = archiveBuffer
+
+        // 9. 清理临时目录（异步执行，不阻塞响应）
+        fs.rm(tmpDir, { recursive: true, force: true }).catch(err => {
+          console.error(`[mockbubu 2025/11/19 16:30:00] 清理临时目录失败: ${err.message}`)
+        })
+
+        console.log('[mockbubu 2025/11/19 16:30:00] 导出完成')
+      } catch (err) {
+        // 出错时清理临时目录
+        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {})
+        throw err
+      }
+    } catch (error) {
+      console.error('[mockbubu 2025/11/19 16:30:00] 导出失败:', error.message)
+      ctx.set('Content-Type', 'application/json')
+      ctx.body = createErrorResponse(`导出失败: ${error.message}`)
+    }
+  })
+
+  /**
+   * 导入压缩包到新组
+   * POST /cgi-bin/mockbubu/import-group-archive
+   * Content-Type: multipart/form-data
+   */
+  router.post('/cgi-bin/mockbubu/import-group-archive', async (ctx) => {
+    console.log('[mockbubu 2025/11/19 16:30:00] 开始导入压缩包')
+
+    try {
+      const { storageAdapter } = ctx
+      const v3Storage = storageAdapter.v3Storage
+
+      // 1. 解析上传的文件
+      const file = await parseMultipartFile(ctx)
+      if (!file || !file.buffer) {
+        ctx.body = createErrorResponse('未检测到上传文件')
+        return
+      }
+
+      console.log(`[mockbubu 2025/11/19 16:30:00] 上传文件: ${file.filename}, 大小: ${(file.buffer.length / 1024).toFixed(2)} KB`)
+
+      // 2. 创建临时目录
+      const tmpDir = path.join(os.tmpdir(), `mockbubu-import-${Date.now()}-${Math.random().toString(36).slice(2)}`)
+      const extractDir = path.join(tmpDir, 'extract')
+      await fs.mkdir(extractDir, { recursive: true })
+
+      console.log(`[mockbubu 2025/11/19 16:30:00] 临时目录: ${tmpDir}`)
+
+      try {
+        // 3. 保存上传的压缩包
+        const uploadPath = path.join(tmpDir, 'upload.tar.gz')
+        await fs.writeFile(uploadPath, file.buffer)
+
+        // 4. 解压
+        await extractTarGz(uploadPath, extractDir)
+        console.log('[mockbubu 2025/11/19 16:30:00] 解压完成')
+
+        // 5. 读取导出元数据
+        const exportMetaPath = path.join(extractDir, 'export-meta.json')
+        const exportMetaContent = await fs.readFile(exportMetaPath, 'utf8')
+        const exportMeta = JSON.parse(exportMetaContent)
+
+        console.log(`[mockbubu 2025/11/19 16:30:00] 导出元数据: 组名=${exportMeta.groupName}, 文件数=${exportMeta.fileCount}`)
+
+        // 6. 生成新组名（处理冲突）
+        let newGroupName = exportMeta.groupName
+        let suffix = 1
+        const allGroups = await v3Storage.listGroups()
+        const existingNames = allGroups.map(g => g.name)
+
+        while (existingNames.includes(newGroupName)) {
+          newGroupName = `${exportMeta.groupName} (${suffix})`
+          suffix++
+        }
+
+        console.log(`[mockbubu 2025/11/19 16:30:00] 新组名: ${newGroupName}`)
+
+        // 7. 生成新组ID（确保唯一）
+        let newGroupId = newGroupName.toLowerCase().replace(/[^a-z0-9]/g, '-')
+        const existingIds = allGroups.map(g => g.id)
+
+        if (existingIds.includes(newGroupId)) {
+          newGroupId = `${newGroupId}-${Date.now()}`
+        }
+
+        console.log(`[mockbubu 2025/11/19 16:30:00] 新组ID: ${newGroupId}`)
+
+        // 8. 创建新组
+        await v3Storage.createGroup({
+          id: newGroupId,
+          name: newGroupName,
+          description: exportMeta.groupDescription || `从【${exportMeta.groupName}】导入`,
+        })
+
+        console.log('[mockbubu 2025/11/19 16:30:00] 新组已创建')
+
+        // 9. 复制文件到新组
+        const sourceFilesDir = path.join(extractDir, 'files')
+        const targetFilesDir = path.join(v3Storage.groupsDir, newGroupId, 'files')
+        await fs.mkdir(targetFilesDir, { recursive: true })
+
+        const importedFiles = []
+        for (const fileMeta of exportMeta.files) {
+          const sourceFileDir = path.join(sourceFilesDir, fileMeta.id)
+          const targetFileDir = path.join(targetFilesDir, fileMeta.id)
+
+          // 检查源文件是否存在
+          try {
+            await fs.access(sourceFileDir)
+            await v3Storage._copyDirectory(sourceFileDir, targetFileDir)
+
+            importedFiles.push(fileMeta)
+            console.log(`[mockbubu 2025/11/19 16:30:00] 已导入文件: ${fileMeta.url} (${fileMeta.id})`)
+          } catch (err) {
+            console.error(`[mockbubu 2025/11/19 16:30:00] 导入文件失败: ${fileMeta.id}`, err.message)
+          }
+        }
+
+        // 10. 重建索引
+        await v3Storage.rebuildIndex(newGroupId)
+        console.log('[mockbubu 2025/11/19 16:30:00] 索引已重建')
+
+        // 11. 清理临时目录
+        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {})
+
+        console.log('[mockbubu 2025/11/19 16:30:00] 导入完成')
+
+        ctx.body = createSuccessResponse(
+          {
+            groupId: newGroupId,
+            groupName: newGroupName,
+            fileCount: importedFiles.length,
+          },
+          `成功导入到新组【${newGroupName}】，共 ${importedFiles.length} 个文件`,
+        )
+      } catch (err) {
+        // 出错时清理临时目录
+        await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {})
+        throw err
+      }
+    } catch (error) {
+      console.error('[mockbubu 2025/11/19 16:30:00] 导入失败:', error.message)
+      ctx.body = createErrorResponse(`导入失败: ${error.message}`)
+    }
+  })
+
+  // ==================== 存储管理功能 ====================
+
+  // 获取存储统计信息
+  router.get('/cgi-bin/mockbubu/storage-stats', async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      // 获取所有物理文件
+      const allFiles = storageAdapter.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 = {}
+      for (const group of groups) {
+        groupsFileCount[group.id] = 0
+      }
+
+      // 遍历所有文件统计
+      for (const item of allFiles) {
+        const filename = item.name
+        let hasConfig = false
+
+        // 读取文件大小
+        const file = await storageAdapter.readFile(filename)
+        if (file) {
+          const fileSize = Buffer.byteLength(file, 'utf8')
+          totalSize += fileSize
+          originalDataSize += fileSize
+        }
+
+        // 检查各组配置
+        for (const group of groups) {
+          // 使用 hasGroupConfig 直接检查配置是否存在
+          const hasActualConfig = await groupManager.hasGroupConfig(group.id, filename)
+
+          if (hasActualConfig) {
+            hasConfig = true
+            groupsFileCount[group.id]++
+
+            // 获取配置详情用于统计
+            const config = await groupManager.getGroupFileConfig(group.id, filename)
+
+            // 统计 mock 状态
+            if (config.mock) {
+              stats.mockEnabled++
+            } else {
+              stats.mockDisabled++
+            }
+
+            // 统计锁定状态
+            if (config.locked) {
+              stats.locked++
+            }
+
+            // 统计版本数据大小
+            const versions = await groupManager.getGroupVersions(group.id, filename)
+            for (const version of versions) {
+              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
+
+          for (const group of groups) {
+            if (await groupManager.hasGroupConfig(group.id, filename)) {
+              const config = await groupManager.getGroupFileConfig(group.id, filename)
+
+              if (config.mock) {
+                allMockDisabled = false
+              }
+
+              if (config.locked) {
+                allLocked = true
+              }
+
+              const versions = await 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', async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      const allFiles = storageAdapter.getFileList()
+      const orphanFiles = []
+      let totalSize = 0
+
+      for (const item of allFiles) {
+        try {
+          // 解码文件名: {index}.{encodedName} -> groupId/filename
+          const decodedName = decodeURIComponent(item.name)
+
+          // 提取 groupId 和纯文件名
+          const slashIndex = decodedName.indexOf('/')
+          if (slashIndex === -1) {
+            // 文件名格式不正确，跳过
+            continue
+          }
+
+          const groupId = decodedName.substring(0, slashIndex)
+          const pureFilename = decodedName.substring(slashIndex + 1)
+
+          // 检查该组是否有配置
+          const hasConfig = await groupManager.hasGroupConfig(groupId, pureFilename)
+
+          // 是孤儿文件：物理文件存在但没有组配置
+          if (!hasConfig) {
+            const file = await storageAdapter.readFile(item.name)
+            const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+            orphanFiles.push({
+              name: item.name, // 原始编码文件名
+              pureFilename, // 纯文件名
+              groupId, // 所属组
+              url: pureFilename, // URL 就是纯文件名
+              size: fileSize,
+            })
+
+            totalSize += fileSize
+          }
+        } catch (err) {
+          console.warn(`[mockbubu] 处理文件 ${item.name} 失败:`, err.message)
+        }
+      }
+
+      ctx.body = createSuccessResponse({
+        files: orphanFiles,
+        totalSize,
+        count: orphanFiles.length,
+      })
+    } catch (error) {
+      ctx.body = createErrorResponse(error.message)
+    }
+  })
+
+  // 清理孤儿文件
+  router.post('/cgi-bin/mockbubu/cleanup-orphan-files', async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      const allFiles = storageAdapter.getFileList()
+      let deleted = 0
+      let freedSpace = 0
+
+      for (const item of allFiles) {
+        try {
+          // 解码文件名: {index}.{encodedName} -> groupId/filename
+          const decodedName = decodeURIComponent(item.name)
+
+          // 提取 groupId 和纯文件名
+          const slashIndex = decodedName.indexOf('/')
+          if (slashIndex === -1) {
+            // 文件名格式不正确，跳过
+            continue
+          }
+
+          const groupId = decodedName.substring(0, slashIndex)
+          const pureFilename = decodedName.substring(slashIndex + 1)
+
+          // 检查该组是否有配置
+          const hasConfig = await groupManager.hasGroupConfig(groupId, pureFilename)
+
+          // 删除孤儿文件：物理文件存在但没有组配置
+          if (!hasConfig) {
+            const file = await storageAdapter.readFile(item.name)
+            const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+            // 删除物理文件（使用原始编码文件名）
+            await storageAdapter.removeFile(item.name)
+
+            deleted++
+            freedSpace += fileSize
+          }
+        } catch (err) {
+          console.warn(`[mockbubu] 处理文件 ${item.name} 失败:`, err.message)
+        }
+      }
+
+      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', async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      const allFiles = storageAdapter.getFileList()
+      const unusedFiles = []
+      let totalSize = 0
+
+      for (const item of allFiles) {
+        try {
+          // 解码文件名: {index}.{encodedName} -> groupId/filename
+          const decodedName = decodeURIComponent(item.name)
+
+          // 提取 groupId 和纯文件名
+          const slashIndex = decodedName.indexOf('/')
+          if (slashIndex === -1) {
+            continue
+          }
+
+          const groupId = decodedName.substring(0, slashIndex)
+          const pureFilename = decodedName.substring(slashIndex + 1)
+
+          // 检查该文件所属的组是否有配置
+          if (!await groupManager.hasGroupConfig(groupId, pureFilename)) {
+            // 没有配置，是孤儿文件，不是未使用文件
+            continue
+          }
+
+          const config = await groupManager.getGroupFileConfig(groupId, pureFilename)
+
+          // 检查是否为未使用文件：未开启mock + 未锁定 + 无自定义版本
+          const isMockDisabled = !config.mock
+          const isNotLocked = !config.locked
+          const versions = await groupManager.getGroupVersions(groupId, pureFilename)
+          const customVersions = versions.filter(v => v.filename !== 'source')
+          const hasNoCustomVersions = customVersions.length === 0
+
+          if (isMockDisabled && isNotLocked && hasNoCustomVersions) {
+            const file = await storageAdapter.readFile(item.name)
+            const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+            unusedFiles.push({
+              name: item.name, // 原始编码文件名
+              pureFilename, // 纯文件名
+              groupId, // 所属组
+              url: pureFilename,
+              size: fileSize,
+              mock: config.mock,
+              locked: config.locked,
+            })
+
+            totalSize += fileSize
+          }
+        } catch (err) {
+          console.warn(`[mockbubu] 处理文件 ${item.name} 失败:`, err.message)
+        }
+      }
+
+      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
+    },
+  }), async (ctx) => {
+    try {
+      const { storageAdapter } = ctx
+      const { groupManager } = ctx
+
+      const allFiles = storageAdapter.getFileList()
+      let deleted = 0
+      let freedSpace = 0
+
+      for (const item of allFiles) {
+        try {
+          // 解码文件名: {index}.{encodedName} -> groupId/filename
+          const decodedName = decodeURIComponent(item.name)
+
+          // 提取 groupId 和纯文件名
+          const slashIndex = decodedName.indexOf('/')
+          if (slashIndex === -1) {
+            continue
+          }
+
+          const groupId = decodedName.substring(0, slashIndex)
+          const pureFilename = decodedName.substring(slashIndex + 1)
+
+          // 检查该文件所属的组是否有配置
+          if (!await groupManager.hasGroupConfig(groupId, pureFilename)) {
+            // 没有配置，是孤儿文件，不是未使用文件
+            continue
+          }
+
+          const config = await groupManager.getGroupFileConfig(groupId, pureFilename)
+
+          // 检查是否为未使用文件：未开启mock + 未锁定 + 无自定义版本
+          const isMockDisabled = !config.mock
+          const isNotLocked = !config.locked
+          const versions = await groupManager.getGroupVersions(groupId, pureFilename)
+          const customVersions = versions.filter(v => v.filename !== 'source')
+          const hasNoCustomVersions = customVersions.length === 0
+
+          if (isMockDisabled && isNotLocked && hasNoCustomVersions) {
+            const file = await storageAdapter.readFile(item.name)
+            const fileSize = file ? Buffer.byteLength(file, 'utf8') : 0
+
+            // 删除物理文件（使用原始编码文件名）
+            await storageAdapter.removeFile(item.name)
+
+            // 删除该组的配置（Layer 3）
+            await groupManager.removeGroupFileConfig(groupId, pureFilename)
+
+            deleted++
+            freedSpace += fileSize
+          }
+        } catch (err) {
+          console.warn(`[mockbubu] 处理文件 ${item.name} 失败:`, err.message)
+        }
+      }
+
+      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/memory-stats', async (ctx) => {
+    try {
+      const v8 = require('v8')
+      const memoryUsage = process.memoryUsage()
+      const heapStats = v8.getHeapStatistics()
+      const heapSpaces = v8.getHeapSpaceStatistics()
+
+      // 格式化字节为 MB
+      const formatMB = (bytes) => (bytes / 1024 / 1024).toFixed(2)
+
+      // New Space 和 Old Space
+      const newSpace = heapSpaces.find(space => space.space_name === 'new_space')
+      const oldSpace = heapSpaces.find(space => space.space_name === 'old_space')
+
+      // 计算使用率
+      const heapUsagePercent = ((heapStats.used_heap_size / heapStats.heap_size_limit) * 100).toFixed(2)
+
+      ctx.body = createSuccessResponse({
+        // 总体堆内存
+        heap: {
+          used: formatMB(heapStats.used_heap_size),
+          total: formatMB(heapStats.total_heap_size),
+          limit: formatMB(heapStats.heap_size_limit),
+          usagePercent: heapUsagePercent,
+        },
+        // New Space (Young Generation)
+        newSpace: newSpace
+          ? {
+            size: formatMB(newSpace.space_size),
+            used: formatMB(newSpace.space_used_size),
+            usagePercent: ((newSpace.space_used_size / newSpace.space_size) * 100).toFixed(2),
+            available: formatMB(newSpace.space_available_size),
+            physical: formatMB(newSpace.physical_space_size),
+          }
+          : null,
+        // Old Space (Old Generation)
+        oldSpace: oldSpace
+          ? {
+            size: formatMB(oldSpace.space_size),
+            used: formatMB(oldSpace.space_used_size),
+            usagePercent: ((oldSpace.space_used_size / oldSpace.space_size) * 100).toFixed(2),
+            available: formatMB(oldSpace.space_available_size),
+            physical: formatMB(oldSpace.physical_space_size),
+          }
+          : null,
+        // 进程总内存
+        process: {
+          rss: formatMB(memoryUsage.rss),
+          heapUsed: formatMB(memoryUsage.heapUsed),
+          heapTotal: formatMB(memoryUsage.heapTotal),
+          external: formatMB(memoryUsage.external),
+          arrayBuffers: formatMB(memoryUsage.arrayBuffers),
+        },
+        // GC 统计
+        gc: {
+          mallocedMemory: formatMB(heapStats.malloced_memory),
+          peakMalloced: formatMB(heapStats.peak_malloced_memory),
+          nativeContexts: heapStats.number_of_native_contexts,
+          detachedContexts: heapStats.number_of_detached_contexts,
+        },
+        // 时间戳
+        timestamp: new Date().toISOString(),
+        pid: process.pid,
+      }, '内存统计数据获取成功')
     } catch (error) {
       ctx.body = createErrorResponse(error.message)
     }