# 快速开始指南

本指南帮助你在 5 分钟内开始使用 NSFC Spider。

## 第一步：安装

```bash
# 安装 nsfc-spider
pip install nsfc-spider

# 安装浏览器
playwright install chromium
```

## 第二步：配置 API

### 方式一：交互式配置（推荐新手）

```bash
# 启动工具
nsfc-spider
```

在命令行中输入：

```bash
nsfc> /config
```

按提示输入：
- LLM 提供商：输入 `openai`（或其他）
- 模型：输入 `gpt-4o`（或其他）
- API Key：粘贴你的 API Key
- Base URL：直接回车（使用默认）

### 方式二：创建配置文件

创建文件 `.env`：

```env
LLM_PROVIDER=openai
LLM_MODEL=gpt-4o
LLM_API_KEY=sk-your-api-key-here
```

**获取 API Key**：
- OpenAI: https://platform.openai.com/api-keys
- DeepSeek: https://platform.deepseek.com/

## 第三步：开始使用

### 1. 直接爬取（推荐）

```bash
nsfc> /scrape 人工智能 -p 3
```

这会：
- 搜索"人工智能"关键词
- 爬取 3 页结果
- 自动获取项目详情和摘要
- 保存为 JSON 文件

### 2. 查看数据

```bash
# 数据统计
nsfc> /analyze

# 导出 Excel
nsfc> /export excel
```

### 3. 智能筛选（需要 LLM）

```bash
nsfc> /filter 与深度学习相关的项目
```

### 4. 生成综述（需要 LLM）

```bash
nsfc> /review 人工智能研究综述
```

## 常用命令速查

| 命令 | 说明 | 示例 |
|------|------|------|
| `/scrape` | 直接爬取 | `/scrape 轨道交通 -p 3` |
| `/load` | 加载数据 | `/load` |
| `/export` | 导出数据 | `/export excel` |
| `/analyze` | 数据分析 | `/analyze` |
| `/filter` | LLM筛选 | `/filter 风险相关` |
| `/review` | 生成综述 | `/review 研究综述` |
| `/help` | 查看帮助 | `/help` |
| `/exit` | 退出 | `/exit` |

## 完整工作流示例

### 场景：研究轨道交通安全风险

```bash
# 1. 启动工具
nsfc-spider

# 2. 爬取数据（最近5年，每年2页）
nsfc> /scrape 轨道交通 -y 5 -p 2

# 3. 查看统计
nsfc> /analyze

# 4. 筛选相关项目
nsfc> /filter 与安全风险评估相关的项目

# 5. 导出 Excel
nsfc> /export excel

# 6. 生成综述
nsfc> /review 轨道交通安全风险研究综述
```

完成！你会得到：
- ✅ Excel 数据表格
- ✅ Word 格式的研究综述

## 按年份爬取（获取更多数据）

```bash
# 最近5年，每年2页
nsfc> /scrape 人工智能 -y 5 -p 2

# 指定年份范围
nsfc> /scrape 人工智能 -y 2020-2024

# 指定多个年份，全部页面
nsfc> /scrape 人工智能 -y 2023,2024 -p all
```

## 批量搜索

```bash
# 搜索多个关键词，自动去重
nsfc> /batch 深度学习,机器学习,神经网络 -p 2
```

## 一键流程

完整流程：爬取 → 筛选 → 综述

```bash
nsfc> /pipeline 人工智能 -p 5 | 深度学习相关 | 深度学习研究综述
```

## 常见问题

### Q: 爬取速度慢？
A: 这是正常的，因为需要：
- 等待页面加载
- 获取详情信息
- 避免触发反爬

### Q: 没有配置 LLM 可以用吗？
A: 可以！直接爬取功能不需要 LLM：
```bash
nsfc> /scrape 关键词 -p 3
nsfc> /export excel
```

### Q: 数据保存在哪里？
A: 默认保存在 `./output/` 目录

### Q: 如何查看配置状态？
A: 
```bash
nsfc> /status
```

### Q: 浏览器窗口太多？
A: 在配置文件中设置：
```env
HEADLESS=true
```

## 下一步

- 📖 查看 [完整使用指南](USAGE.md)
- 🔧 查看 [配置指南](CONFIGURATION.md)
- 💡 查看 [高级功能](USAGE.md#高级功能)

## 需要帮助？

- 📚 查看文档：[docs/](.)
- 🐛 报告问题：[GitHub Issues](https://github.com/yourusername/nsfc-spider/issues)
- 💬 在 CLI 中输入 `/help` 查看所有命令

祝你使用愉快！🎉
