From 0bb4c884b00222a09df74407a3f26d09467f39b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=88=E5=AD=90=E9=BB=98?= <925456043@qq.com>
Date: Tue, 24 Feb 2026 16:45:23 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BF=AE=E5=A4=8D=E5=85=A8=E9=87=8F?=
 =?UTF-8?q?=E7=B1=BB=E5=9E=8B=E6=A3=80=E6=9F=A5=E6=8A=A5=E9=94=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 收敛可选配置字段并补齐默认值，消除 strict 模式报错

- 补充页面脚本类型定义，移除未使用变量与隐式 any

- 修复主题、表格、标签页等公共包类型边界
---
 easyflow-ui-admin/app/src/api/request.ts      |  2 +-
 easyflow-ui-admin/app/src/router/access.ts    |  2 +-
 easyflow-ui-admin/app/src/store/auth.ts       |  8 ++-
 .../src/views/_core/authentication/login.vue  | 11 ----
 .../app/src/views/ai/plugin/Plugin.vue        | 49 ++++++++++++-----
 .../SysApiKeyResourcePermissionList.vue       |  1 +
 .../src/views/config/settings/Settings.vue    | 52 +++++++++++++++----
 .../preferences/src/update-css-variables.ts   | 21 +++++---
 .../common-ui/src/ui/profile/profile.vue      |  8 +--
 .../effects/layouts/src/basic/layout.vue      | 14 ++---
 .../preferences/preferences-drawer.vue        |  2 +-
 .../plugins/src/echarts/use-echarts.ts        |  4 +-
 .../effects/plugins/src/vxe-table/init.ts     |  5 +-
 .../packages/stores/src/modules/tabbar.ts     |  2 +-
 14 files changed, 113 insertions(+), 68 deletions(-)

diff --git a/easyflow-ui-admin/app/src/api/request.ts b/easyflow-ui-admin/app/src/api/request.ts
index 12a67c9..ecafbe9 100644
--- a/easyflow-ui-admin/app/src/api/request.ts
+++ b/easyflow-ui-admin/app/src/api/request.ts
@@ -92,7 +92,7 @@ function createRequestClient(baseURL: string, options?: RequestClientOptions) {
       client,
       doReAuthenticate,
       doRefreshToken,
-      enableRefreshToken: preferences.app.enableRefreshToken,
+      enableRefreshToken: preferences.app.enableRefreshToken ?? false,
       formatToken,
     }),
   );
diff --git a/easyflow-ui-admin/app/src/router/access.ts b/easyflow-ui-admin/app/src/router/access.ts
index a8ddc83..7925bb6 100644
--- a/easyflow-ui-admin/app/src/router/access.ts
+++ b/easyflow-ui-admin/app/src/router/access.ts
@@ -22,7 +22,7 @@ async function generateAccess(options: GenerateMenuAndRoutesOptions) {
     IFrameView,
   };
 
