Merge branch 'yongxu-dev' into devlop

# Conflicts:
#	.cursor/agent/软件测试/evolution/索引.md   resolved by yongxu-dev version
#	.cursor/skills/testing/SKILL.md   resolved by yongxu-dev version
#	.gitignore   resolved by yongxu-dev version
#	miniprogram/app.js   resolved by yongxu-dev version
#	miniprogram/app.json   resolved by yongxu-dev version
#	miniprogram/pages/chapters/chapters.js   resolved by yongxu-dev version
#	miniprogram/pages/index/index.js   resolved by yongxu-dev version
#	miniprogram/pages/index/index.wxml   resolved by yongxu-dev version
#	miniprogram/pages/match/match.js   resolved by yongxu-dev version
#	miniprogram/pages/my/my.js   resolved by yongxu-dev version
#	miniprogram/pages/my/my.wxml   resolved by yongxu-dev version
#	miniprogram/pages/my/my.wxss   resolved by yongxu-dev version
#	miniprogram/pages/read/read.js   resolved by yongxu-dev version
#	miniprogram/pages/read/read.wxml   resolved by yongxu-dev version
#	miniprogram/pages/read/read.wxss   resolved by yongxu-dev version
#	miniprogram/pages/wallet/wallet.js   resolved by yongxu-dev version
#	miniprogram/pages/wallet/wallet.wxml   resolved by yongxu-dev version
#	miniprogram/pages/wallet/wallet.wxss   resolved by yongxu-dev version
#	miniprogram/utils/ruleEngine.js   resolved by yongxu-dev version
#	miniprogram/utils/trackClick.js   resolved by yongxu-dev version
#	soul-admin/dist/index.html   resolved by yongxu-dev version
#	soul-admin/src/components/RichEditor.tsx   resolved by yongxu-dev version
#	soul-admin/src/layouts/AdminLayout.tsx   resolved by yongxu-dev version
#	soul-admin/src/pages/api-docs/ApiDocsPage.tsx   resolved by yongxu-dev version
#	soul-admin/src/pages/content/ContentPage.tsx   resolved by yongxu-dev version
#	soul-admin/src/pages/settings/SettingsPage.tsx   resolved by yongxu-dev version
#	soul-admin/tsconfig.tsbuildinfo   resolved by yongxu-dev version
#	soul-api/.env.production   resolved by yongxu-dev version
#	soul-api/internal/database/database.go   resolved by yongxu-dev version
#	soul-api/internal/handler/balance.go   resolved by yongxu-dev version
#	soul-api/internal/handler/book.go   resolved by yongxu-dev version
#	soul-api/internal/handler/ckb_open.go   resolved by yongxu-dev version
#	soul-api/internal/handler/db.go   resolved by yongxu-dev version
#	soul-api/internal/handler/db_book.go   resolved by yongxu-dev version
#	soul-api/internal/handler/db_person.go   resolved by yongxu-dev version
#	soul-api/internal/handler/search.go   resolved by yongxu-dev version
#	soul-api/internal/handler/upload.go   resolved by yongxu-dev version
#	soul-api/internal/router/router.go   resolved by yongxu-dev version
#	soul-api/wechat/info.log   resolved by yongxu-dev version
#	开发文档/10、项目管理/运营与变更.md   resolved by yongxu-dev version
#	开发文档/1、需求/需求汇总.md   resolved by yongxu-dev version

miniprogram/pages/vip/vip.js

@@ -87,7 +87,37 @@ Page({
       }
     }
     this.setData({ purchasing: true })
+    const amount = this.data.price
     try {
+      // 0. 尝试余额支付（若余额足够）
+      const referralCode = wx.getStorageSync('referral_code') || ''
+      try {
+        const balanceRes = await app.request({ url: `/api/miniprogram/balance?userId=${userId}`, silent: true })
+        const balance = balanceRes?.data?.balance || 0
+        if (balance >= amount) {
+          const consumeRes = await app.request({
+            url: '/api/miniprogram/balance/consume',
+            method: 'POST',
+            data: {
+              userId,
+              productType: 'vip',
+              productId: 'vip_annual',
+              amount,
+              referralCode: referralCode || undefined
+            }
+          })
+          if (consumeRes?.success) {
+            this.setData({ purchasing: false })
+            wx.showToast({ title: 'VIP开通成功', icon: 'success' })
+            await this._onVipPaymentSuccess()
+            return
+          }
+        }
+      } catch (e) {
+        console.warn('[VIP] 余额支付失败，改用微信支付:', e)
+      }
+
+      // 1. 微信支付
       const payRes = await app.request('/api/miniprogram/pay', {
         method: 'POST',
         data: {
@@ -95,7 +125,7 @@ Page({
           userId,
           productType: 'vip',
           productId: 'vip_annual',
-          amount: this.data.price,
+          amount,
           description: '卡若创业派对VIP年度会员（365天）'
         }
       })