From a1160bc394bde546c122f92ead43e9a249e39069 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B8=A5=E6=B5=A9?= <h_mini2024@oo1.dev>
Date: Sat, 25 Oct 2025 22:46:11 +0800
Subject: [PATCH] =?UTF-8?q?refactor(layout):=20=E9=87=8D=E6=9E=84=E5=9F=BA?=
 =?UTF-8?q?=E7=A1=80=E5=B8=83=E5=B1=80=E5=A4=B4=E9=83=A8=E7=BB=84=E4=BB=B6?=
 =?UTF-8?q?=E7=BB=93=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                                     |  4 ++
 .../base-layout/base-layout-header.vue        | 71 -------------------
 .../base-layout-header/base-layout-header.vue | 16 +++++
 .../components/LanguageSwitchButton.vue       | 33 +++++++++
 .../components/ThemeSwitchButton.vue          | 30 ++++++++
 .../components/ToggleSiderButton.vue          | 23 ++++++
 src/layouts/base-layout/base-layout.vue       |  2 +-
 src/plugins/00.vueI18n-plugin.ts              | 32 ++++-----
 vite-plugins/02.unplugin-auto-import.ts       |  3 +
 vite.config.ts                                | 16 ++++-
 10 files changed, 141 insertions(+), 89 deletions(-)
 delete mode 100644 src/layouts/base-layout/base-layout-header.vue
 create mode 100644 src/layouts/base-layout/base-layout-header/base-layout-header.vue
 create mode 100644 src/layouts/base-layout/base-layout-header/components/LanguageSwitchButton.vue
 create mode 100644 src/layouts/base-layout/base-layout-header/components/ThemeSwitchButton.vue
 create mode 100644 src/layouts/base-layout/base-layout-header/components/ToggleSiderButton.vue

diff --git a/AGENTS.md b/AGENTS.md
index 61b2c6b..cf13d50 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -6,6 +6,10 @@ This file provides guidance to AI when working with code in this repository.
 
 Vue 3 TypeScript application with Vite.
 
+## 开发服务器
+
+- **不要启动开发服务器**: 开发服务器通常已经由用户启动。除非特别要求，否则不要执行 `pnpm dev` 之类的命令。
+
 ### Routing & Layouts
 
 - **File-based routing**: Uses `unplugin-vue-router` with `.page.vue` and `.page.md` extensions in `src/pages/`
