feat(frontend): 管理端改用 Gi Admin Pro 框架 + 腾讯云主题

前端此前只有本地实现、从未入库，本次首次纳入版本管理。

框架切换
  · 以 Gi Admin Pro（Vue3 + Vite + TS + Arco Design Vue + Pinia）为底
  · 剥离 14 个演示页面目录 / 121 个文件（demo 28、file 20、form 19、system 18…）
  · 依赖 dependencies 35 → 19，devDependencies 31 → 27
  · 保留框架核心：layout、Gi* 组件库、hooks、权限指令、错误页、登录页

主题：腾讯云 / TDesign 官方色板
  · 主色 #0052D9（腾讯蓝）、成功 #00A870、警告 #ED7B2F、危险 #E34D59
  · 页面底色 #f3f3f3、文字 rgba(0,0,0,90/60/40/26%)
  · 覆盖 Arco 底层色板 + 显式语义别名（primary/success/warning/danger/link/neutral）
  · 三个改了不生效也不报错的坑已记入注释：
      1) Arco 色值是逗号分隔 RGB 三元组，不是 #RRGGBB
      2) Arco 把色板定义在 body 而非 :root，必须写 `:root, body`
      3) setting.json 的 themeColor 会以内联样式写进 body，优先级高于样式表

对接后端（三处契约差异在 @/utils/http 统一适配）
  · 响应信封 {code,msg,data} → {code,success,message,data}
  · Token 头 token → Authorization: Bearer
  · 分页 {list,total} → 补一份 records，list 原样保留
  · 40101 → 登录页；登录密码 RSA 加密（公钥走 /auth/public-key，轮换无需重建前端）
  · 路由：后端只下发菜单键，前端在本地路由表上过滤（有哪些页面归代码，谁能看归后端）

已实现页面（浏览器实测通过）
  · 登录：RSA 加密 + 自适应验证码/租户码 + 账号锁定提示
  · 工作台：真实数据（组织 6 个 / 角色 1 个 / 权限 25 项）
  · 组织架构：三级树 + CRUD + 占用校验
  · 租户管理：开通租户 + 初始密码只显示一次的强确认
  · 待建页：未实现菜单显示所属里程碑
  · 权限菜单：学校管理员看不到「租户管理」

视觉资产按腾讯云主题重做
  · logo.svg（渐变圆角方 + 填）、favicon.svg（小尺寸做减法）、login-hero.svg（材料归集）
  · 登录页点阵纹理走主题变量，换主色自动跟随
  · 文案改为产品实际能力：自动改名 / 强制压缩 / 隐私保护

清理模板遗留（约 17MB + 三处外部依赖）
  · 百度统计脚本（上报到 gi-demo 作者的统计账号）
  · 用户菜单「项目地址」（跳转模板作者的 Gitee 仓库）
  · 两份 8.8MB mp3、388KB favicon.ico、57KB 模板插画、未引用字体与 loading.gif
  · 「个人中心」指向已删除的 /system/account（点了 404）
  · 头部头像在无 avatarUrl 时渲染成裂图 → 改为姓名首字兜底

后端修复
  · 新增 GET /auth/public-key（前端加密登录密码用）
  · DataSeeder.ancestor_path 生成错误：子节点本该是 /16/17/ 却写成 /17/
    该字段是「按院系统计」的索引，错了会漏人/多人且不报错 —— 改为从库里读父节点路径
  · seedDemoOrgs 曾放在租户作用域外 + admin 早退分支之后，导致启动失败 / 永不执行
  · 示范租户补一套三级组织树（1 学校 / 2 院系 / 3 班级），供界面演示

frontend-pc/src/layout/LayoutColumns.vue

@@ -0,0 +1,77 @@
+<template>
+  <div class="layout-columns">
+    <div v-show="isDesktop" class="layout-columns__left">
+      <!-- 左侧一级菜单区域 -->
+      <OneLevelMenu :data="oneLevelMenus" :active-path="oneActivePath"
+        @menu-click="handleOneMenuItemClick($event.path)"></OneLevelMenu>
+
+      <!-- 左侧二级菜单区域 -->
+      <a-menu v-if="twoLevelMenus.length > 1 || oneActiveRoute?.meta?.alwaysShow === true" :key="twoLevelMenuKey"
+        class="layout-columns__menu" :theme="menuTheme" :selected-keys="[twoActivePath]"
+        :accordion="appStore.isMenuAccordion" auto-open-selected :collapsed="appStore.isMenuCollapsed"
+        :style="{ width: '180px' }" @menu-item-click="handleTwoMenuItemClick">
+        <MenuItem v-for="(item, index) in twoLevelMenus" :key="item.path + index" :item="item" />
+      </a-menu>
+    </div>
+
+    <!-- 右侧内容区域 -->
+    <section class="layout-columns__content">
+      <Header />
+      <Tabs v-if="appStore.isTabVisible" />
+      <Main />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useDevice } from '@/hooks'
+import { useLevelMenu } from '@/layout/hooks/useLevelMenu'
+import { useAppStore } from '@/stores'
+import Header from './components/Header/index.vue'
+import Main from './components/Main.vue'
+import MenuItem from './components/Menu/MenuItem.vue'
+import OneLevelMenu from './components/OneLevelMenu/index.vue'
+import Tabs from './components/Tabs/index.vue'
+
+defineOptions({ name: 'LayoutColumns' })
+
+const appStore = useAppStore()
+const { isDesktop } = useDevice()
+
+const twoLevelMenuKey = ref(false)
+const { menuTheme, oneLevelMenus, twoLevelMenus, oneActiveRoute, oneActivePath, twoActivePath, getOneLevelMenus, handleOneMenuItemClick, handleTwoMenuItemClick } = useLevelMenu({
+  oneActivePathChange: () => {
+    setTimeout(() => {
+      twoLevelMenuKey.value = !twoLevelMenuKey.value
+    }, 300)
+  }
+})
+getOneLevelMenus()
+</script>
+
+<style lang="scss" scoped>
+.layout-columns {
+  display: flex;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+
+  &__left {
+    display: flex;
+    height: 100%;
+    overflow: hidden;
+    background-color: var(--color-bg-1);
+  }
+
+  &__menu {
+    border-right: 1px solid var(--color-border-2);
+  }
+
+  &__content {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    overflow: hidden;
+  }
+}
+</style>

frontend-pc/src/layout/LayoutDefault.vue

@@ -0,0 +1,33 @@
+<template>
+  <a-layout class="layout-default">
+    <Asider></Asider>
+    <a-layout class="layout-default__right">
+      <Header></Header>
+      <Tabs v-if="appStore.isTabVisible"></Tabs>
+      <Main></Main>
+    </a-layout>
+  </a-layout>
+</template>
+
+<script setup lang="ts">
+import { useAppStore } from '@/stores'
+import Asider from './components/Asider/index.vue'
+import Header from './components/Header/index.vue'
+import Main from './components/Main.vue'
+import Tabs from './components/Tabs/index.vue'
+
+defineOptions({ name: 'LayoutDefault' })
+
+const appStore = useAppStore()
+</script>
+
+<style lang="scss" scoped>
+.layout-default {
+  flex-direction: row;
+  height: 100%;
+
+  &__right {
+    overflow: hidden;
+  }
+}
+</style>

frontend-pc/src/layout/LayoutMix.vue

@@ -0,0 +1,165 @@
+<!--
+  @file LayoutMix 组件
+  @description 混合布局组件，支持顶部导航和左侧菜单组合的布局方式
+-->
+<template>
+  <div class="layout-mix">
+    <!-- 左侧菜单区域 -->
+    <section v-if="isDesktop" class="layout-mix-left asider" :class="{ 'app-menu-dark': appStore.isMenuDark }"
+      :style="getMenuStyle">
+      <a-layout-sider class="asider__menu" collapsible breakpoint="xl" hide-trigger :width="200"
+        :collapsed="appStore.isMenuCollapsed">
+        <Logo :collapsed="appStore.isMenuCollapsed" />
+        <a-scrollbar outer-class="asider__menu-scroll-view" style="height: 100%; overflow: auto">
+          <a-menu :theme="menuTheme" mode="vertical" auto-open-selected :collapsed="shouldCollapse"
+            :selected-keys="[twoActivePath]" breakpoint="xl" :accordion="appStore.isMenuAccordion"
+            @menu-item-click="handleTwoMenuItemClick">
+            <MenuItem v-for="(item, index) in twoLevelMenus" :key="item.path + index" :item="item" />
+          </a-menu>
+        </a-scrollbar>
+      </a-layout-sider>
+    </section>
+
+    <!-- 右侧内容区域 -->
+    <section class="layout-mix-right">
+      <header class="header" :class="{ 'app-menu-dark': appStore.isMenuDark }" :style="getMenuStyle">
+        <MenuFoldBtn />
+        <a-menu mode="horizontal" :theme="menuTheme" :selected-keys="[oneActivePath]"
+          @menu-item-click="handleOneMenuItemClick">
+          <MenuItem v-for="(item, index) in topMenus" :key="item.path + index" :item="item" />
+        </a-menu>
+        <HeaderRightBar />
+      </header>
+      <Tabs v-if="appStore.isTabVisible" />
+      <Main />
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useDevice } from '@/hooks'
+import { useLevelMenu } from '@/layout/hooks/useLevelMenu'
+import { useAppStore } from '@/stores'
+import HeaderRightBar from './components/HeaderRightBar/index.vue'
+import Logo from './components/Logo.vue'
+import Main from './components/Main.vue'
+import MenuItem from './components/Menu/MenuItem.vue'
+import MenuFoldBtn from './components/MenuFoldBtn.vue'
+import Tabs from './components/Tabs/index.vue'
+
+/** 组件名称 */
+defineOptions({ name: 'LayoutMix' })
+
+const appStore = useAppStore()
+const { isDesktop } = useDevice()
+
+const { menuTheme, getMenuStyle, oneLevelMenus, twoLevelMenus, oneActivePath, twoActivePath, getOneLevelMenus, handleOneMenuItemClick, handleTwoMenuItemClick } = useLevelMenu()
+getOneLevelMenus()
+
+const topMenus = computed(() => {
+  const arr = JSON.parse(JSON.stringify(oneLevelMenus.value))
+  arr.forEach((i) => {
+    delete i.children
+  })
+  return arr
+})
+
+// 是否折叠菜单
+const shouldCollapse = computed(() =>
+  !isDesktop.value ? false : appStore.isMenuCollapsed
+)
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-menu-pop) {
+  white-space: nowrap;
+}
+
+:deep(.arco-menu.arco-menu-vertical.arco-menu-collapsed) {
+
+  // Menu菜单组件修改
+  .arco-menu-icon {
+    padding: 10px 0;
+    margin-right: 0;
+  }
+
+  .arco-menu-has-icon {
+    justify-content: center;
+    padding: 0;
+  }
+
+  .arco-menu-title {
+    display: none;
+  }
+}
+
+:deep(.arco-menu-horizontal) {
+  flex: 1;
+  overflow: hidden;
+
+  .arco-menu-inner {
+    padding-left: 0;
+
+    .arco-menu-overflow-wrap {
+      white-space: nowrap;
+    }
+  }
+}
+
+.layout-mix {
+  display: flex;
+  align-items: stretch;
+  height: 100%;
+  overflow: hidden;
+
+  &-left {
+    overflow: hidden;
+  }
+
+  &-right {
+    display: flex;
+    flex: 1;
+    flex-direction: column;
+    overflow: hidden;
+  }
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 56px;
+  padding: 0 var(--padding);
+  overflow: hidden;
+  color: var(--color-text-1);
+  background-color: var(--color-bg-1);
+  border-bottom: 1px solid var(--color-border);
+}
+
+.asider {
+  z-index: 1000;
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  color: var(--color-text-1);
+  background-color: var(--color-bg-1);
+  border-right: 1px solid var(--color-border-2);
+
+  :deep(.arco-layout-sider-children) {
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+  }
+
+  &__menu {
+    flex: 1;
+    overflow: hidden;
+    background-color: inherit;
+  }
+
+  &__menu-scroll-view {
+    flex: 1;
+    overflow: hidden;
+  }
+}
+</style>

