feat(api)!: 适配新版后端接口

切换到 Cookie 会话和新版 DTO，并迁移画廊、地图、个人主页、百科及上传流程。停用后端尚未实现的账号与徽章功能，同时纳入新版 API 契约文档。

BREAKING CHANGE: 前端不再兼容旧 /api/v1 接口和 refresh token 流程。

src/views/gallery/GalleryView.vue

@@ -1,17 +1,17 @@
 <script setup lang="ts">
 import { computed, onMounted, onUnmounted, ref, watch } from 'vue'
+import { RouterLink } from 'vue-router'
 import { NAlert, NButton, NDropdown, NEmpty, NIcon, NSkeleton, NTag, useMessage } from 'naive-ui'
 import { Clock, Location, Search, Settings, User, X } from '@vicons/tabler'
 import CloudEditModal, { type CloudEditFormValue } from '@/components/cloud/CloudEditModal.vue'
 import ImageDetailModal from '@/components/cloud/ImageDetailModal.vue'
 import MiniLocationMap from '@/components/cloud/MiniLocationMap.vue'
-import { apiRequest } from '@/lib/api'
+import { ApiError, apiRequest, toApiCloud } from '@/lib/api'
 import { useAuthStore } from '@/stores/auth'
 import { useCloudsStore } from '@/stores/clouds'
 import { useProfileStore } from '@/stores/profile'
 
