Files

T

odboy 99b9460bcd feat(classify): 添加图片明暗分类功能

- 修改 ImageDir 函数增加 darkScore 和 lightScore 参数
- 实现 BrightnessName 函数计算明暗等级
- 定义暗色和亮色阈值等级数组
- 在 organize.go 中集成图片明暗分析逻辑
- 使用 ITU-R BT.601 公式计算像素亮度
- 为大图实现自动采样加速分析
- 更新 README.md 文档说明明暗分类算法
- 在目录结构中体现明暗等级命名规则

2025-03-29 21:11:14 +08:00

7.4 KiB

Raw Blame History

kenaito-media-picker

媒体分辨率分类整理工具：一键扫描目录下所有图片与视频，按横屏 / 竖屏 / 等比和分辨率自动归类到对应子目录。

功能特性

图片 / 视频 / 音频：扫描当前目录（递归），自动识别图片、视频与音频文件
标准分辨率归类：720P、1080P、2K、2.5K、影院 2K、DCI 4K、8K 及带鱼屏（UltraWide 2K/3K/4K）等标准规格单独建目录
非标分辨率归类：按像素区间（每 1024px 一档）自动归入 1K ~ 19K / 普通 / 原图（原画质）目录
方向区分：横屏、竖屏、等比（正方形）分开整理，GIF 单独处理
明暗分类：基于 ITU-R BT.601 亮度公式分析每张图片明暗程度，暗色（亮度 < 80）像素占比为 darkScore、亮色（亮度 > 175）像素占比为 lightScore，按主导分在目录名末尾追加 -dark_100 ~ -dark_55 / -bright_85 ~ -bright_15 明暗等级
音频归类：音频文件单独归入「音频」目录
异常兜底：读取失败、不支持的格式自动归入「读取异常」「已忽略」目录
自动整理：无需人工干预，扫描 → 分析 → 移动一次完成，跨磁盘自动降级为复制后删除
全格式支持：视频/音频以内嵌的 ffprobe（按系统自动内嵌 macOS/Windows 对应版本）作为最终判定依据，凡是 ffmpeg 支持的格式都能识别，不再依赖扩展名白名单
媒体信息入库：自动将文件的 MD5 与完整媒体信息（类型/宽高/时长/编码/容器等）存入根目录下的 media-info.db（SQLite，xorm 驱动），支持按字段查询与去重

支持的格式

类型	格式
图片	JPG / JPEG / JPE / JFIF / PNG / GIF / BMP / WEBP / PSB，PSD 单独归入「图片_PSD」；Go 无法解码的图片格式（如 TIFF）由 ffprobe 兜底
视频	凡 ffmpeg 支持的容器/编码均可识别（MP4 / MKV / AVI / MOV / TS / FLV / WMV / RM / RMVB / WEBM / M2TS 等），以 ffprobe 探测结果为准
音频	凡 ffmpeg 支持的音频（MP3 / WAV / FLAC / AAC / M4A / OGG / WMA 等）归入「音频」目录

判断依据：图片按文件 MIME + 扩展名识别（扩展名大小写不敏感）；视频/音频由 ffprobe 读取媒体流判定，支持范围与 ffmpeg 一致。

构建编译

sh build.sh

依赖 Go 1.19+（go.mod 指定 1.19）
每个平台构建时只内嵌本平台的 ffprobe：internal/probe/bin/ffprobe_mac（macOS）、internal/probe/bin/ffprobe.exe（Windows），需提前放置（未入库，见 .gitignore）
build.sh 按系统类型编译：Windows 下 go build 后使用 upx 压缩，输出 kenaito-media-picker.exe；macOS / Linux 直接构建，输出 kenaito-media-picker（不压缩）
编译所需工具（ffmpeg / upx）压缩包已放在 doc/ 目录，按需解压使用（upx 仅 Windows 构建时需要，放置于项目根目录 upx）

使用方法

# 双击有风险, 双击需谨慎
将 kenaito-media-picker.exe 拖拽到需要整理的文件夹内，双击运行即可

# 或命令行运行
kenaito-media-picker.exe

程序启动后有 5 秒倒计时，期间可 Ctrl+C 取消；倒计时结束后自动开始整理。

整理规则

执行后，会在当前目录生成一批以 UUID 开头命名的子目录，文件按规则移动（或复制）进去：

图片

