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

解决照片混乱的终极方案

"旅行回来相机里500张照片散成一团，重要瞬间淹没在数字垃圾中？" Phockup 用技术魔法解决这个难题——它像一位专业档案管理员，自动识别照片的"数字身份证"（元数据解析），按时间轴线为你的回忆建造井然有序的"档案馆"。作为开源照片整理工具中的佼佼者，Phockup 凭借三大核心优势脱颖而出：跨平台兼容性让它能在任何操作系统上施展拳脚，无配置启动设计让新手也能秒上手，而灵活的定制规则又能满足专业用户的高阶需求。

3步极速启动照片整理

环境准备：5分钟搭建工作间

📌 第一步：获取工具

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

💡 确保系统已安装Python 3.6+和exiftool（元数据解析引擎），就像给工具配备了"照片解读眼镜"。

核心命令：一行代码搞定整理

📌 第二步：执行整理

python phockup.py ~/DCIM ~/Photos  #️⃣1基础命令格式

这个命令包含两个关键参数：

• ~/DCIM【源目录】：相机存储卡或混乱照片所在位置
• ~/Photos【目标目录】：整理后照片的新家

💡 为什么这样设计？Phockup采用"无侵入式"架构，原始文件默认保持不动（复制模式），让你无需担心操作风险。

效果验证：见证秩序诞生

📌 第三步：检查成果
打开目标目录，你会发现所有照片已按"年/月/日"结构自动归档：

Photos/
├── 2023/
│   ├── 05/
│   │   └── 12/
│   │       └── 20230512-143022.jpg  #️⃣按拍摄时间命名
│   └── 06/
└── unknown/  #️⃣无日期信息的照片

💡 找不到日期的照片会被统一放到"unknown"文件夹，就像图书馆里的"待分类区"。

构建个性化整理规则

基础配置：核心参数解析

参数	作用	类比说明
--move	移动文件而非复制	相当于"剪切-粘贴"操作
--link	创建硬链接	给照片创建"分身"，修改任一文件都会同步变化
--original-filenames	保留原文件名	让"DSC_0001.jpg"继续使用原名
--dir-format "%Y-%m-%d"	自定义目录格式	把"年/月/日"改为"年月日"的紧凑格式

场景化配置模板

家庭相册场景

python phockup.py ~/相机 ~/家庭相册 \
  --original-filenames \  #️⃣保留孩子成长的系列照片原名
  --dir-format "%Y年/%m月"  #️⃣用中文月份更符合长辈阅读习惯

专业摄影场景

python phockup.py ~/RAW ~/作品集 \
  --move \  #️⃣处理完源文件可删除
  --date-field "CreateDate" \  #️⃣指定使用创建日期而非修改日期
  --dir-format "%Y/%m-%B"  #️⃣生成"2023/05-五月"这样的专业目录

旅行照片场景

python phockup.py ~/旅行 ~/环球之旅 \
  --output-prefix "Europe2023-" \  #️⃣添加行程前缀
  --date-regex "IMG_(\d{8})"  #️⃣从文件名提取日期（如IMG_20230512）

功能模块解析

Phockup的内部架构如同精密钟表，各模块协同工作：

• 元数据解析引擎「功能实现→src/exif.py」：像海关检查护照一样读取照片的EXIF信息，提取拍摄日期、设备型号等关键数据。核心函数Exif.data()通过调用系统exiftool获取原始数据，再进行结构化处理。

• 日期处理中心「功能实现→src/date.py」：相当于照片的"时间翻译官"，能从EXIF、文件名、XMP等多种来源推断拍摄日期。Date.from_exif()方法会依次检查DateTimeOriginal、CreateDate等字段，确保找到最准确的时间戳。

• 文件操作中枢「功能实现→src/phockup.py」：负责文件的复制/移动/链接操作，process_file()方法处理重名冲突（自动添加序号）、重复文件检测等复杂逻辑，确保文件安全转移。

常见误区解析

误区1：盲目使用--move参数

危险操作：python phockup.py /SDCard /Photos --move
⚠️ 风险：SD卡文件可能因中途断电导致永久丢失
✅ 正确做法：先使用默认复制模式，验证结果无误后再用--move

误区2：忽略XMP文件

问题：整理RAW照片时只移动了.CR2文件，丢失后期编辑信息
💡 解决方案：Phockup会自动检测并处理同名XMP文件，但需确保原始文件和XMP在同一目录

误区3：过度依赖日期正则

错误示例：--date-regex "(\d{4})(\d{2})(\d{2})"
⚠️ 问题：错误的正则可能错误解析文件名（如"IMG20230512.jpg"会被正确识别，但"20230512_holiday.jpg"可能失败）
✅ 正确做法：使用--dry-run参数先测试正则效果：
python phockup.py ~/test ~/output --date-regex "..." --dry-run

Phockup用技术简化记忆管理，让你专注于创作而非整理。无论是家庭用户的日常照片，还是专业摄影师的工作流，这个开源工具都能成为数字生活的"秩序守护者"。现在就用git clone命令开启你的照片整理之旅吧！