frontend-pc/src/layout/LayoutTop.vue

@@ -0,0 +1,57 @@
+<template>
+  <div class="layout-top">
+    <a-row align="center" class="layout-top__header" :class="{ 'app-menu-dark': appStore.isMenuDark }"
+      :style="getMenuStyle">
+      <Logo></Logo>
+      <a-menu class="layout-top__menu" mode="horizontal" :theme="menuTheme" :menu-trigger-props="menuTriggerProps"
+        :selected-keys="selectedKeys" @menu-item-click="handleMenuItemClick">
+        <MenuItem v-for="(item, index) in menuList" :key="item.path + index" :item="item" />
+      </a-menu>
+      <HeaderRightBar></HeaderRightBar>
+    </a-row>
+    <Tabs v-if="appStore.isTabVisible"></Tabs>
+    <Main></Main>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useMenu } from '@/layout/hooks/useMenu'
+import { useAppStore } from '@/stores'
+import HeaderRightBar from './components/HeaderRightBar/index.vue'
+import Logo from './components/Logo.vue'
+import Main from './components/Main.vue'
+import MenuItem from './components/Menu/MenuItem.vue'
+import Tabs from './components/Tabs/index.vue'
+
+defineOptions({ name: 'LayoutTop' })
+
+const appStore = useAppStore()
+const { menuTheme, menuList, menuTriggerProps, handleMenuItemClick, selectedKeys, getMenuStyle } = useMenu()
+</script>
+
+<style lang="scss" scoped>
+.layout-top {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  overflow: hidden;
+
+  &__header {
+    box-sizing: border-box;
+    width: 100%;
+    padding-right: 16px;
+    overflow: hidden;
+    background-color: var(--color-bg-1);
+    border-bottom: 1px solid var(--color-border);
+  }
+
+  &__menu {
+    flex: 1;
+    overflow: hidden;
+
+    :deep(.arco-menu-inner) {
+      padding-left: 0;
+    }
+  }
+}
+</style>

frontend-pc/src/layout/components/Asider/index.vue

