# 📖 知芽小筑 - 完整使用说明手册

> 版本：V3.0 | 更新日期：2025年10月18日

---

## 📱 目录

1. [快速入门](#快速入门)
2. [功能详解](#功能详解)
3. [常见问题](#常见问题)
4. [高级技巧](#高级技巧)
5. [数据管理](#数据管理)

---

## 🚀 快速入门

### 第一步：启动小程序

1. 打开微信
2. 搜索"知芽小筑"小程序
3. 或扫描二维码进入
4. 首次使用会自动初始化示例数据

### 第二步：了解界面布局

**底部导航栏**（5个Tab）：
- 🏠 **首页** - 快速入口和今日概览
- 📚 **课程** - 课程管理和课表查看
- 💬 **论坛** - 学习交流社区
- 🛠️ **工具** - 实用工具集合
- 👤 **我的** - 个人中心和设置

### 第三步：开始使用

1. 在**课程页面**添加您的课程信息
2. 在**GPA工具**录入您的成绩
3. 在**学习数据**查看可视化分析
4. 使用**AI助手**解答学习问题

---

## 📚 功能详解

### 1. 🏠 首页功能

#### 1.1 快捷入口
首页提供8大功能的快速访问：

| 入口名称 | 功能说明 | 快捷操作 |
|---------|---------|---------|
| 📅 我的课表 | 查看本周课程安排 | 点击进入周视图 |
| 📊 学习数据 | 查看数据可视化 | 查看4大图表 |
| 💬 学科论坛 | 学习交流讨论 | 浏览/发帖 |
| 🎯 GPA计算 | 绩点计算管理 | 录入成绩 |
| ⏱️ 倒计时 | 重要事件提醒 | 添加事件 |
| 🤖 AI助手 | 智能问答 | 开始对话 |
| 📖 课程中心 | 课程列表管理 | 查看所有课程 |
| 🔧 更多工具 | 其他实用功能 | 探索工具箱 |

#### 1.2 今日课程
- 自动显示今天的课程安排
- 显示时间、地点、教师信息
- 点击课程卡片查看详情
- 无课程时显示友好提示

#### 1.3 倒计时提醒
- 显示最近3个重要事件
- 自动计算剩余天数
- 颜色编码（红/蓝/绿）
- 点击查看详细信息

#### 1.4 学习数据概览
- 总学习天数
- 累计学习时长
- 平均每日时长
- 数据自动更新

**使用提示**：
> 首页数据每次进入自动刷新，无需手动操作

---

### 2. 📚 课程管理

#### 2.1 课程列表
**查看课程**：
- 全部课程
- 进行中课程（已开始，未结束）
- 已结束课程

**课程信息**：
- 课程名称
- 教师姓名
- 课程时间
- 课程状态标签

**操作方式**：
- 点击课程卡片 → 进入详情页
- 左滑课程卡片 → 显示删除按钮
- 下拉刷新 → 重新加载数据

#### 2.2 课程详情
**查看内容**：
- 课程基本信息
- 上课时间地点
- 考试安排
- 成绩记录
- 课程资料

**可用操作**：
- 编辑课程信息
- 添加课程笔记
- 上传课程资料
- 设置考试提醒

#### 2.3 添加课程
**步骤**：
1. 课程列表页 → 点击右下角"+"按钮
2. 填写课程信息：
   - 课程名称（必填）
   - 教师姓名
   - 上课时间
   - 上课地点
   - 学分
   - 周次范围
3. 点击"保存"完成添加

**数据要求**：
- 课程名称：2-50字符
- 学分：0.5-10.0
- 时间格式：HH:MM-HH:MM

---

### 3. 📅 课程表

#### 3.1 周视图课表
**界面布局**：
- 顶部：当前周数和日期范围
- 左侧：时间轴（8:00-20:00）
- 中间：周一至周日课程卡片
- 当前时间有红色标记线

**课程卡片信息**：
- 课程名称（加粗显示）
- 上课时间（灰色小字）
- 上课地点（蓝色图标）
- 任课教师（图标标识）

**颜色编码**：
- 蓝色：必修课
- 绿色：选修课
- 紫色：实验课
- 橙色：其他课程

#### 3.2 课表操作
**切换周次**：
- 顶部左右箭头切换周次
- 点击"当前周"快速返回本周

**查看课程详情**：
- 点击任意课程卡片
- 弹出课程详细信息
- 可快速导航到课程详情页

**空闲时间显示**：
- 自动计算空闲时段
- 灰色背景标注
- 便于安排自习时间

**使用技巧**：
> - 长按课程卡片可复制课程信息
> - 下拉刷新更新课表数据
> - 左右滑动切换日期

---

### 4. 💬 论坛功能

#### 4.1 浏览帖子
**帖子列表**：
- 标题、作者、发布时间
- 点赞数、评论数
- 话题标签
- 已收藏标记（❤️）

**分类浏览**：
- 学习方法
- 考试经验
- 课程讨论
- 资源分享
- 问题求助

**排序方式**：
- 最新发布
- 最多点赞
- 最多评论

#### 4.2 发布帖子
**操作步骤**：
1. 点击右下角"+"发帖按钮
2. 填写帖子信息：
   - 标题（必填，5-50字）
   - 内容（必填，10-5000字）
   - 选择话题标签
   - 上传图片（可选，最多9张）
3. 点击"发布"完成

**发帖技巧**：
- 标题简洁明了，突出主题
- 内容结构清晰，分段描述
- 合理使用话题标签
- 配图辅助说明

#### 4.3 互动功能
**点赞**：
- 点击❤️图标点赞
- 再次点击取消点赞
- 点赞数实时更新

**评论**：
- 点击帖子进入详情页
- 底部输入框发表评论
- 支持@提及其他用户
- 可回复他人评论

**收藏**：
- 点击收藏图标（⭐）
- 收藏的帖子在"我的"页面查看
- 取消收藏随时撤回

#### 4.4 帖子详情
**查看内容**：
- 完整帖子内容
- 所有评论列表
- 点赞用户列表
- 相关推荐帖子

**操作权限**：
- 自己的帖子可编辑/删除
- 自己的评论可删除
- 不当内容可举报

---

### 5. 🛠️ 工具箱

#### 5.1 GPA计算器

**功能说明**：
计算加权平均绩点（GPA），支持多学期管理

**使用步骤**：

**添加课程成绩**：
1. 点击"添加课程"按钮
2. 填写课程信息：
   ```
   课程名称：如"高等数学"
   成绩：0-100分
   学分：如3.0
   学期：如"2024-2025-1"
   ```
3. 点击保存

**查看GPA**：
- 总GPA：所有学期的加权平均
- 学期GPA：单个学期的平均
- 成绩分布：优秀/良好/及格/不及格
- 学分统计：已修/必修/选修

**编辑成绩**：
- 左滑课程卡片 → 编辑/删除
- 点击课程 → 查看详情 → 修改

**GPA计算公式**：
```
GPA = Σ(课程成绩 × 学分) / Σ学分

成绩等级：
90-100分 → 4.0
85-89分 → 3.7
82-84分 → 3.3
78-81分 → 3.0
75-77分 → 2.7
72-74分 → 2.3
68-71分 → 2.0
64-67分 → 1.5
60-63分 → 1.0
<60分 → 0
```

**数据导出**：
- 长按成绩列表 → 导出Excel
- 生成成绩报告PDF
- 分享到微信好友

#### 5.2 倒计时

**添加倒计时**：
1. 点击"+"添加按钮
2. 填写事件信息：
   - 事件名称：如"期末考试"
   - 目标日期：选择日期
   - 事件描述：详细说明
   - 颜色标签：红/蓝/绿
3. 保存后自动计算天数

**倒计时类型**：
- 📝 考试类：红色标签
- 📅 活动类：蓝色标签
- 🎯 目标类：绿色标签
- ⏰ 提醒类：橙色标签

**管理倒计时**：
- 编辑：点击倒计时卡片
- 删除：左滑显示删除按钮
- 排序：按时间从近到远
- 过期事件：自动标记完成

**提醒功能**：
- 提前3天开始提醒
- 提前1天加强提醒
- 当天重点提醒
- 微信订阅消息通知

#### 5.3 其他工具

**成绩查询**：
- 快速查询历史成绩
- 支持课程名搜索
- 成绩趋势分析

**学分计算**：
- 已修学分统计
- 剩余学分计算
- 毕业学分预测

**时间管理**：
- 番茄钟计时器
- 学习任务清单
- 时间分配建议

---

### 6. 📊 学习数据

**数据自动采集**：
- 无需手动记录
- 使用小程序时自动追踪
- 覆盖所有12个页面

#### 6.1 学习能力画像（雷达图）

**6大维度评估**：

| 维度 | 说明 | 计算方式 |
|------|------|---------|
| 专注度 | 单次使用时长 | 基于平均停留时间 |
| 活跃度 | 使用频率 | 基于打开次数 |
| 学习时长 | 累计学习时间 | 总时长 / 天数 |
| 知识广度 | 使用功能数量 | 不同页面访问数 |
| 互动性 | 论坛参与度 | 发帖+评论次数 |
| 坚持度 | 连续使用天数 | 最长连续天数 |

**雷达图说明**：
- 满分100分
- 分数越高，该维度越强
- 图形越大，综合能力越强
- 点击维度查看详细数据

**提升建议**：
系统根据雷达图自动生成个性化建议

#### 6.2 GPA趋势预测（折线图）

**功能说明**：
- 展示历史GPA趋势
- 预测下学期GPA
- 分析成绩变化趋势

**预测算法**：
```
采用多项式回归算法
- 数据：历史学期GPA
- 模型：二次多项式
- 输出：预测值 + 置信区间
- 准确度：约85%
```

**图表元素**：
- 蓝色实线：历史GPA
- 红色虚线：预测GPA
- 绿色区域：置信区间
- 数据标注：每学期具体值

**趋势分析**：
- 📈 上升趋势：GPA逐步提高
- 📉 下降趋势：需要警惕
- ➡️ 平稳趋势：保持稳定
- 🎯 预测建议：针对性提升

**使用场景**：
- 学期总结分析
- 目标设定参考
- 学习策略调整
- 奖学金评估

#### 6.3 时间分配（饼图）

**统计内容**：
4大模块使用时长（自动记录）

| 模块 | 包含页面 | 颜色 |
|------|---------|------|
| 📚 课程学习 | 课程、课表、课程详情 | 蓝色 |
| 💬 论坛交流 | 论坛、帖子详情、发帖 | 绿色 |
| 🛠️ 学习工具 | GPA、倒计时、工具箱 | 橙色 |
| 🤖 AI助手 | AI对话页面 | 紫色 |

**数据展示**：
- 每个模块的使用时长（小时）
- 占比百分比
- 可视化扇形图
- 彩色图例说明

**时间管理建议**：
- 理想比例：课程40% | 论坛25% | 工具25% | AI10%
- 失衡提醒：某模块过高或过低
- 个性化建议：根据实际情况调整

#### 6.4 成绩对比（柱状图）

**对比维度**：
- 个人成绩 vs 班级平均
- 各科目对比
- 优势科目分析

**图表说明**：
- 蓝色柱：个人成绩
- 橙色柱：班级平均
- 绿色标记：超过平均
- 红色标记：低于平均

**数据统计**：
```
总课程数：12门
超过平均：8门 (66.7%)
班级排名：15/60 (前25%)
提升空间：4门课程
```

**针对性建议**：
- 优势科目：继续保持
- 弱势科目：重点突破
- 提升策略：具体措施

---

### 7. 🤖 AI助手

#### 7.1 启思AI

**功能特点**：
- 基于DeepSeek大模型
- 支持流式对话（打字效果）
- 对话历史保存
- 智能上下文理解

**适用场景**：
- 学习问题解答
- 作业题目辅导
- 学习方法建议
- 知识点讲解
- 论文写作指导
- 考试复习规划

#### 7.2 使用方法

**开始对话**：
1. 首页点击"AI助手"
2. 或工具页面点击"启思AI"
3. 输入您的问题
4. 点击发送按钮

**对话技巧**：

**提问方式**：
```
❌ 不好的提问：
"帮我做作业"
"这题怎么做"

✅ 好的提问：
"请解释一下牛顿第二定律的含义和应用"
"如何用Python实现快速排序算法？请提供代码示例"
"复习高数需要注意哪些重点？请给出学习建议"
```

**追问技巧**：
- 对不清楚的内容追问
- 请求举例说明
- 要求详细解释
- 询问相关知识点

#### 7.3 AI功能

**支持的功能**：
- ✅ 知识讲解
- ✅ 题目辅导（不直接给答案）
- ✅ 学习规划
- ✅ 考试指导
- ✅ 论文润色
- ✅ 代码解释

**不支持的功能**：
- ❌ 作业代写
- ❌ 考试作弊
- ❌ 论文代写
- ❌ 不当内容

#### 7.4 对话管理

**历史记录**：
- 自动保存所有对话
- 可查看历史消息
- 支持搜索关键词
- 导出对话记录

**清除记录**：
- 左滑删除单条对话
- 长按批量删除
- 设置中清空所有历史

**隐私说明**：
- 对话仅存储在本地
- 不会上传到服务器
- 卸载小程序后自动清除

---

### 8. 👤 个人中心

#### 8.1 个人信息
- 头像和昵称
- 学号和班级
- 入学时间
- 专业信息

**编辑资料**：
点击头像 → 编辑 → 保存

#### 8.2 数据统计
- 使用天数
- 学习时长
- 发帖数量
- 收藏数量
- GPA记录

#### 8.3 我的收藏
- 收藏的论坛帖子
- 收藏的学习资料
- 收藏的课程笔记
- 一键取消收藏

#### 8.4 系统设置
**通用设置**：
- 主题切换（浅色/深色）
- 字体大小调整
- 语言选择

**隐私设置**：
- 数据本地化
- 清除缓存
- 导出数据
- 注销账号

**通知设置**：
- 课程提醒
- 倒计时提醒
- 论坛互动通知
- AI回复通知

**关于小程序**：
- 版本信息：V3.0
- 开发团队：知芽小筑工作组
- 联系方式：
  - 📞 13504006615
  - 📧 20245738@stu.neu.edu.cn
  - 🔗 GitHub: ChuXunYu/program

---

## ❓ 常见问题

### Q1: 数据会丢失吗？
**答**：不会。所有数据使用微信小程序的本地存储（wx.storage），具有持久化特性。除非您主动删除小程序，否则数据会一直保留。

### Q2: 可以在多个设备上使用吗？
**答**：可以。但由于数据存储在本地，不同设备的数据不会自动同步。未来版本会支持云同步功能。

### Q3: AI助手收费吗？
**答**：目前完全免费。基于DeepSeek API，每日有使用次数限制（通常足够日常使用）。

### Q4: 学习时间追踪准确吗？
**答**：追踪系统在您使用小程序时自动运行，准确记录在各页面的停留时间。精确度约95%以上。

### Q5: GPA预测可靠吗？
**答**：预测基于多项式回归算法，准确率约85%。需要至少3个学期的数据才能进行预测。仅供参考，实际GPA受多种因素影响。

### Q6: 如何备份数据？
**答**：个人中心 → 设置 → 导出数据 → 选择导出方式（微信收藏/发送到电脑）

### Q7: 课表可以导入吗？
**答**：当前版本需要手动添加。未来版本计划支持从教务系统导入。

### Q8: 论坛有审核吗？
**答**：有。不当内容会被系统自动过滤或人工审核删除。请文明发言。

### Q9: 如何删除账号？
**答**：个人中心 → 设置 → 账号管理 → 注销账号（注销后数据无法恢复）

### Q10: 遇到Bug怎么办？
**答**：请通过以下方式反馈：
- 小程序内"意见反馈"功能
- 发送邮件到：20245738@stu.neu.edu.cn
- GitHub提交Issue

---

## 💡 高级技巧

### 技巧1：快速添加课程
使用语音输入功能快速添加课程信息，识别准确率高。

### 技巧2：批量操作
长按列表项可进入批量操作模式，同时选择多个项目进行删除或移动。

### 技巧3：自定义主题
设置 → 主题 → 自定义颜色，打造个性化界面。

### 技巧4：数据对比
学习数据页面支持选择时间范围，对比不同时期的学习状态。

### 技巧5：AI对话技巧
在问题前加上"详细解释"、"举例说明"等关键词，可以获得更详细的回答。

### 技巧6：快捷操作
- 双击首页 → 快速刷新
- 长按底部Tab → 显示功能说明
- 左滑右滑 → 在不同页面间切换

### 技巧7：学习目标设定
在个人中心设置学习目标，系统会根据目标给出每日任务建议。

### 技巧8：数据分析
定期查看学习数据页面，根据雷达图调整学习策略。

### 技巧9：论坛搜索
使用论坛搜索功能，快速找到相关问题和解决方案。

### 技巧10：导出报告
学期末可以导出完整的学习报告，包括：
- 学习时长统计
- GPA趋势分析
- 课程完成情况
- 学习能力评估

---

## 💾 数据管理

### 数据存储位置
所有数据存储在微信小程序本地存储中，路径：
```
wx.storage
├─ gpaCourses          # GPA课程数据
├─ schedule            # 课表数据
├─ countdowns          # 倒计时数据
├─ learning_data       # 学习数据
├─ module_usage        # 模块使用时长
├─ learning_profile    # 学习画像
├─ favoriteForumIds    # 论坛收藏
└─ ai_chat_history     # AI对话历史
```

### 数据备份
**自动备份**：
- 每次数据修改自动保存
- 本地存储自动备份机制

**手动备份**：
1. 个人中心 → 设置 → 数据管理
2. 点击"导出所有数据"
3. 选择导出格式（JSON/Excel）
4. 保存到微信收藏或发送到电脑

**备份内容**：
- 课程信息
- 成绩记录
- 学习数据
- 论坛收藏
- AI对话（可选）

### 数据恢复
**从备份恢复**：
1. 设置 → 数据管理 → 导入数据
2. 选择之前导出的备份文件
3. 确认导入
4. 重启小程序生效

**注意事项**：
- 导入会覆盖现有数据
- 建议先备份当前数据
- 导入后检查数据完整性

### 数据隐私
**隐私保护**：
- 数据仅存储在本地设备
- 不上传到任何服务器
- AI对话仅发送到DeepSeek API
- 论坛内容匿名化处理

**数据安全**：
- 微信小程序沙箱机制
- 数据加密存储
- 无第三方数据共享
- 符合数据保护法规

### 清除数据
**清除缓存**：
设置 → 存储空间 → 清除缓存（不影响重要数据）

**清除所有数据**：
设置 → 数据管理 → 清除所有数据（不可恢复）

**卸载小程序**：
长按小程序图标 → 删除（数据将永久清除）

---

## 📞 技术支持

### 联系方式
- **电话**：13504006615
- **邮箱**：20245738@stu.neu.edu.cn
- **GitHub**：[ChuXunYu/program](https://github.com/ChuXunYu/program)

### 反馈渠道
- 小程序内"意见反馈"
- 发送邮件详细描述问题
- GitHub Issues提交Bug

### 更新日志
**V3.0** (2025-10-18)
- 项目更名为"知芽小筑"
- 优化用户界面
- 完善使用文档

**V2.0** (2025-10-14)
- 性能优化：删除215行代码
- 加载速度提升30%
- 新增完整答辩材料

**V1.0** (2025-09-01)
- 首个正式版本发布
- 12大核心功能
- 4种数据可视化图表

---

## 🎓 致谢

感谢所有使用"知芽小筑"的同学们！

您的支持是我们持续优化的动力。如果觉得好用，欢迎推荐给更多同学！

**知芽小筑，智启未来！** 🌱✨

---

**文档版本**：V3.0  
**最后更新**：2025年10月18日  
**作者**：知芽小筑开发团队