名片简介限制改为30字

src/api/keyboard/appversions/index.ts

@@ -0,0 +1,61 @@
+import request from '@/config/axios'
+import type { Dayjs } from 'dayjs';
+
+/** App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。信息 */
+export interface AppVersions {
+          id: number; // 主键，自增版本记录ID。
+          appId?: string; // 应用标识（支持多App/多包名场景）；单App可固定为 main。
+          platform?: string; // 平台：android 或 ios（用 CHECK 约束限制取值）。
+          channel?: string; // 渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。
+          versionName?: string; // 展示用版本号（语义版本字符串），如 1.2.3。
+          versionCode?: number; // 比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。
+          buildNumber: string; // iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。
+          minSupportedCode?: number; // 最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。
+          isForceUpdate?: boolean; // 是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。
+          isActive?: boolean; // 是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。
+          releaseNotes: string; // 更新说明（展示给用户的版本更新内容）。
+          downloadUrl: string; // 下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。
+          storeUrl: string; // 应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。
+          metadata?: object; // 扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。
+          releasedAt?: string | Dayjs; // 发布时间（对外宣布/上线时间），用于展示与排序。
+          createdAt?: string | Dayjs; // 记录创建时间。
+          updatedAt?: string | Dayjs; // 记录更新时间（建议配合触发器自动维护）。
+  }
+
+// App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 API
+export const AppVersionsApi = {
+  // 查询App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。分页
+  getAppVersionsPage: async (params: any) => {
+    return await request.get({ url: `/keyboard/app-versions/page`, params })
+  },
+
+  // 查询App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。详情
+  getAppVersions: async (id: number) => {
+    return await request.get({ url: `/keyboard/app-versions/get?id=` + id })
+  },
+
+  // 新增App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。
+  createAppVersions: async (data: AppVersions) => {
+    return await request.post({ url: `/keyboard/app-versions/create`, data })
+  },
+
+  // 修改App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。
+  updateAppVersions: async (data: AppVersions) => {
+    return await request.put({ url: `/keyboard/app-versions/update`, data })
+  },
+
+  // 删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。
+  deleteAppVersions: async (id: number) => {
+    return await request.delete({ url: `/keyboard/app-versions/delete?id=` + id })
+  },
+
+  /** 批量删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 */
+  deleteAppVersionsList: async (ids: number[]) => {
+    return await request.delete({ url: `/keyboard/app-versions/delete-list?ids=${ids.join(',')}` })
+  },
+
+  // 导出App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 Excel
+  exportAppVersions: async (params) => {
+    return await request.download({ url: `/keyboard/app-versions/export-excel`, params })
+  }
+}

src/views/keyboard/appversions/AppVersionsForm.vue

