[T.17] 团队项目：Beta 阶段发布说明

项目	内容
这个作业属于哪个课程	首页 - 2026年春季软件工程 - 北京航空航天大学 - 班级博客 - 博客园
这个作业的要求在哪里	[T.17] 团队项目：Beta 阶段发布说明 - 作业 - 2026年春季软件工程 - 班级博客 - 博客园
我在这个课程的目标是	学习并实践现代软件工程的完整开发流程，提升全栈开发与团队协作能力
这个作业在哪个具体方面帮助我实现目标	本次作业通过编写发布说明，帮助团队梳理 Beta 阶段的新功能、修复缺陷与运行环境，向公众推介成果

启元知微 Beta 版正式发布。

这是一个面向北航计算机类课程学习场景的一体化智能学习平台。相比 Alpha 阶段，Beta 版不再只追求“问答、题库、论坛、工具都能用”，而是进一步把它们连成复习闭环：回答有来源，错题能复练，问题能讨论，违规能治理，团队能看到产品运行状态。

发布地址：http://beta.buaapgy.cn/

一、本版本新功能与特性

1. RAG 问答引用溯源

Alpha 阶段的知识问答已经能结合课程资料回答问题，但用户很难知道答案到底参考了哪份讲义、哪一段材料。Beta 版加入了引用溯源能力：RAG 检索阶段保留来源文件、片段摘要、相关度等元数据，回答正文中插入可点击的引用角标，前端将角标渲染为引用按钮。

它解决的问题：

• 考前复习时，学生不希望只看到“模型自信地回答”，还希望能回到课程资料核对。
• 对概念、定理、算法流程等内容，来源比措辞更重要。
• RAG 系统如果不能展示证据，用户很难建立长期信任。

应用场景故事：

小明在复习操作系统，问“工作集模型为什么能减少颠簸”。系统流式输出解释，并在关键概念旁出现引用角标。小明点击角标，看到了对应讲义片段，于是能把模型解释和课程原文对照起来，复习时更安心。

2. 错题复练与高级筛选

Alpha 阶段的错题本更像“错题列表”，学生能看见错题，但不能自然进入下一轮练习。Beta 版打通了错题本和组卷系统，支持按课程、错题频次、掌握状态筛选，并一键生成错题复练卷。

它解决的问题：

• 学生考前最需要复习薄弱点，但手动整理错题成本高。
• 只看错题不等于掌握，必须重新作答才能检验。
• 错题频次和掌握状态能帮助学生区分“偶然失误”和“长期薄弱点”。

应用场景故事：

期末前一天，小明打开错题本，只筛选“操作系统 + 错误次数大于 2 + 未掌握”的题目，点击“一键复练”。系统自动生成一套小卷，他在 15 分钟内完成复测，发现虚拟内存相关题目仍然不稳，于是继续查看解析。

3. AI 辅助深度解析

Beta 版在题目详情和复练链路中加入“AI 深度解析”。当学生对某道题的标准解析仍然不理解时，可以一键请求 AI 结合课程上下文进行流式讲解。

它解决的问题：

• 标准答案通常短，适合判分，不一定适合理解。
• 学生不知道自己卡在哪个前置概念上。
• 题库和知识库以前是两个模块，Beta 版让“做题”和“查知识点”靠得更近。

应用场景故事：

小明做错一道页面置换题，标准解析只有几行。他点击“AI 深度解析”，系统从课程资料中检索相关概念，用分步骤方式解释题目，并指出这道题考查的是工作集与缺页率的关系。小明不需要再在讲义、搜索引擎、聊天窗口之间来回切换。

4. 行为统计、服务健康与资源保护

Beta 版加入用户行为统计和管理员统计视图，用于观察用户规模、活跃用户、服务健康度和热门功能。同时，系统对高成本 AI 接口加入限流，避免单个用户短时间内消耗过多资源。

它解决的问题：

• 团队不能只靠主观感觉判断产品是否有用。
• AI 能力有成本，高频调用需要保护。
• 发布后需要知道服务是否健康，而不是等用户来报错。

当前统计视图中维护的核心数据包括：累计用户 87，活跃用户 65，VIP 用户 20，超级管理员 3。

6. 移动端与暗色主题优化

Beta 版重点适配了论坛列表、知识问答消息流、错题复练页面和 Markdown/Mermaid 渲染。公式、长表格、代码块、引用卡片在窄屏下的可读性明显提升，暗色主题下图表边框和加载态也进行了修正。

它解决的问题：

