Skip to content

liukai-peng/paper-analysis-agent

Repository files navigation

🎓 智能论文分析系统

让研究生新手 10 分钟读懂一篇学术论文

一个基于 AI 的学术论文分析工具,帮助研究生新手快速理解和学习学术论文,节省数小时的阅读时间。

✨ 核心价值

  • 节省时间:从阅读一篇论文需要 2-3 小时,缩短到 10 分钟快速理解
  • 降低门槛:用通俗语言解释复杂概念,像导师手把手教学
  • 系统学习:7 步三遍阅读法,从找战场到画连接,层层深入
  • 实战导向:提取有用表达和写作技巧,直接应用到自己的论文写作

🎯 适合人群

  • 📚 研究生新手(硕士/博士)
  • 📝 需要快速了解领域前沿的研究者
  • 🌐 跨学科研究者(需要快速理解陌生领域)
  • 👨‍🏫 学术导师(用于教学和指导)

🚀 快速开始

1. 安装依赖

git clone https://github.com/yourusername/paper-analyzer.git
cd paper-analyzer
pip install -r requirements.txt

2. 配置 API 密钥

复制 .env.example.env,并填入你的 DeepSeek API 密钥:

cp .env.example .env

编辑 .env 文件:

DEEPSEEK_API_KEY=your_api_key_here

或者在应用界面中直接输入 API 密钥。

3. 运行应用

python run.py

应用将在 http://localhost:8502 启动。

💡 提示:首次运行可能需要 1-2 分钟下载依赖,请耐心等待。

📸 示例输出

上传一篇论文后,系统会自动生成:

📊 论文结构分析

  • 自动识别章节结构(摘要、引言、方法、实验、结论等)
  • 提取每个章节的关键点
  • 评估章节重要性

🎯 第一遍:找战场

  • 研究现象:用通俗语言解释论文在研究什么
  • 理论工具:详细解释使用的理论框架和方法
  • 核心贡献:最重要的发现、理论贡献、实践意义

🗺️ 第二遍:拆地图

  • 研究问题:核心问题和子问题
  • 文献综述:相关工作和研究空白
  • 方法论:研究方法和实验设计

🔗 第三遍:画连接

  • 理论对话:与哪些理论进行对话
  • 方法评估:方法的优缺点
  • 发现意义:研究的理论意义和实际价值

🛠️ 使用说明

  1. 上传 PDF: 在左侧边栏上传 PDF 文件
  2. 查看结构: 系统自动分析论文结构
  3. 选择分析模式: 选择快速分析或深度分析
  4. 分步学习: 按照 7 个步骤逐步学习论文内容
  5. 保存到文献库: 分析结果可保存供以后查看

📁 项目结构

backend/
├── app/
│   ├── core/           # 核心工作流和 Agent
│   ├── database/       # 数据库管理
│   ├── ui_modules/     # Streamlit UI 组件
│   └── utils/          # 工具函数
├── project/work_dir/   # 分析结果存储
├── run.py              # 启动脚本
└── requirements.txt    # 依赖列表

🛠️ 技术栈

  • 前端: Streamlit
  • AI: DeepSeek API
  • 数据库: SQLite / MongoDB / MySQL (可选)

🤝 贡献指南

欢迎任何形式的贡献!

报告 Bug

如果发现 bug,请在 Issues 中提交,并尽可能提供:

  • 问题描述
  • 复现步骤
  • 预期行为
  • 实际行为
  • 环境信息(操作系统、Python 版本等)

提交功能请求

如果你有新的功能想法,欢迎在 Issues 中提交,并说明:

  • 功能描述
  • 使用场景
  • 预期效果

提交代码

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 提交 Pull Request

📄 开源协议

本项目采用 MIT 协议开源,欢迎自由使用和修改。

📞 联系方式

⭐ Star History

如果这个项目对你有帮助,请给个 ⭐ Star!


让学术研究不再难懂,让每篇论文都能快速掌握!

About

基于 AI 的学术论文分析系统,帮助研究生新手快速理解和学习学术论文

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages