# ImageTextEditor

**Repository Path**: zzroot123/image-text-editor

## Basic Information

- **Project Name**: ImageTextEditor
- **Description**: 修改图片上的文字，框选修改区域，输入要修改成的文字；然后点击修改按钮，就会生成图片；
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 榜单车牌号修改系统

> 专为处理多种格式榜单的车牌号修改工具，支持桌面版和Web版

## 📦 版本说明

本系统提供两个版本，满足不同使用需求：

### 桌面版（Desktop）
- 适合：个人使用、测试、本地批量处理
- 特点：图形界面、本地运行、处理速度快
- 启动：`python main.py` 或双击 `start.bat`

### Web版（Web）
- 适合：团队协作、业务人员使用、远程访问
- 特点：浏览器访问、多用户共享、无需安装
- 启动：`python web_app.py` 或双击 `start_web.bat`

## ✨ 核心功能

### 通用功能
- ✅ **多模板管理**：为每种格式的榜单创建独立模板
- ✅ **批量处理**：一次性处理大量榜单图片
- ✅ **智能识别**：自动识别车牌号区域
- ✅ **灵活配置**：支持自定义颜色、位置、大小
- ✅ **重复使用**：模板创建后可长期使用

### Web版独有功能
- ✅ **无需安装**：业务人员只需浏览器即可使用
- ✅ **多用户共享**：部署一次，多人同时使用
- ✅ **跨平台访问**：Windows、Mac、Linux均可使用
- ✅ **移动端支持**：支持手机、平板访问

## 🚀 快速开始

### 桌面版启动

```bash
# Windows用户
双击 start.bat

# Linux/Mac用户
chmod +x start.sh
./start.sh

# 手动启动
python main.py
```

### Web版启动

```bash
# Windows用户
双击 start_web.bat

# Linux/Mac用户
chmod +x start_web.sh
./start_web.sh

# 手动启动
python web_app.py
```

启动后，在浏览器中打开：http://localhost:5000

## 📖 使用文档

### 快速上手
- `5分钟上手.md` - 5分钟快速了解系统
- `Web版快速开始.md` - Web版快速上手

### 详细指南
- `多格式榜单使用指南.md` - 处理多种格式的完整指南
- `Web部署指南.md` - Web版部署到生产服务器
- `磅单使用说明.md` - 专门针对磅单的说明

### 版本对比
- `Web版说明.md` - 桌面版与Web版对比

### 其他文档
- `测试报告.md` - 系统测试报告
- `快速开始.md` - 常见操作流程
- `使用说明.md` - 完整功能说明
- `更新说明.md` - 系统更新日志

## 📁 文件结构

```
pic/
│
├── 桌面版文件
│   ├── main.py                      # 桌面版主程序
│   ├── requirements.txt             # 桌面版依赖包
│   ├── start.bat                    # Windows启动脚本
│   └── start.sh                     # Linux/Mac启动脚本
│
├── Web版文件
│   ├── web_app.py                   # Web应用主程序 ⭐
│   ├── requirements_web.txt         # Web版依赖包 ⭐
│   ├── start_web.bat                # Windows启动脚本 ⭐
│   ├── start_web.sh                 # Linux/Mac启动脚本 ⭐
│   │
│   └── templates/                   # Flask模板目录 ⭐
│       └── index.html               # Web前端界面 ⭐
│
├── 测试和工具
│   ├── test_basic.py                # 基础测试脚本
│   ├── test_simple.py               # 简化测试脚本
│   └── create_weigh_bill_template.py # 配置助手
│
├── 文档目录
│   ├── README.md                    # 本文件
│   ├── 5分钟上手.md
│   ├── Web版快速开始.md
│   ├── Web部署指南.md
│   ├── Web版说明.md
│   ├── 多格式榜单使用指南.md
│   ├── 磅单使用说明.md
│   ├── 快速开始.md
│   ├── 使用说明.md
│   ├── 更新说明.md
│   └── 测试报告.md
│
├── 数据目录（自动创建）
│   ├── templates/                   # 桌面版模板
│   ├── templates_db/               # Web版模板数据库
│   ├── output/                      # 处理后的图片
│   ├── uploads/                     # 上传的图片
│   ├── static/                      # Web静态文件
│   └── test_batch/                  # 测试图片
│
└── 配置文件（自动创建）
    └── templates_config.json        # 模板配置
```

## 🎯 适用场景

### 场景1：单一格式榜单
```
创建1个模板 → 批量处理所有图片 → 完成
```

### 场景2：多种格式榜单
```
格式A → 创建模板A → 批量处理格式A图片
格式B → 创建模板B → 批量处理格式B图片
格式C → 创建模板C → 批量处理格式C图片
```

