From c915847d9210ee352e403e631771b3ccd2b6451f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sat, 5 Sep 2026 23:30:14 +0800
Subject: [PATCH] =?UTF-8?q?align(=E8=BD=AF=E4=BB=B6=E7=89=88=E6=9C=AC):=20?=
 =?UTF-8?q?=E6=93=8D=E4=BD=9C=E5=88=97=E4=B8=8B=E8=BD=BD=E6=94=B9<a=20down?=
 =?UTF-8?q?load>=E5=BC=BA=E5=88=B6=E4=B8=8B=E8=BD=BD=E3=80=81=E4=B8=8A?=
 =?UTF-8?q?=E4=BC=A0=E6=88=90=E5=8A=9F=E7=95=99=E9=A9=BB=E5=BC=B9=E7=AA=97?=
 =?UTF-8?q?(=E5=8F=91=E5=B8=83=E6=88=90=E5=8A=9F=E3=80=82=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=EF=BC=9AX=EF=BC=8C=E9=93=BE=E6=8E=A5=EF=BC=9AY?=
 =?UTF-8?q?=E5=8F=AF=E5=A4=8D=E5=88=B6)=E3=80=81=E6=8C=89=E9=92=AE?=
 =?UTF-8?q?=E5=90=8D=E4=B8=8A=E4=BC=A0=E8=BD=AF=E4=BB=B6=E7=89=88=E6=9C=AC?=
 =?UTF-8?q?/=E5=BC=B9=E7=AA=97=E6=A0=87=E9=A2=98=E4=B8=8A=E4=BC=A0?=
 =?UTF-8?q?=E6=96=B0=E7=89=88=E6=9C=AC/=E6=8F=8F=E8=BF=B0=E4=B8=8Ezip?=
 =?UTF-8?q?=E6=8F=90=E7=A4=BA=E5=AF=B9=E9=BD=90=E3=80=81=E7=A9=BA=E6=80=81?=
 =?UTF-8?q?=E6=9A=82=E6=97=A0=E7=89=88=E6=9C=AC=E8=AE=B0=E5=BD=95=EF=BC=88?=
 =?UTF-8?q?=E5=AF=B9=E9=BD=90=20admin.js=20loadSoftwareVersions/=E4=B8=8A?=
 =?UTF-8?q?=E4=BC=A0=E6=AE=B5+admin.html:6094-6110=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../records/RecordsSoftwareVersionPage.vue    | 51 +++++++++++++------
 .../tests/align-software-version.test.ts      | 21 ++++++++
 admin-frontend-vue/tests/task-260.test.ts     |  2 +-
 3 files changed, 58 insertions(+), 16 deletions(-)
 create mode 100644 admin-frontend-vue/tests/align-software-version.test.ts

diff --git a/admin-frontend-vue/src/pages/records/RecordsSoftwareVersionPage.vue b/admin-frontend-vue/src/pages/records/RecordsSoftwareVersionPage.vue
index f6d799b5..90838097 100644
--- a/admin-frontend-vue/src/pages/records/RecordsSoftwareVersionPage.vue
+++ b/admin-frontend-vue/src/pages/records/RecordsSoftwareVersionPage.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { formatDateTime } from '@/utils/datetime'
-/** 软件版本管理页：客户端版本列表 + 上传新版本。 */
+/** 软件版本管理页：客户端版本列表 + 上传新版本（成功留驻弹窗含链接，对齐 admin panel-version）。 */
 import { onMounted, ref } from 'vue'
 import { ElMessage } from 'element-plus'
 import { fetchSoftwareVersions, uploadSoftwareVersion } from './version-api.ts'
@@ -14,6 +14,9 @@ const uploadVisible = ref(false)
 const uploading = ref(false)
 const newVersion = ref('')
 const pickedFile = ref<File | null>(null)