-import type { ApiCloud, ApiPage } from '@/types/api'
-import type { CloudType } from '@/types/database'
+import type { ApiCloud, BackendCloudInfo } from '@/types/api'
 
 interface GalleryCloud {
   id: string
@@ -29,7 +29,7 @@ interface GalleryCloud {
   status: 'pending' | 'approved' | 'rejected'
   is_hidden: boolean
   cloudTypeName: string
-  cloudTypeRarity: CloudType['rarity']
+  cloudTypeRarity: number
   username: string
 }
 
@@ -47,8 +47,7 @@ const selectedTypeId = ref<number | 'all'>('all')
 const searchQuery = ref('')
 const selectedCloud = ref<GalleryCloud | null>(null)
 const currentPage = ref(1)
-const totalCount = ref(0)
-const totalPages = computed(() => Math.max(1, Math.ceil(totalCount.value / PAGE_SIZE)))
+const hasNextPage = ref(false)
 const manageError = ref('')
 const editModalOpen = ref(false)
 const editSaving = ref(false)
@@ -56,11 +55,7 @@ const editInitialValue = ref<CloudEditFormValue | null>(null)
 
 let searchTimer: number | null = null
 
-const rarityMeta = {
-  common: { label: '常见', chip: 'bg-sky-100 text-sky-700 border-sky-200' },
-  uncommon: { label: '少见', chip: 'bg-amber-100 text-amber-700 border-amber-200' },
-  rare: { label: '罕见', chip: 'bg-rose-100 text-rose-700 border-rose-200' },
-} satisfies Record<CloudType['rarity'], { label: string; chip: string }>
+const rarityChip = 'border-slate-200 bg-slate-50 text-slate-600'
 
 function formatDateTime(iso: string | null) {
   if (!iso) return '未知时间'
@@ -105,7 +100,7 @@ function toGalleryCloud(row: ApiCloud) {
     status: row.status,
     is_hidden: row.is_hidden,
     cloudTypeName: row.cloud_type_name || row.custom_cloud_type || '未知',
-    cloudTypeRarity: row.cloud_type_rarity || 'common',
+    cloudTypeRarity: row.cloud_type_rarity_value ?? 0,
     username: row.username || '匿名',
   } satisfies GalleryCloud
 }
@@ -116,14 +111,28 @@ async function loadPage(page: number) {
 
   try {
     const params = new URLSearchParams({ page: String(page), page_size: String(PAGE_SIZE) })
-    if (selectedTypeId.value !== 'all') params.set('type_id', String(selectedTypeId.value))
-    if (normalizedSearch.value) params.set('search', normalizedSearch.value)
+    if (normalizedSearch.value) {
+      params.set('filter', isUserSearch.value ? 'owner' : 'type')
+      params.set('value', normalizedSearch.value)
+    } else if (selectedTypeId.value !== 'all') {
+      const typeName = cloudsStore.cloudTypes.find(type => type.id === selectedTypeId.value)?.name
+      if (typeName) {
+        params.set('filter', 'type')
+        params.set('value', typeName)
+      }
+    }
 
-    const result = await apiRequest<ApiPage<ApiCloud>>(`/clouds?${params}`, { auth: false })
-    totalCount.value = result.total
-    galleryItems.value = result.items.map(toGalleryCloud)
+    const rows = await apiRequest<BackendCloudInfo[]>(`/cloud?${params}`, { auth: false })
+    galleryItems.value = rows.map(toApiCloud).map(toGalleryCloud)
+    hasNextPage.value = rows.length === PAGE_SIZE
     currentPage.value = page
   } catch (error) {
+    if (error instanceof ApiError && error.status === 404 && isUserSearch.value) {
+      galleryItems.value = []
+      hasNextPage.value = false
+      currentPage.value = page
+      return
+    }
     loadError.value = error instanceof Error ? error.message : '画廊加载失败'
   } finally {
     loading.value = false
@@ -131,7 +140,7 @@ async function loadPage(page: number) {
 }
 
 async function goToPage(page: number) {
-  if (page < 1 || page > totalPages.value || page === currentPage.value) return
+  if (page < 1 || page === currentPage.value || (page > currentPage.value && !hasNextPage.value)) return
   await loadPage(page)
   window.scrollTo({ top: 0, behavior: 'smooth' })
 }
@@ -172,12 +181,10 @@ function openEditModal() {
 
   manageError.value = ''
   editInitialValue.value = {
-    cloudCategoryId: selectedCloud.value.cloud_type_id ?? (selectedCloud.value.custom_cloud_type ? 'other' : null),
-    customCloudType: selectedCloud.value.custom_cloud_type || '',
+    cloudCategoryId: selectedCloud.value.cloud_type_id,
     capturedAt: formatDatetimeLocal(selectedCloud.value.captured_at),
     latitude: selectedCloud.value.latitude,
     longitude: selectedCloud.value.longitude,
-    locationName: selectedCloud.value.location_name || '',
     description: selectedCloud.value.description || '',
     isPublic: !selectedCloud.value.is_hidden,
   }
@@ -204,18 +211,14 @@ async function submitEditModal(value: CloudEditFormValue) {
     manageError.value = '请选择云型类别。'
     return
   }
-  if (value.cloudCategoryId === 'other' && !value.customCloudType.trim()) {
-    manageError.value = '请输入自定义云型名称。'
-    return
-  }
-  if (!value.capturedAt) {
-    manageError.value = '请选择拍摄时间。'
-    return
-  }
   const hasLat = typeof value.latitude === 'number' && !Number.isNaN(value.latitude)
   const hasLng = typeof value.longitude === 'number' && !Number.isNaN(value.longitude)
-  if (hasLat !== hasLng) {
-    manageError.value = '经纬度必须同时填写。'
+  if (!hasLat || !hasLng) {
+    manageError.value = '经纬度为必填项。'
+    return
+  }
+  if (value.description.trim().length > 128) {
+    manageError.value = '图片描述不能超过 128 个字符。'
     return
   }
 
@@ -225,13 +228,11 @@ async function submitEditModal(value: CloudEditFormValue) {
 
   try {
     const updated = await profileStore.updateCloud(authStore.user.id, current.id, {
-      cloud_type_id: value.cloudCategoryId === 'other' ? null : value.cloudCategoryId,
-      custom_cloud_type: value.cloudCategoryId === 'other' ? value.customCloudType.trim() : null,
-      latitude: hasLat ? blurCoordinate(value.latitude as number) : null,
-      longitude: hasLng ? blurCoordinate(value.longitude as number) : null,
-      location_name: value.locationName.trim() || null,
-      description: value.description.trim() || null,
-      captured_at: new Date(value.capturedAt).toISOString(),
+      type_id: value.cloudCategoryId,
+      latitude: blurCoordinate(value.latitude as number),
+      longitude: blurCoordinate(value.longitude as number),
+      description: value.description.trim(),
+      ...(value.capturedAt ? { captured_at: new Date(value.capturedAt).toISOString() } : {}),
       is_hidden: !value.isPublic,
     })
 
@@ -362,7 +363,7 @@ onUnmounted(() => {
               v-model="searchQuery"
               type="text"
               class="min-w-0 flex-1 bg-transparent text-sm text-slate-800 outline-none placeholder:text-slate-400"
-              placeholder="搜索云型名称，或输入 @用户名 查看某个用户的图片"
+              placeholder="输入完整云类型名称，或 @用户名进行精确搜索"
             />
             <button
               v-if="searchQuery"
@@ -382,7 +383,7 @@ onUnmounted(() => {
               正在按上传者搜索：{{ normalizedSearch.slice(1) || '请输入用户名' }}
             </template>
             <template v-else>
-              正在匹配云型名称和自定义云型：{{ normalizedSearch }}
+              正在精确匹配云型名称：{{ normalizedSearch }}
             </template>
           </p>
         </div>
@@ -444,7 +445,7 @@ onUnmounted(() => {
               <div class="flex items-center justify-between gap-3">
                 <p class="truncate text-sm font-semibold">{{ cloud.cloudTypeName }}</p>
                 <NTag size="small" :bordered="false" class="shrink-0 bg-white/12 text-white backdrop-blur">
-                  {{ rarityMeta[cloud.cloudTypeRarity].label }}
+                  稀有度 {{ cloud.cloudTypeRarity }}
                 </NTag>
               </div>
               <p class="mt-2 flex items-center gap-1.5 truncate text-xs text-white/82">
@@ -463,7 +464,7 @@ onUnmounted(() => {
                 <NIcon size="14">
                   <Location />
                 </NIcon>
-                <span class="truncate">{{ cloud.location_name || '未填写位置' }}</span>
+                <span class="truncate">{{ formatCoordinate(cloud.latitude) }}, {{ formatCoordinate(cloud.longitude) }}</span>
               </p>
             </div>
           </div>
@@ -478,7 +479,7 @@ onUnmounted(() => {
         </NEmpty>
       </section>
 
-      <div v-if="totalPages > 1" class="mt-8 flex items-center justify-center gap-2">
+      <div v-if="currentPage > 1 || hasNextPage" class="mt-8 flex items-center justify-center gap-2">
         <NButton
           secondary
           strong
@@ -490,28 +491,13 @@ onUnmounted(() => {
           上一页
         </NButton>
 
-        <template v-for="page in totalPages" :key="page">
-          <NButton
-            v-if="page === 1 || page === totalPages || Math.abs(page - currentPage) <= 2"
-            secondary
-            strong
-            :class="page === currentPage ? 'oc-panel-button oc-panel-button--sky' : 'oc-panel-button oc-panel-button--neutral'"
-            type="default"
-            @click="goToPage(page)"
-          >
-            {{ page }}
-          </NButton>
-          <span
-            v-else-if="page === 2 || page === totalPages - 1"
-            class="px-1 text-sm text-slate-400"
-          >...</span>
-        </template>
+        <span class="border border-slate-200 bg-white px-4 py-2 text-sm text-slate-600">第 {{ currentPage }} 页</span>
 
         <NButton
           secondary
           strong
           type="default"
-          :disabled="currentPage >= totalPages"
+          :disabled="!hasNextPage"
           class="oc-panel-button oc-panel-button--neutral"
           @click="goToPage(currentPage + 1)"
         >
@@ -519,10 +505,6 @@ onUnmounted(() => {
         </NButton>
       </div>
 
-      <div v-if="totalCount > 0" class="mt-2 text-center text-xs text-slate-400">
-        共 {{ totalCount }} 张照片，第 {{ currentPage }} / {{ totalPages }} 页
-      </div>
-
       <ImageDetailModal
         v-if="selectedCloud"
         :open="!!selectedCloud"
@@ -531,8 +513,8 @@ onUnmounted(() => {
         :image-alt="selectedCloud.cloudTypeName"
         :title="selectedCloud.cloudTypeName"
         :subtitle="`上传者：${selectedCloud.username}`"
-        :badge-label="rarityMeta[selectedCloud.cloudTypeRarity].label"
-        :badge-class="rarityMeta[selectedCloud.cloudTypeRarity].chip"
+        :badge-label="`稀有度 ${selectedCloud.cloudTypeRarity}`"
+        :badge-class="rarityChip"
         @close="closeDetail"
       >
         <div class="grid gap-4 sm:grid-cols-2">
@@ -546,7 +528,7 @@ onUnmounted(() => {
           </div>
           <div class="oc-inset-panel">
             <p class="oc-section-label">位置</p>
-            <p class="mt-2 text-sm font-medium text-slate-900">{{ selectedCloud.location_name || '未填写位置名称' }}</p>
+            <p class="mt-2 text-sm font-medium text-slate-900">已记录经纬度</p>
           </div>
           <div class="oc-inset-panel">
             <p class="oc-section-label">模糊化经纬度</p>
@@ -556,13 +538,20 @@ onUnmounted(() => {
           </div>
         </div>
 
-        <div class="mt-5 border border-slate-200 bg-white p-5">
+      <div class="mt-5 border border-slate-200 bg-white p-5">
           <p class="oc-section-label">图片说明</p>
           <p class="mt-3 text-sm leading-7 text-slate-700">
             {{ selectedCloud.description || '上传者没有留下额外说明。' }}
           </p>
-        </div>
-        <MiniLocationMap
+      </div>
+
+      <RouterLink
+        :to="{ name: 'user-profile', params: { id: selectedCloud.username } }"
+        class="oc-panel-button oc-panel-button--neutral mt-5 inline-flex"
+      >
+        查看 @{{ selectedCloud.username }} 的公开主页
+      </RouterLink>
+      <MiniLocationMap
           :latitude="selectedCloud.latitude"
           :longitude="selectedCloud.longitude"
           :location-name="selectedCloud.location_name"