Agent Skills
返回列表
🤖

photo-cli 本地照片库归档整理

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/archive-and-reorganize-local-photo-libraries-with-photo-cli。

技能介绍

要解决什么问题

本地照片库往往在多年累积后变得混乱：照片散落在不同磁盘、不同相机或手机导出的目录里，文件名没有规律，IMG_20230101_0001.jpg 这样的默认命名让你无法快速判断内容。手动整理既耗时又容易出错，而迁移到 iCloud、Google Photos 等托管平台又意味着放弃本地控制权，还要承担订阅和隐私成本。

技能如何工作

这个技能围绕 photo-cli 展开，它是一款命令行照片库管理工具，适合 agent 在需要规范化本地照片存档时调用。核心流程分三步：

  1. 读取拍摄元数据：解析每张照片的 EXIF 信息，包括拍摄时间、相机型号、光圈快门等，以拍摄时间作为重排的主要依据。
  2. 反向地理编码：如果照片包含 GPS 坐标，工具会将坐标转换为可读的位置信息，帮助你按地点而非随机的文件路径归类。
  3. 重建文件夹结构：按日期范围或自定义相册名重建目录，输出成一个整洁的照片存档，并生成 photo-cli.db SQLite 数据库来记录归档后的映射关系，方便后续检索与审计。

适用边界与注意点

  • 技能仅处理本地文件，不涉及任何云端同步，适合离线或内网环境使用。
  • 归档完成后的目录必须保留 photo-cli.db，否则后续维护时会丢失文件与新结构的对应关系。
  • 源照片库需要可读权限，目标存储空间需要提前规划，重排操作本质上是复制/软链接而非无损变换，请先备份。
  • 对没有拍摄时间戳的极老照片，工具会退化为依赖文件系统时间，归类结果可能不够精确。

使用场景

  • 多台相机与手机的导出目录混在一起，需要按拍摄时间与 GPS 位置重新归入相册，全程只在本地磁盘完成。
  • 接手客户交付的原始照片盘，文件名全是 IMG_ 开头，要按日期范围拆成结构化存档，供后期团队按地点检索。
  • 想把家庭照片从多个外接硬盘合并成一套目录，但不想上传到任何云端平台，需要保留 photo-cli.db 以便日后追溯。
  • 老照片目录里混杂了带 GPS 与不带 GPS 两类文件，需要分别按地点和时间归入不同相册。

适合人员

  • 独立摄影师：跨多年、跨多台设备的数万张原片需要一套完全本地运行的归档流程。
  • 影像后期工作室的整理专员：客户硬盘命名混乱，要按日期与地点快速产出可检索的存档目录。
  • 重视隐私的个人用户：想把家庭照片整理成结构化目录，但拒绝上传到托管平台。
  • 搭建自动化工作流的开发者：希望 agent 直接调用命令行工具读取元数据并重建目录结构。