feat 完善注释

src/components/FilePreviewDialog.vue

@@ -37,12 +37,10 @@ function onDownload(): void {
         </header>
 
         <div class="preview-dialog__body">
-          <!-- 加载中 -->
           <div v-if="loading" class="preview-dialog__center">
             预览加载中…
           </div>
 
-          <!-- 加载失败 / 无 ossId 等错误 -->
           <div v-else-if="error" class="preview-dialog__center">
             <p class="preview-dialog__msg">{{ error }}</p>
             <AppButton v-if="file?.url" type="primary" @click="onDownload">
@@ -50,7 +48,6 @@ function onDownload(): void {
             </AppButton>
           </div>
 
-          <!-- 不支持内联预览（office 等） -->
           <div v-else-if="kind === 'unsupported'" class="preview-dialog__center">
             <p class="preview-dialog__msg">
               当前格式（{{ (file?.name ?? '').split('.').pop() }}）不支持在线预览，请下载后查看。
@@ -60,7 +57,6 @@ function onDownload(): void {
             </AppButton>
           </div>
 
-          <!-- 图片 -->
           <img
             v-else-if="kind === 'image' && objectUrl"
             :src="objectUrl"
@@ -68,7 +64,6 @@ function onDownload(): void {
             alt="预览"
           >
 
-          <!-- PDF（blob 已带 application/pdf，iframe 内联渲染） -->
           <iframe
             v-else-if="kind === 'pdf' && objectUrl"
             :src="objectUrl"
@@ -76,7 +71,6 @@ function onDownload(): void {
             title="预览"
           />
 
-          <!-- 视频 -->
           <video
             v-else-if="kind === 'video' && objectUrl"
             :src="objectUrl"
@@ -84,7 +78,6 @@ function onDownload(): void {
             controls
           />
 
-          <!-- 音频 -->
           <audio
             v-else-if="kind === 'audio' && objectUrl"
             :src="objectUrl"
@@ -92,7 +85,6 @@ function onDownload(): void {
             controls
           />
 
-          <!-- 文本（大文件截断预览，避免卡死浏览器） -->
           <div v-else-if="kind === 'text'" class="preview-dialog__text-wrap">
             <p v-if="truncated" class="preview-dialog__hint">
               <span>文件较大（{{ formatBytes(totalBytes ?? 0) }}），仅预览前 {{ formatBytes(PREVIEW_TEXT_MAX_BYTES) }}，完整内容请下载。</span>