Photo Organizer

照片批量整理工具，支持按时间、地点自动分类和打标签。适用于手机照片整理、相册归档等场景，帮助用户快速整理成千上万张照片！

Security Scan

The skill is internally consistent with a local photo-organizer utility: it reads images, uses EXIF when available, copies files into an organized folder and saves a local backup mapping; there is no network activity or secret access requested.

Purpose & Capability

Name/description match the code's core behavior (organize by date/location, preview, undo). However the docs advertise extra features (batch tagging, GPS->place name conversion, config file options) that are not implemented in the shipped photo_organizer.py — an overpromise but not evidence of malicious behavior.

Instruction Scope

SKILL.md instructs running the CLI on local directories and to use --preview first; the code only accesses the specified input/output directories and writes a local backup JSON. Instructions do not request unrelated files, environment variables, or external endpoints.

Install Mechanism

There is no install spec in the registry bundle (instruction-only). README/SKILL.md suggest installing via pip or clawhub, but no install script is provided in this package. This mismatch is an implementation/documentation inconsistency but not a high-risk install mechanism.

Credentials

The skill requires no environment variables, no credentials, and does not access system-wide config. Its file I/O is limited to the user-specified input/output directories and a backup JSON in the output directory.

Persistence & Privilege

always is false and the skill does not request persistent privileges or modify other skills or system-wide agent settings. It stores a local backup mapping file in the output directory (expected behavior for undo).

Assessment

This skill appears to be a straightforward local photo organizer with no network exfiltration or secret access. Before installing/using: 1) test with a small copy of your photos and use --preview to verify results; 2) ensure you have backups of originals (the tool copies files but keep an independent backup); 3) note the documentation overpromises features (tagging, place-name resolution, config options) that the current script does not implement; 4) ensure Pillow is installed for EXIF support (HEIC/webp support may require additional libraries); and 5) be cautious running any tool on the original master photo library until you confirm behavior on a sample.

Photo Organizer - 照片批量整理工具

功能特性

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

安装

# 方法一：通过 clawhub 安装
clawhub install photo-organizer

# 方法二：作为 Python 包安装
pip install photo-organizer

快速开始

1. 按时间整理照片

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

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

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

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

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

4. 撤销操作

photo-organizer undo ./organized

详细使用说明

整理模式

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

文件夹结构

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

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

配置文件

可以在项目根目录创建 .photo-organizer.json：

{
  "output_dir": "./organized",
  "folder_structure": "{year}/{month}",
  "auto_tag": true,
  "backup_original": true
}

示例场景

场景 1：整理手机照片

# 将 DCIM 文件夹里的照片按时间整理
photo-organizer organize ./DCIM --by date --output ./my-photos

场景 2：旅行照片整理

# 将旅行照片按地点整理（如果有 GPS）
photo-organizer organize ./trip-photos --by location --output ./trip-by-place

注意事项

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

更新日志

v0.1.0 (2026-03-06)

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