# PyAutoTools

**Repository Path**: linux3/py-auto-tools

## Basic Information

- **Project Name**: PyAutoTools
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-10
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyAutoTools - Python自动化工具集

一个包含多个实用自动化工具的Python工具集，提供图形化界面，简单易用。

## 📦 包含工具

### 1️⃣ 卡券链接生成器 (coupon_link_generator.py)

批量为卡券添加URL前缀，生成完整链接。

**功能特点：**
- 📁 支持文件导入或手动输入
- 🔗 批量添加URL前缀
- 💾 自动保存生成的链接
- 👁️ 实时预览结果
- 🌐 支持UTF-8和GBK编码

**快速开始：**
```bash
python coupon_link_generator.py
```

### 2️⃣ IP质量检测工具 (ip_quality_checker.py) ⭐

批量检测IP地址质量，自动筛选高分IP。

**功能特点：**
- 🚀 批量检测IP质量（调用API）
- 📝 支持直接粘贴或文件导入
- 🎯 自动提取IP（支持代理格式）
- ⭐ 智能筛选高分IP（可自定义分数）
- 📊 实时显示检测日志
- 💾 支持导出结果（TXT/JSON）

**快速开始：**
```bash
python ip_quality_checker.py
# 或者直接双击：启动IP检测工具.bat
```

**支持的IP格式：**
- 纯IP：`192.168.1.1`
- 代理格式：`192.168.1.1:8080:user:pass`（自动提取IP，**导出时还原原始格式**）

**导出格式：**
- 默认导出：完整的代理格式（IP:端口:用户名:密码）
- 详细报告：原始格式 + 检测详情
- JSON格式：结构化数据

详细说明请查看：[README_IP_CHECKER.md](README_IP_CHECKER.md) | [功能演示.md](功能演示.md)

## 🚀 快速安装

1. **克隆或下载本项目**

2. **安装依赖**
```bash
# 卡券工具（无需额外依赖）
python coupon_link_generator.py

# IP检测工具
pip install -r requirements_ip.txt
python ip_quality_checker.py
```

## 📖 使用说明

### 卡券链接生成器

1. 运行程序
2. 选择包含卡券的txt文件
3. 输入URL前缀
4. 生成并保存链接

示例：
```
输入：ABC123, DEF456
前缀：https://example.com/
输出：https://example.com/ABC123, https://example.com/DEF456
```

### IP质量检测工具

1. 运行程序
2. 在输入框粘贴IP列表（支持代理格式）
3. 点击"🔍 解析并检测"
4. 查看结果并导出高分IP

示例：
```
输入（代理格式）：
216.170.122.241:6279:user:pass
154.194.24.46:5656:user:pass

自动提取：
216.170.122.241
154.194.24.46
```

## 📁 项目文件说明

```
PyAutoTools/
├── coupon_link_generator.py    # 卡券链接生成器
├── ip_quality_checker.py       # IP质量检测工具
├── requirements.txt            # 卡券工具依赖
├── requirements_ip.txt         # IP检测工具依赖
├── README.md                   # 本文件
├── README_IP_CHECKER.md        # IP检测工具详细说明
├── 使用说明.txt                 # IP检测工具快速指南
├── 启动IP检测工具.bat          # Windows快捷启动脚本
├── example_coupons.txt         # 卡券示例数据
├── example_ips.txt             # 纯IP示例数据
└── example_proxy_ips.txt       # 代理格式IP示例数据
```

## 💡 使用技巧

### IP质量检测工具
- 支持粘贴大批量IP，自动解析
- 代理格式自动提取IP部分
- 可自定义筛选分数（默认90分）
- 实时查看检测进度
- 支持中途暂停/继续

### 卡券链接生成器
- 支持大文件批量处理
- 自动忽略空行
- 预览功能避免错误
- 支持多种编码格式

## 🛠️ 系统要求

- Python 3.6+
- Windows / macOS / Linux
- 图形界面需要tkinter支持（Python通常自带）

## 📦 打包成exe（可选）

使用PyInstaller打包成独立exe程序：

```bash
pip install pyinstaller

# 打包卡券工具
pyinstaller --onefile --windowed --name "卡券链接生成器" coupon_link_generator.py

# 打包IP检测工具
pyinstaller --onefile --windowed --name "IP质量检测工具" ip_quality_checker.py
```

生成的exe文件在 `dist` 目录下。

## 📝 更新日志

**v1.1** (当前版本)
- ✅ 新增IP质量检测工具
- ✅ 支持代理格式IP自动解析
- ✅ 支持直接粘贴IP列表
- ✅ 实时检测和进度显示

**v1.0**
- ✅ 卡券链接生成器

## 🤝 贡献

欢迎提交Issue和Pull Request！

## 📄 许可证

MIT License

---

**提示：** 
- Windows用户可以直接双击 `启动IP检测工具.bat` 快速启动IP检测工具
- 详细使用说明请查看 `使用说明.txt` 和各工具的README文件