鸿蒙智学舱（base_study）

面向 HarmonyOS 的本地学习型应用：体系课 Markdown、智学短文/视频/JSON 题库、刷题与错题本、学习计划等。适合作为课程设计 / 简历项目持续迭代。

运行环境

• DevEco Studio（与工程 build-profile.json5 中 compatibleSdkVersion 一致，当前为 HarmonyOS 6.0.x 档）
• 真机或模拟器（Phone）

克隆工程后，用 DevEco 打开仓库根目录，待依赖同步完成，对 entry 模块选择 Run 即可。

架构要点（对应「无后端 / 数据在哪」）

类型	说明
无服务端	学习进度、智学偏好、头像等均在端上；未发现业务云 API。
体系课正文	entry/src/main/resources/rawfile/learning_catalog_md/ 等，由 LearningCatalog 聚合。
智学内容	rawfile 下 JSON（文章、视频、题库等），经 ZhiXueDataLoader 加载。
全局刷题错题	WrongBookService + 本地持久化（与「智学 JSON 错题偏好」分列两套入口，个人中心有说明）。

若以后要 账号同步 / 多端学习记录，需单独接入认证与云存储；当前工程未包含该层。

入口说明

• 实际启动页：EntryAbility 加载 pages/MainPage（四 Tab 主框架），无需登录。
• Login / Register / Recover / AIDebug：仍在 main_pages.json 中注册，页面为占位，便于将来扩展或 Deep Link；日常用户不会从冷启动进入这些页。

主要页面（节选）

• MainPage：首页 / 学习 / 题库 / 个人中心
• ArticleDetailPage、ThemeDetailPage：体系课文档与主题
• QuizPage：章节测验、鸿蒙每日练、智学 JSON 套卷等
• ZhiXueSearchPage、ZhiXueLessonDetailPage：智学搜索与短文详情
• WrongBookListPage：全局刷题错题本

主路由封装见 entry/src/main/ets/common/AppNavigation.ets。

测试

• 本地单元测试入口：entry/src/test/List.test.ets → LocalUnit.test.ets（Hypium）。
• 在 DevEco 中执行 entry 模块的 Test 任务即可；具体目录以 IDE 导航为准。

手动验收建议（上架 / 答辩前可跑一遍）

1. 冷启动进入首页，切换四个 Tab 无崩溃。
2. 打开一篇体系课文档，返回后进度或展示正常。
3. 从题库进入 QuizPage，提交一题，解析与（若有）延伸阅读按钮符合预期。
4. 搜索 → 进详情 → 返回，搜索关键词是否仍保留（按当前产品设定）。
5. 个人中心：智学记录、刷题错题本、清除学习进度等与说明文案一致。

文档与协作

• 答辩 / 汇报用完整说明：见 docs/项目报告.md。
• 修改题库结构时，请同时核对 zhixue_quiz.json 与 ZhiXueModels / QuizModels / ZhiXueQuizSessionBuilder 的字段映射。
• 欢迎用 Git 小步提交，便于回溯与展示过程量。