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

miniprogram/RESTORE-ANALYSIS.md

@@ -0,0 +1,54 @@
+# 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 逻辑。