# 道路损伤检测系统 v2.2 - 改进版

## 版本信息
- **版本号**: v2.2
- **发布日期**: 2024年12月19日
- **系统类型**: 改进版道路损伤检测系统

## 🚀 核心功能

### 🔍 智能检测引擎
- **动态模型识别**: 自动识别模型类型并优化检测参数
- **自适应置信度调整**: 根据检测场景动态调整置信度阈值
- **多尺度检测**: 支持不同尺寸目标的精确检测
- **检测质量过滤**: 自动过滤低质量检测结果

### 📊 纯中文标注系统 (v2.2新增)
- **纯中文标注**: 标注框只显示中文类别名称，更符合中文用户习惯
- **智能类别映射**: 自动将英文类别映射为中文，支持部分匹配和组合词
- **动态颜色分配**: 根据类别自动分配识别颜色
- **置信度可视化**: 标注框粗细反映检测置信度
- **高质量字体渲染**: 支持中文字体显示

### 🗂️ 智能文件夹管理 (v2.2新增)
- **按需创建文件夹**: 只为检测到目标的类别创建文件夹
- **避免空文件夹**: 不生成无用的空文件夹，节省存储空间
- **优化存储策略**: 只保存标注后的图片，减少50%存储占用

### 🛠️ 技术改进
- **智能模型分析**: 动态解析模型类别信息
- **自适应检测算法**: 根据检测质量动态调整参数
- **动态类别映射**: 支持多种模型的类别映射
- **增强的错误处理**: 更好的异常处理和日志记录

## 文件结构

### 核心程序文件
- `run_improved_detection.py` - 改进版主程序
- `detector.py` - 核心检测器
- `batch_detector.py` - 批量检测器
- `config.py` - 配置管理
- `app.py` - Web界面程序

### 启动脚本
- `简易启动.bat` - 简化启动脚本（推荐）
- `start_improved_detection.bat` - 完整功能启动脚本
- `start_web_app.bat` - Web界面启动脚本
- `install.bat` - 环境安装脚本

### 文档文件
- `README_改进版.md` - 技术文档
- `客户端使用指南.md` - 详细使用说明
- `使用说明_图解版.md` - 图解使用指南
- `VERSION.md` - 版本信息（本文件）

### Web界面
- `templates/` - HTML模板文件
- `static/` - 静态资源文件

### 数据文件夹
- `input_videos/` - 输入视频文件夹
- `models/` - 检测模型文件夹
- `output_frames/` - 检测结果输出文件夹
- `logs/` - 系统日志文件夹

## 使用方法

### 快速开始
1. 双击 `简易启动.bat` 启动系统
2. 将视频文件放入 `input_videos` 文件夹
3. 按照提示选择模型和参数
4. 开始检测并查看结果

### Web界面
1. 双击 `start_web_app.bat` 启动Web服务
2. 在浏览器中访问 http://localhost:5000
3. 通过图形界面进行操作

## 系统要求
- **Python**: 3.8 或更高版本
- **内存**: 建议 8GB 以上
- **存储**: 建议 10GB 可用空间
- **GPU**: 可选，NVIDIA GPU 可加速检测

## 支持的格式
- **视频格式**: .mp4, .avi, .mov, .mkv, .wmv, .flv, .webm
- **模型格式**: .pt (PyTorch YOLO模型)

## 📅 更新历史

### v2.2 (2024年12月19日)
- 🏷️ **纯中文标注**: 标注框只显示中文类别名称
- 🧠 **智能类别映射**: 扩展中英文映射词典，支持智能匹配
- 🗂️ **智能文件夹管理**: 只生成检测到目标的类别文件夹
- 💾 **优化存储策略**: 只保存标注图片，减少50%存储占用
- 🔧 **改进匹配算法**: 支持完全匹配、部分匹配和组合词处理
- 📝 **用户体验优化**: 更符合中文用户使用习惯

### v2.1 (2024年12月)
- 🔍 实现动态模型识别功能
- 🎯 添加自适应置信度调整
- 🏷️ 改进标注显示效果
- 🧠 增强多场景检测能力
- 📊 添加检测质量过滤
- 🛠️ 优化系统架构和性能
- 📚 完善文档和使用指南

### v2.0
- 新增Web界面
- 优化检测算法
- 改进用户体验
- 增加批量处理功能

### v1.0
- 初始版本发布
- 基础检测功能
- 命令行界面

## 技术支持
- 查看详细文档：`客户端使用指南.md`
- 图解说明：`使用说明_图解版.md`
- 技术文档：`README_改进版.md`
- 系统日志：`logs/` 文件夹

---

**注意**: 本系统仅供学习和研究使用，检测结果仅供参考，实际应用请结合专业判断。