diff --git a/src/layouts/base-layout/base-layout-header.vue b/src/layouts/base-layout/base-layout-header.vue
deleted file mode 100644
index 8799e81..0000000
--- a/src/layouts/base-layout/base-layout-header.vue
+++ /dev/null
@@ -1,71 +0,0 @@
-<script setup lang="ts">
-const buttonRef = useTemplateRef('buttonRef');
-const appStore = useAppStore();
-
-function toggleCollapsed() {
-  // https://github.com/tusen-ai/naive-ui/issues/3688
-  // hover style 鼠标移出就会消失 如果是点击 button 会聚焦需要失去焦点才会恢复
-  buttonRef.value?.$el.blur();
-  appStore.toggleSidebar();
-}
-
-const themeLabels: Record<AppThemeMode, string> = {
-  light: '浅色',
-  dark: '深色',
-  system: '跟随系统',
-};
-
-const { locale } = useI18n();
-const languageLabels: Record<string, string> = {
-  'en-US': 'English',
-  'zh-CN': '简体中文',
-};
-function toggleLanguage() {
-  locale.value = locale.value === 'zh-CN' ? 'en-US' : 'zh-CN';
-}
-</script>
-
-<template>
-  <div class="h-full flex items-center justify-between px-12px shadow-header dark:shadow-gray-700">
-    <div>
-      <NTooltip :disabled="appStore.isMobile" placement="bottom-start">
-        {{ appStore.sidebarCollapsed ? '展开菜单' : '收起菜单' }}
-        <template #trigger>
-          <NButton ref="buttonRef" quaternary @click="toggleCollapsed">
-            <icon-line-md:menu-fold-right v-if="appStore.sidebarCollapsed" w-4.5 h-4.5 />
-            <icon-line-md:menu-fold-left v-else w-4.5 h-4.5 />
-          </NButton>
-        </template>
-      </NTooltip>
-    </div>
-
-    <div class="flex items-center">
-      <NTooltip :disabled="appStore.isMobile" placement="bottom-end">
-        {{ languageLabels[locale] }}
-        <template #trigger>
-          <NButton quaternary @click="toggleLanguage">
-            <icon-clarity:language-line w-4.5 h-4.5 />
-          </NButton>
-        </template>
-      </NTooltip>
-      <NTooltip :disabled="appStore.isMobile" placement="bottom-end">
-        {{ themeLabels[appStore.themeMode] }}
-        <template #trigger>
-          <NButton quaternary @click="appStore.cycleTheme">
-            <icon-line-md:sunny-filled-loop-to-moon-filled-loop-transition
-              v-if="appStore.themeMode === 'light'"
-              w-4.5
-              h-4.5
-            />
-            <icon-line-md:moon-filled-to-sunny-filled-loop-transition
-              v-else-if="appStore.themeMode === 'dark'"
-              w-4.5
-              h-4.5
-            />
-            <icon-line-md:computer v-else w-4.5 h-4.5 />
-          </NButton>
-        </template>
-      </NTooltip>
-    </div>
-  </div>
-</template>
diff --git a/src/layouts/base-layout/base-layout-header/base-layout-header.vue b/src/layouts/base-layout/base-layout-header/base-layout-header.vue
new file mode 100644
index 0000000..b631f15
--- /dev/null
+++ b/src/layouts/base-layout/base-layout-header/base-layout-header.vue
@@ -0,0 +1,16 @@
+<script setup lang="ts">
+import LanguageSwitchButton from './components/LanguageSwitchButton.vue';
+import ThemeSwitchButton from './components/ThemeSwitchButton.vue';
+import ToggleSiderButton from './components/ToggleSiderButton.vue';
+</script>
+
+<template>
+  <div class="h-full flex items-center justify-between px-12px shadow-header dark:shadow-gray-700">
+    <ToggleSiderButton />
+
+    <div class="flex items-center">
+      <LanguageSwitchButton />
+      <ThemeSwitchButton />
+    </div>
+  </div>
+</template>
diff --git a/src/layouts/base-layout/base-layout-header/components/LanguageSwitchButton.vue b/src/layouts/base-layout/base-layout-header/components/LanguageSwitchButton.vue
new file mode 100644
index 0000000..4ea655c
--- /dev/null
+++ b/src/layouts/base-layout/base-layout-header/components/LanguageSwitchButton.vue
@@ -0,0 +1,33 @@
+<script setup lang="ts">
+import type { DropdownOption } from 'naive-ui';
+
+const { locale, availableLocales } = useI18n({ useScope: 'global' });
+
+const languageLabels: Record<string, string> = {
+  'en-US': 'English',
+  'zh-CN': '简体中文',
+};
+
+const options = computed<DropdownOption[]>(() =>
+  availableLocales.map((lang) => ({
+    label: languageLabels[lang] || lang,
+    key: lang,
+    disabled: locale.value === lang,
+  })),
+);
+
+function handleSelect(key: string) {
+  locale.value = key;
+}
+</script>
+
+<template>
+  <NDropdown trigger="hover" placement="bottom-end" :options="options" @select="handleSelect">
+    <NButton quaternary class="flex items-center gap-1">
+      <template #icon>
+        <icon-clarity:language-line w-4.5 h-4.5 />
+      </template>
+      <span>{{ languageLabels[locale] }}</span>
+    </NButton>
+  </NDropdown>
+</template>
diff --git a/src/layouts/base-layout/base-layout-header/components/ThemeSwitchButton.vue b/src/layouts/base-layout/base-layout-header/components/ThemeSwitchButton.vue
new file mode 100644
index 0000000..84044de
--- /dev/null
+++ b/src/layouts/base-layout/base-layout-header/components/ThemeSwitchButton.vue
@@ -0,0 +1,30 @@
+<script setup lang="ts">
+const appStore = useAppStore();
+
+const themeLabels: Record<AppThemeMode, string> = {
+  light: '浅色',
+  dark: '深色',
+  system: '跟随系统',
+};
+</script>
+
+<template>
+  <NTooltip :disabled="appStore.isMobile" placement="bottom-end">
+    {{ themeLabels[appStore.themeMode] }}
+    <template #trigger>
+      <NButton quaternary @click="appStore.cycleTheme">
+        <icon-line-md:sunny-filled-loop-to-moon-filled-loop-transition
+          v-if="appStore.themeMode === 'light'"
+          w-4.5
+          h-4.5
+        />
+        <icon-line-md:moon-filled-to-sunny-filled-loop-transition
+          v-else-if="appStore.themeMode === 'dark'"
+          w-4.5
+          h-4.5
+        />
+        <icon-line-md:computer v-else w-4.5 h-4.5 />
+      </NButton>
+    </template>
+  </NTooltip>
+</template>
diff --git a/src/layouts/base-layout/base-layout-header/components/ToggleSiderButton.vue b/src/layouts/base-layout/base-layout-header/components/ToggleSiderButton.vue
new file mode 100644
index 0000000..d874851
--- /dev/null
+++ b/src/layouts/base-layout/base-layout-header/components/ToggleSiderButton.vue
@@ -0,0 +1,23 @@
+<script setup lang="ts">
+const buttonRef = useTemplateRef('buttonRef');
+const appStore = useAppStore();
+
+function toggleCollapsed() {
+  // https://github.com/tusen-ai/naive-ui/issues/3688
+  // hover style 鼠标移出就会消失 如果是点击 button 会聚焦需要失去焦点才会恢复
+  buttonRef.value?.$el.blur();
+  appStore.toggleSidebar();
+}
+</script>
+
+<template>
+  <NTooltip :disabled="appStore.isMobile" placement="bottom-start">
+    {{ appStore.sidebarCollapsed ? '展开菜单' : '收起菜单' }}
+    <template #trigger>
+      <NButton ref="buttonRef" quaternary @click="toggleCollapsed">
+        <icon-line-md:menu-fold-right v-if="appStore.sidebarCollapsed" w-4.5 h-4.5 />
+        <icon-line-md:menu-fold-left v-else w-4.5 h-4.5 />
+      </NButton>
+    </template>
+  </NTooltip>
+</template>
diff --git a/src/layouts/base-layout/base-layout.vue b/src/layouts/base-layout/base-layout.vue
index c41273a..9b63278 100644
--- a/src/layouts/base-layout/base-layout.vue
+++ b/src/layouts/base-layout/base-layout.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { AdminLayout } from '@sa/materials';
-import BaseLayoutHeader from './base-layout-header.vue';
+import BaseLayoutHeader from './base-layout-header/base-layout-header.vue';
 import BaseLayoutSider from './base-layout-sider.vue';
 
 const appStore = useAppStore();
