一个极简、AI 驱动的智能相册，专为现代 Web 设计。它集成了 PWA、流式加载、多数据库架构和高性能缓存，旨在提供极致的浏览体验和智能的交互方式。

• AI 画中密语：AI 扮演照片人物，通过第一人称视角提供沉浸式对话体验。
• 全模型支持：兼容 OpenAI (GPT-4V)、Claude-3、Gemini 等主流视觉模型。
• 极致隐私：对话历史仅存于浏览器 IndexedDB，支持导入导出，后端绝不触碰私密数据。
• 高性能架构：内置 AI 微服务，采用内存队列与 Redis 持久化缓存，大幅降低 API 调用成本。

• 多源订阅：支持 RSS/Atom 协议，自动同步外部图库（如 Pinterest, Pixiv 等）的媒体流。
• 智能爬虫：基于任务调度器 (TaskScheduler) 的并发控制，支持断点续传与重试机制。

• 多库并发：主库/设置库/索引库分离，彻底解决 SQLite 锁竞争，提升高并发下的响应速度。
• 流式加载：自研图片流式渲染技术，海量照片也能瞬间秒开。
• Worker 线程池：缩略图生成、索引重建、视频 HLS 处理全部在独立线程运行，不阻塞主进程。

graph TD
    User((用户)) <-->|HTTP/SSE| WebApp[Frontend SPA / PWA]
    WebApp <-->|API| Backend[Express Server]
    
    subgraph "Core Services"
        Backend <--> AI[AI Microservice]
        Backend <--> Downloader[Download & RSS Service]
        Backend <--> WorkerManager[Worker Manager]
    end

    subgraph "Storage Layer"
        Backend <--> Redis[(Redis Cache)]
        WorkerManager --> gallery_db[(gallery.db)]
        WorkerManager --> index_db[(index.db)]
        Backend <--> settings_db[(settings.db)]
    end

    subgraph "Workers"
        WorkerManager --> TW[Thumbnail Worker]
        WorkerManager --> IW[Indexing Worker]
        WorkerManager --> VP[Video Processor]
    end

    AI <--> LLM[External LLM Providers]

最快速的部署方式，无需配置开发环境。

1. 环境准备：确保已安装 Docker 和 Docker Compose。
2. 下载配置：

   mkdir -p photonix && cd photonix
   curl -O https://raw.githubusercontent.com/li88iioo/Photonix/main/docker-compose.ghcr.yml
   mv docker-compose.ghcr.yml docker-compose.yml

3. 初始化环境：

   curl -o .env https://raw.githubusercontent.com/li88iioo/Photonix/main/env.example/env.example
   # 生成随机密钥
   sed -i "s/CHANGE_ME_TO_A_SECURE_32_PLUS_CHAR_STRING/$(openssl rand -base64 48 | tr -d '\n')/" .env

4. 启动：

   docker compose up -d

适合需要二次开发的用户。完整流程请参考 本地开发环境指南。

git clone https://github.com/li88iioo/Photonix.git
cd Photonix

# 1. 安装后端依赖
cd backend && npm install

# 2. 安装前端依赖并构建
cd ../frontend && npm install && npm run build

# 3. 详细的联调与环境配置
# 请务必查阅 docs/development.md 进行后续操作

• Nginx 配置指南：包含 SSE 专用配置、HTTP/HTTPS 代理模板及排障方法。
• RESTful API 文档：完整的核心接口说明，助力二次开发。
• 前端技术架构：深入了解无框架 SPA 设计及 PWA 实现。
• 本地开发环境：非 Docker 环境下的依赖安装与配置指南。
• 技术实现详情：深入了解 AI 生命周期、微服务架构及媒体处理工作流。
• 运维与更新：版本升级、备份策略及系统性能优化建议。
• 故障排查指南：整理了部署阶段及功能使用中的常见问题 (FAQ)。
• AI 提示词模板：内置多种 AI 角色设定与对话风格参考。
• 如何贡献。
• 多数据库架构：详细的数据库分布与维护说明。

Photonix 提供了极细粒度的配置项，详见 ENV_GUIDE.md。

• 健康检查：访问 /health 实时获取数据库与服务负载状态。
• 监控指标：
  • /api/metrics/cache：Redis 缓存命中分布。
  • /api/metrics/queue：Worker 任务堆积详情。
• 多库管理：详见 数据库维护指南。

我们欢迎任何形式的贡献！

1. 提出问题：发现 Bug 或有新想法？请提交 Issue。
2. 提交代码：Fork 本仓库 -> 创建特性分支 -> 提交 PR。
3. 文档完善：发现文档描述不清？欢迎直接通过 PR 修正。

本项目采用 MIT License。详情请参阅 LICENSE 文件。

Built with ❤️ for photography lovers.