# 安装指南

## 系统要求

- Python 3.11 或更高版本
- Windows / macOS / Linux
- 至少 2GB 可用磁盘空间（用于浏览器）

## 安装方式

### 方式一：使用 pip 安装（推荐）

```bash
pip install nsfc-spider
```

安装完成后，运行以下命令安装浏览器：

```bash
playwright install chromium
```

### 方式二：从源码安装

1. 克隆仓库：

```bash
git clone https://github.com/yourusername/nsfc-spider.git
cd nsfc-spider
```

2. 创建虚拟环境（推荐）：

```bash
python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate
```

3. 安装依赖：

```bash
pip install -e .
```

4. 安装 Playwright 浏览器：

```bash
playwright install chromium
```

## 配置

### 1. 创建配置文件

复制示例配置文件：

```bash
cp config/.env.example .env
```

### 2. 编辑配置文件

编辑 `.env` 文件，填入你的 API Key：

```env
# LLM 配置
LLM_PROVIDER=openai
LLM_MODEL=gpt-4o
LLM_API_KEY=your-api-key-here
LLM_BASE_URL=https://api.openai.com/v1

# 浏览器配置
HEADLESS=false
```

### 3. 支持的 LLM 提供商

#### OpenAI

```env
LLM_PROVIDER=openai
LLM_MODEL=gpt-4o
LLM_API_KEY=sk-...
```

#### Anthropic

```env
LLM_PROVIDER=anthropic
LLM_MODEL=claude-sonnet-4
LLM_API_KEY=sk-ant-...
```

#### DeepSeek

```env
LLM_PROVIDER=openai
LLM_MODEL=deepseek-chat
LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.deepseek.com/v1
```

#### Ollama（本地）

```env
LLM_PROVIDER=ollama
LLM_MODEL=llama2
LLM_BASE_URL=http://localhost:11434
```

## 验证安装

运行以下命令验证安装：

```bash
nsfc-spider
```

如果看到欢迎界面，说明安装成功！

## 常见问题

### 1. Playwright 浏览器安装失败

如果自动安装失败，可以手动安装：

```bash
python -m playwright install chromium
```

### 2. 权限错误

Windows 用户可能需要以管理员身份运行命令提示符。

### 3. 网络问题

如果下载速度慢，可以设置镜像：

```bash
# 使用清华镜像
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple nsfc-spider
```

### 4. 依赖冲突

建议使用虚拟环境避免依赖冲突：

```bash
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
```

## 下一步

安装完成后，查看 [使用指南](USAGE.md) 了解如何使用 NSFC Spider。
