# SurfAI Chrome 扩展

**版本**: v0.8.1  
**发布日期**: 2026-03-07  
**作者**: SurfAI Team

---

## 简介

SurfAI 是一款自然语言驱动的浏览器自动化工具。通过 Chrome 扩展，您可以直接在浏览器侧边栏输入指令，让 AI 自动完成网页操作。

---

## 功能特点

- 🎯 **自然语言控制** - 用中文或英文描述操作，AI 自动执行
- 🤖 **多模型支持** - 支持 Kimi、DeepSeek、OpenAI、Ollama 本地模型
- 📸 **自动截图** - 操作过程自动截图保存
- 📊 **数据导出** - 支持 JSON、CSV、Excel 格式
- 🔍 **网页监控** - 定时监控网页变化
- 🎬 **录制回放** - 录制操作并重复执行
- 🛡️ **反检测** - 自动隐藏自动化特征

---

## 安装步骤

### 1. 安装 Python 包

```bash
pip install surfai
```

### 2. 配置模型

```bash
# 使用 Ollama 本地模型（推荐）
surfai config --model ollama --key dummy

# 或使用云端模型
surfai config --model kimi --key your-api-key
```

### 3. 启动后端服务

```bash
surfai server
```

服务将运行在 http://localhost:8000

### 4. 安装 Chrome 扩展

1. 下载 `surfai-extension-v0.8.1.zip`
2. 解压到本地文件夹
3. 打开 Chrome，访问 `chrome://extensions/`
4. 开启右上角「开发者模式」
5. 点击「加载已解压的扩展程序」
6. 选择解压后的文件夹

---

## 使用方式

### 基本操作

1. 点击 Chrome 工具栏的 SurfAI 图标
2. 在侧边栏输入指令，例如：
   - "打开 github.com"
   - "截图"
   - "提取页面标题"
3. 点击「执行」按钮

### 示例指令

```
打开 github.com，找 star 最多的 Python 项目
访问淘宝，搜索 iPhone 16，提取前5个价格
监控 example.com 的价格变化，每60秒检查一次
```

---

## 文件存储位置

所有生成的文件保存在：
- **截图**: `/mnt/fnos/SurfAI/项目文件/截图/`
- **导出数据**: `/mnt/fnos/SurfAI/项目文件/导出数据/`

---

## 系统要求

- Chrome 浏览器 88+
- Python 3.9+
- 2GB+ 内存
- 网络连接（使用云端模型时）

---

## 隐私说明

- 所有数据默认保存在本地
- API Key 仅存储在本地配置文件
- 截图和导出数据不会上传到云端

---

## 技术支持

- **GitHub**: https://github.com/surfai/surfai
- **PyPI**: https://pypi.org/project/surfai/
- **问题反馈**: 请提交 GitHub Issue

---

## 更新日志

### v0.8.1 (2026-03-07)
- ✅ Chrome 扩展发布
- ✅ 前后端联调完成
- ✅ 侧边栏界面优化
- ✅ 通知系统完善

### v0.7.0
- 录制回放功能

### v0.6.0
- 反检测增强

### v0.5.0
- 网页监控功能

---

**许可证**: MIT License
