告别文件混乱：Phockup的智能媒体整理解决方案

面对日益增长的照片和视频文件，你是否常常陷入查找困难、分类混乱的困境？Phockup作为一款专注于媒体文件整理的开源工具，能够自动按时间维度（年/月/日）组织文件，让你的数字记忆井然有序。本文将从痛点分析到实际应用，全面介绍这款工具如何通过智能识别和安全处理，帮助普通用户轻松管理媒体文件库。

🔍 为何你的媒体文件需要智能整理

现代生活中，我们的手机、相机和云存储中积累了大量媒体文件。这些文件往往以随机数字命名，散落在不同文件夹中，导致：

• 查找特定时刻的照片需要翻阅大量文件
• 重复备份占用宝贵存储空间
• 重要回忆因文件混乱而难以快速回顾

Phockup通过自动化的时间分类系统，从根本上解决这些问题。它能够读取照片的EXIF元数据和视频的创建信息，将文件精准归类到对应时间文件夹，同时保持原始文件完好无损。

🚀 核心价值：让整理变得简单高效

智能时间识别技术

Phockup内置强大的日期解析引擎，能够从多种来源获取文件创建时间：

• EXIF数据：直接读取照片的拍摄时间戳
• 文件名分析：识别如"IMG_20231005.jpg"这样的时间格式
• 文件属性：当元数据缺失时使用系统修改时间
• 附属文件：自动关联XMP等元数据文件，确保信息完整

对于无法识别时间的文件，系统会统一归类到"unknown"文件夹，避免遗漏任何文件。

安全无损的处理机制

与传统的文件移动方式不同，Phockup采用复制+硬链接的混合处理模式：

• 首次处理时创建文件副本，保护原始数据
• 重复文件仅创建硬链接，节省存储空间
• 所有操作在输出目录进行，源文件保持不变

这种设计让你可以在确认整理结果无误后，再决定是否删除原始文件，彻底消除操作风险。

💻 快速上手：两种安装方式任你选

🔧 Docker一键部署（推荐新手）

使用Docker可以跳过环境配置步骤，直接运行：

docker run -v ~/Pictures:/mnt ivandokov/phockup:latest /mnt/input /mnt/output

只需将命令中的~/Pictures替换为你的媒体文件目录，工具会自动在该目录下创建input（源文件）和output（整理结果）文件夹。

🔧 手动安装步骤

如果你需要更灵活的配置，可以选择手动安装：

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/ph/phockup

2. 进入项目目录并安装依赖：

cd phockup
pip install -r requirements.txt

3. 基本使用命令：

python phockup.py 输入目录路径 输出目录路径

🏠 场景应用：让整理融入生活

家庭照片库整理

假设你有一个存放多年照片的~/FamilyPhotos目录，使用Phockup整理后会得到清晰的时间线结构：

输出目录/
├── 2024/
│   ├── 05/
│   │   ├── 20240512_103022.jpg  # 女儿生日
│   │   └── 20240520_164510.mp4  # 家庭旅行
├── 2023/
│   └── 12/
│       └── 20231225_091500.jpg  # 圣诞节聚会
└── unknown/
    └── IMG_0001.jpg  # 无法识别时间的旧照片

摄影爱好者工作流

专业摄影师可以将Phockup集成到后期工作流中：

1. 从相机导入原始文件到/raw目录
2. 运行Phockup整理到/sorted目录
3. 在整理后的目录中进行筛选和编辑
4. 最终作品归档到/final目录

这种结构化处理方式大幅减少了查找素材的时间成本。

💡 进阶技巧：释放工具全部潜力

自定义日期格式

默认情况下，Phockup使用YYYY/MM/DD的目录结构，你可以通过参数自定义格式：

# 按季度整理：YYYY/QQ/DD
python phockup.py input output -d "%Y/%q/%d"

支持的格式占位符可参考项目文档中的日期格式说明。

处理特殊文件

面对名称包含特殊字符或非常规格式的文件，Phockup同样应对自如：

• 自动转义特殊字符，避免文件命名错误
• 支持视频文件（MP4、MOV等）的时间识别
• 保留文件元数据和附属文件（如XMP、THM）

自动化定期整理

通过系统定时任务实现自动整理：

1. 创建整理脚本organize_media.sh：

#!/bin/bash
python /path/to/phockup.py ~/Downloads ~/MediaLibrary

2. 添加到crontab（每周日凌晨2点执行）：

0 2 * * 0 /path/to/organize_media.sh

⚠️ 使用注意事项

• 测试先行：首次使用时建议先用少量文件测试，确认结果符合预期
• 空间检查：确保目标磁盘有足够空间，整理过程会创建文件副本
• 备份重要文件：虽然Phockup不会修改源文件，但重要数据仍建议提前备份
• 定期更新：通过git pull保持工具为最新版本，获取新功能和bug修复

Phockup通过简单直观的设计，将复杂的媒体整理过程简化为几个步骤。无论是普通用户整理家庭照片，还是专业人士管理素材库，这款工具都能显著提升文件管理效率，让你专注于创造和回忆，而非整理文件。

详细参数和高级功能说明可参考项目根目录下的readme.md文件。