本地模糊图片与高清图片匹配替换工具

本地模糊图片与高清图片匹配替换工具使用说明

image_matcher.exe - 图片匹配工具

功能概述

使用多线程和GPU加速计算图片特征值自动匹配模糊图片对应的高清版本，支持批量处理和结果可视化。

核心功能：

• 多线程和GPU加速计算图片特征值
• 自定义相似度阈值和哈希大小
• 支持文件名正则过滤
• 生成交互式HTML报告,方便人工检查匹配结果
• 失败匹配重试功能
• 实时进度显示

参数说明

参数 说明 默认值 --clear (必需) 高清图片目录路径 - --blur (必需) 模糊图片目录路径 - --threshold 哈希差异阈值(0-64，越小越严格) 15 --hash_size 哈希大小(8-32，越大越精确) 16 --recursive 递归搜索子目录 False --extensions 图片扩展名(逗号分隔) .png,.jpg,.jpeg --regex 文件名正则过滤模式 None --output_dir 输出目录 results --retry 错误匹配JSON文件路径(用于重试) None --no_multiprocessing 禁用多进程加速 False

使用示例

1. 基本匹配：

image_matcher.exe --clear ./高清图片 --blur ./模糊图片

2. 递归搜索并设置严格阈值：

image_matcher.exe --clear ./clear --blur ./blur --recursive --threshold 10

3. 重试失败匹配：

image_matcher.exe --clear ./clear --blur ./blur --retry matching_errors.json

输出结果

• results_YYYYMMDDHHMMSS.html - 交互式HTML报告
• results_YYYYMMDDHHMMSS.txt - 文本格式匹配结果
• image_matching.log - 运行日志

HTML报告功能

1. 图片点击放大查看，支持缩放和拖动
2. 批量选择和导出匹配结果
3. 按成功/失败筛选图片
4. 显示相似度百分比
5. 保留原始路径信息

image_replacer.exe - 图片替换工具

功能概述

根据匹配结果自动用高清图片替换模糊图片，保持原文件名和格式。

核心功能：

• 自动转换图片格式(JPG/PNG等)
• 可选备份原始文件
• 支持模拟运行测试
• 静默模式减少输出
• 进度条显示处理状态

参数说明

参数 说明 默认值 --matches (必需) 匹配结果JSON文件路径 - --no_backup 不备份原始文件 False --dry_run 模拟运行，不实际替换 False --quiet 静默模式，减少输出 False

使用示例

1. 实际替换(自动备份):

image_replacer.exe --matches success_matches_20230415.json

2. 模拟运行测试:

image_replacer.exe --matches matches.json --dry_run

3. 静默模式运行:

image_replacer.exe --matches matches.json --quiet

输出结果

• backup/ - 原始文件备份目录(除非禁用备份)
• image_replacement.log - 运行日志

技术细节

1. 自动处理格式转换：当高清和模糊图片格式不同时自动转换
2. 保持原文件名：确保网页引用不受影响
3. 原子操作：先转换到临时文件，再替换原文件
4. 支持多种匹配文件格式：兼容image_matcher生成的多种JSON格式

工作流程示意图

1. 使用image_matcher.exe生成匹配结果
2. 检查HTML报告确认匹配准确性
3. 使用image_replacer.exe执行替换

最佳实践建议

• 首次运行时使用--dry_run参数测试
• 处理前备份重要图片
• 从较小阈值(如10)开始，逐步增加直到获得满意结果
• 使用HTML报告手动验证关键图片
• 批量操作前先用小样本测试

程序运行截图

下载地址:https://wwed.lanzout.com/inxDs2souamh 密码:3wez