{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4mm932mw5nva","handle":"photo-organizer-mcp","url":"https://wellknown.network/agents/photo-organizer-mcp","links":{"self":"https://wellknown.network/agents/photo-organizer-mcp/record.json","html":"https://wellknown.network/agents/photo-organizer-mcp","markdown":"https://wellknown.network/agents/photo-organizer-mcp/record.md","api":"https://wellknown.network/api/v1/agents/photo-organizer-mcp","status":"https://wellknown.network/api/v1/agents/photo-organizer-mcp/status","claim":"https://wellknown.network/agents/photo-organizer-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/photo-organizer-mcp/claim.json","badge":"https://wellknown.network/agents/photo-organizer-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/photo-organizer-mcp/history","tools":"https://wellknown.network/api/v1/agents/photo-organizer-mcp/tools"},"ard":{"identifier":"urn:air::server:photo-organizer-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"photo-organizer-mcp","summary":"MCP (Model Context Protocol) server for photo-organizer: organize photos/videos by date with a safe preview+confirm workflow. Independent from the PyPI package \"photo-organizer\" by Supporterino.","description":"# Photo Organizer 照片按拍摄日期归类工具\n\n> ⚠️ 注意：本包为 `photo-organizer-mcp`，与 PyPI 上 Supporterino 维护的 `photo-organizer` / `photo_organizer` 无任何关联，请认准包名安装。\n\n将照片/视频按拍摄日期自动归类到日期文件夹的小工具。支持命令行（CLI）与图形界面（GUI），二者合并为单一脚本。\n\n## 版本\n\n当前版本 **v0.4.0**。可用 `python photo_organizer.py --version` 查看。\n\n更新历史见 [CHANGELOG.md](CHANGELOG.md)。\n\n## 功能\n\n- **双语界面与语言切换**：界面与输出支持中文/英文，首次启动跟随系统语言（默认 zh），GUI 顶部一键切换，CLI 可用 `--lang zh|en` 指定；语言选择持久化保存\n- 三级日期判定：EXIF 拍摄日期 → 文件名日期 → 文件修改时间（Windows 另含创建时间，取较早者）；可用 `--no-exif` 跳过 EXIF 读取，大批量整理时显著提速\n- 支持常见图片格式（JPG/PNG/HEIC 等，可在界面勾选/自定义扩展名）与视频格式（MP4/MOV 等），视频默认一并整理，可用 `--no-video` 关闭\n- 支持文件名日期多种写法：`IMG_20260806_144736.jpg`、`Screenshot_2026-08-09-05-03-57.jpg`、`2026.08.06.jpg`、`mmexport1785419041663.jpg`（仅限 `mmexport`/`wx_camera_` 等已知拍摄前缀的 10 位时间戳）等；日期判定带数字边界保护，避免误判普通数字串\n- 分组方式可选：**单层日期文件夹**（如 `2026-10-20`），或**按年 / 按年+月 / 按年+月+日**嵌套分组，各层文件夹名格式可单独自定义（strftime）\n- 嵌套分组时可勾选「分组时创建日期文件夹」，在最内层再按日期格式建文件夹\n- 可选**递归扫描**源文件夹的所有子文件夹；目标文件夹在源内部时自动排除，不会重复扫描已归类文件\n- **跳过已有日期文件夹**默认开启：仅原地整理（源=目标且递归）时跳过已存在的日期文件夹，避免重复处理；关闭用 `--no-skip-existing-date-folders`\n- **可整理隐藏文件与 .trashed 文件**：默认跳过隐藏文件（Windows 隐藏属性或文件名以点开头）与 `.trashed-` 开头的 Android 回收站文件，避免误整理；需处理时勾选「包含隐藏文件和 .trashed 文件」或用 `--include-hidden-trash` 开启\n- 重名冲突默认**跳过**，可切换为**自动加来源文件夹名前缀**（如 `trip_IMG_20260806.jpg`）\n- 默认**移动**文件到日期文件夹，可切换**复制模式**（原文件保留）\n- **模拟运行**独立按钮/参数：只预览归类结果，不移动、不复制任何文件\n- 单文件出错不影响整体，末尾汇总报告（含图片/视频分类与跳过统计）\n- **日志着色**：整理日志按事件类型着色（错误红 / 警告橙 / 跳过黄 / 移动绿 / 复制蓝 / 重命名紫 / 模拟青 / 信息蓝），CLI 彩色标签默认开启，可用 `--mono` 关闭\n- **操作清单（.jsonl）**：每次整理可保存动作清单，支持查看明细 / 删除所选 / 导出 / 导入 / 一键还原变更 / 清空\n- **清理数据**：一键删除配置文件与全部操作清单（GUI 按钮或 `--clear-data`）\n- **清理半成品**：手动清理上次中断遗留的 `.photo-org-tmp` 半成品文件（GUI「清理半成品」按钮或 `--cleanup-parts`，需确认后执行）\n- 配置持久化：界面设置自动保存到配置目录 `config.json`，支持一键恢复默认\n- 界面悬停提示（ToolTip）说明各项含义；「格式说明」弹窗列出 strftime 记号与常用组合\n- **标题栏版本号**：窗口标题显示当前版本（如「照片按拍摄日期归类 v0.2.1」）\n\n## 图形界面\n\n```bash\npython photo_organizer.py          # 无参数运行（或双击 EXE），直接打开图形界面\npython photo_organizer.py --gui    # 强制图形界面\n# 或\npython photo_organizer.py -g\n```\n\n界面顶部提供**语言切换**…","publisher":{"name":"Tamwai","url":null},"homepage":null,"repository":null,"version":"0.4.0","license":"MIT","protocols":["mcp"],"tags":["mcp","photo","organizer","filesystem","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:photo-organizer-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"zh"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"photo-organizer-mcp","registry":"pypi","observedAt":"2026-11-05T22:26:27.885Z","publishedAt":"2026-10-26T17:31:46.561648Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"photo-organizer-mcp","url":"https://pypi.org/project/photo-organizer-mcp/","firstSeenAt":"2026-10-24T18:28:03.631Z","fetchedAt":"2026-11-05T22:25:08.724Z","normalizedAt":"2026-11-05T22:25:08.724Z"}]},"firstSeenAt":"2026-10-24T18:28:03.631Z","updatedAt":"2026-11-05T22:26:27.885Z"}