[T.12] 团队项目：Alpha 阶段发布说明

这个作业属于哪个课程	北航2026年春季软件工程
这个作业的要求在哪里	[T.12] 团队项目：Alpha 阶段发布说明
我在这个课程的目标是	完成软件开发，感受软件工程流程
这个作业在哪个具体方面帮助我实现目标	完成alpha阶段测试

欢迎大家体验哈基米南北绿队的软工项目 启元知微。它是一个面向北航学生的一体化智能学习平台，Alpha 版本已经开放知识问答、题库资料、学习论坛、实用工具等能力。

1. 本版本新功能与特性

1.1 课程感知的知识问答

启元知微的知识问答不是简单接入一个通用聊天窗口，而是将课程上下文、历史会话和 RAG 检索能力结合起来。用户可以选择指定课程，围绕课程资料进行多轮提问，系统会以流式方式返回答案，并支持 Markdown、代码块、公式、思维导图、时序图等内容展示。在通用问答模式下，也可以体验文生图能力。

它主要解决的问题是：同学在复习专业课时，资料散落在课件、教材、往年题、同学讨论和搜索引擎里，查一个知识点常常需要打开很多页面。启元知微希望把“查资料”和“问问题”合到一个入口里。

一个典型场景是：周三晚上，袁子轩准备预习操作系统。他打开启元知微，选择操作系统课程，输入“用户态和内核态切换的开销来自哪里？”。系统先给出解释，他再追问“这和上下文切换是一回事吗？”。整个过程保留在同一个会话里，第二天复习时可以继续接着看。

1.2 结构化学习内容与图表生成

在知识问答链路上，启元知微支持将学习材料或问题整理成结构化 Markdown 内容。用户可以让系统把概念对比、复习提纲、章节要点整理成标题、列表、表格等形式，并在合适场景下生成思维导图、流程图、时序图等 Mermaid 图表，方便复制到自己的笔记工具中。

它解决的问题是：考前复习时，很多同学不是没有资料，而是资料太散，难以在短时间内形成清晰提纲。结构化生成能力可以帮助用户把“问答过程中的零散内容”沉淀成“可复习的结构化内容”。

一个典型场景是：赵志勇要复习数据库系统的范式。他输入“把 1NF、2NF、3NF、BCNF 的区别整理成表格，并列出常见误区”。系统输出 Markdown 表格后，他直接复制到本地复习文档，再结合教材核对。

1.3 题库资料、模拟考试与错题本

Alpha 版本提供题库资料入口，支持按课程浏览往年真题、查看试卷与题目详情，并开放模拟考试、自定义组卷和错题本相关路径。用户可以从“看题”逐步过渡到“练题”和“复盘错题”。

它解决的问题是：往年题经常分散在群文件、网盘或个人收藏里，查找成本高；刷题过程也容易只做不记，错题无法沉淀。题库模块希望把课程、试卷、作答记录和错题复习串起来。

一个典型场景是：期末前一周，罗浩宇打开题库资料，选择数据库课程，先浏览往年卷面结构，再进入模拟考试做一套题。交卷后，他可以回到错题本查看薄弱点，把不会的题目带回知识问答继续追问。

1.4 学习论坛

学习论坛按课程组织讨论，支持浏览帖子、发布新帖、回复、点赞、举报以及编辑 / 删除自己的帖子。它承担的是“人与人之间”的学习互助，而知识问答承担的是“人与系统之间”的即时答疑。

它解决的问题是：同学遇到实验环境、课程作业理解、复习方法等问题时，往往更需要同伴视角的经验。论坛把这些讨论沉淀下来，后来的同学可以搜索和复用。

一个典型场景是：刘诗怡在配置实验环境时遇到报错。她进入学习论坛，选择对应课程分区，贴出报错信息和已尝试的方法。李昊霖看到后回复了配置项，刘诗怡点赞并补充“已解决”。之后再有同学遇到同样的问题，就可以直接看到这条讨论。

1.5 免费图床与 Typora 上传工具

实用工具模块提供免费图床，并支持接入 Typora。用户在写博客或整理 Markdown 文档时，可以把本地图片自动上传并替换为网络图片地址。

它解决的问题是：课程博客经常需要插入截图，如果图片路径仍是本地路径，发布到博客园或其他平台后就会失效。图床工具让本地截图能更顺利地变成可访问的外链。

一个典型场景是：团队成员写 Alpha 总结博客时，在 Typora 中粘贴一张演示截图。配置好上传脚本后，图片会自动上传到图床，Markdown 中留下可访问的图片 URL，博客发布时就不需要再手动处理图片。

2. 本版本修复的缺陷

启元知微是本学期从零开始推进的新项目。Alpha 阶段虽然不属于继承项目，但在内部迭代和联调过程中，我们仍然修复了一批影响核心体验的问题。

问题	负面影响	修复方式	当前状态
登录态过期后接口失败	用户刷新或长时间停留后需要重新手动登录	前端 Axios 拦截器增加 Token 刷新逻辑	已修复
RAG 服务超时时页面一直等待	用户不知道是生成慢还是服务异常	后端捕获超时并返回明确错误，前端显示失败提示	已修复
SSE 流式结束事件不统一	偶发生成空消息或结束状态异常	统一 Backend 与 RAG 的流式事件协议	已修复
题库无数据时页面空白	用户误以为页面损坏	增加空态提示和返回入口	已修复
未登录访问受限功能提示不清楚	用户不知道下一步该登录还是返回	路由守卫统一打开登录弹窗	已修复
移动端长文本溢出	论坛帖子或问答内容阅读困难	调整正文容器、换行与滚动策略	部分修复
图床上传失败提示过于笼统	用户不知道是格式、大小还是网络问题	按错误类型展示中文提示	已修复
Backend 与 RAG 环境变量容易配错	联调时服务能启动但无法问答	补充 .env.example 与联调说明	已修复

