chore: document v1 dto fields

backend/app/http/v1/dto/common.go

@@ -3,18 +3,26 @@ package dto
 import "quyun/v2/app/requests"
 
 type UploadResult struct {
-	ID       int64  `json:"id"`
-	URL      string `json:"url"`
+	// ID 媒体资源ID。
+	ID int64 `json:"id"`
+	// URL 访问地址（包含签名或公共URL）。
+	URL string `json:"url"`
+	// Filename 原始文件名。
 	Filename string `json:"filename"`
-	Size     int64  `json:"size"`
+	// Size 文件大小（字节）。
+	Size int64 `json:"size"`
+	// MimeType 文件类型（如 image/png）。
 	MimeType string `json:"mime_type"`
 }
 
 type OptionsResponse struct {
+	// ContentStatus 内容状态选项。
 	ContentStatus []requests.KV `json:"content_status"`
-	ContentGenre  []requests.KV `json:"content_genre"`
+	// ContentGenre 内容类型/分类选项。
+	ContentGenre []requests.KV `json:"content_genre"`
 }
 
 type UploadForm struct {
+	// Type 上传资源类型（如 cover/media/avatar）。
 	Type string `form:"type" json:"type"`
 }