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

这个作业属于哪个课程	北航2026年春季软件工程
这个作业的要求在哪里	[T.17] 团队项目：Beta 阶段发布说明
我在这个课程的目标是	体验完整软件开发流程，交付一款真正解决科研阅读痛点的软件产品
这个作业在哪个具体方面帮助我实现目标	完成 Beta 阶段发布说明

Scider 是一个智能学术论文管理辅助平台，面向科研人员与学生，提供论文检索、AI 解析、知识图谱可视化与个人文库管理等功能。

Beta 版本现已上线，在 Alpha 版本核心功能的基础上，新增了 PDF 内文字搜索、连续滚动浏览、文本高亮批注、要点对照阅读、富文本笔记、笔记导出、笔记与 PDF 联动、LLM 自动图结构生成与聚类、图谱编辑、AI 问答助手等丰富功能，所有核心功能均可免费使用，期待您的使用反馈！

• 在线体验：http://39.107.252.200
• 宣传网页：https://www.cnblogs.com/BBnomoney/p/20542987

1. 新功能和特性

1.1 PDF 内文字搜索

实现需求

在 PDF 阅读界面中，支持用户输入关键词搜索当前论文全文，高亮显示所有匹配位置，并支持在结果列表间逐条跳转。

应用场景

研一新生张同学正在阅读一篇关于 Transformer 的论文，想快速找到文中所有出现"attention mechanism"的位置。他在 PDF 阅读器的搜索框中输入关键词，系统立刻高亮显示所有匹配位置，并支持逐条跳转，几分钟内就完成了原本需要半小时的翻阅工作。

1.2 连续滚动浏览与页码定位

实现需求

PDF 阅读模式由逐页翻页改为垂直连续滚动浏览，切换页面时缩放比例保持不变；支持在页码输入框中输入目标页码，自动滚动到该页并将其定位在阅读界面视图中央。

应用场景

张同学在阅读一篇 30 页的论文时，导师建议他重点看第 15 页的实验部分。他在页码输入框中键入"15"，PDF 立即滚动到该页并居中显示，全程不到一秒，阅读体验流畅连贯。

1.3 要点对照阅读

实现需求

在 PDF 阅读界面的右侧边栏中，并排显示 LLM 提取的四要素关键点（研究背景、研究方法、创新点、研究结论），实现正文阅读与核心要点的同步对照。

应用场景

张同学在阅读论文正文时，右侧边栏始终展示着 AI 提取的四要素。当他读到方法部分时，可以随时对照右侧的"研究方法"摘要，确认自己的理解是否正确，阅读与理解同步进行，效率大幅提升。

1.4 笔记列表与全文搜索

实现需求

每篇论文下支持创建多篇笔记，笔记按论文归集管理。

应用场景

张同学在阅读一篇论文时，边读边记录了多篇笔记，全部挂载在同一篇论文下。几天后回顾时，直接在论文详情页展开笔记列表，所有笔记按时间倒序排列，标题清晰展示，点击即看，围绕同一篇论文归集，不会与其他论文混淆，知识脉络一目了然。

1.5 富文本编辑器

实现需求

笔记编辑器支持 Markdown 语法渲染、LaTeX 数学公式（通过 katex 扩展）、图片粘贴自动上传至后端。

应用场景

张同学在记录一篇机器学习论文的笔记时，需要写下公式 $L(\theta) = -\mathbb{E}_{x \sim p}[\log p_\theta(x)]$。在富文本编辑器中输入 LaTeX 语法后，公式实时渲染为漂亮的数学表达式，同时他还粘贴了一张模型架构图，图片自动上传并嵌入笔记中。

1.6 笔记导出

实现需求

支持将笔记导出为 Markdown、TXT 或 PDF 格式的文件，方便用户在不同平台间迁移和使用笔记内容。

应用场景

张同学完成了文献调研，需要将所有论文笔记整理成一份综述报告。他选择将相关笔记导出为 PDF 格式，一键下载后直接作为报告附件提交给导师。

1.7 LLM 自动图结构生成与聚类

实现需求

基于文库中已确认的论文集合，调用大语言模型自动分析并生成图结构，包含基于研究主题/领域的自动聚类展示，以不同颜色区分不同研究簇。

应用场景

张同学上传了 5 篇关于"对比学习"的论文并确认了四要素。点击"生成图谱"后，系统自动将论文按"图像对比学习"、"文本对比学习"、"多模态对比学习"等主题聚类，不同颜色区分不同研究簇。张同学一眼看出该领域的研究热点分布，并发现了两个交叉方向的研究空白。

