更新小程序接口路径，统一为 /api/miniprogram/*，确保各页面正确调用 VIP 相关接口。增强分享功能，支持通过 mid 参数分享章节，优化用户体验。调整文档，明确后端待办事项。

miniprogram/pages/read/read.js

@@ -12,6 +12,7 @@
 
 import accessManager from '../../utils/chapterAccessManager'
 import readingTracker from '../../utils/readingTracker'
+const { parseScene } = require('../../utils/scene.js')
 
 const app = getApp()
 
@@ -66,37 +67,67 @@ Page({
     isGeneratingPoster: false,
     
     // 免费章节
-    freeIds: ['preface', 'epilogue', '1.1', 'appendix-1', 'appendix-2', 'appendix-3']
+    freeIds: ['preface', 'epilogue', '1.1', 'appendix-1', 'appendix-2', 'appendix-3'],
+
+    // 章节 mid（扫码/海报分享用，便于分享 path 带 mid）
+    sectionMid: null
   },
 
   async onLoad(options) {
-    const { id, ref } = options
-    
+    // 支持 scene（扫码）、mid、id、ref
+    const sceneStr = (options && options.scene) || ''
+    const parsed = parseScene(sceneStr)
+    const mid = options.mid ? parseInt(options.mid, 10) : (parsed.mid || app.globalData.initialSectionMid || 0)
+    let id = options.id || parsed.id || app.globalData.initialSectionId
+    const ref = options.ref || parsed.ref
+    if (app.globalData.initialSectionMid) delete app.globalData.initialSectionMid
+    if (app.globalData.initialSectionId) delete app.globalData.initialSectionId
+
+    // mid 有值但无 id 时，从 bookData 或 API 解析 id
+    if (mid && !id) {
+      const bookData = app.globalData.bookData || []
+      const ch = bookData.find(c => c.mid == mid || (c.mid && Number(c.mid) === Number(mid)))
+      if (ch?.id) {
+        id = ch.id
+      } else {
+        try {
+          const chRes = await app.request({ url: `/api/miniprogram/book/chapter/by-mid/${mid}`, silent: true })
+          if (chRes && chRes.id) id = chRes.id
+        } catch (e) {
+          console.warn('[Read] by-mid 解析失败:', e)
+        }
+      }
+    }
+
+    if (!id) {
+      wx.showToast({ title: '章节参数缺失', icon: 'none' })
+      this.setData({ accessState: 'error', loading: false })
+      return
+    }
+
     this.setData({
       statusBarHeight: app.globalData.statusBarHeight,
       navBarHeight: app.globalData.navBarHeight,
       sectionId: id,
+      sectionMid: mid || null,
       loading: true,
       accessState: 'unknown'
     })
-    
-    // 处理推荐码绑定（异步不阻塞）
+
     if (ref) {
       console.log('[Read] 检测到推荐码:', ref)
       wx.setStorageSync('referral_code', ref)
       app.handleReferralCode({ query: { ref } })
     }
-    
+
     try {
-      // 【标准流程】1. 拉取最新配置（免费列表、价格）
       const config = await accessManager.fetchLatestConfig()
       this.setData({
         freeIds: config.freeChapters,
         sectionPrice: config.prices?.section ?? 1,
         fullBookPrice: config.prices?.fullbook ?? 9.9
       })
-      
-      // 【标准流程】2. 确定权限状态
+
       const accessState = await accessManager.determineAccessState(id, config.freeChapters)
       const canAccess = accessManager.canAccessFullContent(accessState)
       
@@ -175,14 +206,15 @@ Page({
       if (res && res.content) {
         const lines = res.content.split('\n').filter(line => line.trim())
         const previewCount = Math.ceil(lines.length * 0.2)
-        
-        this.setData({
+        const updates = {
           content: res.content,
           contentParagraphs: lines,
           previewParagraphs: lines.slice(0, previewCount),
           partTitle: res.partTitle || '',
           chapterTitle: res.chapterTitle || ''
-        })
+        }
+        if (res.mid) updates.sectionMid = res.mid
+        this.setData(updates)
         
         // 如果有权限，标记为已读
         if (accessManager.canAccessFullContent(accessState)) {
@@ -454,31 +486,28 @@ Page({
     })
   },
 
-  // 分享到微信 - 自动带分享人ID（统一使用 app.getMyReferralCode）
+  // 分享到微信 - 自动带分享人ID；优先用 mid（扫码/海报闭环），无则用 id
   onShareAppMessage() {
-    const { section, sectionId } = this.data
+    const { section, sectionId, sectionMid } = this.data
     const ref = app.getMyReferralCode()
-    
-    // 分享标题优化
-    const shareTitle = section?.title 
+    const q = sectionMid ? `mid=${sectionMid}` : `id=${sectionId}`
+    const shareTitle = section?.title
       ? `📚 ${section.title.length > 20 ? section.title.slice(0, 20) + '...' : section.title}`
       : '📚 Soul创业派对 - 真实商业故事'
-    
     return {
       title: shareTitle,
-      path: `/pages/read/read?id=${sectionId}${ref ? '&ref=' + ref : ''}`,
-      imageUrl: '/assets/share-cover.png' // 可配置分享封面图
+      path: ref ? `/pages/read/read?${q}&ref=${ref}` : `/pages/read/read?${q}`,
+      imageUrl: '/assets/share-cover.png'
     }
   },
-  
-  // 分享到朋友圈
+
   onShareTimeline() {
-    const { section, sectionId } = this.data
+    const { section, sectionId, sectionMid } = this.data
     const ref = app.getMyReferralCode()
-    
+    const q = sectionMid ? `mid=${sectionMid}` : `id=${sectionId}`
     return {
       title: `${section?.title || 'Soul创业派对'} - 来自派对房的真实故事`,
-      query: `id=${sectionId}${ref ? '&ref=' + ref : ''}`
+      query: ref ? `${q}&ref=${ref}` : q
     }
   },