fnvtk/soul-yongping
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

重构推荐码处理逻辑，整合 scene 解析功能，优化扫码参数接收。更新阅读页面逻辑，支持通过 scene 解析 mid、id 和 ref，提升用户体验。新增二维码生成逻辑，确保与 scene 生成闭环。

Browse Source
This commit is contained in:
乘风
2026-02-12 19:17:50 +08:00
parent a71e14d2e6
commit 808c959a20
4 changed files with 269 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

199
miniprogram/pages/read/FLOW.txt Normal file
View File

@@ -0,0 +1,199 @@
================================================================================
miniprogram/pages/read 阅读页 - 当前处理流程 (ASCII)
================================================================================
---------- 1. 进入页面 onLoad(options) 总览 ----------
+------------------+
| onLoad(options) |
+--------+---------+
|
v
+----------------------------------------+
| sceneStr = options.scene || '' |
| parsed = parseScene(sceneStr) | <-- utils/scene.js
| mid = options.mid || parsed.mid || |
| app.globalData.initialSectionMid|
| id = options.id || parsed.id || |
| app.globalData.initialSectionId |
| ref = options.ref || parsed.ref |
+--------+-------------------------------+
|
v
+----------------------------------------+
| 清除 app.globalData.initialSection* |
+--------+-------------------------------+
|
v
[ mid || id ? ]
|
No ---+---> 提示「章节参数缺失」, return
|
Yes v
+----------------------------------------+
| setData: sectionMid, loading=true |
| if (ref): 存 referral_code, |
| app.handleReferralCode(ref) |
+--------+-------------------------------+
|
v
+----------------------------------------+
| Promise.all: |
| - accessManager.fetchLatestConfig() |
| - /api/.../purchase-status (若登录) |
+--------+-------------------------------+
|
v
+----------------------------------------+
| 计算价格/推荐折扣, setData 配置 |
+--------+-------------------------------+
|
v
+----------------------------------------+
| resolvedId = id |
| if (mid && !id): |
| GET /book/chapter/by-mid/:mid |
| resolvedId = chRes.id |
| prefetchedChapter = chRes |
| setData(sectionId: resolvedId) |
+--------+-------------------------------+
|
v
+----------------------------------------+
| accessManager.determineAccessState() |
| setData: accessState, canAccess, |
| showPaywall, isLoggedIn |
+--------+-------------------------------+
|
v
+----------------------------------------+
| await loadContent(mid, resolvedId, |
| accessState, |
| prefetchedChapter) |
+--------+-------------------------------+
|
v
+----------------------------------------+
| if (canAccess): readingTracker.init() |
| loadNavigation(resolvedId) |
| setData(loading: false) |
+----------------------------------------+
---------- 2. scene 闭环（海报生成 <-> 扫码解析）----------
[ 生成海报 ]
|
v
+----------------------------------------+
| buildScene({ mid?, id?, ref? }) | utils/scene.js
| 例: mid=1, ref=ogpTW5fmXR |
| => "mid=1_ref=ogpTW5fmXR" |
+--------+-------------------------------+
|
v
+----------------------------------------+
| GET /api/miniprogram/qrcode/image |
| ?scene=mid%3D1_ref%3Dxxx |
| &page=pages/read/read&width=280 |
+--------+-------------------------------+
|
v
+----------------------------------------+
| 后端: & -> _ (若需要), 调微信生成图 |
| 返回 image/png |
+--------+-------------------------------+
|
v
+----------------------------------------+
| wx.downloadFile(url) -> tempFilePath |
| canvas drawImage(tempFilePath) 画海报 |
+----------------------------------------+
---------- 用户扫码 ----------
+----------------------------------------+
| 微信: 打开 pages/read/read |
| options.scene = "mid=1_ref=xxx" |
+--------+-------------------------------+
|
v
+----------------------------------------+
| App.onLaunch(options) |
| handleReferralCode(options) |
| parseScene(options.scene) |
| -> initialSectionMid, initialSectionId|
| -> ref 存 referral_code / 绑定 |
+----------------------------------------+
|
v
+----------------------------------------+
| Read.onLoad(options) |
| parseScene(options.scene) -> mid,id,ref|
| 与 app.globalData.initial* 合并 |
| -> 用 mid/id 拉章节, ref 已存 |
+----------------------------------------+
---------- 3. loadContent(mid, id, accessState, prefetched) ----------
+------------------+
| loadContent(...) |
+--------+---------+
|
v
+----------------------------------------+
| section = getSectionInfo(id) |
| setData({ section }) |
+--------+-------------------------------+
|
v
+----------------------------------------+
| prefetched 有内容? |
+--------+-------------------------------+
| Yes
+-----> res = prefetched (不请求)
|
| No
v
+----------------------------------------+
| mid ? GET /book/chapter/by-mid/:mid |
| : GET /book/chapter/:id |
+--------+-------------------------------+
|
v
+----------------------------------------+
| res && res.content ? |
+--------+-------------------------------+
| Yes
+-----> setData(content, paragraphs, partTitle, chapterTitle)
| if (canAccess): markSectionAsRead(id)
| setTimeout(drawShareCard, 600)
|
| No / 请求异常
v
+----------------------------------------+
| 尝试 wx.getStorageSync(cacheKey) |
| 有缓存 -> setData 内容; 无 -> throw |
+----------------------------------------+
---------- 4. 参数来源优先级（onLoad 内 mid / id / ref）----------
mid = options.mid
?? parseInt(parsed.mid)
?? app.globalData.initialSectionMid
?? 0
id = options.id
?? parsed.id
?? app.globalData.initialSectionId
?? ''
ref = options.ref
?? parsed.ref
?? ''
(解析 parsed = parseScene(options.scene)，支持 scene 内 & 或 _ 分隔)
================================================================================