1.8 图谱编辑功能

实现需求

支持手动添加/删除节点、编辑节点属性、建立或删除节点间关系；删除节点时自动删除与该节点关联的所有边。

应用场景

张同学发现 AI 将一篇关于"CLIP"的论文误分到了"文本对比学习"簇，而实际上它应该属于"多模态对比学习"。他拖拽该节点到正确的簇中，并手动添加了一条与另一篇多模态论文的关联边，知识图谱更加准确，完全符合他的研究认知。

1.9 图谱导出

实现需求

支持将当前知识图谱视图导出为 PNG 或 SVG 格式的图片。

应用场景

张同学完成文献调研后，将整理好的知识图谱导出为 PNG 图片，插入到组会汇报的 PPT 中，清晰地展示了领域研究脉络，获得了导师的表扬。

1.10 AI 问答助手（PDF 场景）

实现需求

在 PDF 阅读界面，允许用户输入自然语言问题，系统基于当前论文全文及用户笔记内容，通过 RAG（检索增强生成）流程返回回答。

应用场景

张同学读到一篇 40 页的论文，对"对比损失函数的温度参数为什么选择 0.07"感到困惑。他在 AI 问答框中输入这个问题，系统基于论文全文生成了详细的回答，并引用了原文中的相关论述，张同学立刻理解了设计者的考量，省去了反复翻找的时间。

1.11 AI 问答助手（知识图谱场景）

实现需求

在知识图谱界面，允许用户输入自然语言问题，系统基于当前生成图谱内容与论文关联信息返回回答。

### 应用场景

张同学看着生成的对比学习知识图谱，在问答框中输入"这个领域的主要研究方向有哪些？"系统分析图谱结构后回答："主要分为图像对比学习、文本对比学习、多模态对比学习三个方向，其中文本对比学习方向最近两年发文量增长最快。..."知识图谱的价值被自然语言交互进一步放大。

2. 修复的缺陷

2.1 图谱交互修复

原有问题：Alpha 版本中，知识图谱在拖动节点时，信息弹窗与节点发生位置偏移，弹窗没有跟随节点移动。用户在拖拽整理图谱时，弹窗与节点分离，导致信息展示错乱，严重影响图谱的可读性和操作体验。

修复方式：重构弹窗定位逻辑，使用相对 Canvas 坐标定位，通过 getBoundingClientRect 计算节点位置并实时更新；绑定拖拽事件连续更新位置，结合 requestAnimationFrame 优化定位计算。新版本中弹窗紧密跟随节点移动，拖拽体验流畅精准。

2.2 上传流程中断修复

原有问题：上传重复 PDF 后，上传流程未能正确终止，前端 UI 状态未清理。用户误传重复文件后，界面仍显示"上传中"状态，无法继续操作，需要刷新页面才能恢复。

修复方式：前端使用 Pinia 管理上传状态，在组件 onUnmounted 中调用 uploadStore.clearState() 并执行 abortController?.abort()。后端 MD5 检测机制复用，重复文件上传时立即返回提示并清理前端状态。新版本中重复上传会明确提示"文件已存在"，界面状态正常。

2.3 筛选逻辑修复

原有问题："最近论文"筛选导致语义关联连线消失，力导向图的边数据绑定异常。用户切换筛选条件后，图谱中的论文节点之间的连线丢失，无法看到论文间的关联关系。

修复方式：采用 D3 的"enter-update-exit"模式重构力导向图边数据绑定，筛选后先清空旧边再绑定新数据集，确保无残留连线。新版本中切换筛选条件时，图谱节点和边的数据同步更新，关联关系始终可见。

2.4 前端单元测试补全

原有问题：Alpha 阶段前端缺乏系统性的单元测试，关键 Vue 组件（PDF 预览组件、知识图谱可视化组件、登录注册组件）的交互逻辑与渲染完整性未经自动化验证，存在潜在回归风险。

修复方式：使用 Vitest + Vue Test Utils 编写前端单元测试，Mock API 时使用 vi.mock 模拟 api/ 目录下的模块，异步组件测试配合 flushPromises 等待状态更新完成。

2.5 后端 API 集成测试补全

原有问题：Alpha 阶段后端 API 缺乏系统性集成测试，密码重置、JWT 刷新、LLM 图结构生成等关键接口的正确性依赖于人工验证。