3. 运行环境要求

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

项目	要求
推荐浏览器	Chrome、Edge、Firefox、Safari 最近两个大版本
推荐设备	桌面端或笔记本电脑，移动端可浏览但复杂学习任务建议使用桌面端
网络	能访问 http://alpha.buaapgy.cn/，能正常加载静态资源和后端接口
账号	部分功能需要注册并登录后使用
本地依赖	普通用户无须安装 Python、Node.js 或数据库

开发和部署侧的主要技术栈为：

子系统	技术
Frontend	Vue 3、Vite、TypeScript、Pinia、Vue Router
Backend	FastAPI、SQLAlchemy async、MySQL、Redis、Alembic
RAG	FastAPI、ChromaDB、混合检索、OpenAI 兼容 LLM / Embedding API

4. 安装与使用方法

4.1 访问方式

直接打开发布地址：

http://alpha.buaapgy.cn/

4.2 注册与登录

1. 打开首页；
2. 点击右上角登录 / 注册入口；
3. 注册时填写邮箱、密码和验证码；
4. 登录成功后，即可使用知识问答、题库、论坛、图床等功能。

4.3 使用知识问答

1. 点击顶部导航中的“知识问答”；
2. 选择课程上下文；
3. 在输入框中输入问题；
4. 等待系统流式返回答案；
5. 可以继续追问，也可以在历史会话中回看。

推荐提问方式：

不太推荐	更推荐
“讲一下数据库”	“用表格比较 1NF、2NF、3NF 和 BCNF，并给一个例子”
“操作系统怎么学”	“我已经学完进程调度，请帮我列出常见调度算法的区别和适用场景”
“帮我做作业”	“请解释这道题考察的知识点，并给出解题思路”

4.4 使用题库资料

1. 点击“题库资料”；
2. 选择课程；
3. 浏览往年试卷和题目；
4. 如需练习，可进入模拟考试或自定义组卷；
5. 作答后回看错题，继续复习薄弱知识点。

4.5 使用学习论坛

1. 点击“学习论坛”；
2. 浏览课程分区与帖子列表；
3. 登录后可以发布新帖、回复、点赞；
4. 发现不当内容可以举报；
5. 自己发布的帖子可以编辑或删除。

4.6 使用图床与 Typora 上传

1. 点击“实用工具”；
2. 上传本地图片；
3. 复制系统返回的图片链接；
4. 如果使用 Typora，可按页面说明配置上传脚本；
5. 之后在 Typora 中粘贴图片时，可以自动上传并生成网络图片地址。

5. 已知问题与限制

Alpha 版本仍然有一些已知限制。我们会持续收集反馈，并在 Beta 阶段重点改进。

已知问题 / 限制	表现	缓解方式
AI 回答可能存在不准确	对细节概念、边界条件或课程特殊表述可能产生偏差	将回答作为学习参考，重要内容请对照教材、课件和教师说明
课程知识库覆盖仍在扩充	某些课程或章节的回答质量不稳定	优先选择已开放课程，遇到缺失可通过论坛反馈
移动端不是重点优化形态	小屏下题库、长帖、长回答阅读效率较低	建议使用桌面浏览器完成问答、刷题和长文阅读
论坛审核后台仍不完整	举报后处理依赖团队人工介入	遇到违规内容请先举报，团队会在运营侧处理
题库解析和高级筛选仍待加强	部分题目可能只有题干和选项，解析不够细	可把题目复制到知识问答中继续追问
用户数据统计仍不完整	DAU、留存、转化率目前无法完全自动化展示	Alpha 阶段以手动反馈和日志为主，Beta 补埋点
RAG / LLM 依赖外部服务	外部模型服务慢或不可用时，问答会变慢或失败	稍后重试，或先使用题库、论坛等非生成式功能
图床有格式和大小限制	超大图片或不支持格式上传失败	使用 PNG / JPG，并适当压缩图片

6. 发布方式与发布地址

本次 Alpha 版本采用 Web 方式发布，不上架应用商店，不提供独立安装包。

项目	内容
发布形式	Web 应用
访问地址	http://alpha.buaapgy.cn/
适用人群	北航学生、软工课程同学、对课程学习助手感兴趣的试用用户
推荐浏览器	Chrome / Edge 最新版
反馈方式	通过团队成员、课程群、论坛帖子或后续反馈表收集

7. 后续规划

Beta 阶段我们计划继续推进：

1. 加入操作系统、编译原理等更多核心课程资料；
2. 补齐用户行为埋点，统计 DAU、留存、问答轮次、题库完成率；
3. 增强题库解析、错题复练和自定义组卷体验；
4. 优化知识问答的来源引用与回答稳定性；
5. 完善论坛治理和反馈闭环；
6. 提供更多实用工具；
7. 继续优化 UI 和移动端基础体验。

8. 结语

启元知微的 Alpha 版本还不完美，但已经能支撑一条完整的学习路径：问知识点、看真题、做练习、进论坛讨论、用图床沉淀博客和笔记。

我们期待大家试用并提出建议。希望它能在后续迭代中从“可用的课程项目”逐步成长为“真正能帮同学节省复习时间的学习工具”。