photo-organizer-mcp

# Photo Organizer 照片按拍摄日期归类工具 > ⚠️ 注意：本包为 `photo-organizer-mcp`，与 PyPI 上 Supporterino 维护的 `photo-organizer` / `photo_organizer` 无任何关联，请认准包名安装。 将照片/视频按拍摄日期自动归类到日期文件夹的小工具。支持命令行（CLI）与图形界面（GUI），二者合并为单一脚本。 ## 版本 当前版本 **v0.4.0**。可用 `python photo_organizer.py --version` 查看。 更新历史见 [CHANGELOG.md](CHANGELOG.md)。 ## 功能 - **双语界面与语言切换**：界面与输出支持中文/英文，首次启动跟随系统语言（默认 zh），GUI 顶部一键切换，CLI 可用 `--lang zh|en` 指定；语言选择持久化保存 - 三级日期判定：EXIF 拍摄日期 → 文件名日期 → 文件修改时间（Windows 另含创建时间，取较早者）；可用 `--no-exif` 跳过 EXIF 读取，大批量整理时显著提速 - 支持常见图片格式（JPG/PNG/HEIC 等，可在界面勾选/自定义扩展名）与视频格式（MP4/MOV 等），视频默认一并整理，可用 `--no-video` 关闭 - 支持文件名日期多种写法：`IMG_20260806_144736.jpg`、`Screenshot_2026-08-09-05-03-57.jpg`、`2026.08.06.jpg`、`mmexport1785419041663.jpg`（仅限 `mmexport`/`wx_camera_` 等已知拍摄前缀的 10 位时间戳）等；日期判定带数字边界保护，避免误判普通数字串 - 分组方式可选：**单层日期文件夹**（如 `2026-10-20`），或**按年 / 按年+月 / 按年+月+日**嵌套分组，各层文件夹名格式可单独自定义（strftime） - 嵌套分组时可勾选「分组时创建日期文件夹」，在最内层再按日期格式建文件夹 - 可选**递归扫描**源文件夹的所有子文件夹；目标文件夹在源内部时自动排除，不会重复扫描已归类文件 - **跳过已有日期文件夹**默认开启：仅原地整理（源=目标且递归）时跳过已存在的日期文件夹，避免重复处理；关闭用 `--no-skip-existing-date-folders` - **可整理隐藏文件与 .trashed 文件**：默认跳过隐藏文件（Windows 隐藏属性或文件名以点开头）与 `.trashed-` 开头的 Android 回收站文件，避免误整理；需处理时勾选「包含隐藏文件和 .trashed 文件」或用 `--include-hidden-trash` 开启 - 重名冲突默认**跳过**，可切换为**自动加来源文件夹名前缀**（如 `trip_IMG_20260806.jpg`） - 默认**移动**文件到日期文件夹，可切换**复制模式**（原文件保留） - **模拟运行**独立按钮/参数：只预览归类结果，不移动、不复制任何文件 - 单文件出错不影响整体，末尾汇总报告（含图片/视频分类与跳过统计） - **日志着色**：整理日志按事件类型着色（错误红 / 警告橙 / 跳过黄 / 移动绿 / 复制蓝 / 重命名紫 / 模拟青 / 信息蓝），CLI 彩色标签默认开启，可用 `--mono` 关闭 - **操作清单（.jsonl）**：每次整理可保存动作清单，支持查看明细 / 删除所选 / 导出 / 导入 / 一键还原变更 / 清空 - **清理数据**：一键删除配置文件与全部操作清单（GUI 按钮或 `--clear-data`） - **清理半成品**：手动清理上次中断遗留的 `.photo-org-tmp` 半成品文件（GUI「清理半成品」按钮或 `--cleanup-parts`，需确认后执行） - 配置持久化：界面设置自动保存到配置目录 `config.json`，支持一键恢复默认 - 界面悬停提示（ToolTip）说明各项含义；「格式说明」弹窗列出 strftime 记号与常用组合 - **标题栏版本号**：窗口标题显示当前版本（如「照片按拍摄日期归类 v0.2.1」） ## 图形界面 ```bash python photo_organizer.py # 无参数运行（或双击 EXE），直接打开图形界面 python photo_organizer.py --gui # 强制图形界面 # 或 python photo_organizer.py -g ``` 界面顶部提供**语言切换**…