更新开发文档，强调接口路径必须按使用方区分，禁止通用路径混用。新增小程序分享功能，统一使用推荐码，确保用户体验一致性。

miniprogram/app.js

@@ -3,6 +3,8 @@
  * 开发: 卡若
  */
 
+const { parseScene } = require('./utils/scene.js')
+
 App({
   globalData: {
     // API基础地址 - 连接真实后端
@@ -77,11 +79,17 @@ App({
     this.handleReferralCode(options)
   },
   
-  // 处理推荐码绑定
+  // 处理推荐码绑定：官方以 options.scene 接收扫码参数（可同时带 mid/id + ref），与 utils/scene 解析闭环
   handleReferralCode(options) {
     const query = options?.query || {}
-    const refCode = query.ref || query.referralCode
-    
+    let refCode = query.ref || query.referralCode
+    const sceneStr = (options && (typeof options.scene === 'string' ? options.scene : '')) || ''
+    if (sceneStr) {
+      const parsed = parseScene(sceneStr)
+      if (parsed.mid) this.globalData.initialSectionMid = parsed.mid
+      if (parsed.id) this.globalData.initialSectionId = parsed.id
+      if (parsed.ref) refCode = parsed.ref
+    }
     if (refCode) {
       console.log('[App] 检测到推荐码:', refCode)
       
@@ -156,6 +164,22 @@ App({
     }
   },
 
+  // 根据业务 id 从 bookData 查 mid（用于跳转）
+  getSectionMid(sectionId) {
+    const list = this.globalData.bookData || []
+    const ch = list.find(c => c.id === sectionId)
+    return ch?.mid || 0
+  },
+
+  // 获取当前用户的邀请码（用于分享带 ref，未登录返回空字符串）
+  getMyReferralCode() {
+    const user = this.globalData.userInfo
+    if (!user) return ''
+    if (user.referralCode) return user.referralCode
+    if (user.id) return 'SOUL' + String(user.id).toUpperCase().slice(-6)
+    return ''
+  },
+
   // 获取系统信息
   getSystemInfo() {
     try {
@@ -200,7 +224,7 @@ App({
       }
       
       // 从服务器获取最新数据
-      const res = await this.request('/api/book/all-chapters')
+      const res = await this.request('/api/miniprogram/book/all-chapters')
       if (res && (res.data || res.chapters)) {
         const chapters = res.data || res.chapters || []
         this.globalData.bookData = chapters