HarmonyOS 应用做多设备适配，最容易出现一种“看起来已经适配”的假象：项目里有 sm 、 md 、 lg 三档断点，也写了底部导航和侧边导航，但真正改变窗口宽度时，外层导航没有切换；部分内容页已经变成三列，另一些页面仍保持手机布局；底部按钮看似有安全间距，却没有把系统导航指示区算进去。代码存在不等于路径可达，多设备布局必须从“窗口信号、共享状态、布局决策、组件重排、安全区”整条链路逐项核验

本地应用最容易出现的状态问题，并不是“数据完全没保存”，而是两套状态不同步：用户刚收藏题目，当前按钮已经变色，但返回首页统计仍是旧数字；删除错题后列表消失，重新启动又回来；设置页显示了新考试时长，练习页却仍读取旧值。根因通常是页面状态与持久化存储各自维护一份数据，却没有明确谁负责写入、谁负责通知 UI。 中国方言题库采用一条简单但可复核的链路：Preferences 保存可跨进程重启恢复的数据，

HarmonyOS 应用中的“导航”通常不止一种：底部 Tab 是同一主容器里的内容切换，搜索、题库详情、练习和设置则是路由栈中的页面跳转。若把两者混为一谈，常见结果是点击“更多”不断向路由栈压入重复主页、设置页返回后落错 Tab、启动页出现在返回历史里，或者目标页在参数缺失时直接使用空 ID。 中国方言题库把五个一级入口集中到 Index ，由 currentTabIndex 切换首页、题库、报

HarmonyOS 应用的首屏稳定性，不只取决于某个页面能否成功构建。系统如何找到入口 Ability、运行时状态何时恢复、断点监听何时注册、窗口避让区何时可读、启动页如何进入主页，以及销毁时是否解除监听，共同组成一条完整启动链路。任意一步顺序混乱，都可能表现为首屏白屏、数据闪烁、底部导航被遮挡、窗口变化后布局不更新，或者返回键又退回启动页。 中国方言题库当前版本采用 Stage 模型的 UIAb

在方言学习应用中，题库入口看起来只是“把若干地区卡片排成列表”，真正落到工程里却会同时碰到数据排序、组件复用、学习进度回显、页面路由和多设备布局。若每个地区分别维护一套页面，四川话、粤语、东北话等入口很快会出现重复结构；如果只复用外观而没有统一数据与交互，点击目标、进度口径和大屏布局仍然会分叉。 中国方言题库当前版本没有为六个地区复制六份列表代码，而是由 BankListPage 遍历统一的 BA

摘要：中国方言题库的学习统计页没有维护一套额外计数器，而是从 bankProgress 、 examHistory 、 favoriteRecords 和 wrongRecords 四组本地事实数据实时汇总。 StatService 负责全局答题数、加权正确率、考试次数、收藏数、错题数和已学习题库数，页面再按题库展示完成量与正确率，并在大屏断点下切换为三列布局。本文面向 HarmonyOS 5.0

摘要：中国方言题库的搜索页不是网络搜索，也没有模糊分词引擎，而是基于本地 BANKS 与题目集合完成确定性的子串检索。页面同时支持关键词入口和题型分类入口，通过 searched 明确区分搜索首页、无结果和结果列表三种界面状态，并在用户修改分类关键词时主动退出分类模式。本文面向 HarmonyOS 5.0 及以上版本，逐段复核 SearchPage.ets 的 ArkUI 状态建模、结果上限、题库

摘要：中国方言题库的听音能力并不是播放预置方言音频文件，而是在 PracticePage 中调用 @hms.ai.textToSpeech ，把题目的 audioHint 文本交给系统语音引擎合成。实现采用本地引擎优先、在线引擎回退的策略，用监听器同步开始、完成、停止和错误状态；点击播放时先打开文字兜底弹窗，再尽力启动 TTS；页面离开时停止并关闭引擎。本文面向 HarmonyOS 5.0 及以上

摘要：结果页不是把几个数字摆进卡片，而是一次答题会话的“只读结算边界”。中国方言题库的 ExamResultPage 接收 PracticePage 传来的题库、分数、题量、正确数、用时和逐题记录，计算正确率与等级，生成答题状态网格，并把考试快照写入本地历史。本文面向 HarmonyOS 5.0 及以上版本，基于真实 ArkTS 源码复核参数契约、状态恢复、零题保护、结果持久化、错题解析和再次考试

摘要：答题页真正困难的部分不是画四个选项，而是保证“选中、判定、解析、错题、自动下一题、最终统计”按确定顺序发生。“中国方言题库”的 PracticePage 同时支持章节、随机、考试、错题练习和错题解析，使用 ArkUI @State 驱动单题界面，再通过 @StorageLink 与 UserDataManager 同步收藏、错题、笔记和学习进度。本文面向 HarmonyOS 5.0 及以上版