1

2025-10-19 20:28:31 +08:00
parent c81f8a8b03
commit eaab9a762a
100 changed files with 23416 additions and 0 deletions
--- a/答辩资料/06-完整使用说明手册.md
+++ b/答辩资料/06-完整使用说明手册.md
@@ -0,0 +1,786 @@
+# 📖 知芽小筑 - 完整使用说明手册
+
+> 版本：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日  
+**作者**：知芽小筑开发团队