• 学生并不总是在电脑前复习，手机查看问答和论坛很常见。
• 长公式和代码块在移动端容易溢出。
• 暗色模式如果只改背景色，图表和边框很容易看不清。

二、本版本修复的缺陷

1. 修复 RAG 问答无正文溯源的问题

原有问题：Alpha 阶段虽然已经能基于课程资料生成回答，但用户无法在正文中直接看到引用来源。

负面影响：用户需要自己猜测答案依据，尤其在考试复习场景下，不利于核对和信任。

修复方式：Beta 版在 RAG 检索结果中保留 metadata，通过 SSE 首帧发送引用元数据，并约束模型输出 <cite id="x"/> 标记。前端解析该标记并渲染引用卡片。

2. 修复错题本“只能看不能练”的断链体验

原有问题：错题本仅能展示错题，缺少继续练习入口。

负面影响：用户仍需手动挑题，复盘效率低。

修复方式：新增错题状态、错题频次和临时复练 Session，支持筛选后直接组卷。

3. 修复论坛举报无后台流转的问题

原有问题：用户可以举报，但管理员缺少页面化处理工具。

负面影响：治理依赖人工数据库操作，效率低且容易误操作。

修复方式：新增论坛管理 API 与管理员面板，支持下架、删除、禁言和二次确认。

4. 修复移动端和暗色主题体验问题

原有问题：移动端长内容溢出，暗色模式下 Mermaid 图和部分边框不清楚。

负面影响：手机浏览体验不稳定，深色主题可读性不足。

修复方式：重构部分响应式样式，调整 Markdown、Mermaid、引用卡片和移动端列表布局。

5. 修复发布前回归发现的 3 个明确缺陷

缺陷	修复后状态
iOS Safari 引用卡片触控定位偏移	已修复，移动端点击位置稳定
错题复练 Session 过期后提交返回 500	已修复，改为明确过期提示
禁言用户刷新 token 后权限状态冲突	已修复，刷新后仍统一校验禁言状态

三、运行环境要求

启元知微是 Web 服务，不需要用户安装客户端。

推荐环境：

项目	要求
操作系统	Windows、macOS、Linux、iOS、Android 均可
浏览器	Chrome、Edge、Firefox、Safari 最近两个大版本
网络	可访问发布地址，建议稳定校园网或宽带
屏幕	桌面端体验最佳；移动端已适配核心功能
账号	使用邮箱注册登录

不推荐使用过旧浏览器，例如 IE 或旧版内核浏览器。RAG 问答和 AI 深度解析依赖服务端模型能力，用户本地不需要安装 Python、Node.js 或大模型。

四、安装与使用方法

用户不需要安装软件，直接访问发布地址：

http://beta.buaapgy.cn/

快速上手：

1. 打开网站，注册账号并登录。
2. 进入“知识问答”，选择课程，输入问题，查看流式回答和引用来源。
3. 进入“题库资料”，浏览往年题、模拟考试或自定义组卷。
4. 进入“错题本”，按课程和状态筛选错题，一键复练。
5. 进入“学习论坛”，按课程浏览帖子、发帖、回复或举报。
6. 进入“实用工具”，使用图床上传图片并复制 Markdown 链接。

五、已知问题与限制

类型	表现	缓解方式
模型回答可能出错	AI 生成内容可能与教材表述不完全一致	优先查看引用来源，重要结论自行核对讲义
部分课程资料仍在扩充	不同课程的资料覆盖度不完全一致	优先使用数据库、操作系统、编译原理等已重点维护课程
高峰期 AI 响应变慢	考前多人使用时，流式回答首字可能变慢	稍后重试，或先使用题库与论坛功能
移动端复杂表格不如桌面端舒适	宽表格、长代码块仍更适合电脑查看	复杂内容建议使用桌面浏览器
论坛内容质量依赖社区	用户发帖回复可能有错误或不完整信息	结合 AI 问答、课程资料和同学讨论综合判断

六、发布方式与发布地址

发布方式：

• 前端：Vue 3 + Vite 构建后静态部署。
• 后端：FastAPI 服务，提供 REST API 与 SSE。
• RAG：独立 FastAPI 微服务，提供检索、问答、流式输出等能力。
• 数据层：MySQL + Redis。
• 工程流程：三仓 CI/CD，release 分支触发部署工作流。

发布地址：

http://beta.buaapgy.cn/

七、结语

Beta 版的启元知微，重点从“功能铺开”走向“学习闭环”。我们希望它能帮助同学在考试周少开几个窗口，少翻几次资料，多一点确定感：问答可以查来源，错题可以再练，讨论可以被治理，使用数据也能反过来推动下一轮迭代。