@@ -0,0 +1,79 @@
+<template>
+  <div v-if="isDesktop" class="asider" :class="{ 'app-menu-dark': appStore.isMenuDark }" :style="getMenuStyle">
+    <a-layout-sider class="asider__menu" collapsible breakpoint="xl" hide-trigger :width="220"
+      :collapsed="appStore.isMenuCollapsed" @collapse="handleCollapse">
+      <Logo :collapsed="appStore.isMenuCollapsed"></Logo>
+      <a-scrollbar outer-class="asider__menu-scroll-view" style="height: 100%; overflow: auto">
+        <a-menu :theme="menuTheme" auto-open-selected :menu-trigger-props="menuTriggerProps"
+          :selected-keys="selectedKeys" :collapsed="collapsed" :accordion="appStore.isMenuAccordion"
+          @menu-item-click="handleMenuItemClick">
+          <MenuItem v-for="(item, index) in menuList" :key="item.path + index" :item="item" />
+        </a-menu>
+      </a-scrollbar>
+    </a-layout-sider>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useDevice } from '@/hooks'
+import { useMenu } from '@/layout/hooks/useMenu'
+import { useAppStore } from '@/stores'
+import Logo from '../Logo.vue'
+import MenuItem from '../Menu/MenuItem.vue'
+
+defineOptions({ name: 'AppAsider' })
+const appStore = useAppStore()
+const { isDesktop } = useDevice()
+const { menuTheme, menuList, menuTriggerProps, selectedKeys, collapsed, handleMenuItemClick, getMenuStyle } = useMenu()
+
+const handleCollapse = (isCollapsed: boolean) => {
+  appStore.isMenuCollapsed = isCollapsed
+}
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-menu.arco-menu-vertical.arco-menu-collapsed) {
+
+  // Menu菜单组件修改
+  .arco-menu-icon {
+    padding: 10px 0;
+    margin-right: 0;
+  }
+
+  .arco-menu-has-icon {
+    justify-content: center;
+    padding: 0;
+  }
+
+  .arco-menu-title {
+    display: none;
+  }
+}
+
+:deep(.arco-layout-sider-children) {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+.asider {
+  z-index: 1000;
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  color: var(--color-text-1);
+  background-color: var(--color-bg-1);
+  border-right: 1px solid var(--color-border-2);
+
+  &__menu-scroll-view {
+    flex: 1;
+    overflow: hidden;
+  }
+
+  &__menu {
+    flex: 1;
+    overflow: hidden;
+    background-color: inherit;
+  }
+}
+</style>

frontend-pc/src/layout/components/Breadcrumb/index.vue

@@ -0,0 +1,130 @@
+<!--
+  @file Breadcrumb 组件
+  @description 面包屑导航组件，支持路由导航、动画效果和自定义样式
+-->
+<template>
+  <a-breadcrumb>
+    <transition-group name="breadcrumb">
+      <div v-for="(item, index) in breadcrumbList" :key="item.path + index">
+        <a-breadcrumb-item v-bind="attrs">
+          <template v-if="isLastItem(index) && !hasRedirect(item)">
+            <span class="g-line-1">{{ lastTitle || item.meta.title }}</span>
+          </template>
+          <template v-else>
+            <span class="g-line-1 breadcrumb__item-title" @click="handleLink(item)">
+              {{ item.meta.title }}
+            </span>
+          </template>
+          <icon-right v-if="!isLastItem(index)" />
+        </a-breadcrumb-item>
+      </div>
+    </transition-group>
+  </a-breadcrumb>
+</template>
+
+<script setup lang="ts">
+import type { RouteLocationMatched, RouteLocationNormalized } from 'vue-router'
+import { useRouteListener } from '@/hooks'
+import { useTabsStore } from '@/stores'
+
+/** 组件名称 */
+defineOptions({ name: 'Breadcrumb' })
+
+/** 路由相关 */
+const route = useRoute()
+const router = useRouter()
+const attrs = useAttrs()
+
+const { listenerRouteChange } = useRouteListener()
+const tabsStore = useTabsStore()
+
+/** 首页路由缓存 */
+let homeRoute: RouteLocationMatched | null = null
+
+/** 获取首页路由信息 */
+const getHomeRoute = () => {
+  if (homeRoute) return
+  const allRoutes = router.getRoutes()
+  const obj = allRoutes.find((i) => i.path === '/home')
+  if (obj) {
+    homeRoute = obj
+  }
+}
+
+/** 面包屑列表 */
+const breadcrumbList = ref<RouteLocationMatched[]>([])
+
+/** 获取面包屑列表 */
+const getBreadcrumbList = (to: RouteLocationNormalized) => {
+  getHomeRoute()
+  const arr = to.matched.filter((i) => i.meta.title && i.meta.breadcrumb !== false)
+  if (homeRoute) {
+    breadcrumbList.value = [homeRoute, ...arr]
+  }
+}
+
+/** 判断是否为最后一项 */
+const isLastItem = (index: number) => index === breadcrumbList.value.length - 1
+
+/** 判断是否有重定向 */
+const hasRedirect = (item: RouteLocationMatched) =>
+  item.redirect && item.redirect !== 'noRedirect' && item.redirect !== ''
+
+/** 处理路由跳转 */
+const handleLink = (item: RouteLocationMatched) => {
+  const { redirect, path, children } = item
+  if (redirect === 'noRedirect' && children.length) {
+    const obj = children?.[0]
+    router.push(obj?.meta?.activeMenu || obj.path)
+    return
+  }
+  if (redirect) {
+    router.push(redirect as string)
+    return
+  }
+  router.push(path)
+}
+
+/** 监听路由变化 */
+listenerRouteChange(({ to }) => {
+  if (to.path.startsWith('/redirect/')) return
+  getBreadcrumbList(to)
+}, true)
+
+const lastTitle = computed(() => {
+  return tabsStore.tabList.find((i) => i.path === route.path)?.meta?.title || ''
+})
+</script>
+
+<style lang="scss" scoped>
+/** breadcrumb-transform 面包屑动画 */
+.breadcrumb-enter-active {
+  transition: all 0.2s;
+}
+
+.breadcrumb-enter-from,
+.breadcrumb-leave-active {
+  opacity: 0;
+  transform: translateX(10px);
+}
+
+:deep(.arco-breadcrumb-item) {
+  display: flex;
+  align-items: center;
+  padding: 0;
+
+  .arco-icon-right {
+    margin: 0 4px;
+  }
+}
+
+.breadcrumb__item-title {
+  cursor: pointer;
+  transition: all 0.3s;
+
+  &:hover {
+    font-weight: 600;
+    color: rgb(var(--primary-6));
+  }
+}
+</style>

frontend-pc/src/layout/components/Header/index.vue

@@ -0,0 +1,46 @@
+<template>
+  <a-layout-header class="header">
+    <section class="header__left">
+      <MenuFoldBtn></MenuFoldBtn>
+    </section>
+    <a-row align="center" class="h-full header__right">
+      <a-col :xs="0" :md="10" :lg="10" :xl="12" :xxl="12">
+        <Breadcrumb></Breadcrumb>
+      </a-col>
+      <a-col :xs="24" :md="14" :lg="14" :xl="12" :xxl="12">
+        <a-row justify="end" align="center">
+          <HeaderRightBar></HeaderRightBar>
+        </a-row>
+      </a-col>
+    </a-row>
+  </a-layout-header>
+</template>
+
+<script setup lang="ts">
+import Breadcrumb from '../Breadcrumb/index.vue'
+import HeaderRightBar from '../HeaderRightBar/index.vue'
+import MenuFoldBtn from '../MenuFoldBtn.vue'
+
+defineOptions({ name: 'AppHeader' })
+</script>
+
+<style lang="scss" scoped>
+.arco-dropdown-open .arco-icon-down {
+  transform: rotate(180deg);
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  height: 56px;
+  padding: 0 var(--padding);
+  background: var(--color-bg-1);
+  border-bottom: 1px solid var(--color-neutral-3);
+
+  &__right {
+    flex: 1;
+    margin-left: var(--padding);
+    overflow: hidden;
+  }
+}
+</style>

frontend-pc/src/layout/components/HeaderRightBar/Notice.vue

@@ -0,0 +1,85 @@
+<!--
+  @file Message 组件
+  @description 消息通知组件，包含通知、关注和待办三个标签页
+-->
+<template>
+  <div class="message">
+    <!-- 消息标签页 -->
+    <a-tabs :active-key="activeTab" style="background-color: transparent;" @change="handleTabChange">
+      <a-tab-pane v-for="tab in tabs" :key="tab.key">
+        <template #title>{{ tab.title }}({{ tab.count }})</template>
+      </a-tab-pane>
+    </a-tabs>
+
+    <!-- 消息列表 -->
+    <section class="message-list">
+      <a-comment v-for="item in messageList" :key="item.id" :author="item.name" :content="item.content"
+        :datetime="item.datetime">
+        <template #avatar>
+          <a-avatar>
+            <img :src="item.avatar" :alt="item.name">
+          </a-avatar>
+        </template>
+      </a-comment>
+    </section>
+  </div>
+</template>
+
+<script setup lang="ts">
+import type { TabsInstance } from '@arco-design/web-vue'
+
+/** 组件名称 */
+defineOptions({ name: 'Message' })
+
+/** 消息类型定义 */
+interface MessageItem {
+  id?: string | number
+  name: string
+  datetime: string
+  content: string
+  avatar: string
+  actionText?: string
+}
+
+/** 标签页配置 */
+const tabs = [
+  { key: '1', title: '通知', count: 1 },
+  { key: '2', title: '关注', count: 1 },
+  { key: '3', title: '待办', count: 2 }
+]
+
+/** 组件状态 */
+const activeTab = ref('1')
+
+/** 消息列表数据 */
+const messageList = ref<MessageItem[]>([
+  {
+    id: 1,
+    name: 'Socrates',
+    datetime: '1小时之前',
+    content: 'Comment body content.',
+    avatar: 'https://img1.baidu.com/it/u=1817951587,3188870642&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=500'
+  },
+  {
+    id: 2,
+    name: '木木糖醇',
+    datetime: '2小时之前',
+    content: '关注了你',
+    avatar: 'https://s1.ax1x.com/2022/06/14/XhteeO.jpg'
+  },
+  {
+    id: 3,
+    name: '徐欣',
+    datetime: '2个半小时之前',
+    content: '收藏了你的文章',
+    avatar: 'https://s1.ax1x.com/2022/06/14/XhtSwF.jpg'
+  }
+])
+
+/** 处理标签页切换 */
+const handleTabChange: TabsInstance['onChange'] = (key) => {
+  activeTab.value = key as string
+}
+</script>
+
+<style lang="scss" scoped></style>

frontend-pc/src/layout/components/HeaderRightBar/SettingDrawerPanel.vue

@@ -0,0 +1,168 @@
+<!--
+  @file SettingDrawer 组件
+  @description 系统设置抽屉组件，用于配置系统主题、布局、动画等全局设置
+-->
+<template>
+  <div>
+    <a-space :size="15" direction="vertical" fill>
+      <section>
+        <a-divider orientation="center">系统布局</a-divider>
+        <a-row :gutter="[8, 8]">
+          <a-col v-for="item in LAYOUT_OPTIONS" :key="item.value" :span="8">
+            <LayoutModeItem :mode="item.value" :name="item.label" @click="toggleLayout(item.value)"></LayoutModeItem>
+          </a-col>
+        </a-row>
+      </section>
+
+      <!-- 系统主题设置 -->
+      <section>
+        <a-divider orientation="center">系统主题</a-divider>
+        <a-row justify="center">
+          <ColorPicker theme="dark" :color="appStore.themeColor" :sucker-hide="true" :colors-default="defaultColorList"
+            @change-color="changeColor"></ColorPicker>
+        </a-row>
+      </section>
+
+      <!-- 界面显示设置 -->
+      <section>
+        <a-divider orientation="center">界面显示</a-divider>
+        <a-descriptions :column="1" :align="{ value: 'right' }" :value-style="{ paddingRight: 0 }">
+          <!-- 页签设置 -->
+          <a-descriptions-item label="页签显示">
+            <a-switch v-model="appStore.isTabVisible" />
+          </a-descriptions-item>
+          <a-descriptions-item label="页签风格">
+            <a-select v-model="appStore.tabStyle" placeholder="请选择" :options="TAB_MODE_OPTIONS"
+              :disabled="!appStore.isTabVisible" :trigger-props="{ autoFitPopupMinWidth: true }"
+              :style="{ width: '120px' }">
+            </a-select>
+          </a-descriptions-item>
+
+          <!-- 动画设置 -->
+          <a-descriptions-item label="动画显示">
+            <a-switch v-model="appStore.isTransitionEnabled" />
+          </a-descriptions-item>
+          <a-descriptions-item label="动画效果">
+            <a-select v-model="appStore.transitionName" placeholder="请选择" :options="ANIMATE_MODE_OPTIONS"
+              :disabled="!appStore.isTransitionEnabled" :style="{ width: '120px' }">
+            </a-select>
+          </a-descriptions-item>
+
+          <!-- 菜单设置 -->
+          <a-descriptions-item label="深色菜单">
+            <a-switch v-model="appStore.isMenuDark" />
+          </a-descriptions-item>
+          <a-descriptions-item label="手风琴效果">
+            <a-switch v-model="appStore.isMenuAccordion" />
+          </a-descriptions-item>
+        </a-descriptions>
+      </section>
+    </a-space>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ColorPicker } from 'vue-color-kit'
+import AppSetting from '@/config/setting.json'
+import { useTheme } from '@/hooks'
+import { useAppStore } from '@/stores'
+import LayoutModeItem from './components/LayoutModeItem.vue'
+import 'vue-color-kit/dist/vue-color-kit.css'
+
+/** 组件名称 */
+defineOptions({ name: 'SettingDrawerPanel' })
+
+/** 状态管理 */
+const appStore = useAppStore()
+const { setThemeColor } = useTheme()
+
+type LayoutItem = { label: string, value: App.SettingConfig['layout'] }
+/** 布局选项 */
+const LAYOUT_OPTIONS: LayoutItem[] = [
+  { label: '默认布局', value: 'left' },
+  { label: '顶部布局', value: 'top' },
+  { label: '混合布局', value: 'mix' },
+  { label: '双列布局', value: 'columns' }
+]
+
+type TabItem = { label: string, value: App.SettingConfig['tabStyle'] }
+/** 页签模式选项 */
+const TAB_MODE_OPTIONS: TabItem[] = [
+  { label: '卡片', value: 'card' },
+  { label: '间隔卡片', value: 'card-gutter' },
+  { label: '圆角', value: 'rounded' },
+  { label: '自定义1', value: 'custom1' },
+  { label: '自定义2', value: 'custom2' }
+]
+
+type AnimateItem = { label: string, value: App.SettingConfig['transitionName'] }
+/** 动画模式选项 */
+const ANIMATE_MODE_OPTIONS: AnimateItem[] = [
+  { label: '默认', value: 'zoom-fade' },
+  { label: '滑动', value: 'fade-slide' },
+  { label: '渐变', value: 'fade' },
+  { label: '底部滑出', value: 'fade-bottom' },
+  { label: '缩放消退', value: 'fade-scale' }
+]
+
+/** 初始化设置 */
+const initSetting = () => {
+  const layouts = LAYOUT_OPTIONS.map((i) => i.value)
+  if (!layouts.includes(appStore.layout)) {
+    appStore.layout = AppSetting.layout as App.SettingConfig['layout']
+  }
+  const tabs = TAB_MODE_OPTIONS.map((i) => i.value)
+  if (!tabs.includes(appStore.tabStyle)) {
+    appStore.tabStyle = AppSetting.tabStyle as App.SettingConfig['tabStyle']
+  }
+  const animates = ANIMATE_MODE_OPTIONS.map((i) => i.value)
+  if (!animates.includes(appStore.transitionName)) {
+    appStore.transitionName = AppSetting.transitionName as App.SettingConfig['transitionName']
+  }
+}
+initSetting()
+
+/** 默认主题色列表 */
+const defaultColorList = [
+  '#165DFF',
+  '#409EFF',
+  '#18A058',
+  '#2d8cf0',
+  '#007AFF',
+  '#5ac8fa',
+  '#5856D6',
+  '#536dfe',
+  '#9c27b0',
+  '#AF52DE',
+  '#0096c7',
+  '#00C1D4',
+  '#43a047',
+  '#e53935',
+  '#f4511e',
+  '#6d4c41'
+]
+
+/** 颜色选择器返回值类型 */
+interface ColorObj {
+  hex: string
+  hsv: { h: number, s: number, v: number }
+  rgba: { r: number, g: number, b: number, a: number }
+}
+
+/** 更改主题色 */
+const changeColor = (colorObj: ColorObj) => {
+  if (!/^#[0-9A-Z]{6}/i.test(colorObj.hex)) return
+  setThemeColor(colorObj.hex)
+}
+
+/** 切换布局 */
+const toggleLayout = (layout: App.SettingConfig['layout']) => {
+  appStore.layout = layout
+}
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-descriptions-item-label-block) {
+  color: var(--color-text-1);
+}
+</style>

