前言¶
手機、相機和截圖工具會在同一個目錄裏堆出大量文件名雜亂的照片。手工按日期重命名、查重複、再分類，既慢又容易漏。常見做法是寫一次性腳本或裝桌面整理工具，但規則和統計口徑往往要你自己維護。
下面介紹 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
