鸿蒙实践中心案例库巡览:分页、去重与 Star 状态核验

举报
yd_243549746 发表于 2026/11/14 09:20:09 2026/11/14
【摘要】 鸿蒙实践中心案例库巡览:分页、去重与 Star 状态核验鸿蒙开发实践中心(harmonybp.developer.huaweicloud.com)的「实践任务」页里,有两项每日任务绕不开案例库:浏览一个案例详情页超过 30 秒,以及到案例对应的 GitCode 代码仓点一次 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 状态怎么核验才可信

页面上有三个地方看起来都能说明「点没点过」,可信度完全不同:

  1. Star 计数。最不可靠。仓库被别人 Star 也会让数字变化,你昨天记的是 98,今天看到 99,无法区分是自己点的还是别人点的。
  2. 卡片上的完成标记。也不可靠。实测出现过卡片在点 Star 之前就显示「已完成」的情况,此时成长中心侧仍是「去完成」。
  3. 按钮自身的文案。最可靠。点成功之后按钮会从 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。剩下的时间交给平台同步,不需要反复刷新去确认。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。