frontend-pc/src/layout/components/HeaderRightBar/components/LayoutModeItem.vue

@@ -0,0 +1,270 @@
+<!--
+  @file LayoutItem 组件
+  @description 布局切换选项组件，支持左侧布局、顶部布局和混合布局三种模式
+-->
+<template>
+  <div class="layout-mode-item-wrapper w-full">
+    <!-- 布局预览 -->
+    <div class="layout-mode-item"
+      :class="[{ 'is-active': appStore.layout === props.mode }, `layout-mode-item__${props.mode}`]"
+      @click="emit('click')">
+      <!-- 默认布局 -->
+      <template v-if="props.mode === 'left'">
+        <div class="preview-side preview-side--main">
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+        </div>
+        <div class="preview-main">
+          <div class="preview-header"></div>
+          <div class="preview-content">
+            <span class="preview-line"></span>
+            <span class="preview-line is-short"></span>
+            <span class="preview-line is-short"></span>
+          </div>
+        </div>
+      </template>
+
+      <!-- 顶部布局 -->
+      <template v-if="props.mode === 'top'">
+        <div class="preview-topbar">
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+        </div>
+        <div class="preview-content">
+          <span class="preview-line"></span>
+          <span class="preview-line is-short"></span>
+          <span class="preview-line is-short"></span>
+        </div>
+      </template>
+
+      <!-- 混合布局 -->
+      <template v-if="props.mode === 'mix'">
+        <div class="preview-topbar">
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+          <span class="preview-pill"></span>
+        </div>
+        <div class="preview-main preview-main--row">
+          <div class="preview-side preview-side--main">
+            <span class="preview-line"></span>
+            <span class="preview-line"></span>
+            <span class="preview-line"></span>
+          </div>
+          <div class="preview-content">
+            <span class="preview-line"></span>
+            <span class="preview-line is-short"></span>
+            <span class="preview-line is-short"></span>
+          </div>
+        </div>
+      </template>
+
+      <!-- 双列布局 -->
+      <template v-if="props.mode === 'columns'">
+        <div class="preview-side preview-side--ghost"></div>
+        <div class="preview-side preview-side--main">
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+          <span class="preview-line"></span>
+        </div>
+        <div class="preview-main">
+          <div class="preview-content">
+            <span class="preview-line"></span>
+            <span class="preview-line is-short"></span>
+            <span class="preview-line is-short"></span>
+            <span class="preview-line is-short"></span>
+          </div>
+        </div>
+      </template>
+    </div>
+
+    <!-- 布局名称 -->
+    <p class="layout-mode-item__text">{{ props.name }}</p>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useAppStore } from '@/stores'
+
+defineOptions({
+  name: 'LayoutModeItem'
+})
+
+/** Props 默认值 */
+const props = withDefaults(defineProps<Props>(), {
+  mode: 'left'
+})
+
+/** Emits 定义 */
+const emit = defineEmits<{
+  (e: 'click'): void
+}>()
+
+/** 布局模式类型 */
+type LayoutMode = 'left' | 'top' | 'mix' | 'columns'
+
+/** Props 类型定义 */
+interface Props {
+  /** 布局模式 */
+  mode?: LayoutMode
+  /** 布局名称 */
+  name: string
+}
+
+/** 应用状态 */
+const appStore = useAppStore()
+</script>
+
+<style lang="scss" scoped>
+.layout-mode-item-wrapper {
+  width: 100%;
+}
+
+.layout-mode-item {
+  box-sizing: border-box;
+  display: flex;
+  width: 100%;
+  height: 58px;
+  padding: 6px;
+  gap: 4px;
+  overflow: hidden;
+  cursor: pointer;
+  background-color: var(--color-bg-1);
+  border: 2px solid var(--color-border-2);
+  border-radius: 6px;
+  transition: border-color 0.25s ease, box-shadow 0.25s ease;
+
+  &.is-active {
+    border-color: rgb(var(--primary-6));
+    box-shadow: 0 0 5px 3px rgb(var(--primary-2));
+  }
+
+  &__text {
+    margin-top: 5px;
+    font-size: 12px;
+    color: var(--color-text-2);
+    text-align: center;
+  }
+}
+
+.preview-main {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-width: 0;
+  gap: 4px;
+}
+
+.preview-side {
+  display: flex;
+  flex-direction: column;
+  flex-shrink: 0;
+  width: 12px;
+  padding: 3px 2px;
+  gap: 3px;
+  background-color: var(--color-fill-3);
+  border-radius: 2px;
+  box-sizing: border-box;
+}
+
+.preview-side--main {
+  background-color: var(--color-fill-4);
+}
+
+.preview-side--ghost {
+  width: 11px;
+  background-color: var(--color-fill-2);
+}
+
+.preview-header {
+  width: 100%;
+  height: 8px;
+  background-color: var(--color-fill-3);
+  border-radius: 2px;
+}
+
+.preview-topbar {
+  display: flex;
+  width: 100%;
+  height: 10px;
+  padding: 2px 3px;
+  gap: 3px;
+  background-color: var(--color-fill-3);
+  border-radius: 2px;
+  box-sizing: border-box;
+}
+
+.preview-pill {
+  flex: 1;
+  background-color: var(--color-bg-1);
+  border-radius: 1px;
+}
+
+.preview-content {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  justify-content: flex-start;
+  gap: 4px;
+  min-width: 0;
+  padding-right: 1px;
+  box-sizing: border-box;
+
+  .preview-line {
+    height: 6px;
+  }
+}
+
+.preview-line {
+  display: block;
+  height: 5px;
+  width: 100%;
+  background-color: var(--color-fill-2);
+  border-radius: 1px;
+
+  &.is-short {
+    width: 70%;
+  }
+}
+
+.layout-mode-item__top {
+  flex-direction: column;
+
+  .preview-content {
+    padding-top: 2px;
+  }
+}
+
+.layout-mode-item__mix {
+  flex-direction: column;
+
+  .preview-topbar {
+    flex-shrink: 0;
+  }
+
+  .preview-main {
+    flex: 1;
+  }
+
+  .preview-side {
+    width: 12px;
+  }
+}
+
+.preview-main--row {
+  flex-direction: row;
+  gap: 4px;
+}
+
+.layout-mode-item__columns {
+  .preview-main .preview-content {
+    justify-content: center;
+    padding-top: 0;
+  }
+}
+</style>

frontend-pc/src/layout/components/HeaderRightBar/index.vue