@@ -0,0 +1,197 @@
+<template>
+  <Dialog :title="dialogTitle" v-model="dialogVisible">
+    <el-form
+      ref="formRef"
+      :model="formData"
+      :rules="formRules"
+      label-width="100px"
+      v-loading="formLoading"
+    >
+      <el-form-item label="应用标识（支持多App/多包名场景）；单App可固定为 main。" prop="appId">
+        <el-input v-model="formData.appId" placeholder="请输入应用标识（支持多App/多包名场景）；单App可固定为 main。" />
+      </el-form-item>
+      <el-form-item label="平台：android 或 ios（用 CHECK 约束限制取值）。" prop="platform">
+        <el-input v-model="formData.platform" placeholder="请输入平台：android 或 ios（用 CHECK 约束限制取值）。" />
+      </el-form-item>
+      <el-form-item label="渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。" prop="channel">
+        <el-input v-model="formData.channel" placeholder="请输入渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。" />
+      </el-form-item>
+      <el-form-item label="展示用版本号（语义版本字符串），如 1.2.3。" prop="versionName">
+        <el-input v-model="formData.versionName" placeholder="请输入展示用版本号（语义版本字符串），如 1.2.3。" />
+      </el-form-item>
+      <el-form-item label="比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。" prop="versionCode">
+        <el-input v-model="formData.versionCode" placeholder="请输入比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。" />
+      </el-form-item>
+      <el-form-item label="iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。" prop="buildNumber">
+        <el-input v-model="formData.buildNumber" placeholder="请输入iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。" />
+      </el-form-item>
+      <el-form-item label="最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。" prop="minSupportedCode">
+        <el-input v-model="formData.minSupportedCode" placeholder="请输入最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。" />
+      </el-form-item>
+      <el-form-item label="是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。" prop="isForceUpdate">
+        <el-radio-group v-model="formData.isForceUpdate">
+          <el-radio value="1">请选择字典生成</el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。" prop="isActive">
+        <el-radio-group v-model="formData.isActive">
+          <el-radio value="1">请选择字典生成</el-radio>
+        </el-radio-group>
+      </el-form-item>
+      <el-form-item label="更新说明（展示给用户的版本更新内容）。" prop="releaseNotes">
+        <el-input v-model="formData.releaseNotes" placeholder="请输入更新说明（展示给用户的版本更新内容）。" />
+      </el-form-item>
+      <el-form-item label="下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。" prop="downloadUrl">
+        <el-input v-model="formData.downloadUrl" placeholder="请输入下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。" />
+      </el-form-item>
+      <el-form-item label="应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。" prop="storeUrl">
+        <el-input v-model="formData.storeUrl" placeholder="请输入应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。" />
+      </el-form-item>
+      <el-form-item label="扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。" prop="metadata">
+        <el-input v-model="formData.metadata" placeholder="请输入扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。" />
+      </el-form-item>
+      <el-form-item label="发布时间（对外宣布/上线时间），用于展示与排序。" prop="releasedAt">
+        <el-date-picker
+          v-model="formData.releasedAt"
+          type="date"
+          value-format="x"
+          placeholder="选择发布时间（对外宣布/上线时间），用于展示与排序。"
+        />
+      </el-form-item>
+      <el-form-item label="记录创建时间。" prop="createdAt">
+        <el-date-picker
+          v-model="formData.createdAt"
+          type="date"
+          value-format="x"
+          placeholder="选择记录创建时间。"
+        />
+      </el-form-item>
+      <el-form-item label="记录更新时间（建议配合触发器自动维护）。" prop="updatedAt">
+        <el-date-picker
+          v-model="formData.updatedAt"
+          type="date"
+          value-format="x"
+          placeholder="选择记录更新时间（建议配合触发器自动维护）。"
+        />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="submitForm" type="primary" :disabled="formLoading">确 定</el-button>
+      <el-button @click="dialogVisible = false">取 消</el-button>
+    </template>
+  </Dialog>
+</template>
+<script setup lang="ts">
+import { AppVersionsApi, AppVersions } from '@/api/keyboard/appversions'
+
+/** App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 表单 */
+defineOptions({ name: 'AppVersionsForm' })
+
+const { t } = useI18n() // 国际化
+const message = useMessage() // 消息弹窗
+
+const dialogVisible = ref(false) // 弹窗的是否展示
+const dialogTitle = ref('') // 弹窗的标题
+const formLoading = ref(false) // 表单的加载中：1）修改时的数据加载；2）提交的按钮禁用
+const formType = ref('') // 表单的类型：create - 新增；update - 修改
+const formData = ref({
+  id: undefined,
+  appId: undefined,
+  platform: undefined,
+  channel: undefined,
+  versionName: undefined,
+  versionCode: undefined,
+  buildNumber: undefined,
+  minSupportedCode: undefined,
+  isForceUpdate: undefined,
+  isActive: undefined,
+  releaseNotes: undefined,
+  downloadUrl: undefined,
+  storeUrl: undefined,
+  metadata: undefined,
+  releasedAt: undefined,
+  createdAt: undefined,
+  updatedAt: undefined
+})
+const formRules = reactive({
+  appId: [{ required: true, message: '应用标识（支持多App/多包名场景）；单App可固定为 main。不能为空', trigger: 'blur' }],
+  platform: [{ required: true, message: '平台：android 或 ios（用 CHECK 约束限制取值）。不能为空', trigger: 'blur' }],
+  channel: [{ required: true, message: '渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。不能为空', trigger: 'blur' }],
+  versionName: [{ required: true, message: '展示用版本号（语义版本字符串），如 1.2.3。不能为空', trigger: 'blur' }],
+  versionCode: [{ required: true, message: '比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。不能为空', trigger: 'blur' }],
+  minSupportedCode: [{ required: true, message: '最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。不能为空', trigger: 'blur' }],
+  isForceUpdate: [{ required: true, message: '是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。不能为空', trigger: 'blur' }],
+  isActive: [{ required: true, message: '是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。不能为空', trigger: 'blur' }],
+  metadata: [{ required: true, message: '扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。不能为空', trigger: 'blur' }],
+  releasedAt: [{ required: true, message: '发布时间（对外宣布/上线时间），用于展示与排序。不能为空', trigger: 'blur' }],
+  createdAt: [{ required: true, message: '记录创建时间。不能为空', trigger: 'blur' }],
+  updatedAt: [{ required: true, message: '记录更新时间（建议配合触发器自动维护）。不能为空', trigger: 'blur' }]
+})
+const formRef = ref() // 表单 Ref
+
+/** 打开弹窗 */
+const open = async (type: string, id?: number) => {
+  dialogVisible.value = true
+  dialogTitle.value = t('action.' + type)
+  formType.value = type
+  resetForm()
+  // 修改时，设置数据
+  if (id) {
+    formLoading.value = true
+    try {
+      formData.value = await AppVersionsApi.getAppVersions(id)
+    } finally {
+      formLoading.value = false
+    }
+  }
+}
+defineExpose({ open }) // 提供 open 方法，用于打开弹窗
+
+/** 提交表单 */
+const emit = defineEmits(['success']) // 定义 success 事件，用于操作成功后的回调
+const submitForm = async () => {
+  // 校验表单
+  await formRef.value.validate()
+  // 提交请求
+  formLoading.value = true
+  try {
+    const data = formData.value as unknown as AppVersions
+    if (formType.value === 'create') {
+      await AppVersionsApi.createAppVersions(data)
+      message.success(t('common.createSuccess'))
+    } else {
+      await AppVersionsApi.updateAppVersions(data)
+      message.success(t('common.updateSuccess'))
+    }
+    dialogVisible.value = false
+    // 发送操作成功的事件
+    emit('success')
+  } finally {
+    formLoading.value = false
+  }
+}
+
+/** 重置表单 */
+const resetForm = () => {
+  formData.value = {
+    id: undefined,
+    appId: undefined,
+    platform: undefined,
+    channel: undefined,
+    versionName: undefined,
+    versionCode: undefined,
+    buildNumber: undefined,
+    minSupportedCode: undefined,
+    isForceUpdate: undefined,
+    isActive: undefined,
+    releaseNotes: undefined,
+    downloadUrl: undefined,
+    storeUrl: undefined,
+    metadata: undefined,
+    releasedAt: undefined,
+    createdAt: undefined,
+    updatedAt: undefined
+  }
+  formRef.value?.resetFields()
+}
+</script>