52
miniprogram/pages/read/read.js
View File

@@ -12,6 +12,7 @@
import accessManager from '../../utils/chapterAccessManager'
import readingTracker from '../../utils/readingTracker'
const { buildScene, parseScene } = require('../../utils/scene.js')
const app = getApp()
@@ -79,40 +80,17 @@ Page({
},
async onLoad(options) {
// 支持 mid（优先）或 id：mid 用于新链接，id 兼容旧链接
// 扫码进入时：mid/id 可能在 options、app.globalData.initialSectionMid/initialSectionId、或 scene 中
let mid = options.mid ? parseInt(options.mid, 10) : (app.globalData.initialSectionMid || 0)
let id = options.id || app.globalData.initialSectionId
if ((!mid || !id) && options.scene) {
const scene = (typeof options.scene === 'string' ? decodeURIComponent(options.scene) : '').trim()
const parts = scene.split(/[&_]/)
for (const part of parts) {
const eq = part.indexOf('=')
if (eq > 0) {
const k = part.slice(0, eq)
const v = part.slice(eq + 1)
if (k === 'mid') mid = parseInt(v, 10) || 0
if (k === 'id' && v) id = v
}
}
}
// 官方以 options.scene 接收扫码参数（可同时带 mid/id + ref），与海报生成 buildScene 闭环
const sceneStr = (options && options.scene) || ''
const parsed = parseScene(sceneStr)
const mid = options.mid ? parseInt(options.mid, 10) : (parsed.mid || app.globalData.initialSectionMid || 0)
const 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
// ref：支持 query.ref 或 scene 中的 ref=xxx（扫码进入时 ref 在 scene 里）
let ref = options.ref
if (!ref && options.scene) {
const sceneStr = (typeof options.scene === 'string' ? decodeURIComponent(options.scene) : '').trim()
const parts = sceneStr.split(/[&_]/)
for (const part of parts) {
const eq = part.indexOf('=')
if (eq > 0) {
const k = part.slice(0, eq)
const v = part.slice(eq + 1)
if (k === 'ref' && v) { ref = v; break }
}
}
}
console.log('[Read] onLoad:', { options, sceneRaw: sceneStr || undefined, parsed, mid, id, ref })
console.log('[Read] onLoad options:', options)
if (!mid && !id) {
console.warn('[Read] 未获取到章节 mid/id，options:', options)
@@ -241,6 +219,7 @@ Page({
// 【重构】加载章节内容。mid 优先用 by-mid 接口，id 用旧接口；prefetched 避免重复请求
async loadContent(mid, id, accessState, prefetched) {
console.log('[Read] loadContent 请求参数:', { mid, id, accessState: accessState, prefetched: !!prefetched })
try {
const section = this.getSectionInfo(id)
const sectionPrice = this.data.sectionPrice ?? 1
@@ -1090,12 +1069,15 @@ Page({
const userId = userInfo?.id || ''
const safeParagraphs = contentParagraphs || []
// 通过 GET 接口下载二维码图片，得到 tempFilePath 便于开发工具与真机统一用 drawImage 绘制
// 与 utils/scene 闭环：生成 scene 用 buildScene，扫码后用 parseScene 解析
let qrcodeTempPath = null
try {
const scene = sectionMid
? (userId ? `mid=${sectionMid}&ref=${userId.slice(0, 10)}` : `mid=${sectionMid}`)
: (userId ? `id=${sectionId}&ref=${userId.slice(0, 10)}` : `id=${sectionId}`)
const refVal = userId ? String(userId).slice(0, 12) : ''
const scene = buildScene({
mid: sectionMid || undefined,
id: sectionMid ? undefined : (sectionId || ''),
ref: refVal || undefined
})
const baseUrl = app.globalData.baseUrl || ''
const url = `${baseUrl}/api/miniprogram/qrcode/image?scene=${encodeURIComponent(scene)}&page=${encodeURIComponent('pages/read/read')}&width=280`
qrcodeTempPath = await new Promise((resolve) => {