@@ -0,0 +1,184 @@
+<!--
+  @file HeaderRightBar 组件
+  @description 头部右侧工具栏组件，包含项目配置、消息通知、全屏切换、主题切换和用户菜单等功能
+-->
+<template>
+  <a-row justify="end" align="center" class="header-right-bar">
+    <a-space size="medium">
+      <!-- 项目配置按钮 -->
+      <a-tooltip content="项目配置" position="bl">
+        <a-button size="mini" class="g-hover-btn" @click="handleOpenSettings">
+          <template #icon>
+            <icon-settings :size="18" />
+          </template>
+        </a-button>
+      </a-tooltip>
+
+      <!-- 消息通知下拉框 -->
+      <a-popover position="bottom" trigger="click">
+        <a-badge :count="9" dot>
+          <a-button size="mini" class="g-hover-btn">
+            <template #icon>
+              <icon-notification :size="18" />
+            </template>
+          </a-button>
+        </a-badge>
+        <template #content>
+          <Notice></Notice>
+        </template>
+      </a-popover>
+
+      <!-- 全屏切换按钮 -->
+      <a-tooltip v-if="!['xs', 'sm'].includes(breakpoint)" content="全屏切换" position="bottom">
+        <a-button size="mini" class="g-hover-btn" @click="toggle">
+          <template #icon>
+            <icon-fullscreen v-if="!isFullscreen" :size="18" />
+            <icon-fullscreen-exit v-else :size="18" />
+          </template>
+        </a-button>
+      </a-tooltip>
+
+      <!-- 暗黑模式切换 -->
+      <a-tooltip content="主题切换" position="bottom">
+        <GiThemeBtn></GiThemeBtn>
+      </a-tooltip>
+
+      <!-- 管理员账户 -->
+      <a-dropdown trigger="hover">
+        <a-row align="center" :wrap="false" class="header-right-bar__user">
+          <!-- 头像：后端未下发 avatarUrl（本项目用姓名首字兜底，避免渲染成裂图） -->
+          <a-avatar :size="32" :style="{ backgroundColor: 'rgb(var(--primary-6))' }">
+            <img v-if="userStore.avatar" :src="userStore.avatar" alt="" />
+            <template v-else>{{ avatarText }}</template>
+          </a-avatar>
+          <span class="header-right-bar__username">{{ userStore.name }}</span>
+          <icon-down />
+        </a-row>
+
+        <template #content>
+          <a-doption v-for="item in USER_MENUS" :key="item.key" @click="item.onClick">
+            <template #icon>
+              <GiIconBox :color="item.iconColor">
+                <component :is="item.icon" />
+              </GiIconBox>
+            </template>
+            <span>{{ item.label }}</span>
+          </a-doption>
+          <a-divider :margin="0" />
+          <a-doption @click="handleLogout">
+            <template #icon>
+              <GiIconBox color="warning">
+                <icon-export />
+              </GiIconBox>
+            </template>
+            <span>退出登录</span>
+          </a-doption>
+        </template>
+      </a-dropdown>
+    </a-space>
+  </a-row>
+</template>
+
+<script setup lang="ts">
+import { Button, Drawer, Message, Modal } from '@arco-design/web-vue'
+import { useFullscreen } from '@vueuse/core'
+import { useBreakpoint, useTheme } from '@/hooks'
+import { useAppStore, useUserStore } from '@/stores'
+import Notice from './Notice.vue'
+import SettingDrawerPanel from './SettingDrawerPanel.vue'
+
+/** 组件名称 */
+defineOptions({ name: 'HeaderRight' })
+
+/** 路由实例 */
+const router = useRouter()
+
+/** 状态管理 */
+const userStore = useUserStore()
+const appStore = useAppStore()
+const { setThemeColor } = useTheme()
+
+/** 响应式断点 */
+const { breakpoint } = useBreakpoint()
+
+/** 全屏控制 */
+const { isFullscreen, toggle } = useFullscreen()
+
+/** 头像兜底文案：取姓名首字 */
+const avatarText = computed(() => (userStore.name || '—').slice(0, 1))
+
+/** 用户菜单配置 */
+const USER_MENUS = [
+  {
+    key: 'password',
+    label: '修改密码',
+    icon: 'icon-unlock',
+    iconColor: 'primary',
+    onClick: () => {
+      // 后端 PUT /auth/password 尚未实现（属 M0 剩余任务），
+      // 这里给明确提示，而不是像模板那样假装成功
+      Message.info('修改密码功能待接入后端 PUT /auth/password')
+    }
+  }
+]
+
+/** 恢复默认项目配置 */
+const handleResetSettings = () => {
+  appStore.resetSettings()
+  setThemeColor(appStore.themeColor)
+  Message.success('已恢复默认配置')
+}
+
+/** 打开设置抽屉 */
+const handleOpenSettings = () => {
+  Drawer.open({
+    title: '项目配置',
+    width: 300,
+    content: () => h(SettingDrawerPanel),
+    footer: () => h(Button, { type: 'primary', long: true, style: { margin: 0 }, onClick: handleResetSettings }, { default: () => '恢复默认配置' })
+  })
+}
+
+/** 处理退出登录 */
+const handleLogout = () => {
+  Modal.warning({
+    title: '提示',
+    content: '确认退出登录？',
+    hideCancel: false,
+    closable: true,
+    onBeforeOk: async () => {
+      try {
+        await userStore.logout()
+        router.replace('/login')
+        return true
+      } catch {
+        Message.error('退出登录失败')
+        return false
+      }
+    }
+  })
+}
+</script>
+
+<style lang="scss" scoped>
+.arco-dropdown-open .arco-icon-down {
+  transform: rotate(180deg);
+}
+
+.header-right-bar {
+  &__user {
+    color: var(--color-text-1);
+    cursor: pointer;
+  }
+
+  &__username {
+    margin-left: 10px;
+    white-space: nowrap;
+
+    .arco-icon-down {
+      margin-left: 2px;
+      transition: all 0.3s;
+    }
+  }
+}
+</style>

frontend-pc/src/layout/components/Logo.vue

@@ -0,0 +1,85 @@
+<!--
+  @file Logo 组件
+  @description 系统 Logo 组件，支持折叠状态和首页导航功能
+-->
+<template>
+  <section class="system-logo" :class="{ collapsed: props.collapsed }" @click="handleHomeNavigation">
+    <img class="logo" src="@/assets/images/logo.svg" alt="填报通" />
+    <span v-if="!props.hideName" class="system-name g-line-1">填报通</span>
+  </section>
+</template>
+
+<script setup lang="ts">
+/** 组件名称 */
+defineOptions({ name: 'Logo' })
+
+/** Props 默认值 */
+const props = withDefaults(defineProps<Props>(), {
+  collapsed: false,
+  hideName: false
+})
+
+/** Props 类型定义 */
+interface Props {
+  /** 是否折叠状态 */
+  collapsed?: boolean
+  /** 是否隐藏名称 */
+  hideName?: boolean
+}
+
+/** 路由实例 */
+const router = useRouter()
+
+/** 处理首页导航 */
+const handleHomeNavigation = () => {
+  router.push('/')
+}
+</script>
+
+<style lang="scss" scoped>
+.system-logo {
+  box-sizing: border-box;
+  display: flex;
+  flex-shrink: 0;
+  align-items: center;
+  height: 56px;
+  padding: 0 12px;
+  font-size: 20px;
+  line-height: 1;
+  color: var(--color-text-1);
+  cursor: pointer;
+  user-select: none;
+  transition: padding 0.2s;
+
+  // 折叠状态样式
+  &.collapsed {
+    justify-content: center;
+    padding: 0;
+
+    .system-name {
+      display: none;
+    }
+  }
+
+  // Logo 图片样式
+  .logo {
+    flex-shrink: 0;
+    width: 32px;
+    height: 32px;
+    overflow: hidden;
+    border-radius: 6px;
+    transition: all 0.2s;
+  }
+
+  // 系统名称样式
+  .system-name {
+    padding-left: 10px;
+    white-space: nowrap;
+    transition: color 0.3s;
+
+    &:hover {
+      color: rgb(var(--primary-6));
+    }
+  }
+}
+</style>

frontend-pc/src/layout/components/Main.vue

@@ -0,0 +1,37 @@
+<!--
+  @file Main 组件
+  @description 主内容区组件，支持路由切换动画、页面缓存和组件重载功能
+-->
+<template>
+  <a-layout class="main">
+    <router-view v-slot="{ Component, route }">
+      <transition :name="appStore.pageTransitionName" mode="out-in" appear>
+        <keep-alive :include="(tabsStore.cacheList as string[])">
+          <component :is="Component" v-if="tabsStore.reloadFlag" :key="route.path" />
+        </keep-alive>
+      </transition>
+    </router-view>
+  </a-layout>
+</template>
+
+<script setup lang="ts">
+import { useAppStore, useTabsStore } from '@/stores'
+
+/** 组件名称 */
+defineOptions({ name: 'AppMain' })
+
+/** 状态管理 */
+const appStore = useAppStore()
+const tabsStore = useTabsStore()
+</script>
+
+<style lang="scss" scoped>
+.main {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+}
+</style>

frontend-pc/src/layout/components/Menu/MenuIcon.vue

@@ -0,0 +1,21 @@
+<template>
+  <Icon v-if="props?.icon && (props.icon.startsWith('icon-park') || props.icon.startsWith('custom:'))"
+    :icon="props.icon" :width="16" :height="16" />
+  <component :is="props?.icon" v-else-if="props?.icon && props?.icon?.startsWith('icon')" :size="24">
+  </component>
+  <Icon v-else-if="props?.icon" :icon="props.icon" :width="24" :height="24" />
+</template>
+
+<script lang="ts" setup>
+import { Icon } from '@iconify/vue'
+
+interface Props {
+  icon?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  icon: ''
+})
+</script>
+
+<style lang="scss" scoped></style>

frontend-pc/src/layout/components/Menu/MenuItem.vue

@@ -0,0 +1,44 @@
+<template>
+  <a-menu-item v-if="!item.children?.length" :key="item?.path">
+    <template #icon>
+      <MenuIcon :icon="item?.meta?.icon"></MenuIcon>
+    </template>
+    <a-row v-if="menuBadgeStore.badgeMap[item.path] !== undefined" justify="space-between" align="center"
+      style="flex-wrap: nowrap;">
+      <div class="g-line-1">{{ item?.meta?.title }}</div>
+      <a-badge class="g-ml" :count="menuBadgeStore.badgeMap[item.path]"
+        v-bind="menuBadgeStore.BadgePropsMap[item.path]" />
+    </a-row>
+    <template v-else>{{ item?.meta?.title }}</template>
+  </a-menu-item>
+
+  <a-sub-menu v-else :key="item.path" :title="item?.meta?.title">
+    <template #icon>
+      <MenuIcon :icon="item?.meta?.icon"></MenuIcon>
+    </template>
+    <MenuItem v-for="child in item.children" :key="child.path" :item="child">
+    </MenuItem>
+  </a-sub-menu>
+</template>
+
+<script lang="ts" setup>
+import type { RouteRecordRaw } from 'vue-router'
+import { useMenuBadgeStore } from '@/stores'
+import MenuIcon from './MenuIcon.vue'
+
+defineOptions({ name: 'MenuItem' })
+
+withDefaults(defineProps<Props>(), {})
+
+interface Props {
+  item: RouteRecordRaw
+}
+
+const menuBadgeStore = useMenuBadgeStore()
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-badge) {
+  display: inline-flex;
+}
+</style>

frontend-pc/src/layout/components/MenuFoldBtn.vue

