Photo Organizer - 照片批量整理工具

功能特性

• - ✅ 读取照片EXIF信息（拍摄时间、GPS地点等）
• ✅ 按时间自动分类（年/月文件夹结构）
• ✅ 按地点自动分类（如有GPS信息）
• ✅ 批量打标签
• ✅ 预览模式（先看效果再执行）
• ✅ 撤销操作（安全可靠）

安装

bash

方法一：通过clawhub安装

clawhub install photo-organizer

方法二：作为Python包安装

pip install photo-organizer

快速开始

1. 按时间整理照片

bash photo-organizer organize ./photos --by date --output ./organized

2. 按地点整理照片（需要GPS信息）

bash photo-organizer organize ./photos --by location --output ./organized

3. 预览模式（不实际执行）

bash photo-organizer organize ./photos --by date --preview

4. 撤销操作

bash photo-organizer undo ./organized

详细使用说明

整理模式

• - --by date：按拍摄时间整理（默认）
• --by location：按拍摄地点整理（需要GPS信息）

文件夹结构

默认按时间整理的文件夹结构：

organized/
├── 2026/
│ ├── 03/
│ │ ├── photo_001.jpg
│ │ └── photo_002.jpg
│ └── 04/
└── 2025/

配置文件

可在项目根目录创建.photo-organizer.json： json { output_dir: ./organized, folder_structure: {year}/{month}, auto_tag: true, backup_original: true }

示例场景

场景1：整理手机照片

bash

将DCIM文件夹中的照片按时间整理

photo-organizer organize ./DCIM --by date --output ./my-photos

场景2：旅行照片整理

bash

将旅行照片按地点整理（如有GPS）

photo-organizer organize ./trip-photos --by location --output ./trip-by-place

注意事项

• - 确保拥有照片的读写权限
• 建议先用--preview预览效果
• 大量照片整理可能需要一些时间
• 整理前建议先备份原照片

更新日志

v0.1.0 (2026-03-06)

• - 初始版本发布
• 支持按时间整理
• 支持预览模式
• 支持撤销操作