src/views/keyboard/appversions/index.vue

@@ -0,0 +1,394 @@
+<template>
+  <ContentWrap>
+    <!-- 搜索工作栏 -->
+    <el-form
+      class="-mb-15px"
+      :model="queryParams"
+      ref="queryFormRef"
+      :inline="true"
+      label-width="68px"
+    >
+      <el-form-item label="应用标识（支持多App/多包名场景）；单App可固定为 main。" prop="appId">
+        <el-input
+          v-model="queryParams.appId"
+          placeholder="请输入应用标识（支持多App/多包名场景）；单App可固定为 main。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="平台：android 或 ios（用 CHECK 约束限制取值）。" prop="platform">
+        <el-input
+          v-model="queryParams.platform"
+          placeholder="请输入平台：android 或 ios（用 CHECK 约束限制取值）。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。" prop="channel">
+        <el-input
+          v-model="queryParams.channel"
+          placeholder="请输入渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="展示用版本号（语义版本字符串），如 1.2.3。" prop="versionName">
+        <el-input
+          v-model="queryParams.versionName"
+          placeholder="请输入展示用版本号（语义版本字符串），如 1.2.3。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。" prop="versionCode">
+        <el-input
+          v-model="queryParams.versionCode"
+          placeholder="请输入比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。" prop="buildNumber">
+        <el-input
+          v-model="queryParams.buildNumber"
+          placeholder="请输入iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。" prop="minSupportedCode">
+        <el-input
+          v-model="queryParams.minSupportedCode"
+          placeholder="请输入最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。" prop="isForceUpdate">
+        <el-select
+          v-model="queryParams.isForceUpdate"
+          placeholder="请选择是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。"
+          clearable
+          class="!w-240px"
+        >
+          <el-option label="请选择字典生成" value="" />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。" prop="isActive">
+        <el-select
+          v-model="queryParams.isActive"
+          placeholder="请选择是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。"
+          clearable
+          class="!w-240px"
+        >
+          <el-option label="请选择字典生成" value="" />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="更新说明（展示给用户的版本更新内容）。" prop="releaseNotes">
+        <el-input
+          v-model="queryParams.releaseNotes"
+          placeholder="请输入更新说明（展示给用户的版本更新内容）。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。" prop="downloadUrl">
+        <el-input
+          v-model="queryParams.downloadUrl"
+          placeholder="请输入下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。" prop="storeUrl">
+        <el-input
+          v-model="queryParams.storeUrl"
+          placeholder="请输入应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。" prop="metadata">
+        <el-input
+          v-model="queryParams.metadata"
+          placeholder="请输入扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。"
+          clearable
+          @keyup.enter="handleQuery"
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="发布时间（对外宣布/上线时间），用于展示与排序。" prop="releasedAt">
+        <el-date-picker
+          v-model="queryParams.releasedAt"
+          value-format="YYYY-MM-DD"
+          type="date"
+          placeholder="选择发布时间（对外宣布/上线时间），用于展示与排序。"
+          clearable
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="记录创建时间。" prop="createdAt">
+        <el-date-picker
+          v-model="queryParams.createdAt"
+          value-format="YYYY-MM-DD"
+          type="date"
+          placeholder="选择记录创建时间。"
+          clearable
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item label="记录更新时间（建议配合触发器自动维护）。" prop="updatedAt">
+        <el-date-picker
+          v-model="queryParams.updatedAt"
+          value-format="YYYY-MM-DD"
+          type="date"
+          placeholder="选择记录更新时间（建议配合触发器自动维护）。"
+          clearable
+          class="!w-240px"
+        />
+      </el-form-item>
+      <el-form-item>
+        <el-button @click="handleQuery"><Icon icon="ep:search" class="mr-5px" /> 搜索</el-button>
+        <el-button @click="resetQuery"><Icon icon="ep:refresh" class="mr-5px" /> 重置</el-button>
+        <el-button
+          type="primary"
+          plain
+          @click="openForm('create')"
+          v-hasPermi="['keyboard:app-versions:create']"
+        >
+          <Icon icon="ep:plus" class="mr-5px" /> 新增
+        </el-button>
+        <el-button
+          type="success"
+          plain
+          @click="handleExport"
+          :loading="exportLoading"
+          v-hasPermi="['keyboard:app-versions:export']"
+        >
+          <Icon icon="ep:download" class="mr-5px" /> 导出
+        </el-button>
+        <el-button
+            type="danger"
+            plain
+            :disabled="isEmpty(checkedIds)"
+            @click="handleDeleteBatch"
+            v-hasPermi="['keyboard:app-versions:delete']"
+        >
+          <Icon icon="ep:delete" class="mr-5px" /> 批量删除
+        </el-button>
+      </el-form-item>
+    </el-form>
+  </ContentWrap>
+
+  <!-- 列表 -->
+  <ContentWrap>
+    <el-table
+        row-key="id"
+        v-loading="loading"
+        :data="list"
+        :stripe="true"
+        :show-overflow-tooltip="true"
+        @selection-change="handleRowCheckboxChange"
+    >
+    <el-table-column type="selection" width="55" />
+      <el-table-column label="主键，自增版本记录ID。" align="center" prop="id" />
+      <el-table-column label="应用标识（支持多App/多包名场景）；单App可固定为 main。" align="center" prop="appId" />
+      <el-table-column label="平台：android 或 ios（用 CHECK 约束限制取值）。" align="center" prop="platform" />
+      <el-table-column label="渠道标识：如 official / huawei / xiaomi / testflight 等，用于区分不同分发包。" align="center" prop="channel" />
+      <el-table-column label="展示用版本号（语义版本字符串），如 1.2.3。" align="center" prop="versionName" />
+      <el-table-column label="比较用版本号（整数递增）：Android 对应 versionCode；iOS 建议维护同样的递增值以便比较。" align="center" prop="versionCode" />
+      <el-table-column label="iOS 可选构建号（例如 CFBundleVersion），通常为字符串；用于追溯构建或与CI编号对齐。" align="center" prop="buildNumber" />
+      <el-table-column label="最低支持版本号（整数）：客户端 version_code 低于该值必须更新/可拒绝继续使用。" align="center" prop="minSupportedCode" />
+      <el-table-column label="是否强制更新：当客户端未达到最新版本且此字段为 true，可要求强更（即使 >= min_supported_code）。" align="center" prop="isForceUpdate" />
+      <el-table-column label="是否生效：true 表示该版本记录可用于对外更新检查；false 用于下架/撤回。" align="center" prop="isActive" />
+      <el-table-column label="更新说明（展示给用户的版本更新内容）。" align="center" prop="releaseNotes" />
+      <el-table-column label="下载链接：Android 可为 apk 直链/市场 scheme；iOS 通常为 App Store 链接或统一跳转页。" align="center" prop="downloadUrl" />
+      <el-table-column label="应用市场/商店页面链接（可选，若 download_url 已覆盖可不填）。" align="center" prop="storeUrl" />
+      <el-table-column label="扩展元数据（JSON）：如包大小、md5、签名信息、最低系统版本等。" align="center" prop="metadata" />
+      <el-table-column
+        label="发布时间（对外宣布/上线时间），用于展示与排序。"
+        align="center"
+        prop="releasedAt"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column
+        label="记录创建时间。"
+        align="center"
+        prop="createdAt"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column
+        label="记录更新时间（建议配合触发器自动维护）。"
+        align="center"
+        prop="updatedAt"
+        :formatter="dateFormatter"
+        width="180px"
+      />
+      <el-table-column label="操作" align="center" min-width="120px">
+        <template #default="scope">
+          <el-button
+            link
+            type="primary"
+            @click="openForm('update', scope.row.id)"
+            v-hasPermi="['keyboard:app-versions:update']"
+          >
+            编辑
+          </el-button>
+          <el-button
+            link
+            type="danger"
+            @click="handleDelete(scope.row.id)"
+            v-hasPermi="['keyboard:app-versions:delete']"
+          >
+            删除
+          </el-button>
+        </template>
+      </el-table-column>
+    </el-table>
+    <!-- 分页 -->
+    <Pagination
+      :total="total"
+      v-model:page="queryParams.pageNo"
+      v-model:limit="queryParams.pageSize"
+      @pagination="getList"
+    />
+  </ContentWrap>
+
+  <!-- 表单弹窗：添加/修改 -->
+  <AppVersionsForm ref="formRef" @success="getList" />
+</template>
+
+<script setup lang="ts">
+import { isEmpty } from '@/utils/is'
+import { dateFormatter } from '@/utils/formatTime'
+import download from '@/utils/download'
+import { AppVersionsApi, AppVersions } from '@/api/keyboard/appversions'
+import AppVersionsForm from './AppVersionsForm.vue'
+
+/** App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 列表 */
+defineOptions({ name: 'AppVersions' })
+
+const message = useMessage() // 消息弹窗
+const { t } = useI18n() // 国际化
+
+const loading = ref(true) // 列表的加载中
+const list = ref<AppVersions[]>([]) // 列表的数据
+const total = ref(0) // 列表的总页数
+const queryParams = reactive({
+  pageNo: 1,
+  pageSize: 10,
+  appId: undefined,
+  platform: undefined,
+  channel: undefined,
+  versionName: undefined,
+  versionCode: undefined,
+  buildNumber: undefined,
+  minSupportedCode: undefined,
+  isForceUpdate: [],
+  isActive: undefined,
+  releaseNotes: undefined,
+  downloadUrl: undefined,
+  storeUrl: undefined,
+  metadata: undefined,
+  releasedAt: undefined,
+  releasedAt: [],
+  createdAt: undefined,
+  createdAt: [],
+  updatedAt: undefined,
+  updatedAt: []
+})
+const queryFormRef = ref() // 搜索的表单
+const exportLoading = ref(false) // 导出的加载中
+
+/** 查询列表 */
+const getList = async () => {
+  loading.value = true
+  try {
+    const data = await AppVersionsApi.getAppVersionsPage(queryParams)
+    list.value = data.list
+    total.value = data.total
+  } finally {
+    loading.value = false
+  }
+}
+
+/** 搜索按钮操作 */
+const handleQuery = () => {
+  queryParams.pageNo = 1
+  getList()
+}
+
+/** 重置按钮操作 */
+const resetQuery = () => {
+  queryFormRef.value.resetFields()
+  handleQuery()
+}
+
+/** 添加/修改操作 */
+const formRef = ref()
+const openForm = (type: string, id?: number) => {
+  formRef.value.open(type, id)
+}
+
+/** 删除按钮操作 */
+const handleDelete = async (id: number) => {
+  try {
+    // 删除的二次确认
+    await message.delConfirm()
+    // 发起删除
+    await AppVersionsApi.deleteAppVersions(id)
+    message.success(t('common.delSuccess'))
+    // 刷新列表
+    await getList()
+  } catch {}
+}
+
+/** 批量删除App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。 */
+const handleDeleteBatch = async () => {
+  try {
+    // 删除的二次确认
+    await message.delConfirm()
+    await AppVersionsApi.deleteAppVersionsList(checkedIds.value);
+    checkedIds.value = [];
+    message.success(t('common.delSuccess'))
+    await getList();
+  } catch {}
+}
+
+const checkedIds = ref<number[]>([])
+const handleRowCheckboxChange = (records: AppVersions[]) => {
+  checkedIds.value = records.map((item) => item.id!);
+}
+
+/** 导出按钮操作 */
+const handleExport = async () => {
+  try {
+    // 导出的二次确认
+    await message.exportConfirm()
+    // 发起导出
+    exportLoading.value = true
+    const data = await AppVersionsApi.exportAppVersions(queryParams)
+    download.excel(data, 'App 版本发布与更新检查表：区分 Android/iOS、渠道，支持最低支持版本与强更策略。.xls')
+  } catch {
+  } finally {
+    exportLoading.value = false
+  }
+}
+
+/** 初始化 **/
+onMounted(() => {
+  getList()
+})
+</script>