@@ -0,0 +1,92 @@
+<!--
+  @file MenuFoldBtn 组件
+  @description 菜单折叠按钮组件，支持响应式布局和抽屉模式
+-->
+<template>
+  <!-- 折叠按钮 -->
+  <a-button size="mini" class="g-hover-btn menu-fold-btn" @click="handleFoldClick">
+    <template #icon>
+      <icon-menu-fold v-if="!appStore.isMenuCollapsed" :size="18" :stroke-width="3" />
+      <icon-menu-unfold v-else :size="18" :stroke-width="3" />
+    </template>
+  </a-button>
+
+  <!-- 移动端抽屉菜单 -->
+  <div class="drawer" :class="{ 'app-menu-dark': appStore.isMenuDark }">
+    <a-drawer v-model:visible="visible" placement="left" :header="false" :footer="false" :render-to-body="false"
+      :drawer-style="drawerStyle">
+      <Logo :collapsed="false" />
+      <a-menu class="menu w-full" :menu-trigger-props="menuTriggerProps" :selected-keys="selectedKeys"
+        @menu-item-click="onMenuItemClick">
+        <MenuItem v-for="item in menuList" :key="item.path" :item="item">
+        </MenuItem>
+      </a-menu>
+    </a-drawer>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { useDevice } from '@/hooks'
+import { useMenu } from '@/layout/hooks/useMenu'
+import { useAppStore } from '@/stores'
+
+/** 组件名称 */
+defineOptions({ name: 'MenuFoldBtn' })
+const Logo = defineAsyncComponent(() => import('@/layout/components/Logo.vue'))
+const MenuItem = defineAsyncComponent(() => import('@/layout/components/Menu/MenuItem.vue'))
+
+/** 状态管理 */
+const appStore = useAppStore()
+const { isDesktop } = useDevice()
+const { menuList, menuTriggerProps, handleMenuItemClick, selectedKeys } = useMenu()
+
+/** 抽屉可见性状态 */
+const visible = ref(false)
+
+/** 抽屉样式配置 */
+const drawerStyle = {
+  borderRight: '1px solid var(--color-border-2)',
+  boxSizing: 'border-box',
+  backgroundColor: 'var(--color-bg-2)'
+} as const
+
+/** 处理折叠按钮点击 */
+const handleFoldClick = () => {
+  if (isDesktop.value) {
+    appStore.setMenuCollapse(!appStore.isMenuCollapsed)
+  } else {
+    visible.value = !visible.value
+  }
+}
+
+/** 处理菜单项点击 */
+const onMenuItemClick = (key: string) => {
+  handleMenuItemClick(key)
+  visible.value = false
+}
+</script>
+
+<style lang="scss" scoped>
+.menu-fold-btn {
+  flex-shrink: 0;
+  background-color: var(--color-secondary-hover) !important;
+}
+
+.drawer {
+
+  // 菜单样式
+  .menu {
+    flex: 1;
+    overflow: hidden;
+    background-color: inherit;
+  }
+
+  // 抽屉内容样式
+  :deep(.arco-drawer-body) {
+    display: flex;
+    flex-direction: column;
+    padding: 0;
+    overflow: hidden;
+  }
+}
+</style>

frontend-pc/src/layout/components/OneLevelMenu/index.vue

@@ -0,0 +1,108 @@
+<template>
+  <div class="one-level-menu" :class="{ 'app-menu-dark': appStore.isMenuDark }">
+    <Logo class="one-level-menu__logo" hide-name></Logo>
+    <div class="one-level-menu__wrap">
+      <a-scrollbar style="height:100%;overflow: auto;" :outer-style="{ width: '100%' }">
+        <ul class="one-level-menu__list">
+          <li v-for="(item) in props.data" :key="item.path" class="one-level-menu__item"
+            :class="{ 'one-level-menu__item--active': props.activePath === item.path }"
+            @click="emits('menu-click', item)">
+            <MenuIcon :icon="item?.meta?.icon"></MenuIcon>
+            <p class="one-level-menu__item__title g-line-1" :title="item?.meta?.title">{{ item?.meta?.title }}</p>
+          </li>
+        </ul>
+      </a-scrollbar>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import type { RouteRecordRaw } from 'vue-router'
+import { useAppStore } from '@/stores'
+import Logo from '../Logo.vue'
+import MenuIcon from '../Menu/MenuIcon.vue'
+
+interface Props {
+  activePath?: string
+  data?: RouteRecordRaw[]
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  activePath: '',
+  data: () => []
+})
+
+const emits = defineEmits<{
+  (e: 'menu-click', item: RouteRecordRaw): void
+}>()
+
+const appStore = useAppStore()
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-scrollbar-track) {
+  display: none;
+}
+
+.one-level-menu {
+  box-sizing: border-box;
+  display: flex;
+  flex-shrink: 0;
+  flex-direction: column;
+  width: 68px;
+  height: 100%;
+  overflow: hidden;
+  color: var(--color-text-2);
+  background-color: var(--color-bg-1);
+  border-right: 1px solid var(--color-border-2);
+
+  &__logo {
+    justify-content: center;
+    border-bottom: 1px solid var(--color-border-2);
+
+    :deep(.logo) {
+      width: 40px;
+      height: 40px;
+    }
+  }
+
+  &__wrap {
+    display: flex;
+    flex: 1;
+    overflow: hidden;
+  }
+
+  &__list {
+    box-sizing: border-box;
+    padding: 4px 4px 0;
+  }
+
+  &__item {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 8px 0;
+    margin-bottom: 4px;
+    cursor: pointer;
+    border-radius: 4px;
+
+    &--active {
+      color: rgb(var(--primary-6));
+      background-color: var(--color-primary-light-2)
+    }
+
+    &:not(.one-level-menu__item--active):hover {
+      background-color: var(--color-fill-2);
+    }
+
+    &__title {
+      box-sizing: border-box;
+      padding: 0 8px;
+      margin-top: 8px;
+      font-size: 12px;
+      line-height: 1;
+    }
+  }
+}
+</style>

frontend-pc/src/layout/components/Tabs/MagicIcon.vue

@@ -0,0 +1,99 @@
+<!--
+  @file MagicIcon 组件
+  @description 可旋转的魔法图标组件，用于展示更多操作的下拉菜单触发器
+-->
+<template>
+  <span class="magic-icon-wrapper">
+    <span class="magic-icon">
+      <i class="magic-dot magic-dot-top"></i>
+      <i class="magic-dot magic-dot-bottom"></i>
+    </span>
+  </span>
+</template>
+
+<script setup lang="ts">
+defineOptions({ name: 'MagicIcon' })
+</script>
+
+<style lang="scss" scoped>
+.magic-icon-wrapper {
+  position: relative;
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  // 点击区域扩展
+  &::before {
+    position: absolute;
+    top: -6px;
+    left: -6px;
+    width: 26px;
+    height: 26px;
+    cursor: pointer;
+    content: '';
+  }
+}
+
+.magic-icon {
+  display: inline-block;
+  color: var(--color-text-2);
+  cursor: pointer;
+  transition: transform 0.3s ease-out;
+
+  // 魔法点样式
+  .magic-dot {
+    position: relative;
+    display: block;
+    width: 14px;
+    height: 6px;
+
+    &-bottom {
+      margin-top: 2px;
+    }
+
+    // 左侧点
+    &::before {
+      position: absolute;
+      left: 0;
+      width: 6px;
+      height: 6px;
+      content: '';
+      background: var(--color-text-2);
+      transition: transform 0.3s ease-out;
+    }
+
+    // 右侧点
+    &::after {
+      position: absolute;
+      left: 8px;
+      width: 6px;
+      height: 6px;
+      content: '';
+      background: var(--color-text-2);
+      transition: background-color 0.3s ease-out;
+    }
+  }
+}
+
+// 悬浮和打开状态样式
+.magic-icon-wrapper:hover,
+.arco-dropdown-open {
+  .magic-icon {
+    transform: rotate(90deg);
+
+    .magic-dot {
+
+      &::before,
+      &::after {
+        background: rgb(var(--primary-6));
+      }
+
+      &-top::before {
+        background: rgb(var(--primary-3));
+        transform: rotate(45deg);
+      }
+    }
+  }
+}
+</style>

frontend-pc/src/layout/components/Tabs/ReloadIcon.vue

@@ -0,0 +1,46 @@
+<!--
+  @file ReloadIcon 组件
+  @description 页面重载图标组件，支持加载动画效果
+-->
+<template>
+  <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img"
+    width="18" height="18" viewBox="0 0 24 24" class="reload-icon" @click="handleReload">
+    <path fill="currentColor"
+      d="M5.463 4.433A9.96 9.96 0 0 1 12 2c5.523 0 10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3A8 8 0 0 0 6.46 6.228zm13.074 15.134A9.96 9.96 0 0 1 12 22C6.477 22 2 17.523 2 12c0-2.136.67-4.116 1.81-5.74L7 12H4a8 8 0 0 0 13.54 5.772z">
+    </path>
+  </svg>
+  <!-- <svg width="17" height="17" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" class="reload-icon"
+    @click="handleReload">
+    <path d="M42 8V24" stroke="currentColor" stroke-width="4" stroke-linecap="butt" stroke-linejoin="round" />
+    <path d="M6 24L6 40" stroke="currentColor" stroke-width="4" stroke-linecap="butt" stroke-linejoin="round" />
+    <path
+      d="M42 24C42 14.0589 33.9411 6 24 6C18.9145 6 14.3216 8.10896 11.0481 11.5M6 24C6 33.9411 14.0589 42 24 42C28.8556 42 33.2622 40.0774 36.5 36.9519"
+      stroke="currentColor" stroke-width="4" stroke-linecap="butt" stroke-linejoin="round" />
+  </svg> -->
+</template>
+
+<script setup lang="ts">
+import { useTabsStore } from '@/stores'
+
+/** 组件名称 */
+defineOptions({ name: 'ReloadIcon' })
+
+/** 状态管理 */
+const tabsStore = useTabsStore()
+
+/** 处理重载操作 */
+const handleReload = () => {
+  tabsStore.reloadPage()
+}
+</script>
+
+<style lang="scss" scoped>
+.reload-icon {
+  cursor: pointer;
+
+  &:hover {
+    transform: rotate(180deg);
+    transition: transform 0.5s ease-in-out;
+  }
+}
+</style>

frontend-pc/src/layout/components/Tabs/index.vue

