relive-智能照片记忆相框

项目简介

你的 NAS 里存了多少照片？它们上一次被翻看是什么时候？
Relive 通过 AI 理解每张照片，以”往年今日”为线索，每天把值得重温的记忆送到你的相框上。

Relive 是一个自部署的照片回忆系统 —— 扫描你 NAS 中的照片，用 AI 理解内容，然后每天在相框或屏幕上呈现值得重温的瞬间。
软件代码开源在 github

它由四部分组成：

• Web 管理后台：扫描照片、配置 AI、管理设备和展示策略
• 后端服务：处理照片分析、地理编码、缩略图生成等后台任务
• relive-analyzer：独立的批量分析工具，适合在另一台 AI 主机上运行
• 展示终端：目前已支持 ESP32 墨水屏相框，未来可扩展到电脑屏保、移动端 App、微信小程序等

为什么用 Relive

• 让照片不再只是”存着”：围绕”往年今日”自动选图，每天重温不同年份的这一天
• AI 真正理解照片内容：不只是看 EXIF，而是理解场景、人物、氛围，给出评分和描述
• 支持多种 AI 部署方式：本地模型、远程 GPU、云端 API，按需选择
• NAS 与 AI 主机可以分开部署：通过 relive-analyzer 在另一台机器上批量分析
• 完整的可视化管理：扫描路径、AI 配置、设备管理、展示策略，全部在 Web 后台完成

适合谁

• 有大量家庭照片，想在日常生活中重新看到它们的人
• 用 NAS / Docker 自部署管理照片的人
• 想把照片分析和相框展示串起来的人

当前状态

• ✅ Web 管理后台可用
• ✅ 后端 API 与任务系统可用
• ✅ relive-analyzer API 模式可用
• ✅ 事件驱动型智能策展引擎（6 通道提名）
• ✅ 照片级排除与手动旋转
• ✅ ESP32 墨水屏相框固件（AP 配网、定时睡眠、双配置源）

核心能力

AI 照片分析

• 理解照片内容、人物、场景和氛围
• 生成描述、短句、分类、标签与评分
• 支持 Ollama / vLLM / Qwen / OpenAI / Hybrid

往年今日 & 事件策展

• 每天自动挑选历史上同一天或相近日期的照片
• 事件驱动型智能策展：基于时空聚类的事件引擎，6 个提名通道（时光隧道 / 巅峰回忆 / 地理漂移 / 角落遗珠 / 人物专题 / 季节专题）
• 没有往年今日时，智能回溯到最近的历史记忆，确保每天都有内容
• 支持评分过滤，只展示值得回忆的照片

设备展示

• 支持 ESP32 墨水屏相框、Web 浏览器等多种展示终端
• 后台统一管理设备，自动推送当日展示内容
• 墨水屏相框支持 AP 配网、定时睡眠等低功耗特性

ESP32 墨水屏相框

基于 ESP32-S3 + 7.3 寸 E Ink Spectra 6 彩色墨水屏的实体相框，每天定时从服务器获取"往年今日"照片并显示。

• 硬件：ESP32-S3 + Good Display GDEP073E01 (800x480, 6 色)
• 配网：首次使用自动进入 AP 配网（SSID: relive），Web 页面配置 WiFi、服务器、刷新时间
• 重新配置：15 秒内连续按两次 Reset 键（或快速断电两次）重新进入配置页面，已有设置自动回显
• 低功耗：定时深度睡眠，睡眠电流约 10μA，每天按设定时间点唤醒刷新
• 双模式：Office 模式（编译时配置）与 NVS 模式（AP 配网配置）自动切换

详细说明见 devices/photo-frame/esp32/README.md

Web 管理后台

• 浏览照片和分析结果
• 管理扫描路径、提示词、AI Provider、设备和展示策略
• 查看缩略图、地理编码、分析等后台任务状态

图片预处理与成本优化

• 分析前自动压缩图片
• 减少带宽与 API 成本
• 适合大规模照片库的批量处理场景

系统截图

仪表盘

展示策略 - 往年今日选图

照片管理

AI 分析

设备管理

缩略图生成

GPS 位置解析

事件浏览

配置管理

系统管理