# Extension - 浏览器扩展

## 📋 项目简介

Extension 是 Crawlful Hub 的浏览器扩展，用于自动化操作电商平台，实现数据采集、订单同步、物流跟踪等功能。

## 🚀 核心功能

### 1. 数据采集
- 商品数据采集
- 订单数据采集
- 价格数据采集

### 2. 自动化操作
- 自动发货
- 自动同步库存
- 自动处理退货

### 3. 平台集成
- 支持多个电商平台
- 统一数据格式
- 实时同步

### 4. 指纹管理
- 浏览器指纹管理
- 防检测机制
- 多账号管理

### 5. 物流同步
- 物流轨迹同步
- 物流状态更新
- 异常物流处理

## 🏗 技术栈

- **框架**: Vite + TypeScript
- **语言**: TypeScript
- **样式**: Tailwind CSS
- **浏览器API**: Chrome Extension API

## 📦 快速开始

### 环境要求
- Node.js 16+
- Chrome 浏览器

### 安装依赖

```bash
cd extension
npm install
```

### 构建扩展

```bash
npm run build
```

### 加载扩展

1. 打开 Chrome 浏览器
2. 访问 `chrome://extensions/`
3. 开启 "开发者模式"
4. 点击 "加载已解压的扩展程序"
5. 选择 `extension/dist` 目录

## 📁 项目结构

```
extension/
├── src/
│   ├── background/      # 后台脚本
│   │   ├── services/    # 后台服务
│   │   └── index.ts     # 后台入口
│   ├── content/         # 内容脚本
│   ├── platforms/       # 平台集成
│   ├── utils/           # 工具函数
│   └── index.ts         # 主入口
├── manifest.json        # 扩展配置
├── package.json         # 项目配置
├── tsconfig.json        # TypeScript 配置
├── vite.config.ts       # Vite 配置
└── README.md            # 项目说明
```

## 🔧 开发规范

### 代码规范
- 遵循 TypeScript 最佳实践
- 使用 ESLint 进行代码检查
- 服务类命名使用 PascalCase，后缀为 Service
- 文件命名使用 PascalCase

### 提交规范
- 提交信息使用中文描述
- 提交前确保代码通过测试
- 大型功能提交前创建分支

## 🤝 贡献

欢迎贡献代码和提出建议！请先阅读项目文档，然后提交 Pull Request。