+/** 弹窗内成功/失败文案（对齐 admin.js msgVersion 留驻）。 */
+const uploadMsg = ref('')
+const uploadMsgOk = ref(false)
 
 async function load() {
   loading.value = true
@@ -30,17 +33,27 @@ function onFileChange(file: File) {
   pickedFile.value = file
 }
 
+function openUpload() {
+  uploadMsg.value = ''
+  uploadMsgOk.value = false
+  newVersion.value = ''
+  pickedFile.value = null
+  uploadVisible.value = true
+}
+
 async function submitUpload() {
+  uploadMsg.value = ''
+  uploadMsgOk.value = false
   if (!isNonEmptyVersion(newVersion.value)) {
-    ElMessage.warning('请填写版本号')
+    uploadMsg.value = '请填写版本号'
     return
   }
   if (!pickedFile.value) {
-    ElMessage.warning('请选择 zip 压缩包')
+    uploadMsg.value = '请选择 zip 压缩包'
     return
   }
   if (!/\.zip$/i.test(pickedFile.value.name)) {
-    ElMessage.warning('仅支持 .zip 格式')
+    uploadMsg.value = '仅支持 .zip 格式'
     return
   }
   uploading.value = true
@@ -48,13 +61,14 @@ async function submitUpload() {
     const created = await uploadSoftwareVersion(newVersion.value.trim(), pickedFile.value, pickedFile.value.name)
     const version = created?.version || newVersion.value.trim()
     const link = created?.fileUrl
-    ElMessage.success(link ? `发布成功。版本：${version}，链接：${link}` : `发布成功。版本：${version}`)
-    uploadVisible.value = false
+    // 对齐 admin.js:6484-6488：弹窗保持打开，成功文案(含链接)留驻可复制，仅清空输入并刷新列表。
+    uploadMsg.value = link ? `发布成功。版本：${version}，链接：${link}` : `发布成功。版本：${version}`
+    uploadMsgOk.value = true
     newVersion.value = ''
     pickedFile.value = null
     load()
   } catch (error) {
-    ElMessage.error(error instanceof Error ? error.message : '发布失败')
+    uploadMsg.value = error instanceof Error ? error.message : '上传失败'
   } finally {
     uploading.value = false
   }
@@ -71,16 +85,16 @@ onMounted(load)
         <p>管理客户端更新包版本（用于 /api/version/latest 下发）。</p>
       </div>
       <div class="actions">
-        <el-button type="primary" @click="uploadVisible = true">上传新版本</el-button>
+        <el-button type="primary" @click="openUpload">上传新版本</el-button>
       </div>
     </div>
 
     <el-card shadow="never">
-      <el-table v-loading="loading" :data="items" stripe border empty-text="暂无版本">
+      <el-table v-loading="loading" :data="items" stripe border empty-text="暂无版本记录">
         <el-table-column prop="version" label="版本号" min-width="180" />
         <el-table-column label="下载链接" min-width="240">
           <template #default="{ row }">
-            <el-link v-if="(row as SoftwareVersionItem).fileUrl" type="primary" :href="(row as SoftwareVersionItem).fileUrl" target="_blank">{{ (row as SoftwareVersionItem).fileUrl }}</el-link>
+            <a v-if="(row as SoftwareVersionItem).fileUrl" class="el-link el-link--primary" :href="(row as SoftwareVersionItem).fileUrl" target="_blank" rel="noopener">{{ (row as SoftwareVersionItem).fileUrl }}</a>
             <span v-else class="dim">—</span>
           </template>
         </el-table-column>
@@ -89,28 +103,31 @@ onMounted(load)
         </el-table-column>
         <el-table-column label="操作" width="90" fixed="right">
           <template #default="{ row }">
-            <el-link v-if="(row as SoftwareVersionItem).fileUrl" type="primary" :href="(row as SoftwareVersionItem).fileUrl" target="_blank">下载</el-link>
+            <a v-if="(row as SoftwareVersionItem).fileUrl" class="el-link el-link--primary" :href="(row as SoftwareVersionItem).fileUrl" download>下载</a>
             <span v-else class="dim">—</span>
           </template>
         </el-table-column>
       </el-table>
     </el-card>
 
-    <el-dialog v-model="uploadVisible" title="上传软件版本" width="520px">
+    <el-dialog v-model="uploadVisible" title="上传新版本" width="520px">
+      <p class="upload-desc">上传软件 ZIP 包，系统会自动计算 MD5 并存储到 OSS。</p>
       <el-form label-width="110px">
         <el-form-item label="版本号" required>
-          <el-input v-model="newVersion" placeholder="如 1.0.2" />
+          <el-input v-model="newVersion" placeholder="例如：1.0.0" />
         </el-form-item>
-        <el-form-item label="程序压缩包" required>
+        <el-form-item label="ZIP 压缩包" required>
           <el-upload :auto-upload="false" :limit="1" accept=".zip" :on-change="(file: any) => onFileChange(file.raw)" :on-remove="() => (pickedFile = null)">
             <el-button>选择文件</el-button>
           </el-upload>
+          <p class="zip-hint">仅支持 .zip 格式</p>
           <div v-if="pickedFile" class="dim">{{ pickedFile.name }}</div>
         </el-form-item>
+        <el-alert v-if="uploadMsg" :title="uploadMsg" :type="uploadMsgOk ? 'success' : 'error'" :closable="false" show-icon class="upload-msg" />
       </el-form>
       <template #footer>
         <el-button @click="uploadVisible = false">取消</el-button>
-        <el-button type="primary" :loading="uploading" @click="submitUpload">上传</el-button>
+        <el-button type="primary" :loading="uploading" @click="submitUpload">上传软件版本</el-button>
       </template>
     </el-dialog>
   </div>
@@ -120,4 +137,8 @@ onMounted(load)
 .page-heading { display: flex; justify-content: space-between; align-items: flex-start; }
 .actions { display: flex; align-items: center; gap: 10px; }
 .dim { color: var(--el-text-color-secondary); font-size: 12px; }
+.upload-desc { margin: 0 0 12px; color: var(--el-text-color-secondary); font-size: 12.5px; line-height: 1.6; }
+.zip-hint { margin: 4px 0 0; color: var(--el-text-color-secondary); font-size: 12px; }
+.upload-msg { margin-bottom: 8px; }
+.upload-msg :deep(.el-alert__title) { word-break: break-all; }
 </style>
diff --git a/admin-frontend-vue/tests/align-software-version.test.ts b/admin-frontend-vue/tests/align-software-version.test.ts
new file mode 100644
index 00000000..fd72a1b6
--- /dev/null
+++ b/admin-frontend-vue/tests/align-software-version.test.ts
@@ -0,0 +1,21 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readSource } from './helpers.ts'
+
+/** 对齐 admin.js:6296-6311(强制下载/空态) 与 6475-6495(成功留驻弹窗) 与 admin.html:6090-6110(弹窗文案)。 */
+
+test('align_software_version_page_wiring', () => {
+  const page = readSource('src/pages/records/RecordsSoftwareVersionPage.vue')
+  // 下载按钮：<a download> 强制下载（对齐 admin.js:6301）。
+  assert.match(page, /download/, '下载链接带 download 强制下载')
+  assert.match(page, /download\s*>\s*下载\s*<\/a>/, '操作列下载为强制下载链接')
+  // 上传成功：弹窗保持打开，成功文案留驻可复制（对齐 admin.js:6484-6488）。
+  assert.match(page, /发布成功。版本：/, '成功文案留驻弹窗')
+  assert.match(page, /uploadMsg/, '成功/失败文案在弹窗内展示')
+  // 上传弹窗文案（对齐 admin.html:6094-6110）。
+  assert.match(page, /上传软件 ZIP 包，系统会自动计算 MD5 并存储到 OSS。/, '弹窗描述对齐')
+  assert.match(page, /上传软件版本/, '上传按钮名对齐')
+  assert.match(page, /上传新版本/, '弹窗标题对齐')
+  // 空态（对齐 admin.js:6296 暂无版本记录）。
+  assert.match(page, /暂无版本记录/, '空态文案对齐')
+})
diff --git a/admin-frontend-vue/tests/task-260.test.ts b/admin-frontend-vue/tests/task-260.test.ts
index 57b94579..3a878670 100644
--- a/admin-frontend-vue/tests/task-260.test.ts
+++ b/admin-frontend-vue/tests/task-260.test.ts
@@ -58,7 +58,7 @@ test('test_task_260_version_invalid_input_rejected', () => {
   assert.match(page, /请选择 zip 压缩包/)
   assert.match(page, /仅支持 \.zip 格式/)
   assert.match(page, /accept="\.zip"/)
-  assert.match(page, /发布失败/)
+  assert.match(page, /上传失败/, '上传失败兜底文案')
 })
 
 test('test_task_260_version_dependency_failure_returns_actionable_message', () => {