verify-discover-activity-list.md 8.6 KB

核验报告:发现活动列表两处修复(plainText 摘要 / 返回列表不翻倍)

核验目标:cfc-frontend/pages/activity/index.vue(发现活动列表页,"发现活动" tab)、pages/activity/create.vue、pages/activity/activity-detail/activity-detail.vue
核验方式:只读代码(diff、逐行阅读)+ 语法检查(node --check)+ 小程序反模式审计(scripts/audit-mp-antipatterns.js)+ 重复接口调用审计(scripts/audit-duplicate-api-calls.js)。未启动 HBuilderX/小程序模拟器,行为层仍需真机复现确认。
复核原则:一律以代码实际为准,不信任对方报告;未按此处证据修改的文件不计入。


1. 列表卡片摘要纯文本化(去 HTML 标签/还原实体)

PASS

证据

  • cfc-frontend/pages/activity/index.vue:140(发现列表卡片):

    <text class="card-desc" v-if="act.intro || act.description">{{ plainText(act.intro || act.description) }}</text>
    

    修复前直接渲染 {{ act.intro || act.description }},会把 <p>、<br>、&nbsp; 等原样展示;现统一走 plainText()。

  • cfc-frontend/pages/activity/index.vue:404-422(plainText 方法):去掉 <style>/<script> 标签、去掉全部 HTML 标签、解码 &nbsp; / &lt; / &gt; / &amp; / &quot; 以及 &#x…; / &#…; 数字实体,最后压缩空白并 trim,输出纯文本摘要。

详情页富文本未破坏

  • cfc-frontend/pages/activity/activity-detail/activity-detail.vue:108-112:详情页"活动介绍"区段由 v-if="activity.intro || activity.description" 控制,activity.intro 走 <text class="intro-text"> 纯文本展示,activity.description 仍走 <mp-html :content="activity.description" :tag-style="contentTagStyle" />,富文本渲染完整保留。
  • 页面未移除 mp-html 组件引用(@/components/mp-html/mp-html.vue,activity-detail.vue:329),:intro 传参也使用了 activity.intro || activity.description(activity-detail.vue:301)。

关于 pages/discover/index.vue

已逐行阅读:该页是商品推荐 / 知识分享聚合页,不渲染活动卡片摘要,不存在 act.description 列表展示,无需且未做改动,与本次需求无冲突。


2. 从活动详情返回列表,不重复追加(onShow / 加载更多 / 下拉刷新)

PASS(修正后)

2.1 翻倍根因(修复前行为)

git show HEAD 确认:原 onShow(pages/activity/index.vue:391-399,HEAD 版)在从子页返回时调用 this.loadData(),不带 refresh,而 loadDiscoverActivities() 等未带 refresh 时执行 this.xxxActivities = this.xxxActivities.concat(records)(index.vue:732/761/806 对应旧版行号),导致返回列表重复追加、数据翻倍。

2.2 修复后行为(逐钩子核实)

钩子 位置 行为 结论
onLoad(首次进入) index.vue:381-389 loadData()(首屏,列表为空,正常) 正常
onShow 首次(与 onLoad 连续触发) index.vue:392-393 _onLoadFired === true → 置 false,跳过,避免双发 正常(遵循 AGENTS.md 规则 1)
onShow(从详情/子页返回) index.vue:394-398 this.loadData(true),带 refresh 语义:页码归 1 并清空列表后再加载,旧数据不被追加 已修复翻倍
onTabChange / 筛选 / 维度切换 index.vue:466-480, 634-651 各自 tab 页码归 1、列表清空后 loadData() 正常,无残留旧数据
加载更多(scrolltolower→onLoadMore) index.vue:652-664 !this.hasMore 提前返回;页码 ++,不传 refresh → concat 追加;discoverLoading/mineLoading/historyLoading 互斥守卫 翻页能力保留
下拉刷新(onRefresh) index.vue:665-683 isRefreshing = true,传 true 刷新(页码归 1、列表清空),.finally 复位 isRefreshing 已修复(见下文预存在的 .finally Bug 及修正)
manage tab index.vue:488-492 loadManageData() 固定 page=1、直接覆盖 manageActivities,不翻倍 正常

三个加载方法的 refresh 分支(页码归 1 + 列表置空):

  • loadMyActivities: index.vue:686-688
  • loadDiscoverActivities: index.vue:747-749
  • loadHistoryActivities: index.vue:781-783

