团队项目第一次作业

作业所属课程	计科24级78班-软件工程
作业要求	团队项目第一次作业
作业的目标	基于真实调研需求，将大模型智能体嵌入到自主选题的软件中，最终完成上线运行并进行答辩与博客撰写。
团队名称	成群结队
团队成员学号-名字	3224004234-郑乐冰、3224004384-苏拉娅·斯地克阿吉、3224004268-黄泽欣、3224004266-艾柯代·吐尔逊、3224004232-王昊圆、3224004230-李宇晴、3224004228-陈嫒琳

一、团队展示

1.1 队名：成群结队

1.2 项目规划和描述

本项目为《大学生课程AI复习助手》，旨在解决在校大学生期末复习时资料零散、难以快速提炼考点和自测的真实痛点。项目采用“自研Web前端+扣子平台Web SDK”的轻量级架构，将智能体作为内部核心模块深度嵌入网页，绝不发生外部跳转。核心功能聚焦复习闭环，支持上传PDF/TXT课件后，通过快捷指令一键实现“提炼考点”、“生成习题（带解析）”以及“知识点答疑”，并保留对话历史方便回看。
现有方案已明确前端自研网页与扣子平台Web SDK的对接方式。本次团队项目将在真实调研基础上，重点规划基于快捷指令的考点提炼、习题生成、知识点通俗答疑，以及对话历史留存和公网访问部署。

阶段	目标	关键交付
第一阶段	确认真实复习痛点，确定项目范围	团队展示、调研记录、选题报告、需求分析
第二阶段	完善智能体人设与前端交互流程	文档上传解析、三大快捷指令、对话记录展示
第三阶段	让老师、助教和同学能够访问检查	可访问的公网系统、测试记录与演示材料

1.3 团队风采

学号	姓名	擅长的技术	希望的角色
3224004234	郑乐冰	界面设计，前端开发	前端
3224004384	苏拉娅·斯地克阿吉	测试、数据整理、文档	测试 / 文档
3224004268	黄泽欣	测试、界面验收、录屏	测试 / 演示
3224004266	艾柯代·吐尔逊	文档撰写、测试执行、录屏演示、资料整理	测试 / 文档 / 演示
3224004232	王昊圆	Git操作、Vercel/GitHub Pages部署	部署 / 运维
3224004230	李宇晴	网络配置、静态托管	部署 / 运维
3224004228	陈嫒琳	数据库、部署、后端接口	后端 / 部署

1.4 团队首次合照

1.5项目愿景

我们致力于成为大学生期末复习的一站式智能解题与提效工具。通过将大模型智能体深度嵌入自研网页，我们将繁琐的“啃书、划重点、找题”流程，重构为“上传-提取-生成-自测”的自动化闭环。我们希望做一款真正“懂大学生”的实用软件，不仅提供标准答案，更提供通俗易懂的解题思路，让每一次复习都有的放矢，让高质量的学习资料唾手可得。

二、选题报告

2.1 选题背景

在高校日常教学中，大学生面临着繁重的课业压力。每逢期中、期末复习阶段，学生往往需要面对海量的课件PPT、PDF教材以及零散的课堂笔记。传统的复习方式高度依赖手动整理，不仅效率低下，且难以快速抓住核心考点。同时，虽然市面上已有Kimi、文心一言等通用大模型，但它们多以通用对话为主，缺乏针对“课程复习”的固定流程，学生每次使用都需要重复输入冗长的提示词，且容易分散注意力。
本项目基于上述真实校园痛点，旨在利用大模型智能体技术，开发一款轻量级、纯聚焦的Web端复习工具，并将智能体深度嵌入自研系统，提供一站式的课程复习解决方案。

2.2 要解决的问题

本系统聚焦于解决大学生在复习场景下的三大核心痛点：

• 信息过载与重点难觅：课件内容冗长繁杂，学生手动划重点、梳理知识框架耗费大量时间。
• 自测资源匮乏：学生很难快速基于当前复习的章节，自己出题进行针对性的选择和简答练习。
• 工具门槛与专注度缺失：通用AI缺乏业务约束，学生需要反复写Prompt；且零散的资料分散在不同软件中，缺乏统一的复习入口。

2.3 创新点

• 场景化智能体嵌入：不是简单跳转通用大模型官网，而是通过扣子Web SDK将定制了“复习导师”人设的智能体无缝嵌入自研网页，AI只输出与复习相关的结构化内容，拒绝闲聊。
• “一键式”快捷指令交互：针对复习高频动作，网页端直接提供【提炼考点】【生成习题】【知识点答疑】三大快捷指令按钮，彻底免除用户“写提示词”的烦恼，实现零门槛上手。
• 文档直读与闭环体验：支持直接上传PDF、TXT文件，智能体自动解析文档内容并基于此作答，配合历史对话留存功能，形成一个文档上传 → 提问/生成 → 记录回看的完整复习闭环。

