refactor: 统一接口调用为单前缀写法，去除 19 处页面内写死的 /mp-api（API_BASE 已含），并新增 check:api-prefix 防回归脚本

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

package.json

@@ -34,7 +34,8 @@
     "build:quickapp-webview": "uni build -p quickapp-webview",
     "build:quickapp-webview-huawei": "uni build -p quickapp-webview-huawei",
     "build:quickapp-webview-union": "uni build -p quickapp-webview-union",
-    "type-check": "vue-tsc --noEmit"
+    "type-check": "vue-tsc --noEmit",
+    "check:api-prefix": "bash scripts/check-api-prefix.sh"
   },
   "dependencies": {
     "@dcloudio/uni-app": "3.0.0-alpha-5010320260611001",

scripts/check-api-prefix.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# xuchao: 防止页面调用写死 /mp-api 前缀（request.ts 的 API_BASE 已含该前缀，重复会形成双前缀，
+# 依赖 chaos 路由全局剥离才能工作，属错误写法）。命中即失败。
+set -e
+if grep -rn --include='*.vue' --include='*.ts' -e "('/mp-api/" -e '("/mp-api/' src; then
+  echo "❌ 发现页面写死 /mp-api 前缀，请去掉（API_BASE 会自动拼接）"
+  exit 1
+fi
+echo "✅ api 前缀检查通过"

src/api/types.ts

@@ -185,6 +185,8 @@ export interface OAuth2LoginResult {
 /** 用户年卡列表项（来自 /zhy-api/cardBag/userCardList） */
 export interface UserCardListItem {
   cardNo: string
+  // xuchao: 卡种ID（后端 CardBagBean.cardModelId），人脸预检与卡种过滤均在用
+  cardModelId: number
   cardModelName: string
   validityTime: string
   cardModelPic: string

src/packages/content/pages/faq.vue

@@ -49,7 +49,7 @@ const loading = ref(true)
 
 onMounted(async () => {
   try {
-    const data = await post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'FAQ' })
+    const data = await post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'FAQ' })
     faqList.value = (data || []).map(n => ({
       id: n.id,
       title: n.title,

src/packages/content/pages/notice-list.vue

@@ -41,7 +41,7 @@ const notices = ref<NoticeItem[]>([])
 
 onMounted(async () => {
   try {
-    const data = await post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'NOTICE' })
+    const data = await post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'NOTICE' })
     notices.value = (data || []).map(n => ({
       id: n.id,
       title: n.title,

src/packages/content/pages/scenic-detail.vue

@@ -243,7 +243,7 @@ onLoad((options) => {
 
 async function fetchShopNotice(shopId: string) {
   try {
-    const res = await post<any>('/mp-api/mpShopNotice/queryShopNoticePage', {
+    const res = await post<any>('/mpShopNotice/queryShopNoticePage', {
       shopId,
       pageNo: 1,
       pageSize: 5,
@@ -265,7 +265,7 @@ async function fetchDetail(shopId: string) {
     const phone = uni.getStorageSync('phone') as string
     if (phone) params.phone = phone
 
-    const res = await post<any>('/mp-api/mpScenic/getScenicDetail', params)
+    const res = await post<any>('/mpScenic/getScenicDetail', params)
     if (res) {
       scenic.value = {
         id: res.id || res.scenicId || shopId,

src/packages/content/pages/scenic-list.vue

@@ -294,7 +294,7 @@ async function fetchScenicList(resetPage = true) {
       phone: uni.getStorageSync('phone') || '',
     }
 
-    const res = await post<any>('/mp-api/mpScenic/queryScenicList', params)
+    const res = await post<any>('/mpScenic/queryScenicList', params)
     const list = res?.list || res?.rows || res?.records || res || []
     const totalCount = res?.total || res?.totalCount || 0
     total.value = totalCount
@@ -344,7 +344,7 @@ onLoad((query: any) => {
 })
 
 onMounted(async () => {
-  const filterRes = await post<any>('/mp-api/mpScenic/queryFilterOptions', { channel: 'pingxiang' }).catch(() => null)
+  const filterRes = await post<any>('/mpScenic/queryFilterOptions', { channel: 'pingxiang' }).catch(() => null)
 
   if (filterRes) {
     const levels = filterRes.levels || filterRes.levelList || []

src/packages/content/pages/usage-guide.vue

@@ -17,7 +17,7 @@ const loading = ref(true)
 
 onMounted(async () => {
   try {
-    const data = await post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'GUIDE' })
+    const data = await post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'GUIDE' })
     if (data && data.length > 0) {
       imageUrl.value = data[0].imageUrl || ''
     }

src/packages/user/api/douyin.ts

@@ -82,7 +82,7 @@ export async function queryVoucherList(params: QueryVoucherListParams): Promise<
     await delay(300)
     return MOCK_VOUCHERS.map((v) => ({ ...v, mobile: params.mobile }))
   }
-  return post<VoucherItem[]>('/mp-api/douyin/voucherList', params)
+  return post<VoucherItem[]>('/douyin/voucherList', params)
 }
 
 /**
@@ -94,5 +94,5 @@ export async function activateAndBind(params: ActivateAndBindParams): Promise<vo
     await delay(800)
     return
   }
-  await post<null>('/mp-api/douyin/activateAndBind', params)
+  await post<null>('/douyin/activateAndBind', params)
 }

src/packages/user/pages/buy.vue

@@ -85,7 +85,7 @@ const noticeHtml = computed(() => fixRichHtml(noticeContent.value))
 /** 获取购卡须知富文本（type = CARD_PURCHASE_NOTICE） */
 async function fetchPurchaseNotice() {
   try {
-    const res = await post<BannerItem[]>('/mp-api/mpContent/queryList', {
+    const res = await post<BannerItem[]>('/mpContent/queryList', {
       channel: 'pingxiang',
       type: 'CARD_PURCHASE_NOTICE',
     })

src/packages/user/pages/card-notice.vue

@@ -23,7 +23,7 @@ const loading = ref(true)
 
 onMounted(async () => {
   try {
-    const list = await post<any[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'CARD_NOTICE' })
+    const list = await post<any[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'CARD_NOTICE' })
     content.value = list?.[0]?.content || ''
   } catch {
     showToast('加载失败')

src/packages/user/pages/douyin-verify.vue

@@ -310,7 +310,7 @@ const noticeHtml = computed(() => fixRichHtml(noticeContent.value))
 /** 获取购卡须知富文本（type = CARD_PURCHASE_NOTICE） */
 async function fetchPurchaseNotice() {
   try {
-    const res = await post<BannerItem[]>('/mp-api/mpContent/queryList', {
+    const res = await post<BannerItem[]>('/mpContent/queryList', {
       channel: 'pingxiang',
       type: 'CARD_PURCHASE_NOTICE',
     })

src/pages/index/index.vue

@@ -192,8 +192,8 @@ onMounted(() => {
 async function fetchBannersAndNotices() {
   try {
     const [bannerData, noticeData] = await Promise.all([
-      post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'BANNER' }),
+      post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'BANNER' }),
-      post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'NOTICE' }),
+      post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'NOTICE' }),
     ])
     banners.value = bannerData || []
     announcements.value = (noticeData || []).map(n => ({
@@ -208,7 +208,7 @@ async function fetchBannersAndNotices() {
 /** 获取热门景点（独立加载，不阻塞 banner/公告渲染） */
 async function fetchSpots() {
   try {
-    const spotsData = await post<any>('/mp-api/mpScenic/queryScenicList', { channel: 'pingxiang', pageNo: 1, pageSize: 8, phone: uni.getStorageSync('phone') || '' })
+    const spotsData = await post<any>('/mpScenic/queryScenicList', { channel: 'pingxiang', pageNo: 1, pageSize: 8, phone: uni.getStorageSync('phone') || '' })
     const list = spotsData?.list || spotsData || []
     hotSpots.value = (Array.isArray(list) ? list : []).slice(0, 8).map((s: any) => ({
       id: s.id || s.scenicId,

src/pages/login/agreement.vue

@@ -23,7 +23,7 @@ const loading = ref(true)
 
 onMounted(async () => {
   try {
-    const list = await post<any[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'TERMS' })
+    const list = await post<any[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'TERMS' })
     content.value = list?.[0]?.content || ''
   } catch {
     showToast('加载失败')

src/pages/login/privacy.vue

@@ -23,7 +23,7 @@ const loading = ref(true)
 
 onMounted(async () => {
   try {
-    const list = await post<any[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'PRIVACY' })
+    const list = await post<any[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'PRIVACY' })
     content.value = list?.[0]?.content || ''
   } catch {
     showToast('加载失败')

src/pages/qrcode/index.vue

@@ -233,7 +233,7 @@ async function fetchCards() {
 async function fetchEntryNotice() {
   if (entryNoticeLoaded.value) return
   try {
-    const list = await post<BannerItem[]>('/mp-api/mpContent/queryList', { channel: 'pingxiang', type: 'ENTRY_NOTICE' })
+    const list = await post<BannerItem[]>('/mpContent/queryList', { channel: 'pingxiang', type: 'ENTRY_NOTICE' })
     entryNotice.value = list?.[0]?.content || ''
   } catch {
     entryNotice.value = ''
@@ -386,7 +386,7 @@ function onFeatureClick(item: { label: string }) {
       uni.showToast({ title: '请先选择一张旅游卡', icon: 'none' })
       return
     }
-    post<any>('/mp-api/mpCard/checkFaceBind', { cardModelId: card.cardModelId, cardNumber: card.cardNo })
+    post<any>('/mpCard/checkFaceBind', { cardModelId: card.cardModelId, cardNumber: card.cardNo })
       .then((res) => {
         if (res?.needBindFace) {
           showFaceModal.value = true