# auto-ps

**Repository Path**: bogerJ/auto-ps

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自动证件照处理工具 v1.2

一款基于AI人脸识别和图像处理技术的智能证件照处理工具，支持老照片修复、自动裁剪、智能调色、背景替换、自动排版等功能。

## ✨ 主要功能

- **老照片修复**: 对比度增强、高清增强、图像去噪、黑白上色（百度AI）
- **智能调色**: 自动白平衡、亮度/对比度、饱和度、锐化、降噪（参数可调）
- **人脸识别**: 基于OpenCV的智能人脸检测和裁剪
- **证件照排版**: 自动排版到A4/A3/A5纸张
- **多种尺寸**: 支持1寸、2寸、护照、驾驶证、身份证、签证等7种尺寸

## 🚀 快速开始

### 方式1: 使用 uv (推荐)

uv 是一个极速的 Python 包管理器，比 pip 快 10-100 倍。

**安装 uv:**
```bash
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Linux/Mac
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**Windows:**
```bash
setup_uv.bat    # 首次设置环境
run_uv.bat      # 运行程序
build_uv.bat    # 打包程序
```

**Linux/Mac:**
```bash
./setup_uv.sh           # 首次设置
uv run python main.py   # 运行程序
uv run python build_exe.py  # 打包程序
```

### 方式2: 使用 pip

```bash
pip install -r requirements.txt
python main.py        # 运行程序
python test_modules.py # 测试模块
```

## 📝 使用流程

1. **选择照片** → 点击"浏览文件..."
2. **设置参数** → 选择尺寸、背景颜色、纸张
3. **勾选功能** → 智能调色、自动裁剪、老照片修复
4. **调整参数** → 展开"调色参数"面板调整参数
5. **预览效果** → 点击"预览效果"
6. **生成排版** → 点击"生成排版"
7. **保存图片** → 点击"保存图片"

## 🎨 智能调色参数

| 参数 | 范围 | 默认值 | 说明 |
|-----|------|--------|------|
| 自动白平衡 | 开/关 | 开 | 自动修正色温 |
| 亮度 | 0.5-2.0 | 1.1 | <1变暗，>1变亮 |
| 对比度 | 0.5-2.0 | 1.2 | <1柔和，>1锐利 |
| 饱和度 | 0.5-2.0 | 1.2 | <1灰度，>1鲜艳 |
| 锐化 | 0.5-3.0 | 1.3 | <1模糊，>1清晰 |
| 降噪 | 开/关 | 开 | 消除噪点 |

## 📋 配置文件

编辑 `config.yaml`：

```yaml
# 输出设置
output:
  default_directory: output
  save_quality: 95
  dpi: 300

# 老照片修复（需配置百度AI）
photo_restoration:
  enabled: true
  baidu:
    app_id: ""
    api_key: ""
    secret_key: ""
```

## 📦 打包

### 使用 uv (推荐)
```bash
build_uv.bat           # Windows
uv run python build_exe.py  # 或使用 Python
```

### 使用 pip
```bash
build.bat              # Windows (传统方式)
python build_exe.py    # 或使用 Python
```

## 🔧 技术架构

| 模块 | 功能 | 技术 |
|-----|------|------|
| main.py | GUI界面 | Tkinter |
| face_cropper.py | 人脸识别 | OpenCV Haar Cascade |
| color_adjuster.py | 智能调色 | OpenCV + PIL |
| photo_restorer.py | 老照片修复 | 百度AI API |
| id_photo_layout.py | 证件照排版 | PIL |
| config_loader.py | 配置管理 | PyYAML |

## 💡 常见问题

**Q: 人脸识别失败？**  
A: 使用清晰的正面照片，或取消勾选"自动裁剪"

**Q: 老照片修复不可用？**  
A: 在 `config.yaml` 中配置百度AI的API密钥

**Q: 运行速度慢？**  
A: 使用1-3MB大小的照片，老照片修复需要网络

## 🔄 版本历史

- **v1.2** - 智能调色参数可调（当前版本）
- **v1.1** - 多线程优化、进度条、友好错误提示
- **v1.0** - 基础功能：调色、裁剪、排版

---

**版权所有 © 2025 自动证件照处理工具**