2.4 核心功能

1. 文档上传功能：支持上传课件、笔记文本文件；
2. 考点提炼：读取文档内容，自动精简输出核心考点、知识框架；
3. 习题生成：基于文档知识点，生成自测题目+参考答案解析；
4. 知识点问答：针对课程内容进行提问，AI通俗讲解难点；
5. 对话历史展示：页面展示用户与智能体的交互记录；
6. 基础页面引导：首页说明工具用途、操作指引。

2.5 可行性 & 风险分析

【技术可行性】

1. 智能体能力：扣子平台支持自定义人设、文件上传插件、Web SDK嵌入，官方提供可直接使用的JS嵌入代码，成熟稳定；
2. 前端开发：仅基础HTML、CSS、JavaScript，难度低，开发周期短；
3. 上线部署：使用Github Pages静态网页免费托管，不需要服务器，可生成公网链接，满足上线检查要求；
4. 调试：扣子平台内可以提前单独调试智能体逻辑，网页端只负责展示交互。

【潜在风险 + 应对方案】

1. 风险：扣子免费版有调用次数额度限制，多人高频使用会耗尽额度
   应对：演示、答辩阶段流量很小，足够使用；提前预留额度，答辩前测试；博客里写明该限制；
2. 风险：文件解析对部分扫描版PDF识别效果差
   应对：限制使用场景，优先支持文字版PDF、TXT文档，在页面提示用户；
3. 风险：SDK版本更新，嵌入代码失效
   应对：开发时保存当前可用SDK，上线前反复测试；记录官方文档，出现问题及时重新获取嵌入代码；
4. 风险：Github Pages访问不稳定
   应对：备选部署方案Vercel，提前准备备用访问链接。

三、需求分析文档

3.1 迭代记录表格

版本号	迭代日期	修订内容简述
V1.0	2026-11-08	初始版本，基于真实调研完成需求分析与架构定义

3.2 项目标志

项目名称：大学生课程AI复习助手
项目Logo

3.3 思维导图

3.4 系统类图设计

3.4 详细功能描述

说明：本项目采用扣子Web SDK对接智能体大模型能力，不需要自己写大模型，后端轻量化

【前端模块】（HTML+CSS+JS，自研网页）

1. 首页引导模块：项目标题、工具介绍、使用说明；
2. 文件上传模块：选择本地文档上传，上传状态提示；
3. 对话交互模块：聊天输入框、发送按钮、对话消息展示区；
4. 指令快捷按钮模块：【提炼考点】【生成习题】【知识点提问】快捷按钮，减少用户打字；
5. 页面布局模块：适配电脑、手机的响应式样式。

【后端模块】

方案：使用扣子Coze平台作为智能体服务后端（Web SDK），我们不搭建复杂服务

1. 智能体Agent模块（扣子平台）：内置复习助手人设提示词，控制AI输出格式、约束AI只做复习相关任务；
2. 文件解析插件模块（扣子自带插件）：负责解析上传的PDF、文本文件；
3. SDK接口服务：扣子提供WebSDK，接收前端发送的消息、文件，返回AI结果；

3.5 非功能性需求

• 性能要求：系统能够在主流浏览器（Chrome, Edge, Safari）及移动端正常打开；对话响应延迟取决于大模型，前端需有Loading等待交互。
• 部署要求：静态网页通过 Github Pages 或 Vercel 托管，必须生成公网可访问链接（HTTPS），外网可直接访问。
• 安全与限制：扣子平台免费版有调用额度限制，系统需做好异常捕获（如额度耗尽时给出友好提示）。

3.6 项目验收标准

满足下面全部，即达到本次作业的验收要求：

1. 自研网页系统上线，提供稳定公网访问链接，外网可直接打开；
2. 智能体成功嵌入自研网页内部，不是直接跳转扣子官网，智能体是系统内置能力；
3. 文档上传功能正常，能够读取课程资料；
4. 三大核心功能可用：提炼考点、生成习题、知识点答疑，输出符合复习助手的人设，不闲聊；
5. 页面交互正常，可以看到对话记录，操作简单；
6. 交付物齐全：上线系统、本篇项目博客、答辩PPT；
7. 其他：增加快捷指令按钮，优化页面UI；联动硬件（ESP32屏幕展示考点）。