Photo Toolkit — 照片工具包

Photo Toolkit 将相机RAW文件（NEF/CR2/CR3/ARW/RAF/ORF/DNG/...）、JPG照片和Apple HEIC/HEIF图像转换为JPG缩略图，按拍摄日期查找照片，并生成布局预览。 支持格式 相机RAW品牌扩展名 Nikon .nef, .nrw Canon .cr2, .cr3, .crw Sony .arw, .srf, .sr2 Fujifilm .raf Olympus/OM .orf Panasonic .rw2 Pentax .pef Samsung .srw Leica .rwl, .dng Adobe DNG .dng Hasselblad .3fr, .fff Phase One .iiq Sigma .x3f 标准图像格式扩展名 JPEG .jpg, .jpeg 直接使用Pillow处理 Apple（iPhone/iPad）格式扩展名 HEIC/HEIF .heic, .heif 需要使用pip install pillow-heif 依赖声明 文件：requirements.txt 首选venv：在运行脚本之前，激活项目根目录的虚拟环境（例如.venv/）。如果不存在，请先创建一个： # 创建venv并安装依赖项（推荐） python3 -m venv .venv source .venv/bin/activate pip install -r photo-toolkit/requirements.txt # 或使用技能的设置脚本（检查+安装） bash photo-toolkit/scripts/setup_deps.sh # 在每个会话之前激活venv source .venv/bin/activate 或者，可以全局安装： brew install libraw # macOS apt-get install libraw-dev # Debian/Ubuntu dnf install LibRaw-devel # RedHat/CentOS/Fedora pip3 install -r photo-toolkit/requirements.txt 验证： python3 -c "import rawpy; from PIL import Image; import numpy; print(' Core dependencies installed')" python3 -c "from pillow_heif import register_heif_opener; print(' HEIC/HEIF support available')" 2>/dev/null || echo " HEIC/HEIF support not installed (optional: pip install pillow-heif)" 配置 将config.example.toml复制到config.toml并编辑以设置您的目录。请参阅config.example.toml以获取所有可用选项。 脚本

• convert.py — 照片 → JPG 缩略图

支持RAW、JPG和HEIC/HEIF输入。默认情况下，缩略图输出到{input}/thumbnails/。 # 将所有照片文件转换为缩略图（输出到~/data/RAW/thumbnails/） python3 scripts/convert.py ~/data/RAW # 自定义设置 python3 scripts/convert.py ~/data/RAW ~/data/output/thumbnails --size 2048 --quality 95 # 从stdin读取文件列表（从find_by_date.py管道） python3 scripts/find_by_date.py --date today ~/data/RAW | \ python3 scripts/convert.py --from-stdin # 带报告输出 python3 scripts/convert.py ~/data/RAW --report /tmp/convert_report.json # 干跑 python3 scripts/convert.py ~/data/RAW --dry-run 选项描述默认值 input 照片文件或目录从config中获取 output_dir 输出目录{input}/thumbnails/ --size 最大缩略图尺寸（px）1200 --quality JPEG质量（1-100）85 --workers 并行工作者自动（最大8） --recursive 搜索子目录关闭 --overwrite 覆盖现有文件关闭 --dry-run 预览仅关闭 --no-exif 跳过EXIF复制关闭 --report 输出处理报告JSON路径无 --from-stdin 从stdin读取文件路径（JSON）关闭

• find_by_date.py — 按日期查找照片文件/检测时间间隔

搜索RAW、JPG和HEIC/HEIF文件的EXIF拍摄日期。输出JSON路径列表到stdout。还可以通过识别具有规则间隔的照片运行来检测时间间隔序列。 # 按确切日期查找（输出JSON到stdout） python3 scripts/find_by_date.py --date 3月15日 python3 scripts/find_by_date.py --date 2026-03-15 # 日期范围 python3 scripts/find_by_date.py --from 2026-03-10 --to 2026-03-15 # 保存输出到文件 python3 scripts/find_by_date.py --date 3月15日 --output ~/data/found_files.json # 列出所有日期 python3 scripts/find_by_date.py --list-dates # 时间间隔：检测具有规则间隔的序列，排除随机拍摄的照片 python3 scripts/find_by_date.py ~/data/RAW --timelapse python3 scripts/find_by_date.py ~/data/RAW --timelapse --output ~/data/timelapse_found.json python3 scripts/find_by_date.py ~/data/RAW --timelapse --min-sequence 50 # 管道到convert.py python3 scripts/find_by_date.py --date today ~/data/RAW | \ python3 scripts/convert.py --from-stdin 选项描述默认值 --output, -o 保存JSON输出到文件stdout --timelapse 检测时间间隔序列（规则间隔）关闭 --min-sequence 最小帧数以资格为时间间隔30 --interval-tolerance 间隔偏差容忍度（0.5 = ±50%）0.5 支持的日期格式：2026-03-15、03-15、3月15日、today、yesterday、3天前

• layout_preview.py — 布局预览（比较/网格）

默认：并排比较（左=原始，右=分级） 当--params提供并包含绝对路径时，原始文件将自动解析，无需--originals。 # 比较模式，使用--params中的绝对路径（无需--originals） python3 scripts/layout_preview.py ~/data/output/graded \ --params grading_params.json # 比较模式，使用显式的原始文件目录 python3 scripts/layout_preview.py ~/data/output/graded \ --originals ~/data/RAW --params grading_params.json # 网格模式（宫格）— 仅分级照片 python3 scripts/layout_preview.py ~/data/output/grade