# smart-literature-system

**Repository Path**: simon1239/smart-literature-system

## Basic Information

- **Project Name**: smart-literature-system
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-10
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能文献管理系统

## 项目概述

智能文献管理系统是一个一站式科研文献管理平台，旨在解决信息过载、数据分散和动态更新三大核心问题。系统集成了多源文献爬取、AI过滤、文献归档和团队协作等功能。

## 功能特性

### 文献追踪 (Paper Radar)
- 支持多源文献爬取（arXiv、Nature、Science等50+来源）
- AI过滤器，基于语义相似度过滤低价值论文
- 动态订阅管理，支持关键词/期刊/学者订阅

### 文献保鲜系统
- 智能归档，自动打标签，与Mendeley同步
- 过期预警机制
- 团队协作平台，支持评论标注、进度同步

### AI增强功能
- 价值预判模型，评估论文价值
- 关键词进化，扩展相关研究关键词
- 自动摘要生成，提取论文核心观点

## 技术栈

- 后端：Python + FastAPI
- 数据库：PostgreSQL + Redis
- AI模型：HuggingFace Transformers + FAISS
- 前端：React + TypeScript
- 部署：Docker + Kubernetes

## 快速开始

### 环境要求

- Python 3.11+
- PostgreSQL 15+
- Redis 7+
- Node.js 18+ (for frontend)

### 安装步骤

1. 克隆项目
```bash
git clone https://github.com/your-username/smart-literature-system.git
cd smart-literature-system
```

2. 安装后端依赖
```bash
pip install -r requirements.txt
```

3. 下载spaCy模型
```bash
python -m spacy download en_core_web_md
```

4. 设置环境变量（复制并编辑）
```bash
cp .env.example .env
```

5. 启动服务

使用Docker Compose（推荐）:
```bash
docker-compose up -d
```

或手动启动:
```bash
# 启动数据库和Redis
# 请先确保PostgreSQL和Redis服务正在运行

# 启动后端服务
uvicorn backend.main:app --reload
```

6. 构建前端（如果需要）
```bash
cd frontend
npm install
npm run build
```

### 访问系统

- API文档：http://localhost:8000/docs
- 前端界面：http://localhost:3000 (如果已构建)

## 项目结构

```
smart-literature-system/
├── backend/              # 后端服务
│   ├── api/             # RESTful API
│   ├── services/        # 业务逻辑
│   ├── models/          # 数据模型
│   └── main.py          # 服务入口
├── frontend/            # 前端界面
├── ai_models/           # AI模型和索引
├── data/                # 数据存储
├── scripts/             # 脚本工具
├── tests/               # 测试用例
├── docs/                # 文档
├── requirements.txt     # Python依赖
├── Dockerfile           # 容器化配置
└── docker-compose.yml   # Docker编排
```

## API文档

### 文献搜索
- GET `/api/papers/search` - 搜索论文
- POST `/api/papers/filter` - 过滤论文
- GET `/api/papers/subscribe` - 订阅主题
- GET `/api/papers/subscriptions/{user_id}` - 获取订阅

### 文献归档
- POST `/api/mendeley/archive` - 归档论文
- POST `/api/mendeley/upload` - 上传PDF
- GET `/api/mendeley/library` - 获取文献库
- POST `/api/mendeley/tag/{paper_id}` - 添加标签

## 开发指南

### 添加新的文献源

1. 在 `crawler_service.py` 中添加新的爬取函数
2. 在 `__init__` 中注册新来源
3. 更新 `config.yaml` 中的配置

### 扩展AI模型

1. 在 `ai_service.py` 中添加新功能
2. 更新模型初始化逻辑
3. 添加相应的API端点

## 贡献指南

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许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 联系方式

- 项目维护者：Your Name
- 邮箱：your.email@example.com
- 项目地址：https://github.com/your-username/smart-literature-system

## 致谢

感谢以下开源项目：
- [FastAPI](https://fastapi.tiangolo.com/)
- [Transformers](https://huggingface.co/transformers/)
- [Sentence Transformers](https://www.sbert.net/)
- [FAISS](https://github.com/facebookresearch/faiss)