[T.18] 团队项目：Beta 阶段项目展示
| 这个作业属于哪个课程 | 北航2026年春季软件工程 |
|---|---|
| 这个作业的要求在哪里 | [T.18] 团队项目：Beta 阶段项目展示 |
| 我在这个课程的目标是 | 体验完整软件开发流程，交付一款真正解决科研阅读痛点的软件产品 |
| 这个作业在哪个具体方面帮助我实现目标 | 完成 Beta 阶段项目展示 |
一、项目与团队总结
1. 团队成员与分工
团队成员简介与个人博客地址
| 姓名 | 角色 | 个人博客地址 |
|---|---|---|
| 肖清心 | PM / 前端 | https://www.cnblogs.com/xqxllll |
| 华家璇 | 前端开发 / 运维 | https://www.cnblogs.com/marigoldarly |
| 吴长骏 | 后端开发 / 测试 | https://www.cnblogs.com/327hhhhh |
| 廉晟 | 后端开发 / 部署 / 测试 | https://www.cnblogs.com/wh04m1222 |
| 周嘉祺 | 后端开发 /测试 | https://www.cnblogs.com/404-error-64 |
| 覃宇航 | 后端开发 /测试 | https://www.cnblogs.com/waterdroplet |
项目管理方式：
项目任务分配与管理：飞书
项目开始时根据文档预分配任务并根据依赖关系排期
使用 飞书-项目管理 功能管理项目进度与文档
项目进展交流 : 飞书 + 微信
使用 飞书-视频会议 每2日召开一次线上会议，汇报工作进展和规划，交流出现的问题
会议记录详见[T.9] 团队项目：每日例会报告
平时也通过微信小组群交流
项目开发管理 ：GitHub + Apifox
在GitHub上进行代码管理：https://github.com/XiaCang/Scider
项目结构为：
- docs/: 项目详尽文档、设计方案与技术调研
- scripts/: 开发、部署及数据处理相关的自动化脚本
- src/: 核心源代码
- backend/: 后端服务
- frontend/: 前端用户界面
成员各自创建分支开发，完成后pr到仓库，测试通过后merge到主开发分支dev
在Apifox上进行接口管理与调试
项目实际进展
Beta 阶段按计划完成了新增功能开发、缺陷修复与测试补全三大主线，核心完成情况如下：
Bug 修复与测试补全
- 图谱交互修复：重构弹窗定位逻辑，解决拖拽时节点与信息弹窗分离的偏移问题
- 上传流程中断修复：前端 Pinia 状态管理 + AbortController，重复文件上传流程正确终止
- 筛选逻辑修复：D3 enter-update-exit 模式重构力导向图边数据绑定，筛选后关联连线不再消失
- 前端单元测试：Vitest + Vue Test Utils，覆盖 PDF 预览、知识图谱可视化、登录注册等核心组件
- 后端 API 集成测试：pytest + httpx，覆盖密码重置、JWT 刷新、LLM 图结构生成等关键接口
PDF 阅读增强
- PDF 内文字搜索：基于 pdf.js findController，关键词高亮 + 结果列表遍历跳转
- 连续滚动浏览与页码定位：垂直连续滚动模式 + 页码输入框一键跳转
- 要点对照阅读：右侧边栏同步展示四要素关键点，正文与要点对照阅读
笔记与知识管理
- 笔记列表管理：每篇论文支持多篇笔记存储，按论文归集展示
- 富文本编辑器：vue3-tiptap-editor，Markdown 语法 + LaTeX 公式 + 图片粘贴自动上传
- 笔记导出：支持 Markdown / TXT / PDF 格式导出
- 笔记批注与 PDF 联动：点击笔记关联标记，左侧 PDF 自动跳转并高亮对应区域
知识图谱增强
- LLM 图结构生成与聚类：大模型自动生成节点/边结构，按研究主题自动聚类并以不同颜色区分
- 图谱编辑功能：手动增删节点/边、编辑节点属性、删除节点时自动清理关联边
- 图谱导出：支持 PNG / SVG 格式导出
AI 问答助手
- PDF 场景问答：基于论文全文 RAG 检索，自然语言提问返回上下文相关回答
- 知识图谱场景问答：基于图谱结构与论文关联信息回答领域结构相关问题
- 前端对话界面：PDF 阅读界面与知识图谱界面集成 AI 问答入口，支持多轮对话
用户系统完善
- 密码重置流程：前端三步骤页面（验证码发送 → 新密码输入 → 确认提交）
- 个人设置页增强：头像上传、密码重置入口、LLM 供应商配置
- 保存个人资料 API：用户头像、LLM 供应商配置增删改查接口
部署与测试
- 一键部署脚本：基于 docker-compose 扩展，环境初始化 + 依赖安装 + Alembic 迁移 + 服务启动
- E2E 全流程回归测试：Playwright 覆盖注册 → 上传 PDF → 四要素确认 → 知识图谱 → 笔记 → AI 问答完整链路
- 高并发场景压测：JMeter / Locust 模拟 100+ 并发用户上传、图谱生成、问答请求
- 安全测试：用户数据隔离与越权测试、XSS/CSRF 防护、API 限流与防刷测试
- 跨浏览器兼容性测试：Chrome / Firefox / Safari / Edge 覆盖 PDF 阅读器、图谱交互、富文本编辑器核心功能
Beta 阶段总体按任务清单稳步推进，部分 P2 优先级功能因时间原因略有延期或简化，但全部核心新增功能与 P0/P1 测试任务均按时完成，产品稳定性与用户体验相比 Alpha 阶段有显著提升。
成员贡献量化
我们将团队贡献总分分为60+150+90三部分，分别分配给选题规划、alpha、beta三个阶段，以下是各阶段贡献分分配表格：
选题规划阶段
alpha阶段
beta阶段
总结
2. 典型用户场景
典型用户： 研一新生张同学，面临导师布置的文献调研任务，需要快速了解陌生领域的研究脉络。
http://39.107.252.200/
https://qingxin14.github.io/scider/
详见beta发布说明
3. 杀手级功能
快速发现论文
Scider 能够智能解析用户的个人文库，自动推荐相关论文及上下游文献，且支持将检索到的文献一键收录入库，快速开始新一轮研究
AI 智能解析
Scider 模拟研究者“理解-拆解”论文的过程。上传 PDF 后，AI 自动提取并结构化展示“研究背景”、“研究方法”、“创新点”和“研究结论”四大核心要素，并允许用户编辑确认，将被动阅读变为主动知识沉淀
知识图谱可视化
Scider 能将已确认的论文，基于语义相似度/主题关系自动聚合成“知识网络”，以力导向图形式直观呈现研究簇、交叉领域及潜在研究空白，让用户能快速梳理研究主题脉络与论文间关系，并允许用户编辑图谱，制作个性化思维导图
beta新增功能
笔记系统：支持在每篇论文下创建多篇笔记，支持md渲染与图片上传，随时记录所想
知识图谱升级：增加大模型生成主题聚类图谱，ai自动梳理文库脉络，辅助理解研究方向；增加图谱编辑功能，自由定制个性思维导图
pdf阅读场景与知识图谱场景aichat：在单篇论文/文库脉络的学习场景嵌入ai问答助手，辅助理解
4. 项目发布努力
完成公网访问交付
申请域名scider.xyz
推广
在微信朋友圈、小红书、csdn发布了上线说明
发布后用户活跃数据：
| 日期 | 请求数 | 新增独立访客 | 传输量 |
|---|---|---|---|
| 2026-06-14 | 472 | 116 | 90.0 MB |
| 2026-06-15 | 836 | 170 | 204.4 MB |
| 2026-06-16 | 152 | 39 | 4.0 MB |
5. 软件工程质量
文档
飞书项目文档中心、代码管理规范、前后端项目启动指南README.md
测试
50+个测试文件，9份测试报告
接口管理
Apifox 集中管理全部 API，分 7 组覆盖所有模块
CI/CD
GitHub Actions 自动化构建与测试，3 条工作流 pipeline，运行过 337 次工作流程
代码审查
Pull Request 评审机制，148 PRs，100% PR评审覆盖率
浙公网安备 33010602011771号