篮球口袋教练 HarmonyOS 学习应用（07）：个人页成就与学习统计

一、统计卡片不能从页面临时变量取数个人页同时展示连续学习、累计时长、课程完成、练习和测验等信息。若每张卡片各自维护一个计数器返回页面、重启应用或在其他页面新增记录后数字很容易彼此矛盾。这里把个人页视为统计结果的消费者而不是新的事实来源。export class AchievementService { static checkAll(): string[] { const unlocked: string[] []; // --- streak --- const streak: number ProgressService.streak(); if (streak 3) unlocked.push(streak_3); if (streak 7) unlocked.push(streak_7); if (streak 14) unlocked.push(streak_14); if (streak 30) unlocked.push(streak_30); // --- study --- const studied: string[] AppStorage.getstring[](StorageKeys.STUDIED) ?? []; if (studied.length 1) unlocked.push(study_1); if (studied.length 5) unlocked.push(study_5); if (studied.length 10) unlocked.push(study_10); const seconds: number AppStorage.getnumber(StorageKeys.LEARN_SECONDS) ?? 0; if (seconds 3600) unlocked.push(time_1h); if (seconds 18000) unlocked.push(time_5h); // --- practice --- const logs: PracticeLog[] AppStorage.getPracticeLog[](StorageKeys.PRACTICE_LOGS) ?? []; if (logs.length 1) unlocked.push(practice_1); if (logs.length 10) unlocked.push(practice_10); if (logs.length 30) unlocked.push(practice_30); for (const log of logs) { if (log.rating 5) { unlocked.push(practice_star); break; } } // --- note --- const notes: NoteItem[] AppStorage.getNoteItem[](StorageKeys.NOTES) ?? []; if (notes.length 1) unlocked.push(note_1); if (notes.length 5) unlocked.push(note_5); // --- explore --- const favs: string[] AppStorage.getstring[](StorageKeys.FAVORITES) ?? []; if (favs.length 1) unlocked.push(fav_1); if (favs.length 10) unlocked.push(fav_10); // --- quiz ---二、成就条件怎样复用已持久化的学习事实AchievementService 会把 ProgressService 的连续学习天数、已学习课程集合、PracticeLogService 的日志、笔记集合以及 QuizService 的结果放到同一次条件检查中。它返回的是已解锁成就 id页面再用该结果筛选徽章不把“显示过的徽章”反向当作用户数据。事实唯一来源页面职责正常结果模型或服务的回读渲染可观察状态边界结果明确的缺项或失败分支说明原因并保留入口重进结果持久化或模型再次解析不复用旧页面变量} static totalSeconds(): number { return AppStorage.getnumber(StorageKeys.LEARN_SECONDS) ?? 0; } // 连续学习天数从今天往前数连续有记录的天数 static streak(): number { const days: string[] AppStorage.getstring[](StorageKeys.LEARN_DAYS) ?? []; if (days.length 0) return 0; const sorted: string[] days.slice().sort(); const today: string dayKey(); // 如果今天没有学习记录从昨天开始算 let cur: Date new Date(); if (sorted.indexOf(today) 0) { cur.setDate(cur.getDate() - 1); } let count: number 0; while (true) { const key: string dayKey(cur); if (sorted.indexOf(key) 0) { count; cur.setDate(cur.getDate() - 1); } else { break; } } return count; } }三、个人页与成就页为何必须各自回读累计学习秒数和连续天数都来自持久化键。记录学习行为后服务先写入 AppStorage 并同步 Preferences个人页下次显示时重新读取因此统计不会依赖此前页面是否仍在内存。这个取舍增加了回读成本却避免了跨页面共享可变数组。StorageLink(user_nick) nick: string ; State achieveCount: number 0; aboutToAppear(): void { this.achieveCount AchievementService.checkAll().length; } build() { Column() { Row() { Text(我的) .fontSize(AppText.fsTitle) .fontWeight(AppText.fwSemi) .fontColor(this.palette.textPrimary) .layoutWeight(1); } .width(100%).height(AppSizes.topBar) .padding({ left: AppSizes.s4, right: AppSizes.s4 }); Scroll() { Column({ space: AppSizes.s4 }) { this.userCard(); this.statsCard(); this.menuList(); Column().height(AppSizes.s8); } .width(100%) .padding({ left: AppSizes.s4, right: AppSizes.s4 }); }四、错误统计最容易发生在什么地方成就阈值的边界必须可解释。例如连续学习三天、完成五个课程、完成一次测验分别是不同事实不能用总点击次数替代。若某项写入失败页面应显示未满足条件而不是预先点亮徽章否则用户会看到无法在重启后复现的“成功”。风险不能采用的做法当前链路的处理数据不存在用默认对象继续渲染停在可解释的空或失败状态页面重进复用上一次内存字段重新查询模型或服务重复动作追加同一业务事实通过稳定 id 或进入标记收敛export class QuizService { static submitResult(moduleId: string, score: number, total: number): void { const results: QuizResult[] QuizService.allResults(); results.push({ moduleId, score, total, ts: Date.now() } as QuizResult); AppStorage.setOrCreatestring(QUIZ_KEY, JSON.stringify(results)); } static allResults(): QuizResult[] { const raw: string AppStorage.getstring(QUIZ_KEY) ?? []; try { return JSON.parse(raw) as QuizResult[]; } catch (e) { return []; } } static bestScore(moduleId: string): number { const results: QuizResult[] QuizService.allResults(); let best: number 0; for (const r of results) { if (r.moduleId moduleId r.score best) { best r.score; } } return best; } static hasCompleted(moduleId: string): boolean { return QuizService.allResults().some(r r.moduleId moduleId); }五、可观察的验收动作验收时先完成一项课程或写入一条练习日志再进入个人页与成就页分别回读。随后强制退出并重新打开比较累计时长、连续天数和解锁数量是否保持一致最后切换测验模块确认某一模块成绩不会改写另一模块的统计。验收阶段操作应观察到的结果建立事实完成一次与主题直接对应的动作服务或模型能回读该事实页面回读进入目标页或结果页标题、数据和状态相互一致重进验证返回、重启或切换模块后再次进入结果不依赖上一页残留六、取舍与后续维护当前实现把业务事实集中到模型与服务页面只负责呈现和触发操作。这样做会多出类型、查询和回读代码却能避免同一份统计或记录在多个页面分叉。需要扩展新课程、新资源或新题目时应先补齐稳定标识与服务合同再补页面入口。ArkTS 的响应式状态机制可参考 HarmonyOS ArkTS 状态管理文档。本文的代码和验收围绕同一个原则可见结果必须能回到对应模型、服务或持久化事实不以邻近页面和控件文字代替主题结果。七、围绕事实来源继续演进篮球口袋教练 HarmonyOS 学习应用07个人页成就与学习统计 关注的不是给页面再增加一层显示逻辑而是让“统计卡片不能从页面临时变量取数”始终能回到唯一的业务事实。模型字段、服务返回值和页面展示应当保持单向关系事实先发生页面随后回读页面不保存第二份能够被误认为真实数据的临时副本。处理“成就条件怎样复用已持久化的学习事实”时新增条件必须先归属到课程模型、资源服务、日志事实或测验结果之一。把条件散落在多个组件里短期看起来省事后续就会出现入口不同、重进不同、统计不同的问题。把规则放回稳定入口页面只根据结果改变可见状态能让同一结论在不同入口被复查。“个人页与成就页为何必须各自回读”说明当前实现选择了页面重建后重新查询而不是把对象和统计快照长期塞进路由参数。读取会增加少量成本却避免课程改名、资源替换、日志编辑或题库切换后继续显示旧内容。学习应用的结果需要能解释不能只追求一次渲染恰好看起来正确。异常分支也应保留语义成就阈值的边界必须可解释。例如连续学习三天、完成五个课程、完成一次测验分别是不同事实不能用总点击次数替代。若某项写入失败页面应显示未满足条件而不是预先点亮徽章否则用户会看到无法在重启后复现的“成功”。 这要求页面区分数据不存在、动作未完成和资源不可用并提供返回选择、补充输入、重新下载或再次答题等对应操作不能把不同原因压缩成同一条模糊的成功或失败提示。最后执行“可观察的验收动作”时至少观察一次主题动作、一次目标页回读和一次重进或切换后的回读。三次观察都指向相同模型或服务结果才说明实现链路没有依赖旧页面残留。面向维护的检查可以沿三个问题展开输入对象的稳定标识是什么哪个服务或模型决定结果页面如何把该结果显示出来。把连续学习、课程进度、练习日志和测验结果汇成成就事实个人页只消费服务回读避免把展示字段当成统计源。 这三个问题分别对应数据合同、调用边界和可见反馈只要其中一层被绕过新增入口就可能产生和原入口不同的事实。对失败路径也要保留同样的追踪能力。先让服务返回清晰的不可用、缺项或未完成状态再由页面提供与原因匹配的操作。这样日志、课程、资源和题目发生变化时回归测试能够看到具体的分歧点而不是只能面对一张没有信息的空白页面。这种组织不会承诺所有后续需求都零成本。新增字段需要同步更新模型、服务与验收但它把变更范围限制在可枚举的位置避免把同一判断复制到首页、详情、个人页和结果页后再分别修补。