120 lines
4.4 KiB
Markdown
120 lines
4.4 KiB
Markdown
# Kenaito Wallpaper Organizer 🖼️
|
||
|
||
一个自动扫描、分析并归类壁纸的命令行工具。它会递归扫描指定目录下的所有图片,分析每张图的**明暗程度**,并按**明暗等级 → 方向 → 分辨率**进行分类归档(移动或复制)。
|
||
|
||
## 功能特性
|
||
|
||
- **智能明暗分析**:基于 ITU-R BT.601 亮度公式,同时统计暗色像素(亮度 < 80)与亮色像素(亮度 > 175)占比
|
||
- **五级明暗分类**:暗色 `dark_95/85/75/65/55` 与亮色 `bright_95/85/75/65/55` 五档归档
|
||
- **方向区分**:横屏 `horizontal` / 竖屏 `vertical` / 方形 `square` 子目录
|
||
- **分辨率分档**:按长边区分 1K~8K 子目录
|
||
- **特殊归置**:过小图(`fixed`)、分辨率不足(`other`)、异常文件(`error`)
|
||
- **多格式支持**:JPG、PNG、GIF、BMP、WebP、TIFF
|
||
- **并发处理**:默认 24 线程并行分析,大图自动采样加速
|
||
- **UUID 命名**:归档后的文件统一重命名为随机 UUID,不保留原文件名
|
||
|
||
## 编译
|
||
|
||
```bash
|
||
# Linux / macOS
|
||
go build -o kenaito-wallpaper-organizer main.go
|
||
|
||
# Windows
|
||
go build -o kenaito-wallpaper-organizer.exe main.go
|
||
```
|
||
|
||
或使用构建脚本:
|
||
|
||
```bash
|
||
bash build.sh
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 在壁纸目录下运行（默认移动模式，等待5秒确认）
|
||
cd ~/Pictures/wallpapers
|
||
./kenaito-wallpaper-organizer
|
||
|
||
# 用复制模式试运行（不会移动原文件）
|
||
./kenaito-wallpaper-organizer -copy -sleep 0
|
||
```
|
||
|
||
执行后,源目录下会生成如下结构:
|
||
|
||
├── wallpapers_wallpapers/
|
||
│ ├── dark_95/
|
||
│ │ ├── horizontal/ → 1K/ 2K/ 4K/ …
|
||
│ │ ├── vertical/ → 1K/ 2K/ 4K/ …
|
||
│ │ └── square/ → 1K/ …
|
||
│ ├── bright_95/ # 与 dark_ 同构
|
||
│ ├── neutral/ # 明暗皆不达标但尺寸合格
|
||
│ ├── fixed/ # 长边 < 1080 的过小图
|
||
│ ├── other/ # 尺寸不足 min-width/min-height
|
||
│ └── error/ # 大小超限或解码失败的异常文件
|
||
```
|
||
|
||
## 命令行参数
|
||
|
||
| 参数 | 类型 | 默认值 | 说明 |
|
||
|------|------|--------|------|
|
||
| `-source` | string | `.` | 源目录路径，递归扫描该目录下所有图片 |
|
||
| `-target` | string | 自动生成 | 目标目录基名，留空自动使用 `<源目录名>_wallpapers` |
|
||
| `-min-width` | int | `1080` | 图片最小宽度（像素），低于此值进入 other |
|
||
| `-min-height` | int | `720` | 图片最小高度（像素），低于此值进入 other |
|
||
| `-min-size` | int | `100` | 最小文件大小（KB），小于此值进入 error |
|
||
| `-max-size` | int | `100` | 最大文件大小（MB），大于此值进入 error |
|
||
| `-copy` | bool | `false` | 复制模式，设为 true 则复制原文件而非移动 |
|
||
| `-parallel` | int | `24` | 并发分析线程数 |
|
||
| `-verbose` | bool | `true` | 详细输出，显示每个文件的处理过程 |
|
||
| `-sleep` | int | `5` | 执行前等待秒数，设为 0 则立即执行，等待期间可按 Ctrl+C 取消 |
|
||
|
||
## 使用示例
|
||
|
||
```bash
|
||
# 扫描指定目录
|
||
./kenaito-wallpaper-organizer -source ~/Downloads/wallpapers
|
||
|
||
# 复制模式（保留原文件不动）
|
||
./kenaito-wallpaper-organizer -source ~/Pictures -copy
|
||
|
||
# 跳过等待，直接执行
|
||
./kenaito-wallpaper-organizer -sleep 0
|
||
|
||
# 只要 4K 以上壁纸
|
||
./kenaito-wallpaper-organizer -min-width 3840 -min-height 2160
|
||
|
||
# 高配机器，关闭详细输出加速
|
||
./kenaito-wallpaper-organizer -parallel 48 -verbose=false
|
||
```
|
||
|
||
## 分类优先级
|
||
|
||
1. **fixed**：长边 < 1080 的过小图片
|
||
2. **other**：尺寸达标(≥1080)但低于 `min-width/min-height` 阈值的图片
|
||
3. **dark_N**(从高到低,每张只归入最高档)
|
||
4. **bright_N**(同理,处理完 dark 后剩余图中再判亮色档)
|
||
5. **neutral**：上面均未命中的图片
|
||
6. **error**：文件大小超限或解码失败的异常文件
|
||
|
||
所有正常分类(dark/bright/neutral/other)内部均按 方向 → 分辨率 分子目录。
|
||
|
||
## 明暗评分算法
|
||
|
||
```
|
||
brightness = 0.299×R + 0.587×G + 0.114×B (ITU-R BT.601)
|
||
darkScore = 亮度 < 80 的像素占比
|
||
lightScore = 亮度 > 175 的像素占比
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 默认使用**移动**模式,原文件会从源目录移走,首次使用建议加 `-copy` 试运行
|
||
- 目标目录会被自动跳过,不会重复处理之前已整理的文件
|
||
- UUID 命名,极端情况下重名会自动追加 `_(1)`、`_(2)` 等序号
|
||
- 支持的图片格式依赖 Go 标准库 + `golang.org/x/image`:JPG、PNG、GIF、BMP、WebP、TIFF
|
||
|
||
## License
|
||
|
||
MIT
|