鸿蒙实践中心案例库巡览:分页、去重与 Star 状态核验
鸿蒙实践中心案例库巡览:分页、去重与 Star 状态核验
鸿蒙开发实践中心(harmonybp.developer.huaweicloud.com)的「实践任务」页里,有两项每日任务绕不开案例库:浏览一个案例详情页超过 30 秒,以及到案例对应的 GitCode 代码仓点一次 Star。前者是纯阅读,后者带两个硬约束——每日必须换一个不同的项目,而且点过之后不能取消。这两条约束决定了不能靠肉眼随手点,必须有办法稳定地判断「这个仓我今天/以前点过没有」。
这篇文章记录我把这套流程跑成固定动作之后,关于案例库结构、分页方式与 Star 状态核验的几点观察。
一、列表页的结构:卡片、页码按钮
案例列表以卡片形式排布,一张卡对应一个案例,每页固定 6 个。卡上有标题、简介、难度标签,以及一个「查看案例」入口。很多人第一次写自动化会栽在这里:卡片的「查看案例」不是按钮语义,用 role 定位会一直等到超时。
// 会超时
page.getByRole('button', { name: '查看案例' })
// 改用文本定位,按序号取第 N 张卡
page.getByText('查看案例', { exact: true }).nth(i)
分页控件同样容易判断错。它不是常见的 li.number,而是 button.page-num。如果按 li 去找页码,会得到空集合,然后误以为「只有一页」。第一页的 6 个案例在连续几天之后必然全部点过,这时候不翻页就无解。
二、从案例详情到代码仓
案例详情页的正文里会给出代码仓地址,形如:
https://gitcode.com/harmony-practice-center/xxx.git
注意结尾的 .git。浏览器里直接访问带 .git 的地址会走到裸仓视图,Star 按钮所在的位置和正常仓库页不一样,容易点空。正确做法是去掉后缀再打开:
const repo = link.replace(/\.git$/, '')
仓库命名上,模板类案例多以 HarmonyOS-APPTMPL- 开头(万年历、公交出行、汽车美容都属于这一类),应用类案例则是语义化命名(记账本、待办清单、单词打卡)。这个命名规律对去重很有用:模板类案例数量有限,翻到第二、三页之后大多会落到应用类。
三、Star 状态怎么核验才可信
页面上有三个地方看起来都能说明「点没点过」,可信度完全不同:
- Star 计数。最不可靠。仓库被别人 Star 也会让数字变化,你昨天记的是 98,今天看到 99,无法区分是自己点的还是别人点的。
- 卡片上的完成标记。也不可靠。实测出现过卡片在点 Star 之前就显示「已完成」的情况,此时成长中心侧仍是「去完成」。
- 按钮自身的文案。最可靠。点成功之后按钮会从
Star变成Starred,这是服务端返回的当前账号对该仓库的状态,与计数无关。
用选择器定位时还有一个细节:页面上存在两个同结构的 Star 元素,其中一个是隐藏的引导浮层,宽度为 0。直接取第一个会点到不可见元素上,表现为「点了没反应」。比较稳的判据是取渲染宽度大于 50 像素的那个:
const btns = [...document.querySelectorAll('.repo-action-group--star .status-btn')]
const real = btns.find(b => b.getBoundingClientRect().width > 50)
const starred = real.innerText.trim() === 'Starred'
四、每日换一个项目:靠台账而不是靠记忆
既然「不可取消」且「每日不同」,最省事的做法是维护一份轻量台账:日期、仓库全名、Star 后按钮状态。下次进来先读台账,再对照仓库页的按钮状态复核一遍——两边都通过才动手。
台账不必是数据库,一个 Markdown 表格就够:
| 日期 | 仓库 | 复核结果 |
|---|---|---|
| 11-11 | harmony-practice-center/HarmonyOS-APPTMPL-Calendar | Starred |
| 11-12 | harmony-practice-center/HarmonyOS-APPTMPL-bustravel | Starred |
| 11-13 | harmony-practice-center/HarmonyOS-APPTMPL-car-beauty-care | Starred |
好处是断档时能立刻看出「上一页还有哪几个没点过」,不用重新翻一遍全部案例。
五、几个实测踩到的坑
停留时间按秒表算,不按感觉算。 「浏览超过 30 秒」是服务端判定的,但页面切到后台后计时行为并不一定和前台一致。我在详情页停留 40 秒以上再离开,从未失手;停留 25 秒左右则出现过不计分。留 10 秒余量是成本最低的保险。
新标签页会抢焦点。 点「查看案例」会打开新标签,后续所有操作都要切到新标签再执行,否则会在旧标签上找不到元素。用完后及时关掉,避免标签页堆积后定位错页面。
详情页的渲染是异步的。 刚打开时正文字段可能是空的,立刻抓链接会得到 undefined。等正文出现再抓,或者对链接做一次重试。
积分不是即时到账。 浏览任务的 +10 通常当场进明细,Star 的 +30 可能几分钟,也可能到傍晚。判断依据应该是成长中心的积分流水,而不是任务卡片的文案——卡片长期停在「去完成」是常态,不代表操作失败。
小结
这三件事——分页定位、仓库链接归一化、Star 状态核验——构成了案例库巡览的全部难点。把它们固定成脚本之后,每日操作就退化成三步:翻到第一个未点过的案例、读满 40 秒、点 Star 并确认按钮变为 Starred。剩下的时间交给平台同步,不需要反复刷新去确认。
- 点赞
- 收藏
- 关注作者
评论(0)