前言¶
手机、相机和截图工具会在同一个目录里堆出大量文件名杂乱的照片。手工按日期重命名、查重复、再分类，既慢又容易漏。常见做法是写一次性脚本或装桌面整理工具，但规则和统计口径往往要你自己维护。
下面介绍 SkillHub 社区 Skill「照片智能整理大师」（@user_96e46ec7/photo-organizer-pro）。它把整理流程写进通用 SKILL.md，让 Cursor、Claude Code 等支持 Skills 的 Agent 按同一套约定处理「只整理新增、按规则重命名、去重并汇总统计」。
这是什么¶
「照片智能整理大师」是发布在 SkillHub 上的社区来源（source: community）Skill，坐标 @user_96e46ec7/photo-organizer-pro，当前上架版本为 v1.0.0，发布者账号为 user_96e46ec7（页面展示作者名 Apollo）。SkillHub 分类为 knowledge-management，子类为「资料整理」。
官方页面未提供概述正文（overviewMd 为空），能力说明以包内 SKILL.md 为准。标签 requires_api_key=false，安装使用不依赖额外 API Key。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 README.md：
- 增量整理：只处理新增照片，已整理过的文件不再重复处理。
- 智能重命名：按
{时间}_{内容标签}_{地点}生成文件名；缺省字段会跳过空段后用下划线拼接。 - 去重：自动去重，保留像素更高的版本。
- 统计反馈：整理结束后返回总数、去重数、剩余数，以及按内容标签的分类统计。
- 格式与语言：支持 JPG / JPEG / PNG / HEIC / HEIF / RAW；说明支持中文与英文。
- 运行环境：文档写明支持 Windows / macOS / Android / iOS（具体执行方式由 Agent 结合包内脚本与本地环境完成）。
包内附带 Python 参考实现（main.py.txt、utils.py.txt、config.py.txt），依赖 exifread>=3.0.0、Pillow>=10.0.0。入口函数 organize_photos(folder_path, lang="zh") 对指定文件夹执行上述流程。
安装与启用¶
SkillHub 官方安装说明要求先阅读 SkillHub 安装与优先源配置，再安装本 Skill。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（见官方文档）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 且可能无法被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
skillhub install user_96e46ec7/photo-organizer-pro --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的目录。也可在 SkillHub 详情页通过「下载 Zip 包安装」获取 photo-organizer-pro-1.0.0.zip（下载地址形如 https://api.skillhub.cn/api/v1/download?slug=@user_96e46ec7/photo-organizer-pro）。
3、让 Agent 按官方提示安装¶
SkillHub 页面提供的安装提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_96e46ec7/photo-organizer-pro。
可将上述内容发给支持 Skill 安装的 AI 客户端，由 Agent 按文档完成 CLI 与目录配置。安装后按各客户端要求重启或刷新 Skills 列表。
典型用法¶
Skill 文档未单独给出对话示例，但 SKILL.md 与参考脚本明确了行为边界。启用 Skill 后，可向 Agent 说明要整理的本地相册目录，并指定语言（如 zh 或 en）。Agent 应遵循 Skill 中的命名格式与增量策略，并在完成后汇报统计信息。
包内 main.py.txt 在直接运行时的示例入口为对 ./test_photos 调用整理（仅供理解流程，实际路径由你在对话中指定）：
res = organize_photos("./test_photos", lang="zh")
print(res["message"])
整理逻辑会遍历目录下符合 SUPPORTED_FORMATS 且未标记为已整理的文件，去重后按时间与 EXIF/识别结果生成标签与地点，再重命名并写入已整理记录。
适用场景与注意¶
适合谁：需要把「相册增量归档 + 统一命名 + 去重 + 汇总」交给 Agent 反复执行的用户；SkillHub 侧显示该 Skill 已有 2667 次下载（统计来自 SkillHub 页面数据）。
使用注意：
- 官方 SkillHub 详情页概述为空，使用前建议以 Zip 包内
SKILL.md为准核对能力。 - 包内
skill.json写有skill_version: "2.0.0"，与 SkillHub 上架版本 1.0.0 不一致；以 SkillHub 发布的 1.0.0 为安装版本号。 - 对原始文件的重命名与去重涉及数据变更，首次使用应在副本目录验证，并自行备份重要照片。
- 内容标签依赖包内配置与图像分析逻辑，复杂场景下标签可能需人工抽查。
- SkillHub 安全扫描结果为「安全，无风险」（页面展示的 Keen / 三步检测报告），仍属社区发布内容，请按自身合规要求使用。
结尾¶
「照片智能整理大师」把增量整理、统一命名、去重和统计写进 Agent Skill，适合在已有 Coding Agent 工作流里处理本地照片目录，而无需每次重写整理脚本。
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_96e46ec7/photo-organizer-pro
Skill 坐标与 API 入口：https://api.skillhub.cn/user_96e46ec7/photo-organizer-pro
