# study-app

**Repository Path**: chen-jingyicoco/study-app

## Basic Information

- **Project Name**: study-app
- **Description**: 鸿蒙学习APP
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-30
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鸿蒙三问高效学习机

## 项目简介

基于 HarmonyOS Next (API 22) 开发的智能学习应用，采用"三问高效学习法"，帮助用户构建结构化知识体系、培养批判性思维、验证学习效果。

## 核心功能

### 1. 柔性课程体系
- **提问即建课**：输入问题自动生成课程骨架
- **多源资料整合**：支持上传 PDF/Word/Markdown，AI自动爬取权威资料
- **课程生命周期管理**：未创建 → 活跃 → 完成 → 归档

### 2. 三问学习流程（强制顺序）

#### 第一问：心智模型
- 生成可视化知识图谱
- 展示概念节点、层级关系
- 支持展开/折叠、查看详情

#### 第二问：学术分歧
- 挖掘争议主题和正反观点
- 左右分栏对比展示
- 证据链溯源、立场标记

#### 第三问：深度测评
- 布鲁姆六维度出题（记忆/理解/应用/分析/评价/创造）
- 多种题型：单选、多选、简答、分析题
- 即时判分、解析、错题收藏

### 3. 学习报告
- 能力雷达图可视化
- 薄弱知识点识别
- 个性化学习建议
- 原始对话记录保存

## 技术架构

### 分层架构
```
┌─────────────────────────────┐
│ UI 展示层（Pages）           │
│ Index | CourseSpace | Report│
├─────────────────────────────┤
│ 组件层（Components）         │
│ CourseCard | MindMap        │
│ DebatePanel | QuizCard      │
├─────────────────────────────┤
│ 核心引擎层（Engine）         │
│ ThreeAsk | Course           │
│ KnowledgeBase               │
├─────────────────────────────┤
│ 数据服务层（Service）        │
│ AIService                   │
├─────────────────────────────┤
│ 工具层（Utils）              │
│ Constants | Types | Storage │
└─────────────────────────────┘
```

### 目录结构
```
entry/src/main/ets/
├── pages/                  # 页面
│   ├── Index.ets          # 首页
│   ├── CourseSpace.ets    # 课程空间
│   └── ReportPage.ets     # 学习报告
├── components/            # 组件
│   ├── CourseCard.ets     # 课程卡片
│   ├── MindMap.ets        # 知识图谱
│   ├── DebatePanel.ets    # 学术分歧面板
│   └── QuizCard.ets       # 测评题目卡片
├── engine/                # 核心引擎
│   ├── CourseEngine.ets   # 课程引擎
│   ├── KnowledgeBase.ets  # 知识库引擎
│   └── ThreeAskEngine.ets # 三问引擎
├── service/               # 服务
│   └── AIService.ets      # AI服务
├── utils/                 # 工具
│   ├── Constants.ets      # 常量定义
│   ├── Types.ets          # 类型定义
│   └── Storage.ets        # 存储工具
└── theme/                 # 主题
    └── ThemeManager.ets   # 主题管理器
```

## 开发环境

- **系统**：HarmonyOS Next
- **API版本**：≥ 22
- **开发语言**：ArkTS
- **应用模型**：Stage模型
- **开发工具**：DevEco Studio

## 运行项目

1. 使用 DevEco Studio 打开项目
2. 配置签名证书（如需真机调试）
3. 点击运行按钮或按 `Shift + F10`

## 已完成功能

### Phase 1: 基础框架 ✅
- [x] 项目创建与配置
- [x] 标准目录结构
- [x] 常量定义（Constants.ets）
- [x] 类型定义（Types.ets）
- [x] 存储工具（Storage.ets）
- [x] 首页UI（Index.ets）

### Phase 2: 柔性课程引擎 ✅
- [x] 课程CRUD操作
- [x] 课程生命周期管理
- [x] 学习进度跟踪
- [x] 课程卡片组件
- [x] 多课程并行管理

### Phase 3: 复合知识库 ✅
- [x] 知识节点管理
- [x] 文件上传解析（框架）
- [x] 知识关联与搜索
- [x] 去重检查

### Phase 4: 三问核心引擎 ✅
- [x] 心智模型生成算法
- [x] 知识图谱可视化组件
- [x] 学术分歧挖掘算法
- [x] 学术分歧对比面板
- [x] 布鲁姆六维度出题算法
- [x] 测评题目卡片组件

### Phase 5: AI服务集成 ✅
- [x] AI服务框架
- [x] 网络请求封装
- [x] 内容抓取与解析（框架）
- [x] 离线缓存接口

### Phase 6: UI/可视化 ✅
- [x] 课程空间页面
- [x] 学习报告页面
- [x] 主题管理器
- [x] 多主题支持

## 待完善功能

### 需要补充的实现
1. **真实的AI API集成**
   - 替换模拟数据为真实API调用
   - 配置API密钥和端点

2. **文件解析完整实现**
   - PDF解析库集成
   - Word文档解析
   - Markdown语法解析

3. **路由跳转完善**
   - 首页到课程空间的跳转
   - 课程空间到报告页的跳转
   - 参数传递优化

4. **娱乐化激励**
   - 学习徽章系统
   - 打卡功能
   - 积分排行榜

5. **性能优化**
   - 图片懒加载
   - 列表虚拟化
   - 内存管理

## 注意事项

### 禁止项（评分红线）
- ❌ 隐藏或合并三问步骤
- ❌ AI直接替用户生成完整课程
- ❌ 用AI生成答案喂给APP再评价
- ❌ 无来源的虚假知识内容
- ❌ 跳过测评直接生成报告

### 性能指标要求
- 页面切换 ≤ 300ms
- 课程生成 ≤ 2s
- 图谱加载 ≤ 2s
- 资料解析准确率 ≥ 95%
- 内存占用 ≤ 150MB

## 后续优化方向

1. **增强AI能力**
   - 接入大语言模型API
   - 智能问答机器人
   - 自适应学习路径

2. **社交功能**
   - 学习小组
   - 知识分享
   - 讨论区

3. **数据分析**
   - 学习行为分析
   - 预测模型
   - 个性化推荐

4. **多端适配**
   - 平板优化
   - 折叠屏适配
   - 跨设备同步

## 许可证

本项目仅供学习和研究使用。

## 联系方式

如有问题或建议，欢迎反馈。

---

**祝学习愉快！** 🎓