Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

src/api/file/file.ts

@@ -71,49 +71,49 @@ export const deleteFile = async (id: number) => {
 
 export interface FileListItem {
 
-    /* */
+    /* 文件记录的唯一标识 ID */
     id: number;
 
-    /* */
+    /* 文件的原始名称（不包含扩展名） */
     fileName: string;
 
-    /* */
+    /* 文件扩展名，例如 "png"、"jpg"、"pdf" 等 */
     fileExtension: string;
 
-    /* */
+    /* 文件大小，单位为字节（Byte） */
     fileSize: number;
 
-    /* */
+    /* 文件内容的哈希值（例如 MD5 或 SHA-256），用于校验与秒传 */
     fileHash: string;
 
-    /* */
+    /* 文件的 MIME 类型，例如 "image/png"、"application/pdf" 等 */
     mimeType: string;
 
-    /* */
+    /* 文件存储方式类型，例如本地存储、对象存储等 */
     storageType: string;
 
-    /* */
+    /* 文件在存储系统中的物理或逻辑路径 */
     storagePath: string;
 
-    /* */
+    /* 业务类型标识，用于区分文件所属的业务场景 */
     businessType: string;
 
-    /* */
+    /* 关联的业务主键 ID，例如订单 ID、用户资料 ID 等 */
     businessId: number;
 
-    /* */
+    /* 上传该文件的用户 ID */
     userId: number;
 
-    /* */
+    /* 图片文件的附加信息，例如宽高、分辨率等（非图片可为空） */
     imageInfo: string;
 
-    /* */
+    /* 逻辑删除标记，0 表示未删除，1 表示已删除 */
     isDeleted: number;
 
-    /* */
+    /* 记录创建时间信息 */
     createdAt: Record<string, unknown>;
 
-    /* */
+    /* 记录最近一次更新时间信息 */
     updatedAt: Record<string, unknown>;
 
 }