技能介绍

解决什么问题

本地照片文件夹里堆着相机直出的 JPG/PNG，按时间浏览需要手动翻文件夹，视觉效果差；云端相册要么要上传（隐私风险、依赖网络），要么操作繁琐。这个技能能把这些照片变成自包含、可离线浏览的网页相册，不用服务器、不用外部 CDN，双击就能看。

核心能力与工作流程

原图不动，只生成轻量副本：原图保持原位，额外生成 720px 网格缩略图和 1600px 灯箱预览图，不会动原始文件。
按时间分组，浏览顺滑：侧边栏导航按拍摄日期分组，瀑布流懒加载减少首屏压力；灯箱支持 ←/→ 翻页、空格切换幻灯片、Esc 关闭，还能文件名搜索、回到顶部。
自动化构建流程：

1. 开工前先和你确认三个关键决策：整理方式（按日期分组/不分组/自定义）、生成位置（照片文件夹内/工作区）、原图处理（保持原位/移动），避免返工。
2. 扫描图片时优先从文件名解析真实日期（比如 微信图片_YYYYMMDDHHMMSS、IMG_YYYYMMDD_HHMMSS），解析不到的视为无日期。
3. 多进程并行生成缩略图/预览图，自动按 EXIF Orientation 转正，已存在的图会跳过（可重复跑不重复生成）。
4. 有真实日期的照片归入对应日期，无日期的按连拍序号均分到事件窗口；导出 photos.js 记录分组、路径、尺寸等数据。
5. 自动复制前端模板，验证缩略图/预览图数量与数据一致后，双击 相册/index.html 就能用。

适用边界与注意点

适合本地静态相册需求，不适合需要云端同步、多人协作或 AI 智能打标签的复杂图库。另外相机的 EXIF 日期常常不准，比如拍 2024 年的照片可能显示 2022 年，绝对不能直接按 EXIF 年份分组，必须先确认真实拍摄窗口；如果只认 微信图片_ 前缀，会漏掉 iPhone 导出的 IMG_ 前缀照片，导致这些照片被误判无日期归错天。