@liujitcn/kratos-admin-core 0.0.54 → 0.0.55

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/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/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,7 @@
-<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 64" role="img" aria-label="Admin logo">
+  <rect width="64" height="64" rx="16" fill="#2563eb"/>
+  <path fill="#fff" d="M17 18.5A4.5 4.5 0 0 1 21.5 14h21a4.5 4.5 0 0 1 4.5 4.5v25a4.5 4.5 0 0 1-4.5 4.5h-21a4.5 4.5 0 0 1-4.5-4.5v-25Zm5 1.5v21h20V20.5H22Zm0 25h20v-1H22v1Z"/>
+  <circle cx="23" cy="17.5" r="1.5" fill="#93c5fd"/>
+  <circle cx="28" cy="17.5" r="1.5" fill="#93c5fd"/>
+  <path fill="#93c5fd" d="M25 26h3v10h-3V26Zm5-3h3v13h-3V23Zm5 6h3v7h-3v-7Z"/>
+</svg>

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/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/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.55",
   "type": "module",
   "description": "kratos-admin frontend runtime and base modules",
   "author": {