@liujitcn/kratos-admin-core 0.0.54 → 0.0.56

package/dist/package/declarations/src/api/base/v1/config.d.ts

@@ -1,7 +1,9 @@
-import type { ConfigService, GetConfigRequest, GetConfigResponse } from "../../../rpc/base/v1/config";
+import type { ConfigService, GetConfigRequest, GetConfigResponse, GetI18nCustomRequest, GetI18nCustomResponse } from "../../../rpc/base/v1/config";
 /** 系统配置公共服务 */
 export declare class ConfigServiceImpl implements ConfigService {
     /** 获取系统配置 */
     GetConfig(request: GetConfigRequest): Promise<GetConfigResponse>;
+    /** 获取当前租户的自定义国际化覆盖项。 */
+    GetI18nCustom(request: GetI18nCustomRequest): Promise<GetI18nCustomResponse>;
 }
 export declare const defConfigService: ConfigServiceImpl;

package/dist/package/declarations/src/api/base/v1/file.d.ts

@@ -1,10 +1,10 @@
-import type { MultiUploadFileResponse, FileInfo } from "../../../rpc/base/v1/file";
+import { BaseFileAccessMode, type MultiUploadFileResponse, type FileInfo } from "../../../rpc/base/v1/file";
 /** 文件服务 */
 export declare class FileServiceImpl {
     /** 多个文件上传 */
-    MultiUploadFile(files: File[], fileType: string): Promise<MultiUploadFileResponse>;
+    MultiUploadFile(files: File[], fileType: string, accessMode?: BaseFileAccessMode): Promise<MultiUploadFileResponse>;
     /** 上传文件 */
-    UploadFile(file: File, fileType: string): Promise<FileInfo>;
+    UploadFile(file: File, fileType: string, accessMode?: BaseFileAccessMode): Promise<FileInfo>;
     /** 读取文件内容并返回 Blob。 */
     GetFileBlob(file: string, fileName: string): Promise<Blob>;
     /** 下载文件 */

package/dist/package/declarations/src/components/Upload/File.vue.d.ts

@@ -1,5 +1,5 @@
 import type { UploadUserFile } from "element-plus";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 /** 单文件上传组件属性。 */
 interface UploadFileProps {
     fileInfo?: UploadUserFile;
@@ -8,6 +8,7 @@ interface UploadFileProps {
     fileSize?: number;
     fileType?: string[];
     uploadType?: string;
+    accessMode?: BaseFileAccessMode;
 }
 declare const __VLS_export: import("vue").DefineComponent<UploadFileProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:fileInfo": (value: UploadUserFile | undefined) => any;
@@ -16,6 +17,7 @@ declare const __VLS_export: import("vue").DefineComponent<UploadFileProps, {}, {
 }>, {
     disabled: boolean;
     fileType: string[];
+    accessMode: BaseFileAccessMode;
     uploadType: string;
     fileInfo: UploadUserFile;
     fileSize: number;

package/dist/package/declarations/src/components/Upload/Files.vue.d.ts

@@ -1,5 +1,5 @@
 import type { UploadUserFile } from "element-plus";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 /** 多文件上传组件属性。 */
 interface UploadFilesProps {
     fileList: UploadUserFile[];
@@ -9,6 +9,7 @@ interface UploadFilesProps {
     fileSize?: number;
     fileType?: string[];
     uploadType?: string;
+    accessMode?: BaseFileAccessMode;
 }
 declare const __VLS_export: import("vue").DefineComponent<UploadFilesProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:fileList": (value: UploadUserFile[]) => any;
@@ -17,6 +18,7 @@ declare const __VLS_export: import("vue").DefineComponent<UploadFilesProps, {},
 }>, {
     disabled: boolean;
     fileType: string[];
+    accessMode: BaseFileAccessMode;
     uploadType: string;
     fileSize: number;
     fileList: UploadUserFile[];

package/dist/package/declarations/src/components/Upload/Img.vue.d.ts

@@ -1,9 +1,10 @@
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 /** 单图上传组件属性。 */
 interface UploadFileProps {
     imageUrl: string;
     api?: (file: File) => Promise<FileInfo>;
     uploadType?: string;
+    accessMode?: BaseFileAccessMode;
     drag?: boolean;
     disabled?: boolean;
     fileSize?: number;
@@ -27,10 +28,11 @@ declare const __VLS_base: import("vue").DefineComponent<UploadFileProps, {}, {},
     width: string;
     height: string;
     drag: boolean;
+    imageUrl: string;
     fileType: File.ImageMimeType[];
+    accessMode: BaseFileAccessMode;
     uploadType: string;
     fileSize: number;
-    imageUrl: string;
     borderRadius: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/package/declarations/src/components/Upload/Imgs.vue.d.ts

@@ -1,10 +1,11 @@
 import type { UploadUserFile } from "element-plus";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 /** 多图上传组件属性。 */
 interface UploadFileProps {
     fileList: UploadUserFile[];
     api?: (file: File) => Promise<FileInfo>;
     uploadType?: string;
+    accessMode?: BaseFileAccessMode;
     drag?: boolean;
     disabled?: boolean;
     limit?: number;
@@ -30,6 +31,7 @@ declare const __VLS_base: import("vue").DefineComponent<UploadFileProps, {}, {},
     height: string;
     drag: boolean;
     fileType: File.ImageMimeType[];
+    accessMode: BaseFileAccessMode;
     uploadType: string;
     fileSize: number;
     fileList: UploadUserFile[];

package/dist/package/declarations/src/hooks/useImageUrl.d.ts

@@ -0,0 +1,8 @@
+import { type Ref } from "vue";
+/**
+ * 管理图片地址，并在配置地址为空或加载失败时回退到指定的本地资源。
+ */
+export declare function useImageUrl(configuredImageUrl: Readonly<Ref<string>>, fallbackImageUrl: string): {
+    imageUrl: Ref<string, string>;
+    handleImageError: () => void;
+};

package/dist/package/declarations/src/hooks/useLogoUrl.d.ts

@@ -0,0 +1,8 @@
+import type { Ref } from "vue";
+/**
+ * 管理站点 Logo 地址，并在配置地址不可用时回退到本地默认 Logo。
+ */
+export declare function useLogoUrl(configuredLogoUrl: Readonly<Ref<string>>): {
+    logoUrl: Ref<string, string>;
+    handleLogoError: () => void;
+};

package/dist/package/declarations/src/rpc/base/v1/config.d.ts

@@ -29,8 +29,16 @@ export interface GetConfigResponse {
     configs: ConfigItem[];
     /** AI 助手是否可用 */
     ai_enabled: boolean;
+}
+/** 当前租户自定义国际化覆盖项查询条件。 */
+export interface GetI18nCustomRequest {
+    /** 位置：枚举【BaseConfigSite】 */
+    site: BaseConfigSite;
+}
+/** 当前租户自定义国际化覆盖项查询结果。 */
+export interface GetI18nCustomResponse {
     /** 全部语言的自定义国际化覆盖项 */
-    i18n_customs: I18nCustomItem[];
+    items: I18nCustomItem[];
 }
 /** 全部语言的自定义国际化覆盖项。 */
 export interface I18nCustomItem {
@@ -45,4 +53,6 @@ export interface I18nCustomItem {
 export interface ConfigService {
     /** 获取系统配置 */
     GetConfig(request: GetConfigRequest): Promise<GetConfigResponse>;
+    /** 获取当前租户的自定义国际化覆盖项 */
+    GetI18nCustom(request: GetI18nCustomRequest): Promise<GetI18nCustomResponse>;
 }

package/dist/package/declarations/src/rpc/base/v1/file.d.ts

@@ -1,4 +1,13 @@
 import type { BytesValue } from "../../google/protobuf/wrappers";
+/** 文件访问方式。 */
+export declare enum BaseFileAccessMode {
+    /** BASE_FILE_ACCESS_MODE_UNSPECIFIED - 未指定文件访问方式，服务端按授权访问处理。 */
+    BASE_FILE_ACCESS_MODE_UNSPECIFIED = 0,
+    /** BASE_FILE_ACCESS_MODE_PUBLIC - 允许匿名公开访问。 */
+    BASE_FILE_ACCESS_MODE_PUBLIC = 1,
+    /** BASE_FILE_ACCESS_MODE_AUTHORIZED - 必须携带有效访问令牌。 */
+    BASE_FILE_ACCESS_MODE_AUTHORIZED = 2
+}
 /** 批量上传文件请求参数 */
 export interface MultiUploadFileRequest {
     /** 文件名 */
@@ -24,6 +33,8 @@ export interface UploadFileInfo {
     path: string;
     /** 二进制内容将通过 base64 编码传输 */
     content: Uint8Array;
+    /** 文件访问方式，未指定时默认需要访问令牌 */
+    access_mode: BaseFileAccessMode;
 }
 /** 下载文件请求参数 */
 export interface DownloadFileRequest {

package/dist/package/declarations/src/stores/modules/config.d.ts

@@ -23,6 +23,14 @@ export declare const useConfigStore: import("pinia").StoreDefinition<"admin-conf
         adminLogo: string;
         background: string;
     }>;
+    /**
+     * 登录成功后加载当前租户的自定义国际化覆盖项。
+     */
+    loadI18nCustom(): Promise<void>;
+    /**
+     * 清空租户自定义翻译并恢复本地默认文案。
+     */
+    resetI18nCustom(): void;
 }>;
 /** 刷新当前管理端语言和站点运行配置。 */
 export declare function refreshAdminRuntimeConfig(): Promise<void>;

package/dist/package/declarations/src/utils/tenant.d.ts

@@ -1,6 +1,11 @@
+import type { SelectOptionResponse_Option } from "../rpc/common/v1/common";
 /** 默认租户编码。 */
 export declare const DEFAULT_TENANT_CODE = "0000";
+/** 读取共享租户选项，同一时间只发起一次请求。 */
+export declare function loadSharedTenantOptions(): Promise<SelectOptionResponse_Option[]>;
+/** 清除共享租户选项，租户数据变更后由下一次读取重新加载。 */
+export declare function invalidateTenantOptions(): void;
 /** 读取租户列表筛选选项。 */
 export declare function requestTenantOptions(): Promise<{
-    data: import("../rpc/common/v1/common").SelectOptionResponse_Option[];
+    data: SelectOptionResponse_Option[];
 }>;

package/dist/package/src/api/base/v1/config.ts

@@ -1,5 +1,11 @@
 import service from "../../../utils/request";
-import type { ConfigService, GetConfigRequest, GetConfigResponse } from "../../../rpc/base/v1/config";
+import type {
+  ConfigService,
+  GetConfigRequest,
+  GetConfigResponse,
+  GetI18nCustomRequest,
+  GetI18nCustomResponse
+} from "../../../rpc/base/v1/config";
 
 const CONFIG_URL = "/v1/base/config";
 
@@ -14,6 +20,15 @@ export class ConfigServiceImpl implements ConfigService {
       headers: { Authorization: "no-auth" }
     });
   }
+
+  /** 获取当前租户的自定义国际化覆盖项。 */
+  GetI18nCustom(request: GetI18nCustomRequest): Promise<GetI18nCustomResponse> {
+    return service<GetI18nCustomRequest, GetI18nCustomResponse>({
+      url: `${CONFIG_URL}/i18n-custom`,
+      method: "get",
+      params: request
+    });
+  }
 }
 
 export const defConfigService = new ConfigServiceImpl();

package/dist/package/src/api/base/v1/file.ts

@@ -1,17 +1,18 @@
 import service from "../../../utils/request";
-import type { DownloadFileRequest, MultiUploadFileResponse, FileInfo } from "../../../rpc/base/v1/file";
+import { BaseFileAccessMode, type DownloadFileRequest, type MultiUploadFileResponse, type FileInfo } from "../../../rpc/base/v1/file";
 
 const FILE_URL = "/v1/base/file";
 
 /** 文件服务 */
 export class FileServiceImpl {
   /** 多个文件上传 */
-  MultiUploadFile(files: File[], fileType: string): Promise<MultiUploadFileResponse> {
+  MultiUploadFile(files: File[], fileType: string, accessMode = BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED): Promise<MultiUploadFileResponse> {
     const formData = new FormData();
     files.map(file => {
       formData.append(file.name, file);
     });
     formData.append("fileType", fileType);
+    formData.append("accessMode", String(accessMode));
     return service<FormData, MultiUploadFileResponse>({
       url: `${FILE_URL}/multi`,
       method: "post",
@@ -22,10 +23,11 @@ export class FileServiceImpl {
     });
   }
   /** 上传文件 */
-  UploadFile(file: File, fileType: string): Promise<FileInfo> {
+  UploadFile(file: File, fileType: string, accessMode = BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED): Promise<FileInfo> {
     const formData = new FormData();
     formData.append("file", file);
     formData.append("fileType", fileType);
+    formData.append("accessMode", String(accessMode));
     return service<FormData, FileInfo>({
       url: `${FILE_URL}`,
       method: "post",

package/dist/package/src/assets/images/logo.svg

@@ -1 +1,13 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 261.76 226.69"><path d="M161.096.001l-30.225 52.351L100.647.001H-.005l130.877 226.688L261.749.001z" fill="#41b883"/><path d="M161.096.001l-30.225 52.351L100.647.001H52.346l78.526 136.01L209.398.001z" fill="#34495e"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 56" role="img" aria-label="Admin logo">
+  <rect x="3" y="8" width="54" height="43" rx="7" fill="#eef6ff" stroke="#244987" stroke-width="4"/>
+  <rect x="11" y="17" width="22" height="24" rx="4" fill="#fff"/>
+  <path d="M17 22a5 5 0 1 0 5 5" fill="none" stroke="#ffd15c" stroke-width="4"/>
+  <path d="M22 22a5 5 0 0 1 5 5" fill="none" stroke="#ffbd00" stroke-width="4"/>
+  <rect x="17" y="34" width="3" height="4" rx="1" fill="#8679e8"/>
+  <rect x="22" y="31" width="3" height="7" rx="1" fill="#6f5bd9"/>
+  <rect x="27" y="28" width="3" height="10" rx="1" fill="#5540cf"/>
+  <path d="M39 23h10M39 29h10M39 35h7" fill="none" stroke="#8a7dea" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="52" cy="10" r="10" fill="#c9f8e4"/>
+  <circle cx="52" cy="10" r="7" fill="#56dba0"/>
+  <path d="m48.5 10 2.5 2.5 4.5-5" fill="none" stroke="#fff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/package/src/bootstrap.ts

@@ -30,6 +30,9 @@ import { useUserStore } from "./stores/modules/user";
 import { getRouteMetaTitle } from "./utils";
 import { defLanguageService } from "./api/base/v1/language";
 import { setAdminDocumentTitle } from "./documentTitle";
+import defaultLogoUrl from "./assets/images/logo.svg";
+import defaultLoginBackgroundUrl from "./assets/images/login_bg.svg";
+import defaultLoginIllustrationUrl from "./assets/images/login_left.png";
 
 /**
  * 管理端启动参数。
@@ -49,6 +52,15 @@ export async function bootstrapAdminApp(options: AdminBootstrapOptions = {}) {
   registerAdminModules(modules);
   registerLocaleMessages(modules);
   initializeLocale();
+
+  // 登录页图片与启动接口并行加载，并在首次挂载前完成解码，避免页面先于图片绘制。
+  const loginImagePreloads = [defaultLogoUrl, defaultLoginBackgroundUrl, defaultLoginIllustrationUrl].map(
+    imageUrl => {
+      const image = new Image();
+      image.src = imageUrl;
+      return image.decode();
+    }
+  );
   try {
     applyLanguageConfig(await defLanguageService.OptionLanguage({}));
   } catch {
@@ -82,6 +94,7 @@ export async function bootstrapAdminApp(options: AdminBootstrapOptions = {}) {
   }
   updateDocumentTitle();
 
+  await Promise.allSettled(loginImagePreloads);
   app.mount(options.mount ?? "#app");
   return app;
 }
@@ -92,7 +105,7 @@ async function refreshLocalizedRuntimeData() {
   const authStore = useAuthStore(pinia);
   const dictStore = useDictStore(pinia);
   const configStore = useConfigStore(pinia);
-  await Promise.allSettled([configStore.loadDisplayConfig()]);
+  await Promise.allSettled([configStore.loadDisplayConfig(), ...(userStore.token ? [configStore.loadI18nCustom()] : [])]);
   if (userStore.token) {
     await Promise.allSettled([authStore.getAuthMenuList(), dictStore.updateDictionaryCache()]);
     syncLocalizedRouteState();

package/dist/package/src/components/Upload/File.vue

@@ -39,7 +39,7 @@ import { Delete, Document, Download } from "@element-plus/icons-vue";
 import { ElNotification, formContextKey, formItemContextKey } from "element-plus";
 import type { UploadProps, UploadRequestOptions, UploadUserFile } from "element-plus";
 import { defFileService } from "../../api/base/v1/file";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 import { useLocaleStore } from "../../locales";
 
 const { t } = useLocaleStore();
@@ -52,6 +52,7 @@ interface UploadFileProps {
   fileSize?: number;
   fileType?: string[];
   uploadType?: string;
+  accessMode?: BaseFileAccessMode; // 文件访问方式，默认需要访问令牌。
 }
 
 const props = withDefaults(defineProps<UploadFileProps>(), {
@@ -59,7 +60,8 @@ const props = withDefaults(defineProps<UploadFileProps>(), {
   disabled: false,
   fileSize: 20,
   fileType: () => [],
-  uploadType: "file"
+  uploadType: "file",
+  accessMode: BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED
 });
 
 const emit = defineEmits<{
@@ -113,7 +115,7 @@ const beforeUpload: UploadProps["beforeUpload"] = rawFile => {
 /** 执行自定义文件上传。 */
 const handleHttpUpload = async (options: UploadRequestOptions) => {
   try {
-    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType));
+    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType, props.accessMode));
     const data = await api(options.file);
     options.onSuccess(data);
   } catch (error) {

package/dist/package/src/components/Upload/Files.vue

@@ -45,7 +45,7 @@ import { Delete, Document, Download } from "@element-plus/icons-vue";
 import { ElNotification, formContextKey, formItemContextKey } from "element-plus";
 import type { UploadProps, UploadRequestOptions, UploadUserFile } from "element-plus";
 import { defFileService } from "../../api/base/v1/file";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 import { useLocaleStore } from "../../locales";
 
 const { t } = useLocaleStore();
@@ -59,6 +59,7 @@ interface UploadFilesProps {
   fileSize?: number;
   fileType?: string[];
   uploadType?: string;
+  accessMode?: BaseFileAccessMode; // 文件访问方式，默认需要访问令牌。
 }
 
 const props = withDefaults(defineProps<UploadFilesProps>(), {
@@ -67,7 +68,8 @@ const props = withDefaults(defineProps<UploadFilesProps>(), {
   limit: 5,
   fileSize: 20,
   fileType: () => [],
-  uploadType: "file"
+  uploadType: "file",
+  accessMode: BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED
 });
 
 const emit = defineEmits<{
@@ -129,7 +131,7 @@ const beforeUpload: UploadProps["beforeUpload"] = rawFile => {
 /** 执行多文件自定义上传。 */
 const handleHttpUpload = async (options: UploadRequestOptions) => {
   try {
-    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType));
+    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType, props.accessMode));
     const data = await api(options.file);
     options.onSuccess(data);
   } catch (error) {

package/dist/package/src/components/Upload/Img.vue

@@ -54,7 +54,7 @@ import { formatSrc } from "../../utils/utils";
 import { defFileService } from "../../api/base/v1/file";
 import { ElNotification, formContextKey, formItemContextKey } from "element-plus";
 import type { UploadProps, UploadRequestOptions } from "element-plus";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 import { useLocaleStore } from "../../locales";
 
 const { t } = useLocaleStore();
@@ -63,7 +63,8 @@ const { t } = useLocaleStore();
 interface UploadFileProps {
   imageUrl: string; // 图片地址 ==> 必传
   api?: (file: File) => Promise<FileInfo>; // 上传图片的 api 方法，默认使用当前文件服务 ==> 非必传
-  uploadType?: string; // 上传文件业务类型 ==> 非必传（默认为 image）
+  uploadType?: string;
+  accessMode?: BaseFileAccessMode; // 文件访问方式，默认需要访问令牌。
   drag?: boolean; // 是否支持拖拽上传 ==> 非必传（默认为 true）
   disabled?: boolean; // 是否禁用上传组件 ==> 非必传（默认为 false）
   fileSize?: number; // 图片大小限制 ==> 非必传（默认为 5M）
@@ -77,6 +78,7 @@ interface UploadFileProps {
 const props = withDefaults(defineProps<UploadFileProps>(), {
   imageUrl: "",
   uploadType: "image",
+  accessMode: BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED,
   drag: true,
   disabled: false,
   fileSize: 5,
@@ -112,7 +114,7 @@ const emit = defineEmits<{
 const handleHttpUpload = async (options: UploadRequestOptions) => {
   try {
     // 优先使用页面显式传入的业务上传类型，避免不同业务图片都落到同一个 image 分类。
-    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType));
+    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType, props.accessMode));
     const data = await api(options.file);
     emit("update:imageUrl", data.url);
     // 调用 el-form 内部的校验方法（可自动校验）

package/dist/package/src/components/Upload/Imgs.vue

@@ -50,7 +50,7 @@ import { defFileService } from "../../api/base/v1/file";
 import { formatSrc } from "../../utils/utils";
 import type { UploadProps, UploadFile, UploadUserFile, UploadRequestOptions } from "element-plus";
 import { ElNotification, formContextKey, formItemContextKey } from "element-plus";
-import type { FileInfo } from "../../rpc/base/v1/file";
+import { BaseFileAccessMode, type FileInfo } from "../../rpc/base/v1/file";
 import { useLocaleStore } from "../../locales";
 
 const { t } = useLocaleStore();
@@ -59,7 +59,8 @@ const { t } = useLocaleStore();
 interface UploadFileProps {
   fileList: UploadUserFile[];
   api?: (file: File) => Promise<FileInfo>; // 上传图片的 api 方法，默认使用当前文件服务 ==> 非必传
-  uploadType?: string; // 上传文件业务类型 ==> 非必传（默认为 image）
+  uploadType?: string;
+  accessMode?: BaseFileAccessMode; // 文件访问方式，默认需要访问令牌。
   drag?: boolean; // 是否支持拖拽上传 ==> 非必传（默认为 true）
   disabled?: boolean; // 是否禁用上传组件 ==> 非必传（默认为 false）
   limit?: number; // 最大图片上传数 ==> 非必传（默认为 5张）
@@ -73,6 +74,7 @@ interface UploadFileProps {
 const props = withDefaults(defineProps<UploadFileProps>(), {
   fileList: () => [],
   uploadType: "image",
+  accessMode: BaseFileAccessMode.BASE_FILE_ACCESS_MODE_AUTHORIZED,
   drag: true,
   disabled: false,
   limit: 5,
@@ -133,7 +135,7 @@ const beforeUpload: UploadProps["beforeUpload"] = rawFile => {
 const handleHttpUpload = async (options: UploadRequestOptions) => {
   try {
     // 优先使用页面显式传入的业务上传类型，避免不同业务图片都落到同一个 image 分类。
-    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType));
+    const api = props.api ?? (file => defFileService.UploadFile(file, props.uploadType, props.accessMode));
     const data = await api(options.file);
     options.onSuccess(data);
   } catch (error) {

package/dist/package/src/hooks/useImageUrl.ts

@@ -0,0 +1,25 @@
+import { ref, watch, type Ref } from "vue";
+
+/**
+ * 管理图片地址，并在配置地址为空或加载失败时回退到指定的本地资源。
+ */
+export function useImageUrl(configuredImageUrl: Readonly<Ref<string>>, fallbackImageUrl: string) {
+  const imageUrl = ref(fallbackImageUrl);
+
+  watch(
+    configuredImageUrl,
+    value => {
+      imageUrl.value = value || fallbackImageUrl;
+    },
+    { immediate: true }
+  );
+
+  /** 图片加载失败时回退到指定的本地资源。 */
+  const handleImageError = () => {
+    if (imageUrl.value !== fallbackImageUrl) {
+      imageUrl.value = fallbackImageUrl;
+    }
+  };
+
+  return { imageUrl, handleImageError };
+}

package/dist/package/src/hooks/useLogoUrl.ts

@@ -0,0 +1,11 @@
+import type { Ref } from "vue";
+import defaultLogoUrl from "../assets/images/logo.svg";
+import { useImageUrl } from "../hooks/useImageUrl";
+
+/**
+ * 管理站点 Logo 地址，并在配置地址不可用时回退到本地默认 Logo。
+ */
+export function useLogoUrl(configuredLogoUrl: Readonly<Ref<string>>) {
+  const { imageUrl, handleImageError } = useImageUrl(configuredLogoUrl, defaultLogoUrl);
+  return { logoUrl: imageUrl, handleLogoError: handleImageError };
+}

package/dist/package/src/layouts/LayoutClassic/index.vue

@@ -4,7 +4,12 @@
     <el-header>
       <div class="header-lf mask-image">
         <div class="logo flx-center">
-          <img class="logo-img" :src="logoUrl" :alt="t('core.layout.logo_alt')" />
+          <img
+            class="logo-img"
+            :src="logoUrl"
+            :alt="t('core.layout.logo_alt')"
+            @error="handleLogoError"
+          />
           <span class="logo-text">{{ title }}</span>
         </div>
         <ToolBarLeft />
@@ -47,6 +52,7 @@ import SubMenu from "../../layouts/components/Menu/SubMenu.vue";
 import ToolBarLeft from "../../layouts/components/Header/ToolBarLeft.vue";
 import ToolBarRight from "../../layouts/components/Header/ToolBarRight.vue";
 import { useLocaleStore } from "../../locales";
+import { useLogoUrl } from "../../hooks/useLogoUrl";
 
 const route = useRoute();
 const authStore = useAuthStore();
@@ -58,7 +64,8 @@ const isCollapse = computed(() => globalStore.isCollapse);
 const menuList = computed(() => authStore.showMenuListGet);
 const activeMenu = computed(() => route.path as string);
 const title = computed(() => configStore.display.sysName || import.meta.env.VITE_GLOB_APP_TITLE);
-const logoUrl = computed(() => configStore.display.adminLogo);
+const configuredLogoUrl = computed(() => configStore.display.adminLogo);
+const { logoUrl, handleLogoError } = useLogoUrl(configuredLogoUrl);
 </script>
 
 <style scoped lang="scss">

package/dist/package/src/layouts/LayoutColumns/index.vue

@@ -3,7 +3,12 @@
   <el-container class="layout">
     <div class="aside-split">
       <div class="logo flx-center">
-        <img class="logo-img" :src="logoUrl" :alt="t('core.layout.logo_alt')" />
+        <img
+          class="logo-img"
+          :src="logoUrl"
+          :alt="t('core.layout.logo_alt')"
+          @error="handleLogoError"
+        />
       </div>
       <el-scrollbar>
         <div class="split-list">
@@ -61,6 +66,7 @@ import ToolBarLeft from "../../layouts/components/Header/ToolBarLeft.vue";
 import ToolBarRight from "../../layouts/components/Header/ToolBarRight.vue";
 import SubMenu from "../../layouts/components/Menu/SubMenu.vue";
 import { useLocaleStore } from "../../locales";
+import { useLogoUrl } from "../../hooks/useLogoUrl";
 
 const route = useRoute();
 const router = useRouter();
@@ -74,7 +80,8 @@ const menuList = computed(() => authStore.showMenuListGet.filter(item => Boolean
 const activeMenu = computed(() => route.path as string);
 const title = computed(() => configStore.display.sysName || import.meta.env.VITE_GLOB_APP_TITLE);
 const collapseTitle = computed(() => title.value.slice(0, 1).toUpperCase() || "S");
-const logoUrl = computed(() => configStore.display.adminLogo);
+const configuredLogoUrl = computed(() => configStore.display.adminLogo);
+const { logoUrl, handleLogoError } = useLogoUrl(configuredLogoUrl);
 
 const subMenuList = ref<RouteItem[]>([]);
 const splitActive = ref("");

package/dist/package/src/layouts/LayoutTransverse/index.vue

@@ -3,7 +3,12 @@
   <el-container class="layout">
     <el-header>
       <div class="logo flx-center">
-        <img class="logo-img" :src="logoUrl" :alt="t('core.layout.logo_alt')" />
+        <img
+          class="logo-img"
+          :src="logoUrl"
+          :alt="t('core.layout.logo_alt')"
+          @error="handleLogoError"
+        />
         <span class="logo-text">{{ title }}</span>
       </div>
       <el-menu mode="horizontal" :router="false" :default-active="activeMenu">
@@ -45,6 +50,7 @@ import Main from "../../layouts/components/Main/index.vue";
 import ToolBarRight from "../../layouts/components/Header/ToolBarRight.vue";
 import SubMenu from "../../layouts/components/Menu/SubMenu.vue";
 import { useLocaleStore } from "../../locales";
+import { useLogoUrl } from "../../hooks/useLogoUrl";
 
 const route = useRoute();
 const router = useRouter();
@@ -54,7 +60,8 @@ const { t } = useLocaleStore();
 const menuList = computed(() => authStore.showMenuListGet);
 const activeMenu = computed(() => route.path as string);
 const title = computed(() => configStore.display.sysName || import.meta.env.VITE_GLOB_APP_TITLE);
-const logoUrl = computed(() => configStore.display.adminLogo);
+const configuredLogoUrl = computed(() => configStore.display.adminLogo);
+const { logoUrl, handleLogoError } = useLogoUrl(configuredLogoUrl);
 
 const handleClickMenu = (subItem: RouteItem) => {
   const target = getRouteTarget(subItem);

package/dist/package/src/layouts/LayoutVertical/index.vue

@@ -10,6 +10,7 @@
             class="logo-img"
             :src="logoUrl"
             :alt="t('core.layout.logo_alt')"
+            @error="handleLogoError"
           />
           <span
             v-show="!isCollapse"
@@ -53,6 +54,7 @@ import ToolBarLeft from "../../layouts/components/Header/ToolBarLeft.vue";
 import ToolBarRight from "../../layouts/components/Header/ToolBarRight.vue";
 import SubMenu from "../../layouts/components/Menu/SubMenu.vue";
 import { useLocaleStore } from "../../locales";
+import { useLogoUrl } from "../../hooks/useLogoUrl";
 
 const route = useRoute();
 const authStore = useAuthStore();
@@ -64,7 +66,8 @@ const isCollapse = computed(() => globalStore.isCollapse);
 const menuList = computed(() => authStore.showMenuListGet);
 const activeMenu = computed(() => route.path as string);
 const title = computed(() => configStore.display.sysName || import.meta.env.VITE_GLOB_APP_TITLE);
-const logoUrl = computed(() => configStore.display.adminLogo);
+const configuredLogoUrl = computed(() => configStore.display.adminLogo);
+const { logoUrl, handleLogoError } = useLogoUrl(configuredLogoUrl);
 const logoWrapperRef = ref<HTMLElement>();
 const logoIconRef = ref<HTMLImageElement>();
 const logoTextRef = ref<HTMLElement>();

package/dist/package/src/locales/README.md

@@ -9,4 +9,4 @@
 | `en-US.json` | 英文公共语言包。 | 管理端切换为英文时由 Vue I18n 使用。 |
 | `ja-JP.json` | 日文公共语言包。 | 管理端切换为日文时由 Vue I18n 使用。 |
 
-语言包是标准 JSON，不能在文件内直接写注释；新增语言或修改键后执行仓库根目录的 `make i18n-sync`，脚本会校验所有语言并生成注册产物。语言切换选项固定显示后端 `base_language.native_name`，接口不可用时使用代码内置的原生名称；`common.language.*` 仅用于普通文案和语言迁移初始数据。新增语言的完整文件清单见[国际化语言扩展指南](../../../../../../docs/国际化语言扩展指南.md)。
+语言包是标准 JSON，不能在文件内直接写注释；新增语言或修改键后执行仓库根目录的 `make i18n`，脚本会校验所有语言并生成注册产物。语言切换选项固定显示后端 `base_language.native_name`，接口不可用时使用代码内置的原生名称；`common.language.*` 仅用于普通文案和语言迁移初始数据。新增语言的完整文件清单见[国际化语言扩展指南](../../../../../../docs/国际化语言扩展指南.md)。

package/dist/package/src/rpc/base/v1/config.ts

@@ -40,8 +40,18 @@ export interface GetConfigResponse {
   configs: ConfigItem[];
   /** AI 助手是否可用 */
   ai_enabled: boolean;
+}
+
+/** 当前租户自定义国际化覆盖项查询条件。 */
+export interface GetI18nCustomRequest {
+  /** 位置：枚举【BaseConfigSite】 */
+  site: BaseConfigSite;
+}
+
+/** 当前租户自定义国际化覆盖项查询结果。 */
+export interface GetI18nCustomResponse {
   /** 全部语言的自定义国际化覆盖项 */
-  i18n_customs: I18nCustomItem[];
+  items: I18nCustomItem[];
 }
 
 /** 全部语言的自定义国际化覆盖项。 */
@@ -58,4 +68,6 @@ export interface I18nCustomItem {
 export interface ConfigService {
   /** 获取系统配置 */
   GetConfig(request: GetConfigRequest): Promise<GetConfigResponse>;
+  /** 获取当前租户的自定义国际化覆盖项 */
+  GetI18nCustom(request: GetI18nCustomRequest): Promise<GetI18nCustomResponse>;
 }

package/dist/package/src/rpc/base/v1/file.ts

@@ -7,6 +7,16 @@
 /* eslint-disable */
 import type { BytesValue } from "../../google/protobuf/wrappers";
 
+/** 文件访问方式。 */
+export enum BaseFileAccessMode {
+  /** BASE_FILE_ACCESS_MODE_UNSPECIFIED - 未指定文件访问方式，服务端按授权访问处理。 */
+  BASE_FILE_ACCESS_MODE_UNSPECIFIED = 0,
+  /** BASE_FILE_ACCESS_MODE_PUBLIC - 允许匿名公开访问。 */
+  BASE_FILE_ACCESS_MODE_PUBLIC = 1,
+  /** BASE_FILE_ACCESS_MODE_AUTHORIZED - 必须携带有效访问令牌。 */
+  BASE_FILE_ACCESS_MODE_AUTHORIZED = 2,
+}
+
 /** 批量上传文件请求参数 */
 export interface MultiUploadFileRequest {
   /** 文件名 */
@@ -35,6 +45,8 @@ export interface UploadFileInfo {
   path: string;
   /** 二进制内容将通过 base64 编码传输 */
   content: Uint8Array;
+  /** 文件访问方式，未指定时默认需要访问令牌 */
+  access_mode: BaseFileAccessMode;
 }
 
 /** 下载文件请求参数 */

package/dist/package/src/stores/modules/config.ts

@@ -118,18 +118,33 @@ export const useConfigStore = defineStore("admin-config", {
       });
       const configMap = buildConfigMap(configResponse.configs ?? []);
 
-      applyCustomLocaleMessages(configResponse.i18n_customs ?? []);
       this.setDisplayConfig(normalizeSiteDisplayConfig(configMap));
       this.setLoginCaptchaConfig(normalizeLoginCaptchaConfig(configMap));
       this.showTenantCode = !["false", "0"].includes((configMap[SHOW_TENANT_CODE_KEY] ?? "true").toLowerCase());
       this.i18nDraftEnabled = configMap[I18N_DRAFT_ENABLED_KEY] === "true";
       this.aiEnabled = configResponse.ai_enabled === true;
       return this.display;
+    },
+    /**
+     * 登录成功后加载当前租户的自定义国际化覆盖项。
+     */
+    async loadI18nCustom() {
+      const response = await defConfigService.GetI18nCustom({
+        site: BaseConfigSite.BASE_CONFIG_SITE_ADMIN
+      });
+      applyCustomLocaleMessages(response.items ?? []);
+    },
+    /**
+     * 清空租户自定义翻译并恢复本地默认文案。
+     */
+    resetI18nCustom() {
+      applyCustomLocaleMessages([]);
     }
   }
 });
 
 /** 刷新当前管理端语言和站点运行配置。 */
 export async function refreshAdminRuntimeConfig(): Promise<void> {
-  await useConfigStore().loadDisplayConfig();
+  const configStore = useConfigStore();
+  await Promise.all([configStore.loadDisplayConfig(), configStore.loadI18nCustom()]);
 }

package/dist/package/src/stores/modules/user.ts

@@ -10,6 +10,7 @@ import piniaPersistConfig from "../../stores/helper/persist";
 import { useDictStoreHook } from "../../stores/modules/dict";
 import { useLockScreenStore } from "../../stores/modules/lockScreen";
 import { useAuthStore } from "../../stores/modules/auth";
+import { useConfigStore } from "../../stores/modules/config";
 
 const defaultUserInfo: UserInfoForm = {
   user_name: "",
@@ -100,6 +101,7 @@ export const useUserStore = defineStore("admin-user", {
       useDictStoreHook().clearDictionaryCache();
       useLockScreenStore().clearLock();
       useAuthStore().$reset();
+      useConfigStore().resetI18nCustom();
       this.authVersion += 1;
       this.authInvalidated = true;
       this.setToken("");

package/dist/package/src/tenant.ts

@@ -4,7 +4,11 @@ import type { ColumnProps, EnumProps, RenderScope, SearchType } from "./componen
 import { defBaseTenantService } from "./api/system/admin/v1/base_tenant";
 import type { SelectOptionResponse_Option } from "./rpc/common/v1/common";
 import { useUserStore } from "./stores/runtime";
-import { DEFAULT_TENANT_CODE, requestTenantOptions as requestTenantOptionData } from "./utils/tenant";
+import {
+  DEFAULT_TENANT_CODE,
+  loadSharedTenantOptions,
+  requestTenantOptions as requestTenantOptionData
+} from "./utils/tenant";
 
 export * from "./utils/tenant";
 
@@ -89,8 +93,7 @@ export function useTenantScope(): TenantScope {
   async function loadTenantOptions(includeCurrentTenant = false) {
     if (!includeCurrentTenant && !isDefaultTenant.value) return;
     if (tenantOptions.value.length) return;
-    const response = await defBaseTenantService.OptionBaseTenant({ keyword: "" });
-    tenantOptions.value = response.list ?? [];
+    tenantOptions.value = await loadSharedTenantOptions();
   }
 
   function toRequestTenantId(value: unknown) {
@@ -129,7 +132,12 @@ export function useTenantScope(): TenantScope {
         search:
           options.searchable === false
             ? undefined
-            : { el: options.searchEl ?? "tenant-select", key: options.searchKey ?? prop, props: { filterable: true }, order: options.order },
+            : {
+                el: options.searchEl ?? "tenant-select",
+                key: options.searchKey ?? prop,
+                props: { filterable: true },
+                order: options.order ?? 1
+              },
         enum: options.enum ?? requestTenantOptionData,
         render: options.render ?? (scope => resolveTenantLabel(scope.row, prop))
       }

package/dist/package/src/utils/errorHandler.ts

@@ -1,3 +1,4 @@
+import axios from "axios";
 import { ElNotification } from "element-plus";
 import { t } from "../locales";
 
@@ -5,6 +6,7 @@ import { t } from "../locales";
  * @description 全局代码错误捕捉
  * */
 const errorHandler = (error: any) => {
+  if (axios.isCancel(error) || error === "canceled") return false;
   // 过滤 HTTP 请求错误
   if (error.status || error.status == 0) return false;
   let errorMap: { [key: string]: string } = {

package/dist/package/src/utils/request.ts

@@ -152,6 +152,12 @@ function shouldSkipErrorMessage(config?: InternalAxiosRequestConfig) {
   return requestUrl === SESSION_URL && requestMethod === "delete";
 }
 
+/** 判断当前是否处于退出或认证失效过渡状态。 */
+function isAuthTransitioning() {
+  const userStore = getUserStore();
+  return userStore.isLoggingOut || userStore.authInvalidated;
+}
+
 /** 判断响应是否要求用户先修改密码。 */
 function isPasswordChangeRequired(data?: ErrorResponseData) {
   return data?.metadata?.[PASSWORD_CHANGE_REQUIRED_METADATA_KEY] === "true";
@@ -262,7 +268,6 @@ export async function ensureAccessToken() {
     await handleTokenRefresh(false);
     return hasValidAccessToken();
   } catch {
-    userStore.clearAuthData();
     return false;
   }
 }
@@ -304,7 +309,14 @@ export function handleAuthExpired() {
 // 请求拦截器
 service.interceptors.request.use(
   async (config: InternalAxiosRequestConfig) => {
+    const requestUrl = config.url ?? "";
+    const requestMethod = String(config.method ?? "").toLowerCase();
     const skipAuth = shouldSkipAuth(config);
+    const isLogoutRequest = requestUrl === SESSION_URL && requestMethod === "delete";
+    if (isAuthTransitioning() && !skipAuth && !isLogoutRequest) {
+      throw new axios.CanceledError();
+    }
+
     const accessToken = skipAuth ? "" : await getRequestAccessToken();
     Object.assign(config.headers, getLocaleRequestHeaders());
     config.headers[REFRESH_TOKEN_TRANSPORT_HEADER] = REFRESH_TOKEN_TRANSPORT_COOKIE;
@@ -341,14 +353,24 @@ service.interceptors.response.use(
     return Promise.reject(new Error(message || t("common.message.system_error")));
   },
   async (error: AxiosError) => {
+    if (axios.isCancel(error)) {
+      return Promise.reject(error);
+    }
+
     const status = error.response?.status;
     const data = error.response?.data as ErrorResponseData | undefined;
     const code = data?.code;
     const message = data?.message;
     const requestConfig = error.config as RetryableRequestConfig | undefined;
 
-    // 业务请求仅在 401 时尝试刷新并重放，403 直接展示后端权限错误。
-    if ((status === 401 || code === 401) && !shouldSkipAuthExpiredPrompt(requestConfig)) {
+    // 退出或认证失效后，页面中的在途请求返回 401 属于预期结果，不再重复刷新令牌、弹窗或提示错误。
+    if (isAuthTransitioning()) {
+      return Promise.reject(error);
+    }
+
+    // 业务请求仅在 401 时尝试刷新并重放，公共认证接口的 401 继续展示后端业务错误。
+    const isUnauthorized = status === 401 || code === 401;
+    if (isUnauthorized && !shouldSkipAuthExpiredPrompt(requestConfig)) {
       const userStore = getUserStore();
       if (requestConfig && !requestConfig._authRetried && !userStore.isLoggingOut && !userStore.authInvalidated && hasRefreshCookieHint()) {
         requestConfig._authRetried = true;
@@ -374,7 +396,7 @@ service.interceptors.response.use(
     } else if (!shouldSkipErrorMessage(requestConfig)) {
       showRequestError(error.message || t("common.message.system_error"));
     }
-    return Promise.reject(error.message);
+    return Promise.reject(error);
   }
 );
 
@@ -389,12 +411,25 @@ export default request;
 let isRefreshing = false;
 let refreshPromise: Promise<void> | null = null;
 
+/** 判断刷新令牌是否已被服务端判定为失效。 */
+function isRefreshTokenUnauthorized(error: unknown) {
+  if (!axios.isAxiosError<ErrorResponseData>(error)) return false;
+
+  const status = error.response?.status;
+  const code = error.response?.data?.code;
+  return status === 401 || code === 401;
+}
+
 /** 刷新 Token 处理 */
 async function handleTokenRefresh(promptOnFailure = true) {
   if (!isRefreshing) {
     isRefreshing = true;
     refreshPromise = refreshAccessToken()
       .catch(error => {
+        if (isRefreshTokenUnauthorized(error)) {
+          // 刷新令牌失效后立即终止后续自动刷新，避免旧 Cookie 被反复提交。
+          getUserStore().clearAuthData();
+        }
         if (promptOnFailure) {
           console.log("token 刷新失败", error);
           handleAuthExpired();

package/dist/package/src/utils/tenant.ts

@@ -1,10 +1,42 @@
 import { defBaseTenantService } from "../api/system/admin/v1/base_tenant";
+import type { SelectOptionResponse_Option } from "../rpc/common/v1/common";
 
 /** 默认租户编码。 */
 export const DEFAULT_TENANT_CODE = "0000";
 
+const tenantOptions: SelectOptionResponse_Option[] = [];
+let tenantOptionsLoaded = false;
+let tenantOptionsRequest: Promise<SelectOptionResponse_Option[]> | undefined;
+let tenantOptionsVersion = 0;
+
+/** 读取共享租户选项，同一时间只发起一次请求。 */
+export async function loadSharedTenantOptions() {
+  if (tenantOptionsLoaded) return tenantOptions;
+  if (!tenantOptionsRequest) {
+    const requestVersion = tenantOptionsVersion;
+    tenantOptionsRequest = defBaseTenantService.OptionBaseTenant({ keyword: "" })
+      .then(response => {
+        if (requestVersion !== tenantOptionsVersion) return tenantOptions;
+        tenantOptions.splice(0, tenantOptions.length, ...(response.list ?? []));
+        tenantOptionsLoaded = true;
+        return tenantOptions;
+      })
+      .finally(() => {
+        tenantOptionsRequest = undefined;
+      });
+  }
+  return tenantOptionsRequest;
+}
+
+/** 清除共享租户选项，租户数据变更后由下一次读取重新加载。 */
+export function invalidateTenantOptions() {
+  tenantOptionsVersion += 1;
+  tenantOptions.splice(0, tenantOptions.length);
+  tenantOptionsLoaded = false;
+  tenantOptionsRequest = undefined;
+}
+
 /** 读取租户列表筛选选项。 */
 export async function requestTenantOptions() {
-  const response = await defBaseTenantService.OptionBaseTenant({ keyword: "" });
-  return { data: response.list ?? [] };
+  return { data: await loadSharedTenantOptions() };
 }

package/dist/package/src/views/login/components/LoginForm.vue

@@ -629,6 +629,11 @@ const handleLoginResponse = async (result: LoginResponse) => {
     clearPasswordChangeRequired();
   }
   userStore.updateTokenAuth(result.access_token, result.token_type ?? "", result.expires_in);
+  try {
+    await configStore.loadI18nCustom();
+  } catch {
+    configStore.resetI18nCustom();
+  }
   await finishLogin(mustChangePassword);
 };
 

package/dist/package/src/views/login/index.vue

@@ -4,11 +4,23 @@
       <SwitchDark class="dark" />
       <LocaleSwitch v-if="languageOptions.length > 1" class="locale" />
       <div class="login-left">
-        <img class="login-left-img" :src="backgroundUrl" :alt="t('core.login.background_alt')" />
+        <img
+          class="login-left-img"
+          :src="backgroundUrl"
+          :alt="t('core.login.background_alt')"
+          @error="handleBackgroundError"
+        />
       </div>
       <div ref="loginFormRef" class="login-form">
         <div ref="loginLogoRef" class="login-logo">
-          <img v-show="showLogoIcon" ref="logoIconRef" class="login-icon" :src="logoUrl" alt="" />
+          <img
+            v-show="showLogoIcon"
+            ref="logoIconRef"
+            class="login-icon"
+            :src="logoUrl"
+            alt=""
+            @error="handleLogoError"
+          />
           <h2 ref="logoTextRef" class="logo-text" :style="{ fontSize: `${logoFontSize}px` }">{{ projectName }}</h2>
         </div>
         <LoginForm :dialog-anchor="loginFormRef" />
@@ -24,12 +36,20 @@ import SwitchDark from "../../components/SwitchDark/index.vue";
 import LocaleSwitch from "../../components/LocaleSwitch/index.vue";
 import { useConfigStore } from "../../stores/modules/config";
 import { useLocaleStore } from "../../locales";
+import defaultBackgroundUrl from "../../assets/images/login_left.png";
+import { useLogoUrl } from "../../hooks/useLogoUrl";
+import { useImageUrl } from "../../hooks/useImageUrl";
 
 const configStore = useConfigStore();
 const { t, languageOptions } = useLocaleStore();
 const projectName = computed(() => configStore.display.sysName || import.meta.env.VITE_GLOB_APP_TITLE);
-const logoUrl = computed(() => configStore.display.adminLogo);
-const backgroundUrl = computed(() => configStore.display.background);
+const configuredLogoUrl = computed(() => configStore.display.adminLogo);
+const { logoUrl, handleLogoError } = useLogoUrl(configuredLogoUrl);
+const configuredBackgroundUrl = computed(() => configStore.display.background);
+const { imageUrl: backgroundUrl, handleImageError: handleBackgroundError } = useImageUrl(
+  configuredBackgroundUrl,
+  defaultBackgroundUrl
+);
 
 const MAX_LOGO_FONT_SIZE = 42;
 const PREFERRED_MIN_LOGO_FONT_SIZE = 30;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liujitcn/kratos-admin-core",
   "private": false,
-  "version": "0.0.54",
+  "version": "0.0.56",
   "type": "module",
   "description": "kratos-admin frontend runtime and base modules",
   "author": {
@@ -236,7 +236,7 @@
   "scripts": {
     "build": "pnpm build:package",
     "build:package": "node ../../scripts/build-package.mjs .",
-    "test": "tsc -p tsconfig.test.json && node --test dist/test/tests/modules.test.js dist/test/tests/dict.test.js dist/test/tests/menu.test.js dist/test/tests/source-patterns.test.js dist/test/tests/codegen-hmr.test.js dist/test/tests/dialog-request.test.js",
+    "test": "tsc -p tsconfig.test.json && node --test dist/test/tests/modules.test.js dist/test/tests/dict.test.js dist/test/tests/menu.test.js dist/test/tests/source-patterns.test.js dist/test/tests/codegen-hmr.test.js dist/test/tests/dialog-request.test.js dist/test/tests/request-error.test.js",
     "type:check": "vue-tsc --noEmit --skipLibCheck"
   }
 }