修复方式：使用 pytest.mark.asyncio 装饰异步测试函数，通过 httpx.AsyncClient 发起请求，Mock 外部依赖时使用 AsyncMock。

3. 运行环境

本平台 Beta 阶段为 Web 应用，用户无需安装任何客户端软件，通过浏览器即可访问全部功能。

运行环境

操作系统	浏览器及版本
macOS 14+	Chrome 120+、Safari 17+、Firefox 120+、Edge 120+
Windows 10/11	Chrome 120+、Firefox 120+、Edge 120+
Ubuntu 22.04 LTS	Chrome 120+

最低运行要求

• 浏览器需启用 JavaScript
• 屏幕分辨率不低于 1366×768（推荐 1920×1080）
• 需要能够正常访问以下域名：
  • api.semanticscholar.org（论文检索）
  • dashscope.aliyuncs.com（阿里云通义千问 API）

4. 安装与使用方法

访问方式

本软件为 Web 应用，无需安装。直接在浏览器地址栏输入 http://39.107.252.200 即可访问。

注册方式

平台支持用户自行注册：

• 访问首页，点击右上角"开始使用"按钮
• 填写邮箱地址和密码（密码不少于 6 位）
• 点击"注册"完成账号创建

新用户入门流程

1. 注册登录：使用邮箱和密码注册账号并登录系统
2. 建立文库：进入"我的文库"，创建文件夹搭建个人文献分类结构
3. 上传论文：点击"上传 PDF"按钮，选择或拖拽 PDF 文件，等待后台解析
4. 确认四要素：解析完成后点击论文卡片，在抽屉中查看并确认 AI 提取的四要素内容
5. 探索知识图谱：上传多篇并确认状态的论文后，进入"知识图谱"页面生成图谱并交互探索

进阶功能

• PDF 内搜索：在 PDF 阅读器中输入关键词，高亮定位全文匹配位置
• 文本高亮批注：选中 PDF 中的文字进行高亮标记，标注永久保存
• 添加富文本笔记：在论文预览界面中点击"笔记"标签，支持 Markdown 和 LaTeX 公式
• 笔记与 PDF 联动：点击笔记中的批注标记，自动跳转到 PDF 对应位置
• AI 问答：在 PDF 阅读界面或知识图谱界面，输入自然语言问题获取智能回答
• 图谱导出：将知识图谱导出为 PNG 或 SVG 图片

5. 系统已知的问题和限制

已知问题

富文本编辑器在 Safari 浏览器中图片粘贴偶现失败

• 表现：使用 Safari 浏览器粘贴图片到笔记编辑器时，偶现上传失败
• 触发条件：Safari 浏览器版本较旧或系统权限限制
• 缓解方法：建议使用 Chrome 或 Edge 浏览器；或通过"上传图片"按钮代替粘贴

AI 四要素提取解析偶有偏差

• 表现：部分论文的 AI 提取内容存在不准确或信息不完整的情况
• 触发条件：论文格式不规范（如双栏排版、扫描件）或内容高度专业化
• 预计修复：持续优化 Prompt 工程与模型选择

功能限制

限制项	说明
单文件上传上限	50MB，超大型综述论文建议先压缩后上传
并发上传	同时上传 PDF 数量不超过 5 个，避免 Celery 任务队列积压
笔记长度	单篇笔记建议不超过 10000 字，过长内容可能影响编辑器性能
AI 问答频率	受限于 LLM API 调用配额，建议合理控制问答频次
离线模式	论文搜索、AI 解析、知识图谱等核心功能依赖外部 API，无网络环境下仅可查看已上传的论文和笔记
数据批量导出	暂不支持批量导出论文元数据或笔记，后续版本计划加入
文件夹层级	当前仅支持单级文件夹操作，不支持嵌套子文件夹

6. 软件发布方式与发布地址

在线体验

直接在浏览器中访问 http://39.107.252.200 即可使用全部功能，无需安装任何软件。

宣传网页

Scider 项目宣传网页：https://www.cnblogs.com/BBnomoney/p/20542987

开源仓库

Scider 完全开源，可通过 GitHub 获取源码并自行部署：

git clone https://github.com/XiaCang/Scider.git

GitHub 仓库地址：https://github.com/XiaCang/Scider

团队博客

团队博客：https://www.cnblogs.com/BBnomoney

Scider —— 让学术阅读变得高效而深刻。

欢迎访问 http://39.107.252.200 体验 Beta 版本，也欢迎通过 GitHub Issue 或博客留言给我们反馈！