### 场景3：团队协作（Web版）
```
管理员：部署服务器 → 创建模板
业务人员：浏览器访问 → 批量处理
```

### 场景4：定期更新
```
第1次：创建所有模板（一次性工作）
第2次及以后：直接使用模板（重复使用）
```

## 💡 使用流程

### 桌面版流程

```
1. 启动程序（python main.py）

2. 创建模板
   - 进入「模板管理」
   - 上传榜单图片
   - 框选车牌区域
   - 保存模板

3. 批量处理
   - 进入「批量处理」
   - 选择图片
   - 选择模板
   - 输入新车牌号
   - 开始处理

4. 查看结果
   - 在「修改预览」查看
   - 保存处理后的图片
```

### Web版流程

```
1. 启动服务（python web_app.py）

2. 浏览器访问（http://localhost:5000）

3. 创建模板
   - 进入「模板管理」
   - 上传榜单图片
   - 框选车牌区域
   - 保存模板

4. 批量处理
   - 进入「批量处理」
   - 选择图片（可多选）
   - 选择模板
   - 输入新车牌号
   - 开始处理

5. 下载结果
   - 查看处理结果
   - 点击「下载」保存
```

## 🔧 安装要求

### 桌面版
- Python 3.7+
- PyQt5
- Pillow
- OpenCV
- NumPy

### Web版
- Python 3.7+
- Flask
- Pillow
- OpenCV
- NumPy

## 📊 版本对比

| 功能 | 桌面版 | Web版 |
|------|--------|-------|
| 安装方式 | 需要安装依赖 | 部署一次，多人使用 |
| 访问方式 | 本地程序 | 浏览器 |
| 用户限制 | 单用户 | 多用户 |
| 适用场景 | 个人使用、测试 | 团队协作、业务人员 |
| 启动速度 | 快 | 中等 |
| 处理速度 | 快 | 中等 |
| 管理难度 | 低 | 中等 |

## 🎓 学习路径

### 新手（推荐）
1. 阅读 `5分钟上手.md`
2. 运行 `start_web.bat` 启动Web版
3. 访问 http://localhost:5000
4. 创建第一个模板
5. 批量处理测试图片

### 中级用户
1. 阅读完整文档
2. 熟悉所有功能
3. 创建多个模板
4. 优化处理流程

### 高级用户
1. 部署到生产服务器
2. 配置Nginx反向代理
3. 启用HTTPS
4. 添加用户认证
5. 配置监控和日志

## ❓ 常见问题

### 通用问题

**Q：如何选择版本？**
A：个人用选桌面版，团队用选Web版。

**Q：能处理多少张图片？**
A：理论上无限制，建议每次不超过1000张。

**Q：支持哪些图片格式？**
A：支持 JPG、PNG、BMP 等常见格式。

**Q：模板可以重复使用吗？**
A：可以，创建一次后可以无限次使用。

### 桌面版问题

**Q：程序无法启动？**
A：检查Python版本，运行 `pip install -r requirements.txt`。

**Q：识别不到车牌号？**
A：使用手动标注（更准确），或调整识别参数。

### Web版问题

**Q：如何部署到服务器？**
A：参考 `Web部署指南.md`。

**Q：如何在局域网访问？**
A：修改 `web_app.py` 中的 `host='0.0.0.0'`，然后访问 `http://服务器IP:5000`。

**Q：如何启用HTTPS？**
A：参考 `Web部署指南.md` 中的SSL配置部分。

## 📞 技术支持

### 文档支持
- 查看相关文档（如 `Web部署指南.md`）
- 阅读测试报告了解系统状态

### 问题排查
1. 查看控制台输出
2. 检查日志文件（`logs/app.log`）
3. 验证配置文件（`templates_config.json`）

## 📝 更新日志

### v2.0 (当前版本)
- ✨ 新增Web版支持
- ✨ 多模板管理优化
- ✨ 界面交互改进
- ✨ 支持跨平台访问

### v1.0
- 🎉 初始版本
- 📦 基础模板功能
- 🤖 自动识别功能

## 📄 许可证

本项目仅供学习和个人使用。

## 🎉 开始使用

### 桌面版用户

```bash
# 安装依赖
pip install -r requirements.txt

# 启动程序
python main.py

# 或双击
start.bat
```

### Web版用户

```bash
# 安装依赖
pip install -r requirements_web.txt

# 启动服务
python web_app.py

# 浏览器访问
http://localhost:5000

# 或双击
start_web.bat
```

---

**推荐阅读**：
- 新手：`5分钟上手.md`
- Web版用户：`Web版快速开始.md`
- 部署人员：`Web部署指南.md`

**技术支持**：
- 文档：查看 `docs/` 目录
- 日志：`logs/app.log`

**立即开始**：双击 `start_web.bat` 启动Web版，或 `start.bat` 启动桌面版！