【OpenHarmony/HarmonyOs 】从 0 到 1 打造政治学习助手 App：功能规划到 ArkTS 落地

这篇文章从整体角度复盘 政治视界 的构建过程：如何从一个“政治学习工具”的想法，落地成包含首页、题库、笔记、闪卡、日报、报纸、学习报告和个人中心的 HarmonyOS NEXT App。适合想做教育类 ArkTS 项目的同学参考 🚀

一、先确定产品闭环

政治学习 App 不能只做题库，否则用户刷完就走。完整闭环应该是：

看知识 → 做题 → 记录错题 → 复习概念 → 看报告 → 调整目标

对应到项目模块：

• 每日政治/报纸：输入知识；
• 题库：检测掌握；
• 错题：发现薄弱；
• 闪卡：复习概念；
• 笔记：整理知识；
• 首页：聚合状态；
• 我的/报告：查看成长。

二、设计数据模型

项目先定义统一模型：

export interface Question {
  id: number;
  category: string;
  grade: string;
  knowledgePoint: string;
  type: 'single' | 'multiple' | 'truefalse' | 'fill';
  question: string;
  answer: string | string[];
}

模型先行很重要。页面可以变化，但数据模型是功能的骨架。

三、搭建主框架

Index.ets 负责底部 Tab：

if (this.currentTab === 0) {
  HomePage({ currentTab: $currentTab, refreshSignal: $homePageRefresh })
} else if (this.currentTab === 1) {
  NewspaperPage()
} else if (this.currentTab === 2) {
  NotesPage()
}

一级页面都放进主框架，页面切换统一管理。

四、实现题库核心

题库是第一核心：

checkAnswer(): void {
  const currentQuestion = this.getCurrentQuestion();
  if (!currentQuestion) {
    return;
  }
  const userAnswerStr = this.selectedAnswer.join(',');
  this.dataManager.recordAnswer(currentQuestion, userAnswerStr, correct);
}

答题后立刻写入学习统计和错题记录。

五、实现数据持久化

使用 Preferences：

this.prefs = await preferences.getPreferences(context, PREFERENCES_NAME);

并通过 DataManager 保存学习状态：

private saveStats(): void {
  storageManager.putString(STUDY_STATS_KEY, JSON.stringify(this.studyStats));
}

六、完善学习反馈

首页读取数据：

this.completedQuestions = this.dataManager.getCompletedQuestions();
this.correctRate = this.dataManager.getCorrectRate();
this.wrongQuestionsCount = this.dataManager.getWrongQuestionsCount();

用户每次打开首页都能看到学习状态。

七、加入闪卡和笔记

闪卡用于概念记忆：

card.mastered = true;
card.reviewCount++;
this.dataManager.recordSession('flashcard', card.category);

笔记用于知识整理：

const newNote: Note = {
  id: Date.now(),
  title: this.newNoteTitle,
  content: this.newNoteContent,
  category: this.newNoteCategory,
  grade: this.newNoteGrade,
  tags: [],
  createdTime: Date.now(),
  updatedTime: Date.now()
};

八、加入主题和响应式

主题统一放在 AppTheme，响应式统一放在 ResponsiveUtils。这两个能力越早做越好，否则后期页面多了再改会很痛苦。

九、实现路线总结

产品闭环设计
  ↓
数据模型定义
  ↓
主 Tab 框架
  ↓
题库答题
  ↓
本地存储
  ↓
首页看板
  ↓
闪卡/笔记/报纸
  ↓
成就/报告/响应式

十、结语

从 0 到 1 做学习助手，最重要的是先搭出学习闭环，而不是一开始追求功能数量。政治视界的实现思路是：先让用户能学、能练、能记录，再逐步加入视觉体验、数据反馈和多端适配。

ArkTS 很适合做这种结构清晰的学习 App。只要页面、模型、数据管理分层明确，项目就能稳步扩展 📚

十一、开发顺序建议

如果重新从零开始，我建议按这个顺序开发：

1. 建立 Question、Note、FlashCard 等模型
2. 准备少量样例数据
3. 搭建 Index 底部 Tab
4. 先完成题库答题流程
5. 加入 DataManager 和 StorageManager
6. 首页读取学习统计
7. 做错题记录
8. 加入闪卡和笔记
9. 做主题和响应式
10. 最后补动画、成就、学习报告

不要一开始就写大量页面。先让最核心的“做题-记录-反馈”跑通，后续模块才能围绕它扩展。

十二、每个阶段的验收标准

为了避免项目越写越散，可以给每个阶段设定验收标准：

题库阶段：
  能筛选题目，能判断答案，能显示解析

数据阶段：
  关闭重开 App 后学习数据还在

首页阶段：
  答题后切回首页，统计能刷新

错题阶段：
  答错自动保存，点击能回到题库

闪卡阶段：
  翻转、掌握、统计、学习会话都能更新

主题阶段：
  深浅色切换后所有页面颜色一致

这种验收方式能帮助你判断功能是真的完成了，还是只是页面看起来有了。

十三、代码组织经验

项目中最值得保留的组织方式是：

model：先定义数据
data：放样例内容
pages：写页面交互
utils：放业务和存储
common：放主题、响应式、安全区
components：放可复用视觉组件

这样新加一个功能时，基本知道应该改哪里。比如要做“模拟考试”，可以先在 DataModel 加 ExamRecord，在 data 准备试卷数据，在 pages 新建考试页，在 DataManager 记录成绩。

十四、后续功能路线

政治视界后续可以继续做：

• 模拟考试；
• 错题专项训练；
• 知识点掌握度雷达图；
• 学习计划；
• 隐私与数据页面；
• 元服务快捷入口；
• 平板双栏布局；
• 端侧个性化推荐。

这些功能都可以建立在当前架构上，不需要推倒重来。