Phockup：开源照片智能整理工具全指南

在数字摄影普及的今天，每个人的设备中都存储着大量照片和视频。如何高效管理这些媒体文件，避免杂乱无章的存储状态？Phockup作为一款专注于照片自动分类的开源工具，通过智能识别媒体文件元数据，实现按时间维度批量整理的核心功能。本文将从功能解析、快速上手到高级配置，全面介绍这款工具如何解决媒体文件管理痛点。

一、核心功能解析：如何实现智能整理？

1.1 时间维度自动分类：让文件管理回归时间线

Phockup的核心价值在于其基于EXIF信息和文件属性的智能排序能力。通过解析照片和视频的拍摄时间元数据，工具能自动将文件按"年/月/日"层级结构组织。这种方式特别适合解决多年积累的媒体文件混乱问题，让用户能快速定位特定时期的照片。核心时间解析逻辑实现于src/date.py，通过多源数据比对确保时间准确性。

1.2 多格式批量处理：如何应对复杂媒体类型？

无论是JPG、PNG等图片格式，还是MP4、MOV等视频文件，Phockup都能统一处理。工具通过src/exif.py模块提取不同类型文件的元数据，即使是缺失EXIF信息的文件，也能通过文件名解析或文件创建时间进行分类。这种灵活的处理机制，解决了不同设备拍摄文件格式不一的整理难题。

二、快速上手流程：3步完成批量处理

2.1 环境准备：如何搭建运行环境？

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ph/phockup
2. 进入项目目录：cd phockup
3. 安装依赖：pip install -r requirements.txt

⚠️ 注意事项：确保系统已安装Python 3.6+环境，Linux系统可能需要额外安装exiftool依赖。

2.2 基础使用：零配置如何启动整理？

最简化的使用方式只需指定源目录和目标目录：

python phockup.py /path/to/source /path/to/destination

工具将自动分析源目录中所有媒体文件，按默认规则在目标目录创建"YYYY/MM/DD"结构的文件夹并完成文件整理。

2.3 常见问题：为何部分文件未按预期分类？

• 检查文件是否包含有效EXIF信息
• 确认文件名是否包含可解析的日期格式
• 对于无时间信息的文件，将按文件创建时间归类

💡 实用技巧：使用--dry-run参数可预览整理效果而不实际移动文件，适合首次使用时验证规则。

三、高级配置指南：如何定制整理规则？

3.1 命名规则自定义：关键参数如何影响结果？

通过--filename参数可自定义输出文件名格式，支持的占位符包括：

• {YYYY}：四位数年份
• {MM}：两位数月份
• {DD}：两位数日期
• {HH}：24小时制小时
• {mm}：分钟
• {ss}：秒
• {original}：保留原始文件名

示例：--filename "{YYYY}{MM}{DD}_{HH}{mm}{ss}"将生成类似"20231015_143022.jpg"的文件名。

3.2 目录结构调整：默认与自定义方案对比

方案	结构示例	适用场景
默认结构	YYYY/MM/DD	时间线清晰，适合个人照片库
月度聚合	YYYY-MM	减少层级，适合浏览需求
自定义深度	YYYY/MM	平衡层级与浏览效率

通过--depth参数可调整目录深度，如--depth 2将创建"YYYY/MM"结构。

3.3 高级选项：如何处理特殊文件？

• 重复文件处理：--link-duplicates参数可创建硬链接而非复制文件
• 原始文件保留：--keep-original选项在整理后保留源文件
• 排除模式：--exclude "*.txt"可排除非媒体文件

核心参数解析逻辑实现于src/phockup.py，通过模块化设计支持灵活扩展。

Phockup作为一款轻量级开源工具，以其简洁的设计和强大的功能，为媒体文件管理提供了高效解决方案。无论是个人用户整理手机相册，还是专业摄影师处理大量素材，都能通过其灵活的配置满足多样化需求。通过本文介绍的功能解析和操作指南，相信你已掌握这款工具的核心使用方法，开始体验智能整理带来的高效与便捷。