soul-yongping/miniprogram/RESTORE-ANALYSIS.md

miniprogram 功能还原分析报告

一、对比结论

项目	miniprogram（甲方）	miniprogram2（你写的）
页面分享	仅 read、referral 有	几乎所有页面都有
scene 解析	无	有 utils/scene.js
推荐码获取	分散（userInfo?.referralCode 等）	统一 app.getMyReferralCode()
书籍 API	/api/book/all-chapters	/api/miniprogram/book/all-chapters
特有页面	vip、member-detail	scan、profile-edit

二、已完成的还原项

1. 基础能力（app.js + utils/scene.js）

• 新增 utils/scene.js：扫码 scene 参数编解码，支持 mid、id、ref
• app.js：
  • 引入 parseScene，handleReferralCode 支持 options.scene 解析
  • 新增 getMyReferralCode()：统一获取邀请码
  • 新增 getSectionMid(sectionId)：根据 id 查 mid
  • loadBookData 改为 /api/miniprogram/book/all-chapters

2. 页面分享（onShareAppMessage）

已为以下页面补充分享，路径统一带 ref 参数：

• index、chapters、match、my
• read、referral（原有，已统一用 getMyReferralCode）
• search、settings、purchases、privacy
• withdraw-records、addresses、addresses/edit
• agreement、about、vip、member-detail

3. read.js 分享逻辑

• 使用 app.getMyReferralCode() 替代 userInfo?.referralCode || wx.getStorageSync('referralCode')
• 保持 onShareAppMessage、onShareTimeline 行为不变

4. API 路径修正

• app.loadBookData：/api/book/all-chapters → /api/miniprogram/book/all-chapters
• index.loadBookData、loadFeaturedFromServer、loadLatestChapters：同上
• chapters.loadDailyChapters：同上

三、未改动项（保留甲方逻辑）

• vip 相关接口：/api/vip/members、/api/vip/status、/api/vip/profile 仍为原路径，未改为 /api/miniprogram/*（若 soul-api 无对应 miniprogram 接口，需后端补充）
• 页面结构：保留 vip、member-detail，未引入 scan、profile-edit

四、后续建议

1. soul-api 路由：确认 /api/miniprogram/book/all-chapters 已注册；若 vip 需在小程序使用，建议在 miniprogram 组下增加等价接口。
2. referral.js：检查是否已使用 app.getMyReferralCode()，若仍用旧方式可统一替换。
3. read.js 的 mid 支持：miniprogram2 的 read 支持 mid 参数（便于扫码直达），若需要可在 miniprogram 的 read 中补充 sectionMid 与 getShareConfig 的 mid 逻辑。