# 安装说明

## 依赖管理

### 问题说明

在安装过程中，某些依赖可能会因为编译问题而失败：

1. **faiss-cpu**: 需要 SWIG 编译器，在某些系统上编译困难
2. **selenium**: 需要浏览器驱动，可能增加复杂性
3. **开发工具**: black, isort, flake8 等是可选工具

### 解决方案

我们提供了两个依赖文件：

#### 1. requirements-minimal.txt（推荐）
包含核心功能必需的依赖，安装成功率最高：

```bash
pip install -r requirements-minimal.txt
```

#### 2. requirements.txt
包含所有依赖，包括可选工具：

```bash
pip install -r requirements.txt
```

### 如果仍然遇到问题

#### 对于 faiss-cpu 问题：
```bash
# 方法1：使用 conda 安装
conda install -c conda-forge faiss-cpu

# 方法2：使用预编译包
pip install faiss-cpu --no-build-isolation

# 方法3：暂时跳过，只使用 ChromaDB
# 项目已经配置为默认使用 ChromaDB
```

#### 对于其他编译问题：
```bash
# 安装编译工具
# Ubuntu/Debian
sudo apt-get install build-essential

# macOS
xcode-select --install

# Windows
# 安装 Visual Studio Build Tools
```

### 功能影响

移除某些依赖后的功能影响：

1. **FAISS 向量数据库**: 暂时禁用，但 ChromaDB 功能完整
2. **Selenium**: 网页抓取功能受限，但其他功能正常
3. **开发工具**: 代码格式化功能受限，但不影响核心功能

### 验证安装

安装完成后，运行以下命令验证：

```bash
# 运行基本示例
python examples/basic_usage.py

# 或使用运行器
python run_examples.py
```

### 系统要求

- Python 3.8+
- 内存: 至少 2GB RAM
- 磁盘空间: 至少 500MB 可用空间

### 支持的平台

- ✅ Linux (Ubuntu 18.04+, CentOS 7+)
- ✅ macOS (10.14+)
- ✅ Windows (10+)

### 故障排除

如果遇到安装问题，请：

1. 检查 Python 版本：`python --version`
2. 更新 pip：`pip install --upgrade pip`
3. 使用虚拟环境：
   ```bash
   python -m venv ai_arch_env
   source ai_arch_env/bin/activate  # Linux/macOS
   # 或
   ai_arch_env\Scripts\activate     # Windows
   ```
4. 尝试最小化安装：`pip install -r requirements-minimal.txt`