2.3 本次额外修正(预存在 Bug,影响"下拉刷新仍然可用")

onRefresh 调用 this.loadMyActivities(true).finally(...) 等,但三个加载方法 不返回 Promise(HEAD 版亦如此),导致 undefined.finally 抛 TypeError:数据虽会重载,但 isRefreshing 永不复位,下拉刷新转圈卡死、后续刷新受阻。

已修正:

  • 三个加载方法均 return 接口 Promise 链;未登录/无 memberId 的提前返回分支改为 return Promise.resolve()(index.vue:697, 792)。
  • 同时为三个方法加了 per-tab 请求序号守卫(_mineReqSeq / _discoverReqSeq / _historyReqSeq,index.vue:690-692, 751-753, 785-787):响应到达时若 seq !== 当前序号(即已有更新请求覆盖),直接丢弃,彻底消除“旧分页响应迟到后 concat 到刷新后列表、导致翻倍”的残留竞态。

2.4 剩余风险(已补救,列在下方遗留问题)

  • 极窄竞态:进入详情前触发加载更多(page 2 请求在飞行),返回后 onShow 刷新(page 1),若 page 2 响应迟到晚于刷新响应,会被 seq 守卫丢弃。已通过序号守卫兜底。

3. 语法错误 / 未定义变量 / 遗漏分支 / 残留调试代码

PASS

  • node --check 对三个文件提取的 <script> 块逐一通过(index.vue、create.vue、activity-detail.vue)。
  • scripts/audit-mp-antipatterns.js:0 ERROR / 185 WARN(WARN 全为其它页面的预存在项,本次改动未新增任何 ERROR,无 ?.、:key 运算符表达式、中文 CSS 选择器、uni.getSystemInfoSync()、toLocale*String 等违规)。
  • scripts/audit-duplicate-api-calls.js:0 ERROR / 108 WARN(WARN 全为其它页面,本次改动未新增同 URL 重复调用)。
  • 新增代码无 console.log / debugger / alert;activity-detail.vue:809, 892 的两处 console.warn 为预存在代码(海报降级、报名回写),与本次修复无关,未动。

4. 遗留问题与建议

# 问题 位置 处置
1 仅做了静态/语法审计,未在 HBuilderX 小程序模拟器或真机上复现“返回列表不翻倍”“下拉刷新转圈复位”的运行行为 — 建议放行前在模拟器/真机复现:从发现列表进详情再返回,列表应等于首屏;下拉刷新应停止转圈并可重复触发。
2 verify-vue-compile.js 在本环境因未安装 vue-template-compiler/sass 跳过了模板/样式校验(环境限制,非代码问题) — 放行前在有 HBuilderX 的机器上做一次打包编译确认。
3 详情页海报组件 <ActivityPoster :intro="..."> 已改用 activity.intro,若后端某些老数据只返回 description 未返回 intro,卡片/海报摘要会降级为纯文本化 description(可接受,非回退) activity-detail.vue:301 可接受,无需改动。
4 create.vue 新增 intro 字段提交(payload.intro 为空时不提交,index.vue 等位),后端 Activity 实体已有 intro 字段(cfc-backend/.../entity/Activity.java:23),写入路径未在本次范围内逐行审计 create.vue:107-115, 210, 276, 470-472 建议确认保存/发布接口已持久化 intro,否则列表摘要将一直降级到 description。

结论

可以放行(修正后)。

两处原需求均已在代码中落实并经审计通过:

  1. 发现活动列表卡片摘要已做纯文本化(plainText 去标签、还原 &nbsp; 等实体),详情页富文本渲染(mp-html)未受影响;
  2. 从活动详情返回列表已不重复追加(onShow 带 refresh 重置列表/页码),加载更多与下拉刷新能力保留;同时修正了预存在的下拉刷新 .undefined.finally 卡死 Bug,并加 per-tab 请求序号守卫消除旧分页响应迟到导致的残留翻倍风险。

未动 cfc-backend 中属 BASIC 会员配额的 ActivityController / ActivityRegistrationService 改动;未手改 dist / unpackage;未执行 git commit(按护栏,提交由后续流程统一处理)。

提交范围建议:

  • cfc-frontend/pages/activity/index.vue(含本次修正)
  • cfc-frontend/pages/activity/create.vue
  • cfc-frontend/pages/activity/activity-detail/activity-detail.vue
  • docs/superpowers/plans/verify/verify-discover-activity-list.md(本文件)