@@ -0,0 +1,238 @@
+<!--
+  @file Tabs 组件
+  @description 系统标签页组件，支持多种标签样式、右键菜单和快捷操作
+-->
+<template>
+  <a-tabs :key="appStore.tabStyle" :class="`tabs--${appStore.tabStyle}`" :type="tabsType" :active-key="route.path"
+    editable hide-content size="medium" scroll-position="center" @tab-click="handleTabClick"
+    @delete="tabsStore.close('current', $event as string)">
+    <a-tab-pane v-for="item of tabsStore.tabList" :key="item.path" :title="(item.meta?.title as string)"
+      :closable="!item.meta?.affix">
+      <template v-if="appStore.tabStyle === 'custom2'" #title>
+        <a-dropdown trigger="contextMenu">
+          <a-tag class="tabs-pane__tag" :closable="!item.meta?.affix"
+            :color="route.path === item.path ? 'rgb(var(--primary-6))' : undefined"
+            :bordered="route.path === item.path ? false : true" @close="tabsStore.close('current', item.path)">
+            {{ item.meta?.title }}
+          </a-tag>
+          <template #content>
+            <a-doption @click="tabsStore.close('left', item.path)">
+              <template #icon><icon-left /></template>
+              <template #default>关闭左侧</template>
+            </a-doption>
+            <a-doption @click="tabsStore.close('right', item.path)">
+              <template #icon><icon-right /></template>
+              <template #default>关闭右侧</template>
+            </a-doption>
+            <a-doption @click="tabsStore.close('other', item.path)">
+              <template #icon><icon-close /></template>
+              <template #default>关闭其他</template>
+            </a-doption>
+          </template>
+        </a-dropdown>
+      </template>
+    </a-tab-pane>
+
+    <template #extra>
+      <a-space size="medium">
+        <ReloadIcon></ReloadIcon>
+        <a-dropdown trigger="hover">
+          <MagicIcon></MagicIcon>
+          <template #content>
+            <a-doption @click="tabsStore.close('left', route.path)">
+              <template #icon><icon-left /></template>
+              <template #default>关闭左侧</template>
+            </a-doption>
+            <a-doption @click="tabsStore.close('right', route.path)">
+              <template #icon><icon-right /></template>
+              <template #default>关闭右侧</template>
+            </a-doption>
+            <a-doption @click="tabsStore.close('other', route.path)">
+              <template #icon><icon-close /></template>
+              <template #default>关闭其他</template>
+            </a-doption>
+            <a-doption @click="tabsStore.close('all')">
+              <template #icon><icon-delete /></template>
+              <template #default>关闭全部</template>
+            </a-doption>
+          </template>
+        </a-dropdown>
+      </a-space>
+    </template>
+  </a-tabs>
+</template>
+
+<script setup lang="ts">
+import type { TabsInstance } from '@arco-design/web-vue'
+import Sortable from 'sortablejs'
+import { useRouteListener } from '@/hooks'
+import { useAppStore, useTabsStore } from '@/stores'
+import MagicIcon from './MagicIcon.vue'
+import ReloadIcon from './ReloadIcon.vue'
+
+/** 组件名称 */
+defineOptions({ name: 'Tabs' })
+const route = useRoute()
+const router = useRouter()
+const appStore = useAppStore()
+const tabsStore = useTabsStore()
+const { listenerRouteChange } = useRouteListener()
+const tabsType = computed(() => {
+  return (['custom1', 'custom2'].includes(appStore.tabStyle) ? 'card' : appStore.tabStyle) as unknown as TabsInstance['type']
+})
+
+/** 初始化标签页 */
+tabsStore.init()
+
+/** 监听路由变化 */
+listenerRouteChange(({ to }) => {
+  if (to.name) {
+    const rawTo = toRaw(to)
+    tabsStore.addTabItem(rawTo)
+  }
+})
+
+/** 处理标签页点击 */
+const handleTabClick: TabsInstance['onTabClick'] = (key) => {
+  const targetTab = tabsStore.tabList.find((tab) => tab.path === key)
+  router.push(targetTab?.fullPath || targetTab?.path || (key as string))
+}
+
+onMounted(() => {
+  Sortable.create(document.querySelector('.arco-tabs-nav-tab-list') as HTMLElement, {
+    draggable: '.arco-tabs-tab-closable',
+    animation: 300,
+    onEnd({ newIndex, oldIndex }) {
+      const tabsList = [...tabsStore.tabList]
+      const currRow = tabsList.splice(oldIndex as number, 1)[0]
+      tabsList.splice(newIndex as number, 0, currRow)
+      tabsStore.tabList = tabsList
+    }
+  })
+})
+</script>
+
+<style lang="scss" scoped>
+:deep(.arco-tabs) {
+  background-color: var(--color-bg-1);
+}
+
+:deep(.arco-tabs-nav-tab) {
+  .arco-tabs-tab {
+    border-bottom-color: transparent !important;
+
+    svg {
+      width: 0;
+      transition: all 0.15s;
+    }
+
+    &:hover svg {
+      width: 1em;
+    }
+  }
+}
+
+.tabs--card {
+  :deep(.arco-tabs-nav-type-card) {
+    &::before {
+      z-index: 9;
+    }
+
+    .arco-tabs-tab {
+      border-top: none;
+    }
+
+    &:not(.arco-tabs-nav-tab-scroll) .arco-tabs-tab:first-child {
+      border-left: 0;
+    }
+  }
+}
+
+.tabs--card-gutter {
+  padding-top: 4px;
+  padding-left: 4px;
+}
+
+.tabs--rounded {
+  &::after {
+    position: absolute;
+    right: 0;
+    bottom: 0;
+    left: 0;
+    z-index: 1;
+    width: 100%;
+    height: 1px;
+    content: '';
+    background-color: var(--color-border-2);
+  }
+
+  :deep(.arco-tabs-nav-type-rounded .arco-tabs-tab) {
+    padding: 2px 12px;
+    margin: 5px;
+  }
+}
+
+// 自定义样式1
+.tabs--custom1 {
+  padding-top: 4px;
+
+  :deep(.arco-tabs-nav-tab) {
+    .arco-tabs-tab {
+      padding: 5px 20px;
+      border: none;
+      mask: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAANoAAAAkBAMAAAAdqzmBAAAAMFBMVEVHcEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlTPQ5AAAAD3RSTlMAr3DvEM8wgCBA379gj5//tJBPAAAAnUlEQVRIx2NgAAM27fj/tAO/xBsYkIHyf9qCT8iWMf6nNQhAsk2f5rYheY7Dnua2/U+A28ZEe8v+F9Ax2v7/F4DbxkUH2wzgtvHTwbYPo7aN2jZq26hto7aN2jZq25Cy7Qvctnw62PYNbls9HWz7S8/G6//PsI6H4396gAUQy1je08W2jxDbpv6nD4gB2uWp+J9eYPsEhv/0BPS1DQBvoBLVZ3BppgAAAABJRU5ErkJggg==");
+      mask: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAANoAAAAkBAMAAAAdqzmBAAAAMFBMVEVHcEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlTPQ5AAAAD3RSTlMAr3DvEM8wgCBA379gj5//tJBPAAAAnUlEQVRIx2NgAAM27fj/tAO/xBsYkIHyf9qCT8iWMf6nNQhAsk2f5rYheY7Dnua2/U+A28ZEe8v+F9Ax2v7/F4DbxkUH2wzgtvHTwbYPo7aN2jZq26hto7aN2jZq25Cy7Qvctnw62PYNbls9HWz7S8/G6//PsI6H4396gAUQy1je08W2jxDbpv6nD4gB2uWp+J9eYPsEhv/0BPS1DQBvoBLVZ3BppgAAAABJRU5ErkJggg==");
+      mask-size: 100% 100%;
+      mask-size: 100% 100%;
+    }
+  }
+
+  :deep(.arco-tabs-nav-tab-list) {
+    .arco-tabs-tab-active {
+      padding: 5px 20px;
+      background-color: rgb(var(--primary-6), 0.1);
+      mask: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAANoAAAAkBAMAAAAdqzmBAAAAMFBMVEVHcEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlTPQ5AAAAD3RSTlMAr3DvEM8wgCBA379gj5//tJBPAAAAnUlEQVRIx2NgAAM27fj/tAO/xBsYkIHyf9qCT8iWMf6nNQhAsk2f5rYheY7Dnua2/U+A28ZEe8v+F9Ax2v7/F4DbxkUH2wzgtvHTwbYPo7aN2jZq26hto7aN2jZq25Cy7Qvctnw62PYNbls9HWz7S8/G6//PsI6H4396gAUQy1je08W2jxDbpv6nD4gB2uWp+J9eYPsEhv/0BPS1DQBvoBLVZ3BppgAAAABJRU5ErkJggg==");
+      mask: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAANoAAAAkBAMAAAAdqzmBAAAAMFBMVEVHcEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAlTPQ5AAAAD3RSTlMAr3DvEM8wgCBA379gj5//tJBPAAAAnUlEQVRIx2NgAAM27fj/tAO/xBsYkIHyf9qCT8iWMf6nNQhAsk2f5rYheY7Dnua2/U+A28ZEe8v+F9Ax2v7/F4DbxkUH2wzgtvHTwbYPo7aN2jZq26hto7aN2jZq25Cy7Qvctnw62PYNbls9HWz7S8/G6//PsI6H4396gAUQy1je08W2jxDbpv6nD4gB2uWp+J9eYPsEhv/0BPS1DQBvoBLVZ3BppgAAAABJRU5ErkJggg==");
+      mask-size: 100% 100%;
+      mask-size: 100% 100%;
+
+      &:hover {
+        padding: 5px 20px;
+        background-color: rgb(var(--primary-6), 0.1);
+      }
+    }
+  }
+}
+
+// 自定义样式2
+.tabs--custom2 {
+  :deep(.arco-tabs-nav) {
+    padding-top: 8px;
+    padding-bottom: 8px;
+    padding-left: 6px;
+
+    .arco-tabs-nav-tab-list {
+      display: flex;
+      gap: 0 8px;
+    }
+
+    .arco-tabs-tab {
+      padding: 0;
+      border: 0;
+
+      .arco-tabs-tab-close-btn {
+        display: none;
+      }
+
+      &:hover {
+        background-color: transparent;
+      }
+    }
+
+    .tabs-pane__tag {
+      height: 26px;
+      border-radius: 3px;
+    }
+  }
+}
+</style>

frontend-pc/src/layout/hooks/useLevelMenu.ts

