# jpzcollector

**Repository Path**: hlevel/jpzcollector

## Basic Information

- **Project Name**: jpzcollector
- **Description**: py代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-21
- **Last Updated**: 2025-12-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🛡️ jpzcollector: 专业级数据采集与自动化注册内核

**jpzcollector** 是一款集成了指纹浏览器隔离技术、系统级 HTTPS 流量拦截、自动化过码以及多线程任务管理的综合性工具。该工具专为解决复杂的网页自动化、账号注册及实时数据分析需求而设计。

---

## 📖 1. 功能描述 (Functional Description)

### 核心能力概览
* **指纹浏览器集群控制**：通过 CDP 协议无缝对接 AdsPower、BitBrowser 等环境，彻底告别 WebDriver 特征检测。
* **全协议流量拦截**：内置 `mitmproxy` 模块，不仅拦截网页内的 AJAX，更能拦截系统底层 HTTPS 请求，实时解析 Response 内容。
* **智能验证码破解**：
    * **滑块拼图**：基于 OpenCV 的图像识别，精准计算缺口坐标。
    * **点击验证**：支持图标顺序点击与文字点选。
* **任务编排系统**：支持任务领取、自动重试、异常拉黑手机号及 IP 等逻辑闭环。
* **短信 API 对接**：集成主流接码平台 API，实现从申请号码到读取验证码的全流程自动化。



---

## 🛠️ 2. 安装说明 (Installation Guide)

### 2.1 环境要求
* **操作系统**: Windows 10/11 (暂不支持 Linux/macOS 进行系统级拦截)。
* **Python 版本**: Python 3.10 或更高。

### 2.2 部署步骤
1.  **克隆/下载项目**:
    ```bash
    git clone [https://github.com/your-repo/jpzcollector.git](https://github.com/your-repo/jpzcollector.git)
    cd jpzcollector
    ```
2.  **创建虚拟环境**:
    ```bash
    python -m venv venv
    .\venv\Scripts\activate 或者 .venv\Scripts\Activate.ps1
    ```
3.  **安装依赖库**:
    ```bash
    pip install -r requirements.txt
    ```
4.  **初始化 Playwright**:
    ```bash
    playwright install chromium
    ```

### 2.3 HTTPS 证书安装 (拦截必备)
若需启用系统深度代理功能，必须手动安装 `mitmproxy` 根证书：
1.  在主界面点击 **“开启拦截器”**。
2.  使用系统浏览器访问 [http://mitm.it/](http://mitm.it/)。
3.  选择 **Windows 证书** 并下载。
4.  安装证书时，确保存储路径选择为 **“受信任的根证书颁发机构”**。

---

## 📂 3. 项目文件夹结构

```text
jpzcollector/
├── core/                       # 核心逻辑模块
│   ├── browser_engine.py       # Playwright 与指纹浏览器控制
│   ├── captcha_solver.py       # 验证码识别驱动
│   ├── network_proxy.py        # Mitmproxy 代理服务脚本
│   └── sms_service.py          # 接码平台 API 对接
├── database/                   # 存储层
│   ├── db_manager.py           # SQLite 读写封装
│   └── models.py               # 数据模型定义
├── ui/                         # 界面层
│   ├── main_window.py          # 主窗口界面逻辑
│   └── components/             # 自定义 UI 控件
├── config/                     # 配置层
│   └── settings.yaml           # API Key 及系统参数配置
├── main.py                     # 程序启动入口
└── README.md                   # 本文档