QuizApp 系列 01：本地优先的学习闭环#

为什么本地优先#

学习工具和一次性网页不同。题库、错题、收藏、答题记录和统计数据都有长期价值。如果这些数据依赖不稳定的网络或外部服务，用户很容易因为一次同步失败丢失进度。

本地优先意味着关键数据先保存在本机。即使暂时没有网络，用户也可以继续练习；即使后续版本升级，也要通过迁移策略保留已有数据。

学习路径#

一个稳定的学习路径通常包括六步：选择题库，进入练习，作答，查看答案和解析，记录错题或收藏，再回到统计结果决定下一轮复习范围。

这条路径比功能列表更重要。功能很多但不能串成闭环，用户还是会在页面之间迷路。QuizApp 的页面和状态设计都应该围绕这条路径展开。

数据对象#

本地数据至少包含题库、题目、答案、解析、练习进度、错题记录、收藏记录、主题设置和用户偏好。每类数据都要考虑保存、读取、迁移和异常恢复。

例如，题目可以重新导入，但错题和练习进度是用户长期积累的结果。更新版本时，不能轻易改变这些数据的结构或路径。

状态恢复#

用户关闭工具后再次打开，应该能回到合理状态。练习模式、题目序号、已选答案、答题结果和滚动位置都可能影响体验。尤其是手写题或长题干场景，中断恢复比重新开始更重要。

状态恢复不是简单保存一个页面索引，而是要明确哪些状态属于题库，哪些属于本次练习，哪些属于全局设置。

阶段结论#

QuizApp 的第一优先级是让学习记录稳定存在。只有本地题库、答题状态和复习记录可靠，AI 解析、主题切换和更新分发才有意义。学习工具的基础体验是连续性，而不是一次打开时的功能密度。