{uid}-图片_横屏_720P-dark_100       ← 1280×720，暗色主导
{uid}-图片_横屏_1D5KP-dark_95       ← 1600×900
{uid}-图片_横屏_1080P-bright_85     ← 1920×1080，亮色主导
{uid}-图片_横屏_2DKP-dark_75        ← 2048×1080（影院 2K）
{uid}-图片_横屏_2D5KP-bright_65     ← 2560×1440（2.5K）
{uid}-图片_横屏_ultraWide2KP-dark_55  ← 2560×1080（带鱼屏）
{uid}-图片_横屏_ultraWide3KP-bright_45  ← 3440×1440（带鱼屏）
{uid}-图片_横屏_ultraWide4KP-dark_85  ← 5120×2160（带鱼屏）
{uid}-图片_横屏_4KP-bright_35       ← 3840×2160
{uid}-图片_横屏_4KHP-dark_65        ← 4096×2160（DCI 4K）
{uid}-图片_横屏_8KP-bright_25       ← 7680×4320
{uid}-图片_横屏_1K ~ 19K-bright_15  ← 非标规格按像素区间（每 1024px 一档）
{uid}-图片_横屏_普通-dark_100       ← 像素不足 1024
{uid}-图片_横屏_原图-bright_85      ← 像素 ≥ 20480
{uid}-图片_竖屏_...                  ← 竖屏按同样规则（普通 / 1K~19K / 原图）
{uid}-图片_等比_...                  ← 等比（正方形）按同样规则
{uid}-图片_GIF                      ← 所有 GIF 图片
{uid}-图片_PSD                      ← 所有 PSD 文件
{uid}-图片_读取异常                  ← 无法读取尺寸的图片
{uid}-图片_已忽略                    ← 不支持格式的图片

视频 / 音频

{uid}-视频_横屏_720P / 1080P / 2DKP / 2D5KP / 4KP / 4KHP / 8KP
{uid}-视频_横屏_UltraWide2KP / UltraWide3KP / UltraWide4KP
{uid}-视频_横屏_1k ~ 19k / 普通 / 原画质
{uid}-视频_竖屏_1k ~ 19k / 普通 / 原画质
{uid}-视频_等比_1k ~ 19k / 普通 / 原画质
{uid}-视频_横屏_GIF / 视频_竖屏_GIF / 视频_等比_GIF
音频                      ← 所有音频文件（ffmpeg 可识别的格式）
视频_读取异常              ← mime 为视频但 ffprobe 读取失败
视频_已忽略                ← 非媒体文件或无法识别

视频时长与分辨率通过内嵌 ffprobe 读取（处理时会临时释放到当前目录、完成后自动删除）；凡 ffmpeg 支持的视频/音频格式均可识别。

明暗评分算法

brightness = 0.299×R + 0.587×G + 0.114×B   (ITU-R BT.601)
darkScore  = 亮度 < 80 的像素占比
lightScore = 亮度 > 175 的像素占比

亮色主导（lightScore > darkScore）归 -bright_N，否则归 -dark_N；每张图必归亮暗之一。暗色档位 55/65/75/85/95/100，亮色档位 15/25/35/45/55/65/75/85，取评分命中的最高一档（不足最低档归最低档）。大图（>100 万像素）自动采样加速。

目录结构

├── main.go            # 程序入口（装配与编排）
├── internal/
│   ├── scanner/       # 文件扫描、MIME 读取、图片/媒体候选过滤
│   ├── probe/         # 媒体探测：图片尺寸 + ffprobe 解析 + 内嵌解码器释放
│   ├── classify/      # 纯函数归类规则（方向 + 标准分辨率 + K档 + 明暗等级）
│   ├── organize/      # 整理编排：探测→归类→收集→移动→记录去向
│   ├── mover/         # 文件移动（rename / 跨盘 copy+delete）
│   ├── store/         # SQLite 媒体信息持久化
│   └── digest/        # 文件 MD5 / 指纹采样
├── doc/               # 构建依赖（ffmpeg / upx 压缩包）
└── build.sh           # 编译脚本（upx 压缩）

注意事项

默认使用移动模式，原文件会从源目录移走；同名文件跨磁盘时自动降级为复制 + 删除
已整理文件全部移动到 {当前目录名}-picker 白名单目录内，重复运行会跳过该目录，并将新文件并入已有的分类目录
GIF 图片单独归入「图片_GIF」；GIF 视频按方向归入「视频_*_GIF」
ffprobe 按系统内嵌（macOS/Windows），运行前释放到当前目录、结束后自动删除；若当前平台无内嵌版本，视频/音频将不处理

License

Apache 2.0

7.4 KiB Raw Blame History Unescape Escape