@@ -0,0 +1,123 @@
+import type { CSSProperties } from 'vue'
+import type { RouteLocationNormalizedGeneric, RouteRecordRaw } from 'vue-router'
+import { eachTree, searchTree } from 'xe-utils'
+import { useRouteListener } from '@/hooks'
+import { useAppStore, useRouteStore } from '@/stores'
+import { filterTree } from '@/utils'
+import { isExternal } from '@/utils/validate'
+
+type Options = {
+  oneActivePathChange?: (path: string) => void
+}
+
+/** 获取一级菜单，二级菜单的hooks */
+export function useLevelMenu(options?: Options) {
+  const route = useRoute()
+  const router = useRouter()
+  const appStore = useAppStore()
+  const routeStore = useRouteStore()
+  const { listenerRouteChange } = useRouteListener()
+
+  const menuTheme = computed(() => appStore.isMenuDark ? 'dark' : 'light')
+
+  // 获取菜单样式
+  const getMenuStyle = computed(() => {
+    return { backgroundColor: menuTheme.value === 'dark' ? 'var(--color-menu-dark-bg)' : 'var(--color-menu-light-bg)' } as CSSProperties
+  })
+
+  // 克隆一份路由，避免直接操作原始路由
+  const cloneRoutes = JSON.parse(JSON.stringify(routeStore.routes)) as RouteRecordRaw[]
+  const showMenuList = filterTree(cloneRoutes, (i) => i.meta?.hidden === false) as RouteRecordRaw[]
+
+  // 一级菜单
+  const oneLevelMenus = ref<RouteRecordRaw[]>([])
+
+  // 二级菜单
+  const twoLevelMenus = computed(() => {
+    const path = route.matched[0].path
+    return showMenuList.find((i) => i.path === path)?.children || []
+  })
+
+  // 一级菜单选中的路由
+  const oneActiveRoute = ref<RouteRecordRaw | null>(null)
+  const oneActivePath = ref('')
+  const getOneActiveRoute = (to: RouteLocationNormalizedGeneric) => {
+    let path = to.path
+    if (to?.meta?.activeMenu) {
+      path = to.meta.activeMenu
+    }
+    const arr = searchTree(showMenuList, (i) => i.path === path)
+    oneActivePath.value = arr?.[0]?.path
+    return arr?.[0]
+  }
+
+  // 二级菜单选中的路由
+  const twoActivePath = ref<string>('')
+  const getTwoActivePath = (to: RouteLocationNormalizedGeneric) => {
+    let path = to.path
+    if (to?.meta?.activeMenu) {
+      path = to.meta.activeMenu
+    }
+    return path
+  }
+
+  listenerRouteChange(({ to }) => {
+    oneActiveRoute.value = getOneActiveRoute(to)
+    twoActivePath.value = getTwoActivePath(to)
+  })
+
+  // 获取一级菜单
+  function getOneLevelMenus() {
+    const cloneRoutes = JSON.parse(JSON.stringify(routeStore.routes)) as RouteRecordRaw[]
+    const showMenuList = filterTree(cloneRoutes, (i) => i.meta?.hidden === false) as RouteRecordRaw[]
+    eachTree(showMenuList, (i) => {
+      if (i?.children?.length === 1 && i?.meta?.alwaysShow !== true) {
+        if (i.meta) {
+          i.meta.title = i.meta?.title || i.children?.[0]?.meta?.title
+          i.meta.icon = i.meta?.icon || i.children?.[0]?.meta?.icon
+        }
+        delete i.children
+      }
+    })
+    oneLevelMenus.value = showMenuList
+  }
+
+  // 一级菜单点击事件
+  function handleOneMenuItemClick(path: string) {
+    if (isExternal(path)) {
+      window.open(path)
+      return
+    }
+    options?.oneActivePathChange?.(path)
+    oneActivePath.value = path
+    const obj = oneLevelMenus.value.find((i) => i.path === path)
+    if (obj?.redirect === 'noRedirect' || !obj?.redirect) {
+      router.push({ path: obj?.children?.[0]?.path })
+      return
+    }
+    router.push({ path: (obj?.redirect as string) || path })
+  }
+
+  // 二级菜单点击事件
+  function handleTwoMenuItemClick(path: string) {
+    if (isExternal(path)) {
+      window.open(path)
+      return
+    }
+    twoActivePath.value = path
+    router.push({ path })
+  }
+
+  return {
+    menuTheme,
+    getMenuStyle,
+    oneLevelMenus,
+    twoLevelMenus,
+    oneActiveRoute,
+    oneActivePath,
+    twoActivePath,
+    getOneLevelMenus,
+    handleOneMenuItemClick,
+    handleTwoMenuItemClick
+  }
+}

frontend-pc/src/layout/hooks/useMenu.ts

@@ -0,0 +1,101 @@
+import type { CSSProperties } from 'vue'
+import type { RouteRecordRaw } from 'vue-router'
+import { computed } from 'vue'
+import { eachTree } from 'xe-utils'
+import { useDevice, useRouteListener } from '@/hooks'
+import { useAppStore, useRouteStore } from '@/stores'
+import { filterTree } from '@/utils'
+import { isExternal } from '@/utils/validate'
+
+/**
+ * 菜单管理 Hooks
+ * 用于获取和处理应用程序的菜单列表
+ * 提供菜单的过滤、展平处理等功能
+ * @returns {object} 包含处理后菜单列表的响应式对象
+ */
+export function useMenu() {
+  const router = useRouter()
+  // 路由存储实例，用于获取原始路由配置
+  const routeStore = useRouteStore()
+  const appStore = useAppStore()
+  const { listenerRouteChange } = useRouteListener()
+  const { isDesktop } = useDevice()
+
+  // 是否折叠菜单
+  const collapsed = computed(() =>
+    !isDesktop.value ? false : appStore.isMenuCollapsed
+  )
+
+  // 菜单触发器配置
+  const menuTriggerProps = {
+    animationName: 'slide-dynamic-origin'
+  }
+
+  // 菜单主题
+  const menuTheme = computed(() => appStore.isMenuDark ? 'dark' : 'light')
+
+  // 获取菜单样式
+  const getMenuStyle = computed(() => {
+    return { backgroundColor: menuTheme.value === 'dark' ? 'var(--color-menu-dark-bg)' : 'var(--color-menu-light-bg)' } as CSSProperties
+  })
+
+  /**
+   * 处理后的菜单列表
+   * 响应式计算属性，当路由配置变化时自动更新，
+   * > hidden:false那么代表这个路由项显示在左侧菜单栏中
+   * > 子项chidren只有一个hidden:false的子元素时, 且alwaysShow为false, 那么这个子项会被展平到父项中
+   * 包含以下处理逻辑：
+   * 1. 深拷贝原始路由配置避免直接修改
+   * 2. 过滤掉设置为隐藏的菜单项
+   * 3. 展平只有一个子项的菜单项（提升用户体验）
+   */
+  const menuList = computed(() => {
+    // 深拷贝路由配置，防止修改原始数据
+    const cloneRoutes = JSON.parse(JSON.stringify(routeStore.routes)) as RouteRecordRaw[]
+
+    // 过滤出非隐藏的菜单（meta.hidden !== false）
+    const showMenuList = filterTree(cloneRoutes, (i) => i.meta?.hidden === false) as RouteRecordRaw[]
+
+    // 遍历处理菜单树，展平只有一个子项的菜单项
+    eachTree(showMenuList, (i) => {
+      if (i?.children?.length === 1 && i?.meta?.alwaysShow !== true) {
+        if (i.meta) {
+          i.meta.title = i.meta?.title || i.children?.[0]?.meta?.title
+          i.meta.icon = i.meta?.icon || i.children?.[0]?.meta?.icon
+        }
+        i.path = i.children?.[0]?.path
+        delete i.children
+      }
+    })
+    return showMenuList
+  })
+
+  const selectedKeys = ref<string[]>([])
+
+  function handleMenuItemClick(key: string) {
+    if (isExternal(key)) {
+      window.open(key)
+      return
+    }
+    selectedKeys.value = [key]
+    router.push({ path: key })
+  }
+
+  listenerRouteChange(({ to }) => {
+    if (to?.meta?.activeMenu) {
+      selectedKeys.value = [to.meta.activeMenu]
+      return
+    }
+    selectedKeys.value = [to.path]
+  })
+
+  return {
+    menuTheme,
+    getMenuStyle,
+    menuList,
+    menuTriggerProps,
+    selectedKeys,
+    collapsed,
+    handleMenuItemClick
+  }
+}

frontend-pc/src/layout/index.vue

@@ -0,0 +1,45 @@
+<!--
+  @file Layout 组件
+  @description 布局根组件，支持默认布局、混合布局和顶部布局三种模式
+-->
+<template>
+  <!-- 使用静态组件避免不必要的动态组件切换开销 -->
+  <LayoutMix v-if="appStore.layout === 'mix'" />
+  <LayoutTop v-else-if="appStore.layout === 'top'" />
+  <LayoutColumns v-else-if="appStore.layout === 'columns'" />
+  <LayoutDefault v-else />
+</template>
+
+<script setup lang="ts">
+import { useAppStore } from '@/stores'
+
+/** 组件名称 */
+defineOptions({ name: 'Layout' })
+
+// 优化异步组件加载：添加预加载注释，设置合理的加载策略
+const LayoutDefault = defineAsyncComponent({
+  loader: () => import('./LayoutDefault.vue'),
+  delay: 0, // 立即显示加载状态
+  timeout: 10000 // 避免加载超时
+})
+
+// 对于非默认布局，添加预加载
+const LayoutColumns = defineAsyncComponent({
+  loader: () => import('./LayoutColumns.vue'),
+  delay: 0
+})
+
+const LayoutMix = defineAsyncComponent({
+  loader: () => import('./LayoutMix.vue'),
+  delay: 0
+})
+
+const LayoutTop = defineAsyncComponent({
+  loader: () => import('./LayoutTop.vue'),
+  delay: 0
+})
+
+const appStore = useAppStore()
+</script>
+
+<style lang="scss" scoped></style>