diff --git a/src/plugins/00.vueI18n-plugin.ts b/src/plugins/00.vueI18n-plugin.ts
index d959f35..ab5fd14 100644
--- a/src/plugins/00.vueI18n-plugin.ts
+++ b/src/plugins/00.vueI18n-plugin.ts
@@ -3,23 +3,23 @@
  * at once using the import syntax
  */
 import messages from '@intlify/unplugin-vue-i18n/messages';
+
 import { createI18n } from 'vue-i18n';
 
 export function install({ app }: { app: import('vue').App<Element> }) {
-  app.use(
-    // https://vue-i18n.intlify.dev/guide/essentials/started.html#registering-the-i18n-plugin
-    createI18n({
-      legacy: false, // you must set `false`, to use Composition API
-      locale: navigator.language,
-      fallbackRoot: false,
-      // flatJson: true,
-      missing: (locale, key /* , instance, type */) => {
-        consola.warn(`缺少国际化内容: locale='${locale}', key='${key}'`);
-        return `[${key}]`;
-      },
-      missingWarn: !true,
-      fallbackWarn: !true,
-      messages,
-    }),
-  );
+  // https://vue-i18n.intlify.dev/guide/essentials/started.html#registering-the-i18n-plugin
+  const i18n = createI18n({
+    legacy: false, // you must set `false`, to use Composition API
+    locale: navigator.language,
+    fallbackRoot: false,
+    // flatJson: true,
+    missing: (locale, key /* , instance, type */) => {
+      consola.warn(`缺少国际化内容: locale='${locale}', key='${key}'`);
+      return `[${key}]`;
+    },
+    missingWarn: !true,
+    fallbackWarn: !true,
+    messages,
+  });
+  app.use(i18n);
 }
diff --git a/vite-plugins/02.unplugin-auto-import.ts b/vite-plugins/02.unplugin-auto-import.ts
index 3704811..d3b4773 100644
--- a/vite-plugins/02.unplugin-auto-import.ts
+++ b/vite-plugins/02.unplugin-auto-import.ts
@@ -112,6 +112,9 @@ export function loadPlugin(_configEnv: ConfigEnv): PluginOption {
         NaiveUiResolver(),
       ],
     }),
+
+    // https://github.com/unplugin/unplugin-icons?tab=readme-ov-file
+    // https://icon-sets.iconify.design
     Icons({
       autoInstall: true,
       customCollections: {
diff --git a/vite.config.ts b/vite.config.ts
index 9b4a788..eebb43a 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -121,8 +121,18 @@ export default defineConfig(async (configEnv) => {
 
           // https://www.npmjs.com/package/utils4u/v/2.19.2?activeTab=code
           manualChunks: (id: string, _meta: ManualChunkMeta) => {
-            if (!id.includes('node_modules')) return;
+            /* 有一个问题: dynamic import will not move module into another chunk.
+              if (['/src/layouts'].some((prefix) => id.includes(prefix))) {
+                return 'layouts';
+              }
+            */
 
+            if (id.includes('index.page.vue')) {
+              const parentDir = path.basename(path.dirname(id));
+              return `${parentDir}-index.page`;
+            }
+
+            if (!id.includes('node_modules')) return;
             // 处理 pnpm 的特殊路径结构
             let packageName;
             if (id.includes('.pnpm')) {
@@ -140,6 +150,10 @@ export default defineConfig(async (configEnv) => {
             }
 
             if (packageName) {
+              if (['highlight.js'].includes(packageName)) {
+                return 'lib-hljs';
+              }
+
               // 根据包名分组
               if (['consola', 'lodash', '@juggle+resize-observer'].includes(packageName)) {
                 return 'lib-vendor';