# SurfAI 项目管理

## 项目信息

- **名称**: SurfAI
- **路径**: `/home/alpha/.openclaw/workspace/projects/surfai`
- **环境**: Python 3.12 + 虚拟环境
- **版本**: 0.2.0
- **状态**: Phase 2 完成

## 快速开始

```bash
cd /home/alpha/.openclaw/workspace/projects/surfai
source venv/bin/activate

# 配置 API 模型
surfai config --model kimi --key <your-key>
# 或配置本地 Ollama（零成本）
surfai config --model ollama --key dummy --base-url http://localhost:11434

# 使用
surfai run "你的指令"
```

## 开发规范

1. **必须在虚拟环境中开发**
   ```bash
   source venv/bin/activate
   ```

2. **安装新依赖**
   ```bash
   pip install <package>
   # 然后更新 pyproject.toml
   ```

3. **测试**
   ```bash
   pytest
   ```

## 目录结构

```
surfai/
├── surfai/           # 主代码
│   ├── browser.py    # 浏览器核心
│   ├── cli.py        # 命令行
│   ├── config.py     # 配置管理
│   ├── extractor.py  # 智能提取
│   ├── exporter.py   # 数据导出
│   └── llm/          # LLM  providers
├── examples/         # 示例
├── tests/            # 测试
├── venv/             # 虚拟环境（不提交）
├── pyproject.toml    # 包配置
└── README.md         # 文档
```

## 功能清单

### Phase 1 (✅ 完成)
- [x] 浏览器核心（导航、截图、CSS 提取）
- [x] Kimi/DeepSeek/OpenAI 集成
- [x] CLI 命令行
- [x] 配置管理

### Phase 2 (✅ 完成)
- [x] Ollama 本地 LLM 支持
- [x] 智能提取（表格、链接、列表、价格）
- [x] 数据导出（JSON/CSV/TXT）
- [x] 复杂交互（点击、输入、滚动）

### Phase 3 (待开始)
- [ ] 云端浏览器托管
- [ ] 代理 IP 池
- [ ] Dashboard
- [ ] 更多导出格式（Excel）

## 待办

- [ ] 用户测试（需要 API Key）
- [ ] 完善文档
- [ ] 发布到 PyPI