-  return await generateAccessible(preferences.app.accessMode, {
+  return await generateAccessible(preferences.app.accessMode ?? 'frontend', {
     ...options,
     fetchMenuListAsync: async () => {
       ElMessage({
diff --git a/easyflow-ui-admin/app/src/store/auth.ts b/easyflow-ui-admin/app/src/store/auth.ts
index 9dbef63..e9de50f 100644
--- a/easyflow-ui-admin/app/src/store/auth.ts
+++ b/easyflow-ui-admin/app/src/store/auth.ts
@@ -54,11 +54,9 @@ export const useAuthStore = defineStore('auth', () => {
         if (accessStore.loginExpired) {
           accessStore.setLoginExpired(false);
         } else {
-          onSuccess
-            ? await onSuccess?.()
-            : await router.push(
-                userInfo.homePath || preferences.app.defaultHomePath,
-              );
+          const homePath =
+            userInfo.homePath || preferences.app.defaultHomePath || '/';
+          onSuccess ? await onSuccess?.() : await router.push(homePath);
         }
 
         if (userInfo?.nickname) {
diff --git a/easyflow-ui-admin/app/src/views/_core/authentication/login.vue b/easyflow-ui-admin/app/src/views/_core/authentication/login.vue
index 5cf31e1..fe3c5ce 100644
--- a/easyflow-ui-admin/app/src/views/_core/authentication/login.vue
+++ b/easyflow-ui-admin/app/src/views/_core/authentication/login.vue
@@ -8,7 +8,6 @@ import { useAppConfig } from '@easyflow/hooks';
 import { $t } from '@easyflow/locales';
 import { preferences } from '@easyflow/preferences';
 
-import { api } from '#/api/request';
 import { useAuthStore } from '#/store';
 
 defineOptions({ name: 'Login' });
@@ -18,8 +17,6 @@ const authStore = useAuthStore();
 
 const { apiURL } = useAppConfig(import.meta.env, import.meta.env.PROD);
 
-type PlatformType = 'ding_talk' | 'wx_web';
-
 const title = computed(() => preferences.auth.welcomeBack);
 const subTitle = computed(() => preferences.auth.loginSubtitle);
 const formSchema = computed((): EasyFlowFormSchema[] => {
@@ -91,14 +88,6 @@ function onSubmit(values: any) {
       console.error('初始化tac失败', error);
     });
 }
-
-function getAuthUrl(platform: PlatformType) {
-  return api.get('/thirdAuth/getAuthUrl', {
-    params: {
-      platform,
-    },
-  });
-}
 </script>
 
 <template>
diff --git a/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue b/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
index 6484b03..ff73c25 100644
--- a/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
+++ b/easyflow-ui-admin/app/src/views/ai/plugin/Plugin.vue
@@ -29,6 +29,26 @@ import AddPluginModal from '#/views/ai/plugin/AddPluginModal.vue';
 import CategoryPluginModal from '#/views/ai/plugin/CategoryPluginModal.vue';
 
 const router = useRouter();
+
+interface PluginCategory {
+  id: string;
+  name: string;
+}
+
+interface PluginRecord {
+  id: string;
+  [key: string]: unknown;
+}
+
+interface HeaderActionEvent {
+  key?: string;
+}
+
+interface CategoryFormData {
+  id?: string;
+  name: string;
+}
+
 // 操作按钮配置
 const actions: ActionButton[] = [
   {
@@ -74,12 +94,12 @@ const actions: ActionButton[] = [
     },
   },
 ];
-const categoryList = ref([]);
+const categoryList = ref<PluginCategory[]>([]);
 const controlBtns = [
   {
     icon: Edit,
     label: $t('button.edit'),
-    onClick(row) {
+    onClick(row: PluginCategory) {
       formData.value.name = row.name;
       formData.value.id = row.id;
       isEdit.value = true;
@@ -90,7 +110,7 @@ const controlBtns = [
     type: 'danger',
     icon: Delete,
     label: $t('button.delete'),
-    onClick(row) {
+    onClick(row: PluginCategory) {
       handleDeleteCategory(row);
     },
   },
@@ -106,9 +126,12 @@ const footerButton = {
 const getPluginCategoryList = async () => {
   return api.get('/api/v1/pluginCategory/list').then((res) => {
     if (res.errorCode === 0) {
+      const serverCategories = Array.isArray(res.data)
+        ? (res.data as PluginCategory[])
+        : [];
       categoryList.value = [
         { id: '0', name: $t('common.allCategories') },
-        ...res.data,
+        ...serverCategories,
       ];
     }
   });
@@ -116,7 +139,7 @@ const getPluginCategoryList = async () => {
 onMounted(() => {
   getPluginCategoryList();
 });
-const handleDelete = (item) => {
+const handleDelete = (item: PluginRecord) => {
   ElMessageBox.confirm($t('message.deleteAlert'), $t('message.noticeTitle'), {
     confirmButtonText: $t('message.ok'),
     cancelButtonText: $t('message.cancel'),
@@ -148,7 +171,7 @@ const headerButtons = [
 const pluginCategoryId = ref('0');
 const dialogVisible = ref(false); // 弹窗显隐
 const isEdit = ref(false); // 是否为编辑模式
-const formData = ref({ name: '', id: '' });
+const formData = ref<CategoryFormData>({ name: '', id: '' });
 
 const handleSubmit = () => {
   // 触发对应事件，传递表单数据
@@ -160,7 +183,7 @@ const handleSubmit = () => {
   // 提交后关闭弹窗
   dialogVisible.value = false;
 };
-const handleButtonClick = (event, _item) => {
+const handleButtonClick = (event: HeaderActionEvent, _item: unknown) => {
   switch (event.key) {
     case 'add': {
       aiPluginModalRef.value.openDialog({});
@@ -168,10 +191,10 @@ const handleButtonClick = (event, _item) => {
     }
   }
 };
-const handleSearch = (params) => {
-  pageDataRef.value.setQuery({ title: params, isQueryOr: true });
+const handleSearch = (params?: string) => {
+  pageDataRef.value.setQuery({ title: params ?? '', isQueryOr: true });
 };
-const handleEditCategory = (params) => {
+const handleEditCategory = (params: CategoryFormData) => {
   api
     .post('/api/v1/pluginCategory/update', {
       id: params.id,
@@ -184,7 +207,7 @@ const handleEditCategory = (params) => {
       }
     });
 };
-const handleAddCategory = (params) => {
+const handleAddCategory = (params: CategoryFormData) => {
   api.post('/api/v1/pluginCategory/save', { name: params.name }).then((res) => {
     if (res.errorCode === 0) {
       getPluginCategoryList();
@@ -192,7 +215,7 @@ const handleAddCategory = (params) => {
     }
   });
 };
-const handleDeleteCategory = (params) => {
+const handleDeleteCategory = (params: PluginCategory) => {
   api
     .get(`/api/v1/pluginCategory/doRemoveCategory?id=${params.id}`)
     .then((res) => {
@@ -202,7 +225,7 @@ const handleDeleteCategory = (params) => {
       }
     });
 };
-const handleClickCategory = (item) => {
+const handleClickCategory = (item: PluginCategory) => {
   pageDataRef.value.setQuery({ category: item.id });
 };
 </script>
diff --git a/easyflow-ui-admin/app/src/views/config/apikey/SysApiKeyResourcePermissionList.vue b/easyflow-ui-admin/app/src/views/config/apikey/SysApiKeyResourcePermissionList.vue
index 9285e6c..5065726 100644
--- a/easyflow-ui-admin/app/src/views/config/apikey/SysApiKeyResourcePermissionList.vue
+++ b/easyflow-ui-admin/app/src/views/config/apikey/SysApiKeyResourcePermissionList.vue
@@ -29,6 +29,7 @@ const pageDataRef = ref();
 const saveDialog = ref();
 const formInline = ref({
   id: '',
+  title: '',
 });
 function search(formEl: FormInstance | undefined) {
   formEl?.validate((valid) => {
diff --git a/easyflow-ui-admin/app/src/views/config/settings/Settings.vue b/easyflow-ui-admin/app/src/views/config/settings/Settings.vue
index 53ad26e..a88afd8 100644
--- a/easyflow-ui-admin/app/src/views/config/settings/Settings.vue
+++ b/easyflow-ui-admin/app/src/views/config/settings/Settings.vue
@@ -17,17 +17,47 @@ import {
 import { api } from '#/api/request.js';
 import providerList from '#/views/ai/model/modelUtils/providerList.json';
 
-const providerOptions =
-  ref<Array<{ label: string; options: any; value: string }>>(providerList);
-const brands = ref([]);
-const llmOptions = ref([]);
+interface ProviderOptionExtra {
+  chatPath?: string;
+  llmEndpoint?: string;
+}
+
+interface ProviderOption {
+  label: string;
+  options?: ProviderOptionExtra;
+  value: string;
+}
+
+interface ModelProvider {
+  key: string;
+  options?: ProviderOptionExtra;
+  title: string;
+}
+
+interface LlmOption {
+  extra: Map<string, string | undefined>;
+  label: string;
+  value: string;
+}
+
+interface SettingsEntity {
+  chatgpt_api_key: string;
+  chatgpt_chatPath: string;
+  chatgpt_endpoint: string;
+  chatgpt_model_name: string;
+  model_of_chat: string;
+}
+
+const providerOptions = ref<ProviderOption[]>(providerList as ProviderOption[]);
+const brands = ref<ModelProvider[]>([]);
+const llmOptions = ref<LlmOption[]>([]);
 
 // 获取品牌接口数据
 function getBrands() {
   api.get('/api/v1/modelProvider/list').then((res) => {
     if (res.errorCode === 0) {
-      brands.value = res.data;
-      llmOptions.value = formatLlmList(res.data);
+      brands.value = (res.data ?? []) as ModelProvider[];
+      llmOptions.value = formatLlmList(brands.value);
     }
   });
 }
@@ -47,7 +77,7 @@ onMounted(() => {
   getBrands();
 });
 
-const entity = ref({
+const entity = ref<SettingsEntity>({
   model_of_chat: '',
   chatgpt_api_key: '',
   chatgpt_chatPath: '',
@@ -55,7 +85,7 @@ const entity = ref({
   chatgpt_model_name: '',
 });
 
-function formatLlmList(data) {
+function formatLlmList(data: ModelProvider[]): LlmOption[] {
   return data.map((item) => {
     const extra = new Map([
       ['chatPath', item.options?.chatPath],
@@ -68,10 +98,10 @@ function formatLlmList(data) {
     };
   });
 }
-function handleChangeModel(value) {
+function handleChangeModel(value: string) {
   const extra = providerList.find((item) => item.value === value);
-  entity.value.chatgpt_chatPath = extra.options.chatPath;
-  entity.value.chatgpt_endpoint = extra.options.llmEndpoint;
+  entity.value.chatgpt_chatPath = extra?.options?.chatPath ?? '';
+  entity.value.chatgpt_endpoint = extra?.options?.llmEndpoint ?? '';
 }
 function handleSave() {
   api.post('/api/v1/sysOption/save', entity.value).then((res) => {
diff --git a/easyflow-ui-admin/packages/@core/preferences/src/update-css-variables.ts b/easyflow-ui-admin/packages/@core/preferences/src/update-css-variables.ts
index 1d6385a..b035306 100644
--- a/easyflow-ui-admin/packages/@core/preferences/src/update-css-variables.ts
+++ b/easyflow-ui-admin/packages/@core/preferences/src/update-css-variables.ts
@@ -29,8 +29,9 @@ function updateCSSVariables(preferences: Preferences) {
   // html 设置 data-theme=[builtinType]
   if (Reflect.has(theme, 'builtinType')) {
     const rootTheme = root.dataset.theme;
-    if (rootTheme !== builtinType) {
-      root.dataset.theme = builtinType;
+    const resolvedBuiltinType = builtinType ?? '';
+    if (rootTheme !== resolvedBuiltinType) {
+      root.dataset.theme = resolvedBuiltinType;
     }
   }
 
@@ -39,7 +40,7 @@ function updateCSSVariables(preferences: Preferences) {
     (item) => item.type === builtinType,
   );
 
-  let builtinTypeColorPrimary: string | undefined = '';
+  let builtinTypeColorPrimary: string | undefined;
 
   if (currentBuiltType) {
     const isDark = isDarkTheme(preferences.theme.mode);
@@ -78,12 +79,16 @@ function updateMainColorVariables(preference: Preferences) {
   }
   const { colorDestructive, colorPrimary, colorSuccess, colorWarning } =
     preference.theme;
+  const resolvedColorPrimary = colorPrimary ?? 'hsl(216 100% 50%)';
+  const resolvedColorWarning = colorWarning ?? 'hsl(42 84% 61%)';
+  const resolvedColorSuccess = colorSuccess ?? 'hsl(144 57% 58%)';
+  const resolvedColorDestructive = colorDestructive ?? 'hsl(348 100% 61%)';
 
   const colorVariables = generatorColorVariables([
-    { color: colorPrimary, name: 'primary' },
-    { alias: 'warning', color: colorWarning, name: 'yellow' },
-    { alias: 'success', color: colorSuccess, name: 'green' },
-    { alias: 'destructive', color: colorDestructive, name: 'red' },
+    { color: resolvedColorPrimary, name: 'primary' },
+    { alias: 'warning', color: resolvedColorWarning, name: 'yellow' },
+    { alias: 'success', color: resolvedColorSuccess, name: 'green' },
+    { alias: 'destructive', color: resolvedColorDestructive, name: 'red' },
   ]);
 
   // 要设置的 CSS 变量映射
@@ -105,7 +110,7 @@ function updateMainColorVariables(preference: Preferences) {
   executeUpdateCSSVariables(colorVariables);
 }
 
-function isDarkTheme(theme: string) {
+function isDarkTheme(theme?: string) {
   let dark = theme === 'dark';
   if (theme === 'auto') {
     dark = window.matchMedia('(prefers-color-scheme: dark)').matches;
diff --git a/easyflow-ui-admin/packages/effects/common-ui/src/ui/profile/profile.vue b/easyflow-ui-admin/packages/effects/common-ui/src/ui/profile/profile.vue
index 155f339..22c7585 100644
--- a/easyflow-ui-admin/packages/effects/common-ui/src/ui/profile/profile.vue
+++ b/easyflow-ui-admin/packages/effects/common-ui/src/ui/profile/profile.vue
@@ -3,8 +3,8 @@ import type { Props } from './types';
 
 import { preferences } from '@easyflow-core/preferences';
 import {
-  EasyFlowAvatar,
   Card,
+  EasyFlowAvatar,
   Tabs,
   TabsList,
   TabsTrigger,
@@ -29,14 +29,14 @@ const tabsValue = defineModel<string>('modelValue');
       <Card class="w-[200px]">
         <div class="mt-4 flex h-40 flex-col items-center justify-center gap-4">
           <EasyFlowAvatar
-            :src="userInfo?.avatar ?? preferences.app.defaultAvatar"
+            :src="userInfo?.avatar ?? preferences.app.defaultAvatar ?? ''"
             class="size-20"
           />
           <span class="text-lg font-semibold">
-            {{ userInfo?.realName ?? '' }}
+            {{ (userInfo as any)?.realName ?? userInfo?.nickname ?? '' }}
           </span>
           <span class="text-foreground/80 text-sm">
-            {{ userInfo?.username ?? '' }}
+            {{ (userInfo as any)?.username ?? userInfo?.loginName ?? '' }}
           </span>
         </div>
         <!-- <Separator class="my-4" /> -->
diff --git a/easyflow-ui-admin/packages/effects/layouts/src/basic/layout.vue b/easyflow-ui-admin/packages/effects/layouts/src/basic/layout.vue
index b9f7dfa..498e825 100644
--- a/easyflow-ui-admin/packages/effects/layouts/src/basic/layout.vue
+++ b/easyflow-ui-admin/packages/effects/layouts/src/basic/layout.vue
@@ -159,7 +159,7 @@ function autoCollapseMenuByRouteMeta(route: RouteLocationNormalizedLoaded) {
   // 只在双列模式下生效
   if (
     ['header-mixed-nav', 'sidebar-mixed-nav'].includes(
-      preferences.app.layout,
+      preferences.app.layout ?? '',
     ) &&
     route.meta &&
     route.meta.hideInMenu
@@ -259,9 +259,9 @@ const headerSlots = computed(() => {
         :class="logoClass"
         :collapsed="logoCollapsed"
         :src="preferences.logo.source"
-        :src-dark="preferences.logo.sourceDark"
-        :src-mini="preferences.logo.sourceMini"
-        :text="preferences.app.name"
+        :src-dark="preferences.logo.sourceDark ?? preferences.logo.source ?? ''"
+        :src-mini="preferences.logo.sourceMini ?? preferences.logo.source ?? ''"
+        :text="preferences.app.name ?? ''"
         :theme="showHeaderNav ? headerTheme : theme"
         @click="clickLogo"
       >
@@ -353,9 +353,9 @@ const headerSlots = computed(() => {
         v-if="preferences.logo.enable"
         :fit="preferences.logo.fit"
         :src="preferences.logo.source"
-        :src-dark="preferences.logo.sourceDark"
-        :src-mini="preferences.logo.sourceMini"
-        :text="preferences.app.name"
+        :src-dark="preferences.logo.sourceDark ?? preferences.logo.source ?? ''"
+        :src-mini="preferences.logo.sourceMini ?? preferences.logo.source ?? ''"
+        :text="preferences.app.name ?? ''"
         :theme="theme"
       >
         <template v-if="$slots['logo-text']" #text>
diff --git a/easyflow-ui-admin/packages/effects/layouts/src/widgets/preferences/preferences-drawer.vue b/easyflow-ui-admin/packages/effects/layouts/src/widgets/preferences/preferences-drawer.vue
index 260ec84..20d3db6 100644
--- a/easyflow-ui-admin/packages/effects/layouts/src/widgets/preferences/preferences-drawer.vue
+++ b/easyflow-ui-admin/packages/effects/layouts/src/widgets/preferences/preferences-drawer.vue
@@ -235,7 +235,7 @@ async function handleReset() {
     return;
   }
   resetPreferences();
-  await loadLocaleMessages(preferences.app.locale);
+  await loadLocaleMessages(preferences.app.locale ?? 'zh-CN');
 }
 </script>
 
diff --git a/easyflow-ui-admin/packages/effects/plugins/src/echarts/use-echarts.ts b/easyflow-ui-admin/packages/effects/plugins/src/echarts/use-echarts.ts
index 2e52ab7..f5483e4 100644
--- a/easyflow-ui-admin/packages/effects/plugins/src/echarts/use-echarts.ts
+++ b/easyflow-ui-admin/packages/effects/plugins/src/echarts/use-echarts.ts
@@ -22,8 +22,6 @@ import echarts from './echarts';
 
 type EchartsUIType = typeof EchartsUI | undefined;
 
-type EchartsThemeType = 'dark' | 'light' | null;
-
 function useEcharts(chartRef: Ref<EchartsUIType>) {
   let chartInstance: echarts.ECharts | null = null;
   let cacheOptions: EChartsOption = {};
@@ -57,7 +55,7 @@ function useEcharts(chartRef: Ref<EchartsUIType>) {
     };
   });
 
-  const initCharts = (t?: EchartsThemeType) => {
+  const initCharts = () => {
     const el = chartRef?.value?.$el;
     if (!el) {
       return;
diff --git a/easyflow-ui-admin/packages/effects/plugins/src/vxe-table/init.ts b/easyflow-ui-admin/packages/effects/plugins/src/vxe-table/init.ts
index 9d3815c..3c0c6c3 100644
--- a/easyflow-ui-admin/packages/effects/plugins/src/vxe-table/init.ts
+++ b/easyflow-ui-admin/packages/effects/plugins/src/vxe-table/init.ts
@@ -116,9 +116,10 @@ export function setupEasyFlowVxeTable(setupOptions: SetupVxeTable) {
   watch(
     [() => isDark.value, () => locale.value],
     ([isDarkValue, localeValue]) => {
+      const resolvedLocale = (localeValue ?? 'zh-CN') as keyof typeof localMap;
       VxeUI.setTheme(isDarkValue ? 'dark' : 'light');
-      VxeUI.setI18n(localeValue, localMap[localeValue]);
-      VxeUI.setLanguage(localeValue);
+      VxeUI.setI18n(resolvedLocale, localMap[resolvedLocale]);
+      VxeUI.setLanguage(resolvedLocale);
     },
     {
       immediate: true,
diff --git a/easyflow-ui-admin/packages/stores/src/modules/tabbar.ts b/easyflow-ui-admin/packages/stores/src/modules/tabbar.ts
index 8463a60..11b299f 100644
--- a/easyflow-ui-admin/packages/stores/src/modules/tabbar.ts
+++ b/easyflow-ui-admin/packages/stores/src/modules/tabbar.ts
@@ -120,7 +120,7 @@ export const useTabbarStore = defineStore('core-tabbar', {
       });
 
       if (tabIndex === -1) {
-        const maxCount = preferences.tabbar.maxCount;
+        const maxCount = preferences.tabbar.maxCount ?? 0;
         // 获取动态路由打开数，超过 0 即代表需要控制打开数
         const maxNumOfOpenTab = (routeTab?.meta?.maxNumOfOpenTab ??
           -1) as number;