1
This commit is contained in:
ChuXun
373
README.md
Normal file
373
README.md
Normal file
@@ -0,0 +1,373 @@
|
||||
# 🎓 知芽小筑
|
||||
|
||||
一款功能完善的微信小程序，为大学生提供课程管理、学习数据分析、AI助手等核心功能。
|
||||
|
||||
---
|
||||
|
||||
## 📱 核心功能模块
|
||||
|
||||
### 1. 🏠 首页（index）
|
||||
- 快速入口导航
|
||||
- 今日课程预览
|
||||
- 重要倒计时提醒
|
||||
- 学习数据概览
|
||||
|
||||
### 2. 📚 课程管理（courses）
|
||||
- 课程列表展示
|
||||
- 分类浏览（全部/进行中/已结束）
|
||||
- 课程详情查看
|
||||
- 课程资料管理
|
||||
|
||||
### 3. 📅 课程表（schedule）
|
||||
- 周视图课表
|
||||
- 当前时间定位
|
||||
- 课程详情快速查看
|
||||
- 空闲时间显示
|
||||
|
||||
### 4. 💬 论坛（forum）
|
||||
- 帖子浏览
|
||||
- 发帖功能
|
||||
- 点赞评论
|
||||
- 收藏功能
|
||||
- 话题分类
|
||||
|
||||
### 5. 🎯 GPA计算器（gpa）
|
||||
- 成绩录入
|
||||
- 学分管理
|
||||
- 加权平均绩点计算
|
||||
- 学期分组统计
|
||||
|
||||
### 6. ⏱️ 倒计时（countdown）
|
||||
- 重要事件提醒
|
||||
- 考试倒计时
|
||||
- 自定义事件添加
|
||||
- 天数自动计算
|
||||
|
||||
### 7. 🛠️ 工具箱（tools）
|
||||
- 实用工具集合
|
||||
- 快捷功能入口
|
||||
|
||||
### 8. 🤖 AI助手（启思AI）
|
||||
- 智能对话
|
||||
- 学习问题解答
|
||||
- DeepSeek API集成
|
||||
- 对话历史记录
|
||||
- 实时流式响应
|
||||
|
||||
### 9. 📊 学习数据（dashboard）
|
||||
**4大数据可视化功能**：
|
||||
|
||||
#### 9.1 学习能力画像（雷达图）
|
||||
- 6维度综合评估
|
||||
- 专注度、活跃度、学习时长等
|
||||
- Canvas 高质量绘制
|
||||
|
||||
#### 9.2 GPA趋势预测（折线图）
|
||||
- 历史成绩趋势展示
|
||||
- 多项式回归预测
|
||||
- 智能预测下学期GPA
|
||||
- 趋势分析（上升/下降）
|
||||
|
||||
#### 9.3 时间分配（饼图）
|
||||
- 各模块使用时长统计
|
||||
- 课程、论坛、工具、AI助手
|
||||
- 自动计算占比
|
||||
- 彩色可视化
|
||||
|
||||
#### 9.4 成绩对比（柱状图）
|
||||
- 个人 vs 班级平均
|
||||
- 超过平均课程数统计
|
||||
- 班级排名展示
|
||||
|
||||
### 10. 👤 个人中心（my）
|
||||
- 个人信息展示
|
||||
- 功能设置
|
||||
- 数据统计
|
||||
- 系统设置
|
||||
|
||||
---
|
||||
|
||||
## 🎨 技术特色
|
||||
|
||||
### UI/UX设计
|
||||
- **企业级视觉设计**：紫色渐变主题
|
||||
- **动画效果**：平滑过渡、加载动画
|
||||
- **响应式布局**：适配不同屏幕尺寸
|
||||
- **组件化开发**：loading、empty等通用组件
|
||||
|
||||
### 数据管理
|
||||
- **持久化存储**：wx.storage API
|
||||
- **自动数据追踪**：learningTracker系统
|
||||
- **实时数据同步**：12个页面集成
|
||||
- **智能数据分析**：GPA预测、趋势分析
|
||||
|
||||
### 性能优化
|
||||
- **懒加载**：图表延迟渲染
|
||||
- **数据缓存**：减少重复计算
|
||||
- **异步处理**：流式响应
|
||||
- **错误处理**：友好的空数据提示
|
||||
|
||||
---
|
||||
|
||||
## 📦 技术栈
|
||||
|
||||
### 前端框架
|
||||
- **微信小程序原生框架**
|
||||
- **Canvas API**：图表绘制
|
||||
- **WXSS**：样式设计
|
||||
|
||||
### 核心工具库
|
||||
- `utils/learningTracker.js` - 学习时间自动追踪
|
||||
- `utils/gpaPredictor.js` - GPA预测算法
|
||||
- `utils/util.js` - 通用工具函数
|
||||
- `utils/storage.js` - 数据存储管理
|
||||
- `utils/request.js` - 网络请求封装
|
||||
- `utils/logger.js` - 日志系统
|
||||
- `utils/analytics.js` - 数据分析
|
||||
- `utils/performance.js` - 性能监控
|
||||
|
||||
### 第三方服务
|
||||
- **DeepSeek API**：AI对话功能
|
||||
- **微信云服务**：数据存储（可选）
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ 数据存储结构
|
||||
|
||||
### 核心存储键
|
||||
|
||||
```javascript
|
||||
// GPA课程成绩
|
||||
'gpaCourses': [
|
||||
{ id, name, score, credit, semester }
|
||||
]
|
||||
|
||||
// 学习数据
|
||||
'learning_data': {
|
||||
totalDays: 30,
|
||||
totalHours: 85.5,
|
||||
dailyRecords: []
|
||||
}
|
||||
|
||||
// 模块使用时长（自动记录）
|
||||
'module_usage': {
|
||||
course: 28.5, // 小时
|
||||
forum: 22.3,
|
||||
tools: 25.7,
|
||||
ai: 9.0
|
||||
}
|
||||
|
||||
// 学习画像（自动记录）
|
||||
'learning_profile': {
|
||||
focus: 85, // 专注度
|
||||
activity: 90, // 活跃度
|
||||
duration: 75, // 学习时长
|
||||
breadth: 88, // 知识广度
|
||||
interaction: 72,// 互动性
|
||||
persistence: 95 // 坚持度
|
||||
}
|
||||
|
||||
// 课表数据
|
||||
'schedule': [
|
||||
{ id, name, time, location, teacher, weeks, dayOfWeek }
|
||||
]
|
||||
|
||||
// 倒计时事件
|
||||
'countdowns': [
|
||||
{ id, name, targetDate, description, color }
|
||||
]
|
||||
|
||||
// 论坛收藏
|
||||
'favoriteForumIds': [id1, id2, ...]
|
||||
|
||||
// AI对话历史
|
||||
'ai_chat_history': [
|
||||
{ role: 'user', content: '...', timestamp: ... },
|
||||
{ role: 'assistant', content: '...', timestamp: ... }
|
||||
]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 核心功能实现
|
||||
|
||||
### 1. 学习时间自动追踪
|
||||
|
||||
**原理**：每个页面集成 `learningTracker`
|
||||
|
||||
```javascript
|
||||
// 在 onShow() 中
|
||||
learningTracker.onPageShow('pageName');
|
||||
|
||||
// 在 onHide() 中
|
||||
learningTracker.onHide();
|
||||
```
|
||||
|
||||
**已集成页面**（12个）：
|
||||
- ✅ index, courses, course-detail, schedule
|
||||
- ✅ forum, forum-detail, post, gpa
|
||||
- ✅ countdown, tools, my, dashboard
|
||||
|
||||
### 2. GPA自动计算与预测
|
||||
|
||||
**流程**：
|
||||
1. 用户在 GPA页面 录入课程成绩
|
||||
2. 存储到 `gpaCourses`
|
||||
3. dashboard页面 自动读取
|
||||
4. 按学期分组计算平均GPA
|
||||
5. 使用多项式回归预测下学期
|
||||
|
||||
**算法**：`utils/gpaPredictor.js`
|
||||
- 数据清洗
|
||||
- 学期分组
|
||||
- 加权平均计算
|
||||
- 多项式回归
|
||||
- 预测与置信度评估
|
||||
|
||||
### 3. AI对话流式响应
|
||||
|
||||
**技术实现**：
|
||||
```javascript
|
||||
// 流式读取API响应
|
||||
const reader = res.data.getReader();
|
||||
while (true) {
|
||||
const { done, value } = await reader.read();
|
||||
if (done) break;
|
||||
|
||||
// 解析SSE格式
|
||||
// 实时更新界面
|
||||
// 显示打字效果
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 数据可视化
|
||||
|
||||
### Canvas图表绘制
|
||||
|
||||
**支持的图表类型**：
|
||||
1. **雷达图** - 学习能力6维评估
|
||||
2. **折线图** - GPA趋势与预测
|
||||
3. **饼图** - 时间分配占比
|
||||
4. **柱状图** - 成绩对比分析
|
||||
|
||||
**技术特点**：
|
||||
- 高分辨率适配（pixelRatio）
|
||||
- 响应式尺寸
|
||||
- 平滑动画
|
||||
- 彩色图例
|
||||
- 数据标注
|
||||
|
||||
---
|
||||
|
||||
## 🎯 特色亮点
|
||||
|
||||
### 1. 企业级设计系统
|
||||
- 统一的颜色主题（紫色渐变）
|
||||
- 完整的动画库
|
||||
- 组件化样式
|
||||
- 响应式布局
|
||||
|
||||
### 2. 智能数据分析
|
||||
- 自动追踪学习时间
|
||||
- GPA趋势预测
|
||||
- 学习画像生成
|
||||
- 多维度数据可视化
|
||||
|
||||
### 3. AI助手集成
|
||||
- DeepSeek大模型
|
||||
- 流式对话体验
|
||||
- 对话历史管理
|
||||
- 智能学习建议
|
||||
|
||||
### 4. 完善的功能生态
|
||||
- 课程管理
|
||||
- 论坛交流
|
||||
- GPA计算
|
||||
- 倒计时提醒
|
||||
- 数据分析
|
||||
- AI助手
|
||||
|
||||
---
|
||||
|
||||
## 📈 代码统计
|
||||
|
||||
- **总代码量**：约 15,000+ 行
|
||||
- **页面数量**：12个主要页面
|
||||
- **组件数量**：2个通用组件
|
||||
- **工具函数**：9个核心工具文件
|
||||
- **样式文件**：6个主题样式
|
||||
|
||||
---
|
||||
|
||||
## 🔧 开发与维护
|
||||
|
||||
### 环境要求
|
||||
- 微信开发者工具
|
||||
- Node.js（可选，用于工具链）
|
||||
|
||||
### 本地运行
|
||||
1. 打开微信开发者工具
|
||||
2. 导入项目文件夹
|
||||
3. 配置 AppID
|
||||
4. 点击编译运行
|
||||
|
||||
### 数据初始化
|
||||
- 首次启动自动初始化示例数据
|
||||
- 存储键：`demo_data_initialized`
|
||||
- 可通过控制台手动初始化
|
||||
|
||||
---
|
||||
|
||||
## 📝 文档清单
|
||||
|
||||
- ✅ `学习数据功能说明.md` - 数据可视化详解
|
||||
- ✅ `学习活跃度删除记录.md` - 功能删除记录
|
||||
- ✅ `如何直接添加持久化存储数据.md` - 数据管理指南
|
||||
- ✅ `课表功能优化说明.md` - 课表功能文档
|
||||
- ✅ `课表使用指南.md` - 用户使用指南
|
||||
- ✅ `个人中心功能测试指南.md` - 测试文档
|
||||
- ✅ `论坛收藏功能说明.md` - 论坛功能文档
|
||||
|
||||
---
|
||||
|
||||
## 🎓 项目亮点（适合答辩）
|
||||
|
||||
### 技术创新
|
||||
1. **自动化数据追踪系统** - 零侵入式学习时间记录
|
||||
2. **GPA智能预测算法** - 多项式回归+趋势分析
|
||||
3. **AI对话流式响应** - 打字效果+实时交互
|
||||
4. **Canvas高质量图表** - 4种图表类型+响应式
|
||||
|
||||
### 功能完整性
|
||||
1. **12个功能页面** - 覆盖学习全流程
|
||||
2. **企业级设计** - 统一视觉规范
|
||||
3. **数据持久化** - 完整的存储方案
|
||||
4. **性能优化** - 懒加载+缓存策略
|
||||
|
||||
### 用户体验
|
||||
1. **直观的数据可视化** - 一目了然的学习状态
|
||||
2. **智能的AI助手** - 随时解答学习问题
|
||||
3. **便捷的工具集合** - GPA、课表、倒计时
|
||||
4. **社交论坛功能** - 学习交流互动
|
||||
|
||||
---
|
||||
|
||||
**项目完整、功能丰富、技术先进！** 🎉
|
||||
|
||||
---
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT License
|
||||
|
||||
---
|
||||
|
||||
## 👨💻 开发者
|
||||
|
||||
GitHub: [ChuXunYu/program](https://github.com/ChuXunYu/program)
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2025年10月14日
|
||||
Reference in New Issue
Block a user