返回顶部
a

apple-photos-cleaner苹果照片清理器

Analyze, clean up, and organize Apple Photos libraries. Find and report junk photos (screenshots, low-quality, burst leftovers, duplicates), analyze storage usage, generate photo timeline recaps, plan smart exports, analyze Live Photos, check iCloud sync, audit shared libraries, detect similar photos, curate seasonal highlights, and score face quality. All analysis operations are READ-ONLY on the database (safe). macOS only. Requires Python 3.9+ (stdlib only) and access to the Apple Photos SQLit

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.1
安全检测
已通过
400
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

apple-photos-cleaner

Apple Photos 清理工具

用于分析和清理 Apple Photos 资料库的综合工具包。超越 Photos.app 的功能:智能垃圾检测、详细存储分析、带质量评分的重复项查找、用于故事叙述的时间线回顾以及智能导出规划。

概述

Apple Photos 在整理和同步照片方面表现出色,但在清理方面并不擅长。本技能填补了这一空白:

  • - 资料库分析 — 获取全局概况:数量、存储空间、日期范围、人物、质量分布
  • 垃圾查找器 — 识别截图、低质量照片、连拍残留、旧截图
  • 重复项查找器 — 使用 Apple 检测 + 时间戳/尺寸匹配查找重复项
  • 存储分析器 — 按年份、类型、文件格式、增长趋势、存储大户进行详细分解
  • 时间线回顾 — 为任意日期范围生成照片活动的叙述性摘要
  • 智能导出 — 按年/月、人物、相册或地点规划有序导出;AppleScript 导出
  • 最佳照片 / 隐藏珍宝 — 展示您未收藏的高质量照片
  • 人物分析器 — 深度分析人物:共现情况、随时间变化的趋势、每人最佳照片
  • 地点映射器 — 将 GPS 坐标聚类为地点,识别旅行,离线反向地理编码
  • 场景搜索 — 通过机器学习检测的内容(海滩、狗、食物)进行搜索,或生成内容清单
  • 拍照习惯 — 行为分析:时段、星期几、连续记录、季节性趋势
  • 历史上的今天 — 查看往年今日拍摄的照片
  • 相册审计员 — 查找孤立照片、空相册、相册之间的重叠
  • 清理执行器 — 通过 AppleScript 批量将垃圾移至废纸篓(需确认)
  • 实况照片分析器 — 比较实况照片与静态照片,查找可转换的候选对象,存储影响
  • 共享资料库 — 分析共享资料库与个人资料库:贡献者、内容分配、存储空间
  • iCloud 状态 — 检查 iCloud 同步覆盖范围:已同步与仅本地、大未同步项目
  • 相似度查找器 — 使用计算出的质量特征向量检测视觉上相似的照片
  • 季节性精选 — 使用质量评分和收藏夹精选每季最佳照片
  • 面部质量评分 — 按人对面部照片进行排名:查找最佳/最差肖像

安全性: 所有操作均为只读数据库查询。未经用户明确操作,不会修改或删除任何照片。

何时使用本技能

当用户提及以下内容时使用:

  • - 清理照片 / 释放照片存储空间
  • 查找重复照片
  • 删除旧截图
  • 分析照片资料库存储
  • 查找垃圾或低质量照片
  • 整理照片导出
  • 获取照片时间线摘要(我上周做了什么?)
  • 连拍照片清理
  • 查找照片中的存储大户
  • 查找最佳或隐藏珍宝照片
  • 照片中的人物,谁一起出现
  • 照片拍摄地点、旅行、行程、位置
  • 按内容搜索照片(海滩、日落、狗、食物)
  • 拍照习惯、模式、连续记录
  • 历史上的今天 / 往年照片回忆
  • 相册整理、孤立照片、相册清理
  • 实际删除垃圾照片(批量清理)
  • 实况照片分析,将实况照片转换为静态照片
  • 共享资料库内容,谁贡献了什么
  • iCloud 同步状态、未同步照片、云覆盖范围
  • 查找外观相似的照片
  • 季节性照片精选,每季最佳
  • 面部/肖像质量,每人最佳/最差肖像

快速开始

所有脚本均可独立运行。照片数据库自动位于:
~/Pictures/Photos Library.photoslibrary/database/Photos.sqlite

基本工作流程:

  1. 1. 运行 libraryanalysis.py 获取概况
  2. 运行 junkfinder.py 识别清理候选对象
  3. 运行 duplicate_finder.py 查找重复项
  4. 使用结果指导在 Photos.app 中进行手动清理

命令

1. 资料库分析

获取全面的资料库统计信息:数量、存储空间、日期范围、人物、质量评分。

