103 lines
2.1 KiB
Markdown
103 lines
2.1 KiB
Markdown
|
# 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。
|