# 虚拟环境设置指南

## 创建虚拟环境

### 方法1：使用 venv（推荐）

```bash
# 创建虚拟环境（在当前目录下创建 .venv 文件夹）
python3 -m venv .venv

# 或者指定名称
python3 -m venv venv
```

### 方法2：使用 virtualenv

```bash
# 先安装 virtualenv（如果未安装）
pip install virtualenv

# 创建虚拟环境
virtualenv venv
```

## 激活虚拟环境

### macOS/Linux

```bash
# 激活虚拟环境
source .venv/bin/activate

# 或者如果命名为 venv
source venv/bin/activate
```

激活成功后，终端提示符前会显示 `(venv)` 或 `(.venv)`

### Windows

```bash
# 激活虚拟环境
.venv\Scripts\activate

# 或者如果命名为 venv
venv\Scripts\activate
```

## 停用虚拟环境

```bash
deactivate
```

## 完整设置流程

```bash
# 1. 创建虚拟环境
python3 -m venv .venv

# 2. 激活虚拟环境
source .venv/bin/activate

# 3. 升级pip（可选但推荐）
pip install --upgrade pip

# 4. 安装项目依赖
pip install -r requirements.txt

# 5. 设置环境变量
export OPENROUTER_API_KEY='your-api-key-here'

# 6. 验证安装
python --version
pip list
```

## 检查虚拟环境是否激活

```bash
# 方法1：查看Python路径
which python
# 应该显示虚拟环境路径，如：/path/to/project/.venv/bin/python

# 方法2：查看pip路径
which pip
# 应该显示虚拟环境路径，如：/path/to/project/.venv/bin/pip

# 方法3：查看环境变量
echo $VIRTUAL_ENV
# 应该显示虚拟环境路径
```

## 常见问题

### 1. 找不到 python3 命令

```bash
# 尝试使用 python
python -m venv .venv

# 或者查找Python安装路径
which python3
```

### 2. 权限错误

```bash
# 使用 sudo（不推荐，但有时需要）
sudo python3 -m venv .venv
```

### 3. 虚拟环境已存在

```bash
# 删除旧虚拟环境
rm -rf .venv

# 重新创建
python3 -m venv .venv
```

## 项目特定设置

对于本项目，建议使用 `.venv` 作为虚拟环境名称（已在 .gitignore 中忽略）

```bash
# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 设置API密钥
export OPENROUTER_API_KEY='your-api-key-here'
```