bash
python3 scripts/library_analysis.py [--human] [--output FILE]

选项:

  • - --human — 人类可读摘要而非 JSON
  • --output FILE — 将 JSON 写入文件
  • --db-path PATH — 自定义数据库路径
  • --library PATH — 自定义照片资料库路径

示例输出:

📊 APPLE PHOTOS 资料库分析
==================================================

总资产:12,453
总存储空间:48.3 GB
平均大小:4.1 MB
日期范围:2020-01-15 至 2025-03-03

按类型:
照片:11,234
视频:891
截图:328
收藏:456
连拍:1,234

按年份:
2025:1,203 项,5.2 GB
2024:3,456 项,15.1 GB
2023:2,987 项,12.4 GB
...

主要人物:
Jonah:3,456 张照片
Silas:3,234 张照片
...

对话中的使用:

用户: 我有多少张照片?
AI: 运行带有 --human 标志的 library_analysis.py,报告摘要

用户: 显示我的照片存储分解
AI: 运行 library_analysis.py,突出显示关键统计数据



2. 垃圾查找器

识别清理候选对象:截图、低质量照片、连拍残留、重复项。

bash
python3 scripts/junk_finder.py [--screenshot-age DAYS] [--quality-threshold N] [--human]

选项:

  • - --screenshot-age DAYS — 将超过 N 天的截图视为垃圾(默认:30)
  • --quality-threshold N — 低质量的质量评分阈值(默认:0.3,范围:0.0-1.0)
  • --no-duplicates — 跳过重复检测
  • --human — 人类可读摘要
  • --output FILE — 将 JSON 写入文件

示例输出:

🗑️ 垃圾查找器结果
==================================================

发现:
📸 截图:328
└─ 旧(>30 天):287
📉 低质量:156
📸 连拍残留:1,089
👥 可能重复:45

预计节省:
保守:2.3 GB
(旧截图 + 连拍残留)
激进:5.7 GB
(所有截图 + 低质量 + 连拍 + ~50% 的重复项)

它能找到什么:

  • - 截图 — 通过 ZISDETECTEDSCREENSHOT 标志检测
  • 旧截图 — 超过指定天数的截图(可安全删除)
  • 低质量 — 质量评分低的照片(高失败/噪声,低构图/光照)
  • 连拍残留 — 连拍序列中未选中的照片
  • 可能重复 — 使用 Apple 内置检测

对话中的使用:

用户: 在我的照片中查找垃圾
AI: 运行 junk_finder.py,报告总数和预计节省空间

用户: 我有多少张旧截图?
AI: 运行 junk_finder.py,聚焦截图统计

用户: 我可以删除什么来释放 5GB?
AI: 运行 junk_finder.py,显示保守/激进估计,建议下一步操作



3. 重复项查找器

查找重复照片并根据质量、收藏状态和文件大小推荐保留哪些。

bash
python3 scripts/duplicate_finder.py [--human] [--output FILE]

检测方法:

  1. 1. Apple 内置 — 使用 ZDUPLICATEASSETVISIBILITYSTATE
  2. 时间戳 + 尺寸 — 同一秒拍摄且尺寸相同的照片

推荐逻辑:

  • - 收藏优先
  • 截图扣分
  • 最高质量评分优先
  • 最大文件大小作为平局决胜

示例输出:

👥 重复项查找器结果
==================================================

发现 12 个重复组
总重复项:27
可安全删除:15
总大小:156 MB
潜在节省:89 MB

示例组(显示前 5 个):

组 1(apple_builtin):
✓ 保留 ★ IMG_1234.jpg(4.2 MB,Q:0.823)
删除 IMG_1234-2.jpg(4.1 MB,Q:0.801)

组 2(timestamp_dim

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 apple-photos-cleaner-1776275354 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 apple-photos-cleaner-1776275354 技能

通过命令行安装

skillhub install apple-photos-cleaner-1776275354

下载

⬇ 下载 apple-photos-cleaner v1.0.1(免费)

文件大小: 112.47 KB | 发布时间: 2026-4-16 17:45

v1.0.1 最新 2026-4-16 17:45
- Improved logic and bug fixes across multiple analysis scripts.
- Updated scripts: library_analysis.py, location_mapper.py, on_this_day.py, people_analyzer.py, smart_export.py, timeline_recap.py, and shared code in _common.py.
- Added or updated tests for new or revised script functions.
- General reliability and output improvements for analyzing and cleaning Apple Photos libraries.

Archiver·手机版·闲社网·闲社论坛·智能体自动化市场· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2026 闲社网·AI智能体论坛·AI自动化解决方案·http://xianshe.com

p2p_official_large
返回顶部