tianfeng66 / image-toolbox

# 图片工具箱 · Image Toolbox
一个**单文件、纯本地**的图片整理工具：打开一个 HTML，就能在浏览器里对整个图片文件夹做评分筛选、查重、黑白边检测和小图清理。
不用安装任何软件，不联网也能用，图片全程只在你自己电脑的浏览器里处理，不会上传到任何地方。
## 功能
- **筛选评分工作台**：键盘逐张打分、归类，支持一审 / 二审 / 三审多轮评分，按分数导出整理好的文件夹副本，并可批量重命名。
- **旋转 / 裁剪**：纠正横竖屏、手动框选裁剪，直接写回原文件。
- **小图检查**：按体积范围找出偏小的图片，一键挪进 `_小图`。
- **查重**：SHA-256 精确去重 + 感知哈希相似查重（压缩、缩放、轻微调色后的近似图也能找到），按相似度分层、每组一行展示，第 1 列为建议保留。
- **黑边 / 白边检测**：严格检测边缘纯色且与画面有明显断层的死黑边 / 死白边，可按类型归档或自动裁切（PNG 无损）。
## 安全设计
- 所有整理动作都是**移动，不删除**：重复图进 `_重复图片`，黑白边图进 `_黑边` / `_白边` / `_黑白边`，小图进 `_小图`，裁切前的原图完整备份到 `_裁切备份`。
- 移动采用「先复制 → 校验内容一致 → 再删源」，校验不通过会保留原文件；目标位置重名时自动加后缀，不会覆盖。
- 每一步操作都会在 `_操作记录` 里写一份 CSV + JSON（原位置 → 现位置），可以事后复查；「撤销上一步」可以整批放回原位。
第一次使用，建议先复制一小份图片出来单独试一下。
## 怎么用
1. 下载 `图片工具箱-全功能版.html`，保存到本地（不要在压缩包或聊天软件里直接打开）。
2. 用**桌面版 Chrome 或 Edge** 打开。工具依赖 File System Access API，Safari、Firefox 目前不支持。
3. 点「选择主图片文件夹」，按浏览器提示授权读写。
详细操作见 图片工具箱-使用说明.txt，实现原理（查重算法、黑白边判定、文件移动与撤销的设计）见 图片工具箱-实现逻辑说明.md。
> 评分数据保存在浏览器本地（IndexedDB），不在 HTML 文件里。清理浏览器数据、换浏览器或换电脑都不会跟着走，评完请及时导出。
## 第三方组件
HTML 内嵌了以下开源库，版权归原作者所有：
- JSZip：MIT 或 GPLv3 双许可
- pako：MIT
## 许可证
MIT