hack/tools/scripts/llm-key-hunter/results/_cache/content/chuang1234_photomanager.json

{"repo": "chuang1234/photomanager", "files": {"README.md": {"a2d159203691e625d991973774af2ed6c235ef65": {"t": 1785747240.2845814, "n": 14354, "h": "ec833026c60b2f9b", "c": "<div align=\"center\">\n\n# 📷 家庭相册 Family Photo Manager\n\n**记录每一个温馨瞬间，让家人之间的距离更近一点 💖**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask)](https://flask.palletsprojects.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)\n[![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170F8?logo=ant-design)](https://ant.design/)\n[![MySQL](https://img.shields.io/badge/MySQL-5.7+-4479A1?logo=mysql)](https://www.mysql.com/)\n\n</div>\n\n---\n\n## 📖 项目简介\n\n家庭相册是一个专为家庭设计的私密照片管理系统。支持多家庭成员共享相册、照片上传/拍照、收藏管理，并内置 AI 智能助手提供温馨互动。所有数据存储在本地，保护家庭隐私。\n\n### ✨ 核心功能\n\n| 功能模块 | 描述 |\n|---------|------|\n| 📁 **相册管理** | 创建、重命名、删除相册，自定义封面 |\n| 📤 **照片上传** | 支持批量上传，记录拍摄时间、归属成员、备注 |\n| 📷 **拍照功能** | 调用摄像头直接拍照并上传（需 HTTPS 环境） |\n| 🔍 **照片搜索** | 按名称、归属人、上传者、日期范围筛选 |\n| 💖 **收藏管理** | 创建收藏夹，照片加入收藏/移出，支持多个收藏夹 |\n| 👨‍👩‍👧 **家庭成员** | 多成员管理，照片记录归属人和上传者 |\n| 🤖 **AI 助手** | 内置 AI 对话功能，支持 OpenAI / Ollama 等多种提供商 |\n| 🔐 **登录鉴权** | JWT Token 认证，SHA256 + bcrypt 双重密码加密 |\n\n---\n\n## 🏗️ 技术架构\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   前端 (React 19)                    │\n│  Ant Design 6 · React Router 7 · Axios · Less       │\n│                    :3000 (craco)                     │\n└──────────────────────┬──────────────────────────────┘\n                       │  /api/*  /uploads/*\n                       ▼\n┌─────────────────────────────────────────────────────┐\n│                 后端 (Flask 2.3)                      │\n│  PyJWT · bcrypt · PyMySQL · Werkzeug · python-dotenv│\n│                    :5000                              │\n└───────┬─────────────────────────┬───────────────────┘\n        ▼                         ▼\n┌───────────────┐      ┌──────────────────┐\n│   MySQL 5.7+  │      │  本地文件系统     │\n│  family_photo │      │  uploads/photos  │\n│               │      │  uploads/covers  │\n└───────────────┘      └──────────────────┘\n```\n\n---\n\n## 📂 项目结构\n\n```\nPhotoManager/\n├── family-photo-backend/          # 🔧 后端 (Flask)\n│   ├── config/\n│   │   ├── config.py              # 数据库/JWT/密码加密配置\n│   │   └── log_config.py          # 日志配置（按天轮转）\n│   ├── src/\n│   │   ├── main.py                # Flask 应用入口\n│   │   ├── auth.py                # 登录/登出/Token 鉴权\n│   │   ├── album.py               # 相册 CRUD + 封面上传\n│   │   ├── photo.py               # 照片上传/搜索/删除\n│   │   ├── favorite.py            # 收藏夹 & 收藏照片管理\n│   │   ├── member.py              # 家庭成员查询\n│   │   ├── file.py                # 静态文件服务（路径遍历防护）\n│   │   ├── chat.py                # AI 对话接口\n│   │   ├── ai_service.py          # AI 服务（OpenAI/Ollama）\n│   │   └── utils.py               # 数据库连接 & 工具函数\n│   ├── sql/\n│   │   └── table_info.sql         # 数据库建表 SQL\n│   ├── uploads/                   # 上传文件存储\n│   │   ├── photos/                # 照片文件（按 album_id 分目录）\n│   │   └── covers/                # 相册封面\n│   ├── logs/                      # 日志文件（自动生成）\n│   ├── .env.example               # 环境变量模板\n│   └── requirements.txt           # Python 依赖\n│\n├── family-photo-frontend/         # 🎨 前端 (React)\n│   ├── src/\n│   │   ├── pages/\n│   │   │   ├── Login/             # 登录页\n│   │   │   ├── AlbumList/         # 相册列表\n│   │   │   ├── AlbumDetail/       # 相册详情\n│   │   │   │   ├── components/\n│   │   │   │   │   ├── AlbumPhotoList/  # 照片列表（分页）\n│   │   │   │   │   ├── UploadArare/     # 照片上传区\n│   │   │   │   │   └── PhotoCapture/    # 摄像头拍照\n│   │   │   │   └── popwin/\n│   │   │   │       ├── FilterPopwin/          # 搜索筛选弹窗\n│   │   │   │       └── FavoriteConfirmModal/  # 收藏确认弹窗\n│   │   │   ├── CreateAlbum/       # 创建相册\n│   │   │   └── FavoriteManager/   # 收藏管理\n│   │   ├── components/\n│   │   │   ├── PrivateRoute.js    # 路由守卫\n│   │   │   ├── HeaderComponent.js # 顶部导航\n│   │   │   ├── AiChat/           # AI 对话悬浮窗\n│   │   │   └── ButtonWrapper/    # 按钮封装\n│   │   ├── contexts/\n│   │   │   └── MemberContext.js   # 当前登录成员上下文\n│   │   ├── utils/\n│   │   │   ├── request.js         # Axios 封装（Token 拦截器）\n│   │   │   └── dateUtil.js        # 日期格式化工具\n│   │   └── App.js                 # 路由配置入口\n│   ├── craco.config.js            # Craco 配置（Less/代理）\n│   └── package.json\n│\n└── README.md\n```\n\n---\n\n## 🐳 Docker 一键部署（推荐）\n\n> 无需手动安装 Python、Node.js、MySQL，一条命令搞定全部部署。\n\n### 前置要求\n\n- [Docker Desktop](https://www.docker.com/products/docker-desktop)（Windows/Mac）或 Docker Engine（Linux）\n\n### 一键部署\n\n**Windows：**\n```bash\n# 双击运行 deploy.bat，或在命令行执行：\ndeploy.bat\n```\n\n**Linux / macOS：**\n```bash\nchmod +x deploy.sh\n./deploy.sh\n```\n\n**手动执行（等效于脚本）：**\n```bash\n# 1. 复制环境配置\ncp .env.docker .env\n#   → 编辑 .env 修改数据库密码、JWT密钥等（可选）\n\n# 2. 构建并启动\ndocker compose up -d --build\n\n# 3. 查看状态\ndocker compose ps\n```\n\n### 访问地址\n\n| 服务 | 地址 |\n|------|------|\n| 🌐 前端 | http://localhost |\n| 🔧 后端 API | http://localhost:5000 |\n| 🗄️ MySQL | localhost:3306 |\n\n### Docker 架构\n\n```\n┌──────────────────────────────────────────────────────────┐\n│                    Docker Compose                        │\n│                                                          │\n│  ┌─────────────┐   ┌──────────────┐   ┌──────────────┐ │\n│  │  Frontend   │   │   Backend    │   │    MySQL     │ │\n│  │  (Nginx)    │──▶│  (Gunicorn)  │──▶│   (5.7)      │ │\n│  │  :80        │   │  :5000       │   │  :3306       │ │\n│  │  React 静态  │   │  Flask API   │   │  family_photo│ │\n│  └─────────────┘   └──────┬───────┘   └──────────────┘ │\n│                           │                             │\n│                    ┌──────▼───────┐                     │\n│                    │   Volumes    │                     │\n│                    │ uploads_data │                     │\n│                    │ mysql_data   │                     │\n│                    └──────────────┘                     │\n└──────────────────────────────────────────────────────────┘\n```\n\n### 配置说明\n\n环境配置文件 `.env`（从 `.env.docker` 复制）支持以下变量：\n\n| 变量 | 说明 | 默认值 |\n|------|------|--------|\n| `DB_PASSWORD` | MySQL root 密码 | Chuang@123456 |\n| `JWT_SECRET` | JWT 签名密钥 | 内置默认值（建议修改） |\n| `AI_PROVIDER` | AI 服务提供商 | ollama |\n| `AI_MODEL` | AI 模型名称 | qwen2.5:14b |\n| `FRONTEND_PORT` | 前端端口 | 80 |\n| `BACKEND_PORT` | 后端端口 | 5000 |\n| `MYSQL_PORT` | MySQL 端口 | 3306 |\n\n### 常用命令\n\n```bash\ndocker compose ps          # 查看容器状态\ndocker compose logs -f     # 实时查看日志\ndocker compose down        # 停止所有服务\ndocker compose up -d --build  # 重新构建并启动\ndocker compose down -v     # 停止并删除数据卷（⚠️ 清空数据）\n```\n\n### Docker 部署文件说明\n\n```\nPhotoManager/\n├── docker-compose.yml              # 编排文件（MySQL + 后端 + 前端）\n├── .env.docker                     # 环境配置模板\n├── deploy.bat                      # Windows 一键部署脚本\n├── deploy.sh                       # Linux/Mac 一键部署脚本\n├── docker/\n│   └── mysql/\n│       └── init.sql                # MySQL 自动初始化脚本\n├── family-photo-backend/\n│   ├── Dockerfile                  # 后端镜像构建\n│   ├── .dockerignore\n│   └── docker-entrypoint.sh        # 启动脚本（等待MySQL + Gunicorn）\n└── family-photo-frontend/\n    ├── Dockerfile                  # 前端镜像构建（多阶段：Node构建 + Nginx部署）\n    ├── .dockerignore\n    └── nginx.conf                  # Nginx 配置（SPA路由 + API代理）\n```\n\n---\n\n## 🚀 手动部署（快速开始）\n\n### 环境要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Python | 3.8+ |\n| Node.js | 16+ |\n| MySQL | 5.7+ |\n| npm / yarn | 最新稳定版 |\n\n### 1️⃣ 克隆项目\n\n```bash\ngit clone <your-repo-url>\ncd PhotoManager\n```\n\n### 2️⃣ 初始化数据库\n\n```bash\n# 登录 MySQL 创建数据库\nmysql -u root -p\n\nCREATE DATABASE family_photo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nUSE family_photo;\n\n# 导入建表 SQL（新建数据库时使用）\nsource family-photo-backend/sql/table_info.sql;\n\n# （可选）插入测试家庭成员\nINSERT INTO family_member (name, relation, username, password, email) VALUES\n('爸爸', 'father', 'father', '此处填SHA256哈希', 'father@example.com'),\n('妈妈', 'mother', 'mother', '此处填SHA256哈希', 'mother@example.com');\n```\n\n> 💡 密码存储流程：**前端 SHA256** → **后端 bcrypt 加密** → 存入数据库。  \n> 初始密码可先用 `config/config.py` 中的 `encrypt_password()` 函数生成哈希。\n\n### 3️⃣ 启动后端\n\n```bash\ncd family-photo-backend\n\n# 创建虚拟环境（推荐）\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 配置环境变量（必须！）\ncp .env.example .env\n# 编辑 .env，填入以下必要配置：\n#   DB_PASSWORD  — 数据库密码\n#   JWT_SECRET   — JWT 密钥（用 python -c \"import secrets; print(secrets.token_hex(32))\" 生成）\n#   AI_API_KEY   — AI 服务密钥（可选）\n\n# 启动服务\npython -m src.main\n# 后端运行在 http://localhost:5000\n```\n\n### 4️⃣ 启动前端\n\n```bash\ncd family-photo-frontend\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm start\n# 前端运行在 http://localhost:3000\n# 已配置代理：/api/* 和 /uploads/* 自动转发到后端 5000 端口\n```\n\n---\n\n## ⚙️ 环境变量配置\n\n在 `family-photo-backend/.env` 中配置（参考 `.env.example`）：\n\n```bash\n# ── 数据库配置（必填！）─────────────────────\nDB_HOST=localhost\nDB_USER=root\nDB_PASSWORD=你的数据库密码\nDB_NAME=family_photo\n\n# ── JWT 密钥（必填！）──────────────────────\n# 生成方式：python -c \"import secrets; print(secrets.token_hex(32))\"\nJWT_SECRET=你的JWT密钥\nJWT_EXPIRE_HOURS=24\n\n# ── AI 服务配置 ──────────────────────────────\n# 提供商：openai（默认）| ollama（本地部署，无需 API Key）\nAI_PROVIDER=openai\n\n# OpenAI / DeepSeek / 通义千问\nAI_API_KEY=sk-xxx\nAI_API_BASE=https://api.openai.com/v1\nAI_MODEL=gpt-3.5-turbo\n\n# ── 使用 Ollama 本地部署时，改为以下配置 ───────\n# AI_PROVIDER=ollama\n# AI_MODEL=llama3\n# AI_API_BASE=http://localhost:11434\n\n# ── 通用 ─────────────────────────────────────\nAI_TIMEOUT=60\n\n# ── Flask 环境 ───────────────────────────────\nFLASK_ENV=dev\n```\n\n> ⚠️ **安全提示：**  \n> - `DB_PASSWORD` 和 `JWT_SECRET` 为必填项，未配置时服务启动会报错  \n> - `.env` 文件已在 `.gitignore` 中，不会被提交到代码仓库  \n> - 生产环境请务必使用强随机字符串作为 `JWT_SECRET`\n\n---\n\n## 🗄️ 数据库设计\n\n```\nfamily_member (家庭成员)\n    │\n    ├──< album (相册)\n    │       │\n    │       └──< photo (照片)\n    │               │\n    │               └──< favorite_photo (收藏记录) >── favorite_folder (收藏夹)\n    │\n    └──< ai_chat_message (AI 聊天记录)\n```\n\n| 表名 | 说明 | 关键字段 |\n|------|------|---------|\n| `family_member` | 家庭成员 / 登录账号 | `username`(唯一), `password`(bcrypt), **`is_admin`**(权限标识) |\n| `album` | 相册 | `album_name`, `cover_path`, **`creator_id`**(创建者), `last_upload_user_id` |\n| `photo` | 照片 | `file_path`, `album_id`, `member_id`(归属), `operator_id`(上传者) |\n| `favorite_folder` | 收藏夹 | `folder_name`, `member_id`, `is_default` |\n| `favorite_photo` | 收藏记录 | `folder_id`, `photo_id`, `member_id`（唯一约束防重复） |\n| `ai_chat_message` | AI 聊天记录 | `member_id`, `role`(user/assistant), `content` |\n\n> 加粗字段为本次新增。完整建表 SQL 见 `family-photo-backend/sql/table_info.sql`\n\n---\n\n## 📡 API 接口\n\n### 认证\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/login` | 登录（返回 JWT Token） |\n| POST | `/api/logout` | 登出 |\n\n### 相册\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/albums` | ✅ | 获取所有相册列表 |\n| POST | `/api/album/create` | ✅ | 创建相册（可上传封面） |\n| POST | `/api/album/rename` | ✅ | 修改相册名称 |\n| POST | `/api/album/delete` | ✅ | 删除相册（级联删除照片） |\n| POST | `/api/album/cover/upload` | ✅ | 上传/更换相册封面 |\n| GET | `/api/photos/album/:id` | ✅ | 获取相册下照片（分页） |\n\n### 照片\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| POST | `/api/photos/upload` | ✅ | 上传照片 |\n| POST | `/api/photos/delete` | ✅ | 删除照片 |\n| GET | `/api/photos/search` | ✅ | 搜索照片（支持多条件筛选） |\n\n### 收藏\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/favorite/folders` | ✅ | 获取收藏夹列表 |\n| POST | `/api/favorite/folders` | ✅ | 创建收藏夹 |\n| PUT | `/api/favorite/folders/:id` | ✅ | 修改收藏夹名称 |\n| DELETE | `/api/favorite/folders/:id` | ✅ | 删除收藏夹 |\n| POST | `/api/favorite/photos` | ✅ | 照片加入收藏 |\n| DELETE | `/api/favorite/photos` | ✅ | 照片移出收藏 |\n| GET | `/api/favorite/photos/:folder_id` | ✅ | 获取收藏夹内照片 |\n\n### 成员 & AI\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/current-member` | ✅ | 获取当前登录成员信息 |\n| GET | `/api/members` | ✅ | 获取所有家庭成员 |\n| GET | `/api/chat/history` | ✅ | 获取聊天记录（默认近 3 个月） |\n| POST | `/api/chat/send` | ✅ | 发送消息 & 获取 AI 回复 |\n| GET | `/api/chat/models` | ✅ | 查询 AI 提供商 & 可用模型 |\n| POST | `/api/chat/clear` | ✅ | 清空聊天记录 |\n\n### 静态文件\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/uploads/photos/:filename` | ✅ | 获取照片文件 |\n| GET | `/uploads/covers/:filename` | ✅ | 获取封面文件 |\n\n---\n\n## 🔐 安全机制\n\n| 层面 | 措施 |\n|------|------|\n| **认证** | JWT Token（HS256，24h 过期），`@login_required` 装饰器保护所有接口 |\n| **密码** | 前端 SHA256 + 后端 bcrypt（salt rounds=12）双重加密 |\n| **权限隔离** | `is_admin` 字段区分管理员/普通用户，普通用户只能操作自己创建的相册及照片 |\n| **文件上传** | 扩展名白名单校验、`secure_filename` 过滤、唯一文件名防覆盖 |\n| **路径安全** | 上传目录限制 + `_safe_path()` 绝对路径校验，防止路径遍历 |\n| **数据校验** | `album_id` 等参数强制正整数校验，存在性校验防止对不存在资源操作 |\n| **SQL 注入** | 全部使用 PyMySQL 参数化查询 (`%s`) |\n| **CORS** | Flask-CORS 配置 `supports_credentials=True` |\n\n---\n\n## 👥 权限体系\n\n### 角色说明\n\n| 角色 | `is_admin` 值 | 权限范围 |\n|------|--------------|---------|\n| **管理员** | `1` | 查看所有相册，操作所有资源 |\n| **普通成员** | `0`（默认） | 只能查看/操作**自己创建的**相册及照片 |\n\n### 权限配置\n\n在数据库中手动设置：\n\n```sql\n-- 将某用户设为管理员\nUPDATE family_member SET is_admin = 1 WHERE username = 'father';\n\n-- 取消管理员权限\nUPDATE family_member SET is_admin = 0 WHERE username = 'father';\n\n-- 查看所有成员的权限\nSELECT id, name, username, is_admin FROM family_member;\n```\n\n### 权限覆盖范围\n\n| 操作 | 管理员 | 普通成员 |\n|------|--------|---------|\n| 查看相册列表 | 所有相册 | 仅自己创建的 |\n| 查看相册照片 | 任意相册 | 仅自己创建的相册 |\n| 创建相册 | ✅ | ✅（自动成为创建者） |\n| 重命名/删除相册 | 任意相册 | 仅自己创建的 |\n| 更换相册封面 | 任意相册 | 仅自己创建的 |\n| 上传照片 | 任意相册 | 仅自己创建的相册 |\n| 删除照片 | 任意照片 | 仅自己相册中的照片 |\n| 搜索照片 | 任意相册 | 仅自己创建的相册 |\n| 收藏/取消收藏 | ✅ | ✅（收藏为个人行为，无需权限） |\n\n---\n\n## 🤖 AI 助手\n\n支持三种 AI 提供商，通过环境变量 `AI_PROVIDER` 切换：\n\n| 提供商 | 配置方式 | 特点 |\n|--------|---------|------|\n| **OpenAI** | 配置 `AI_API_KEY` + `AI_API_BASE` | 支持 OpenAI / DeepSeek / 通义千问等兼容接口 |\n| **Ollama** | `AI_PROVIDER=ollama` | 本地部署，无需 API Key，完全离线 |\n| **模拟模式** | 不配置 `AI_API_KEY` | 自动使用预设回复，方便体验功能 |\n\n---\n\n## 📸 功能预览\n\n| 页面 | 功能 |\n|------|------|\n| 🔑 登录页 | 温馨风格登录，SHA256 密码加密传输 |\n| 📁 相册列表 | 展示所有相册，显示封面、最后上传人和时间 |\n| 🖼️ 相册详情 | 照片网格展示、分页加载、搜索筛选 |\n| 📤 上传区域 | 填写归属成员、拍摄时间、备注后批量上传 |\n| 📷 拍照上传 | 调用摄像头拍照 → 预览 → 选择归属人 → 上传 |\n| 💖 收藏管理 | 收藏夹列表 + 收藏照片网格，支持增删改 |\n| 🤖 AI 助手 | 全局悬浮对话窗，聊天记录按账号隔离 |\n\n---\n\n## 🛠️ 开发说明\n\n### 前端代理配置（`craco.config.js`）\n\n```javascript\n// 开发环境下自动代理到后端\n'/api'      → http://localhost:5000/api\n'/uploads'  → http://localhost:5000/uploads\n```\n\n### 日志系统\n\n- 日志目录：`family-photo-backend/logs/`\n- `info.log`：常规操作日志（保留 30 天）\n- `error.log`：错误日志（保留 90 天）\n- 按天自动轮转，Windows 下安全处理文件锁定\n\n### 密码加密流程\n\n```\n用户输入明文密码\n    │\n    ▼\n前端 CryptoJS.SHA256(password)  ──→  SHA256 哈希\n    │\n    ▼\nPOST /api/login  { password: sha256_hash }\n    │\n    ▼\n后端 bcrypt.checkpw(sha256_hash, db_bcrypt_hash)  ──→  验证结果\n```\n\n---\n\n## 📋 待办事项\n\n- [ ] 实现 Token 黑名单机制，使 Logout 真正生效\n- [ ] 添加照片 EXIF 信息自动提取（拍摄时间、GPS 等）\n- [ ] 支持照片压缩上传，减少存储空间\n- [ ] 添加照片分享功能（生成临时链接）\n\n---\n\n## 📄 License\n\nMIT License © 2026 Family Photo Manager"}, "50547fdfec0822bc60189a109af0db1cd0cb289e": {"t": 1785771641.277322, "n": 14354, "h": "ec833026c60b2f9b", "c": "<div align=\"center\">\n\n# 📷 家庭相册 Family Photo Manager\n\n**记录每一个温馨瞬间，让家人之间的距离更近一点 💖**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask)](https://flask.palletsprojects.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)\n[![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170F8?logo=ant-design)](https://ant.design/)\n[![MySQL](https://img.shields.io/badge/MySQL-5.7+-4479A1?logo=mysql)](https://www.mysql.com/)\n\n</div>\n\n---\n\n## 📖 项目简介\n\n家庭相册是一个专为家庭设计的私密照片管理系统。支持多家庭成员共享相册、照片上传/拍照、收藏管理，并内置 AI 智能助手提供温馨互动。所有数据存储在本地，保护家庭隐私。\n\n### ✨ 核心功能\n\n| 功能模块 | 描述 |\n|---------|------|\n| 📁 **相册管理** | 创建、重命名、删除相册，自定义封面 |\n| 📤 **照片上传** | 支持批量上传，记录拍摄时间、归属成员、备注 |\n| 📷 **拍照功能** | 调用摄像头直接拍照并上传（需 HTTPS 环境） |\n| 🔍 **照片搜索** | 按名称、归属人、上传者、日期范围筛选 |\n| 💖 **收藏管理** | 创建收藏夹，照片加入收藏/移出，支持多个收藏夹 |\n| 👨‍👩‍👧 **家庭成员** | 多成员管理，照片记录归属人和上传者 |\n| 🤖 **AI 助手** | 内置 AI 对话功能，支持 OpenAI / Ollama 等多种提供商 |\n| 🔐 **登录鉴权** | JWT Token 认证，SHA256 + bcrypt 双重密码加密 |\n\n---\n\n## 🏗️ 技术架构\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   前端 (React 19)                    │\n│  Ant Design 6 · React Router 7 · Axios · Less       │\n│                    :3000 (craco)                     │\n└──────────────────────┬──────────────────────────────┘\n                       │  /api/*  /uploads/*\n                       ▼\n┌─────────────────────────────────────────────────────┐\n│                 后端 (Flask 2.3)                      │\n│  PyJWT · bcrypt · PyMySQL · Werkzeug · python-dotenv│\n│                    :5000                              │\n└───────┬─────────────────────────┬───────────────────┘\n        ▼                         ▼\n┌───────────────┐      ┌──────────────────┐\n│   MySQL 5.7+  │      │  本地文件系统     │\n│  family_photo │      │  uploads/photos  │\n│               │      │  uploads/covers  │\n└───────────────┘      └──────────────────┘\n```\n\n---\n\n## 📂 项目结构\n\n```\nPhotoManager/\n├── family-photo-backend/          # 🔧 后端 (Flask)\n│   ├── config/\n│   │   ├── config.py              # 数据库/JWT/密码加密配置\n│   │   └── log_config.py          # 日志配置（按天轮转）\n│   ├── src/\n│   │   ├── main.py                # Flask 应用入口\n│   │   ├── auth.py                # 登录/登出/Token 鉴权\n│   │   ├── album.py               # 相册 CRUD + 封面上传\n│   │   ├── photo.py               # 照片上传/搜索/删除\n│   │   ├── favorite.py            # 收藏夹 & 收藏照片管理\n│   │   ├── member.py              # 家庭成员查询\n│   │   ├── file.py                # 静态文件服务（路径遍历防护）\n│   │   ├── chat.py                # AI 对话接口\n│   │   ├── ai_service.py          # AI 服务（OpenAI/Ollama）\n│   │   └── utils.py               # 数据库连接 & 工具函数\n│   ├── sql/\n│   │   └── table_info.sql         # 数据库建表 SQL\n│   ├── uploads/                   # 上传文件存储\n│   │   ├── photos/                # 照片文件（按 album_id 分目录）\n│   │   └── covers/                # 相册封面\n│   ├── logs/                      # 日志文件（自动生成）\n│   ├── .env.example               # 环境变量模板\n│   └── requirements.txt           # Python 依赖\n│\n├── family-photo-frontend/         # 🎨 前端 (React)\n│   ├── src/\n│   │   ├── pages/\n│   │   │   ├── Login/             # 登录页\n│   │   │   ├── AlbumList/         # 相册列表\n│   │   │   ├── AlbumDetail/       # 相册详情\n│   │   │   │   ├── components/\n│   │   │   │   │   ├── AlbumPhotoList/  # 照片列表（分页）\n│   │   │   │   │   ├── UploadArare/     # 照片上传区\n│   │   │   │   │   └── PhotoCapture/    # 摄像头拍照\n│   │   │   │   └── popwin/\n│   │   │   │       ├── FilterPopwin/          # 搜索筛选弹窗\n│   │   │   │       └── FavoriteConfirmModal/  # 收藏确认弹窗\n│   │   │   ├── CreateAlbum/       # 创建相册\n│   │   │   └── FavoriteManager/   # 收藏管理\n│   │   ├── components/\n│   │   │   ├── PrivateRoute.js    # 路由守卫\n│   │   │   ├── HeaderComponent.js # 顶部导航\n│   │   │   ├── AiChat/           # AI 对话悬浮窗\n│   │   │   └── ButtonWrapper/    # 按钮封装\n│   │   ├── contexts/\n│   │   │   └── MemberContext.js   # 当前登录成员上下文\n│   │   ├── utils/\n│   │   │   ├── request.js         # Axios 封装（Token 拦截器）\n│   │   │   └── dateUtil.js        # 日期格式化工具\n│   │   └── App.js                 # 路由配置入口\n│   ├── craco.config.js            # Craco 配置（Less/代理）\n│   └── package.json\n│\n└── README.md\n```\n\n---\n\n## 🐳 Docker 一键部署（推荐）\n\n> 无需手动安装 Python、Node.js、MySQL，一条命令搞定全部部署。\n\n### 前置要求\n\n- [Docker Desktop](https://www.docker.com/products/docker-desktop)（Windows/Mac）或 Docker Engine（Linux）\n\n### 一键部署\n\n**Windows：**\n```bash\n# 双击运行 deploy.bat，或在命令行执行：\ndeploy.bat\n```\n\n**Linux / macOS：**\n```bash\nchmod +x deploy.sh\n./deploy.sh\n```\n\n**手动执行（等效于脚本）：**\n```bash\n# 1. 复制环境配置\ncp .env.docker .env\n#   → 编辑 .env 修改数据库密码、JWT密钥等（可选）\n\n# 2. 构建并启动\ndocker compose up -d --build\n\n# 3. 查看状态\ndocker compose ps\n```\n\n### 访问地址\n\n| 服务 | 地址 |\n|------|------|\n| 🌐 前端 | http://localhost |\n| 🔧 后端 API | http://localhost:5000 |\n| 🗄️ MySQL | localhost:3306 |\n\n### Docker 架构\n\n```\n┌──────────────────────────────────────────────────────────┐\n│                    Docker Compose                        │\n│                                                          │\n│  ┌─────────────┐   ┌──────────────┐   ┌──────────────┐ │\n│  │  Frontend   │   │   Backend    │   │    MySQL     │ │\n│  │  (Nginx)    │──▶│  (Gunicorn)  │──▶│   (5.7)      │ │\n│  │  :80        │   │  :5000       │   │  :3306       │ │\n│  │  React 静态  │   │  Flask API   │   │  family_photo│ │\n│  └─────────────┘   └──────┬───────┘   └──────────────┘ │\n│                           │                             │\n│                    ┌──────▼───────┐                     │\n│                    │   Volumes    │                     │\n│                    │ uploads_data │                     │\n│                    │ mysql_data   │                     │\n│                    └──────────────┘                     │\n└──────────────────────────────────────────────────────────┘\n```\n\n### 配置说明\n\n环境配置文件 `.env`（从 `.env.docker` 复制）支持以下变量：\n\n| 变量 | 说明 | 默认值 |\n|------|------|--------|\n| `DB_PASSWORD` | MySQL root 密码 | Chuang@123456 |\n| `JWT_SECRET` | JWT 签名密钥 | 内置默认值（建议修改） |\n| `AI_PROVIDER` | AI 服务提供商 | ollama |\n| `AI_MODEL` | AI 模型名称 | qwen2.5:14b |\n| `FRONTEND_PORT` | 前端端口 | 80 |\n| `BACKEND_PORT` | 后端端口 | 5000 |\n| `MYSQL_PORT` | MySQL 端口 | 3306 |\n\n### 常用命令\n\n```bash\ndocker compose ps          # 查看容器状态\ndocker compose logs -f     # 实时查看日志\ndocker compose down        # 停止所有服务\ndocker compose up -d --build  # 重新构建并启动\ndocker compose down -v     # 停止并删除数据卷（⚠️ 清空数据）\n```\n\n### Docker 部署文件说明\n\n```\nPhotoManager/\n├── docker-compose.yml              # 编排文件（MySQL + 后端 + 前端）\n├── .env.docker                     # 环境配置模板\n├── deploy.bat                      # Windows 一键部署脚本\n├── deploy.sh                       # Linux/Mac 一键部署脚本\n├── docker/\n│   └── mysql/\n│       └── init.sql                # MySQL 自动初始化脚本\n├── family-photo-backend/\n│   ├── Dockerfile                  # 后端镜像构建\n│   ├── .dockerignore\n│   └── docker-entrypoint.sh        # 启动脚本（等待MySQL + Gunicorn）\n└── family-photo-frontend/\n    ├── Dockerfile                  # 前端镜像构建（多阶段：Node构建 + Nginx部署）\n    ├── .dockerignore\n    └── nginx.conf                  # Nginx 配置（SPA路由 + API代理）\n```\n\n---\n\n## 🚀 手动部署（快速开始）\n\n### 环境要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Python | 3.8+ |\n| Node.js | 16+ |\n| MySQL | 5.7+ |\n| npm / yarn | 最新稳定版 |\n\n### 1️⃣ 克隆项目\n\n```bash\ngit clone <your-repo-url>\ncd PhotoManager\n```\n\n### 2️⃣ 初始化数据库\n\n```bash\n# 登录 MySQL 创建数据库\nmysql -u root -p\n\nCREATE DATABASE family_photo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nUSE family_photo;\n\n# 导入建表 SQL（新建数据库时使用）\nsource family-photo-backend/sql/table_info.sql;\n\n# （可选）插入测试家庭成员\nINSERT INTO family_member (name, relation, username, password, email) VALUES\n('爸爸', 'father', 'father', '此处填SHA256哈希', 'father@example.com'),\n('妈妈', 'mother', 'mother', '此处填SHA256哈希', 'mother@example.com');\n```\n\n> 💡 密码存储流程：**前端 SHA256** → **后端 bcrypt 加密** → 存入数据库。  \n> 初始密码可先用 `config/config.py` 中的 `encrypt_password()` 函数生成哈希。\n\n### 3️⃣ 启动后端\n\n```bash\ncd family-photo-backend\n\n# 创建虚拟环境（推荐）\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 配置环境变量（必须！）\ncp .env.example .env\n# 编辑 .env，填入以下必要配置：\n#   DB_PASSWORD  — 数据库密码\n#   JWT_SECRET   — JWT 密钥（用 python -c \"import secrets; print(secrets.token_hex(32))\" 生成）\n#   AI_API_KEY   — AI 服务密钥（可选）\n\n# 启动服务\npython -m src.main\n# 后端运行在 http://localhost:5000\n```\n\n### 4️⃣ 启动前端\n\n```bash\ncd family-photo-frontend\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm start\n# 前端运行在 http://localhost:3000\n# 已配置代理：/api/* 和 /uploads/* 自动转发到后端 5000 端口\n```\n\n---\n\n## ⚙️ 环境变量配置\n\n在 `family-photo-backend/.env` 中配置（参考 `.env.example`）：\n\n```bash\n# ── 数据库配置（必填！）─────────────────────\nDB_HOST=localhost\nDB_USER=root\nDB_PASSWORD=你的数据库密码\nDB_NAME=family_photo\n\n# ── JWT 密钥（必填！）──────────────────────\n# 生成方式：python -c \"import secrets; print(secrets.token_hex(32))\"\nJWT_SECRET=你的JWT密钥\nJWT_EXPIRE_HOURS=24\n\n# ── AI 服务配置 ──────────────────────────────\n# 提供商：openai（默认）| ollama（本地部署，无需 API Key）\nAI_PROVIDER=openai\n\n# OpenAI / DeepSeek / 通义千问\nAI_API_KEY=sk-xxx\nAI_API_BASE=https://api.openai.com/v1\nAI_MODEL=gpt-3.5-turbo\n\n# ── 使用 Ollama 本地部署时，改为以下配置 ───────\n# AI_PROVIDER=ollama\n# AI_MODEL=llama3\n# AI_API_BASE=http://localhost:11434\n\n# ── 通用 ─────────────────────────────────────\nAI_TIMEOUT=60\n\n# ── Flask 环境 ───────────────────────────────\nFLASK_ENV=dev\n```\n\n> ⚠️ **安全提示：**  \n> - `DB_PASSWORD` 和 `JWT_SECRET` 为必填项，未配置时服务启动会报错  \n> - `.env` 文件已在 `.gitignore` 中，不会被提交到代码仓库  \n> - 生产环境请务必使用强随机字符串作为 `JWT_SECRET`\n\n---\n\n## 🗄️ 数据库设计\n\n```\nfamily_member (家庭成员)\n    │\n    ├──< album (相册)\n    │       │\n    │       └──< photo (照片)\n    │               │\n    │               └──< favorite_photo (收藏记录) >── favorite_folder (收藏夹)\n    │\n    └──< ai_chat_message (AI 聊天记录)\n```\n\n| 表名 | 说明 | 关键字段 |\n|------|------|---------|\n| `family_member` | 家庭成员 / 登录账号 | `username`(唯一), `password`(bcrypt), **`is_admin`**(权限标识) |\n| `album` | 相册 | `album_name`, `cover_path`, **`creator_id`**(创建者), `last_upload_user_id` |\n| `photo` | 照片 | `file_path`, `album_id`, `member_id`(归属), `operator_id`(上传者) |\n| `favorite_folder` | 收藏夹 | `folder_name`, `member_id`, `is_default` |\n| `favorite_photo` | 收藏记录 | `folder_id`, `photo_id`, `member_id`（唯一约束防重复） |\n| `ai_chat_message` | AI 聊天记录 | `member_id`, `role`(user/assistant), `content` |\n\n> 加粗字段为本次新增。完整建表 SQL 见 `family-photo-backend/sql/table_info.sql`\n\n---\n\n## 📡 API 接口\n\n### 认证\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/login` | 登录（返回 JWT Token） |\n| POST | `/api/logout` | 登出 |\n\n### 相册\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/albums` | ✅ | 获取所有相册列表 |\n| POST | `/api/album/create` | ✅ | 创建相册（可上传封面） |\n| POST | `/api/album/rename` | ✅ | 修改相册名称 |\n| POST | `/api/album/delete` | ✅ | 删除相册（级联删除照片） |\n| POST | `/api/album/cover/upload` | ✅ | 上传/更换相册封面 |\n| GET | `/api/photos/album/:id` | ✅ | 获取相册下照片（分页） |\n\n### 照片\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| POST | `/api/photos/upload` | ✅ | 上传照片 |\n| POST | `/api/photos/delete` | ✅ | 删除照片 |\n| GET | `/api/photos/search` | ✅ | 搜索照片（支持多条件筛选） |\n\n### 收藏\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/favorite/folders` | ✅ | 获取收藏夹列表 |\n| POST | `/api/favorite/folders` | ✅ | 创建收藏夹 |\n| PUT | `/api/favorite/folders/:id` | ✅ | 修改收藏夹名称 |\n| DELETE | `/api/favorite/folders/:id` | ✅ | 删除收藏夹 |\n| POST | `/api/favorite/photos` | ✅ | 照片加入收藏 |\n| DELETE | `/api/favorite/photos` | ✅ | 照片移出收藏 |\n| GET | `/api/favorite/photos/:folder_id` | ✅ | 获取收藏夹内照片 |\n\n### 成员 & AI\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/current-member` | ✅ | 获取当前登录成员信息 |\n| GET | `/api/members` | ✅ | 获取所有家庭成员 |\n| GET | `/api/chat/history` | ✅ | 获取聊天记录（默认近 3 个月） |\n| POST | `/api/chat/send` | ✅ | 发送消息 & 获取 AI 回复 |\n| GET | `/api/chat/models` | ✅ | 查询 AI 提供商 & 可用模型 |\n| POST | `/api/chat/clear` | ✅ | 清空聊天记录 |\n\n### 静态文件\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/uploads/photos/:filename` | ✅ | 获取照片文件 |\n| GET | `/uploads/covers/:filename` | ✅ | 获取封面文件 |\n\n---\n\n## 🔐 安全机制\n\n| 层面 | 措施 |\n|------|------|\n| **认证** | JWT Token（HS256，24h 过期），`@login_required` 装饰器保护所有接口 |\n| **密码** | 前端 SHA256 + 后端 bcrypt（salt rounds=12）双重加密 |\n| **权限隔离** | `is_admin` 字段区分管理员/普通用户，普通用户只能操作自己创建的相册及照片 |\n| **文件上传** | 扩展名白名单校验、`secure_filename` 过滤、唯一文件名防覆盖 |\n| **路径安全** | 上传目录限制 + `_safe_path()` 绝对路径校验，防止路径遍历 |\n| **数据校验** | `album_id` 等参数强制正整数校验，存在性校验防止对不存在资源操作 |\n| **SQL 注入** | 全部使用 PyMySQL 参数化查询 (`%s`) |\n| **CORS** | Flask-CORS 配置 `supports_credentials=True` |\n\n---\n\n## 👥 权限体系\n\n### 角色说明\n\n| 角色 | `is_admin` 值 | 权限范围 |\n|------|--------------|---------|\n| **管理员** | `1` | 查看所有相册，操作所有资源 |\n| **普通成员** | `0`（默认） | 只能查看/操作**自己创建的**相册及照片 |\n\n### 权限配置\n\n在数据库中手动设置：\n\n```sql\n-- 将某用户设为管理员\nUPDATE family_member SET is_admin = 1 WHERE username = 'father';\n\n-- 取消管理员权限\nUPDATE family_member SET is_admin = 0 WHERE username = 'father';\n\n-- 查看所有成员的权限\nSELECT id, name, username, is_admin FROM family_member;\n```\n\n### 权限覆盖范围\n\n| 操作 | 管理员 | 普通成员 |\n|------|--------|---------|\n| 查看相册列表 | 所有相册 | 仅自己创建的 |\n| 查看相册照片 | 任意相册 | 仅自己创建的相册 |\n| 创建相册 | ✅ | ✅（自动成为创建者） |\n| 重命名/删除相册 | 任意相册 | 仅自己创建的 |\n| 更换相册封面 | 任意相册 | 仅自己创建的 |\n| 上传照片 | 任意相册 | 仅自己创建的相册 |\n| 删除照片 | 任意照片 | 仅自己相册中的照片 |\n| 搜索照片 | 任意相册 | 仅自己创建的相册 |\n| 收藏/取消收藏 | ✅ | ✅（收藏为个人行为，无需权限） |\n\n---\n\n## 🤖 AI 助手\n\n支持三种 AI 提供商，通过环境变量 `AI_PROVIDER` 切换：\n\n| 提供商 | 配置方式 | 特点 |\n|--------|---------|------|\n| **OpenAI** | 配置 `AI_API_KEY` + `AI_API_BASE` | 支持 OpenAI / DeepSeek / 通义千问等兼容接口 |\n| **Ollama** | `AI_PROVIDER=ollama` | 本地部署，无需 API Key，完全离线 |\n| **模拟模式** | 不配置 `AI_API_KEY` | 自动使用预设回复，方便体验功能 |\n\n---\n\n## 📸 功能预览\n\n| 页面 | 功能 |\n|------|------|\n| 🔑 登录页 | 温馨风格登录，SHA256 密码加密传输 |\n| 📁 相册列表 | 展示所有相册，显示封面、最后上传人和时间 |\n| 🖼️ 相册详情 | 照片网格展示、分页加载、搜索筛选 |\n| 📤 上传区域 | 填写归属成员、拍摄时间、备注后批量上传 |\n| 📷 拍照上传 | 调用摄像头拍照 → 预览 → 选择归属人 → 上传 |\n| 💖 收藏管理 | 收藏夹列表 + 收藏照片网格，支持增删改 |\n| 🤖 AI 助手 | 全局悬浮对话窗，聊天记录按账号隔离 |\n\n---\n\n## 🛠️ 开发说明\n\n### 前端代理配置（`craco.config.js`）\n\n```javascript\n// 开发环境下自动代理到后端\n'/api'      → http://localhost:5000/api\n'/uploads'  → http://localhost:5000/uploads\n```\n\n### 日志系统\n\n- 日志目录：`family-photo-backend/logs/`\n- `info.log`：常规操作日志（保留 30 天）\n- `error.log`：错误日志（保留 90 天）\n- 按天自动轮转，Windows 下安全处理文件锁定\n\n### 密码加密流程\n\n```\n用户输入明文密码\n    │\n    ▼\n前端 CryptoJS.SHA256(password)  ──→  SHA256 哈希\n    │\n    ▼\nPOST /api/login  { password: sha256_hash }\n    │\n    ▼\n后端 bcrypt.checkpw(sha256_hash, db_bcrypt_hash)  ──→  验证结果\n```\n\n---\n\n## 📋 待办事项\n\n- [ ] 实现 Token 黑名单机制，使 Logout 真正生效\n- [ ] 添加照片 EXIF 信息自动提取（拍摄时间、GPS 等）\n- [ ] 支持照片压缩上传，减少存储空间\n- [ ] 添加照片分享功能（生成临时链接）\n\n---\n\n## 📄 License\n\nMIT License © 2026 Family Photo Manager"}, "85ce0ce91ead6f3f61c551e62487a7300377a43b": {"t": 1785771642.7517693, "n": 11497, "h": "53b32a548ab312ae", "c": "<div align=\"center\">\n\n# 📷 家庭相册 Family Photo Manager\n\n**记录每一个温馨瞬间，让家人之间的距离更近一点 💖**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask)](https://flask.palletsprojects.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)\n[![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170F8?logo=ant-design)](https://ant.design/)\n[![MySQL](https://img.shields.io/badge/MySQL-5.7+-4479A1?logo=mysql)](https://www.mysql.com/)\n\n</div>\n\n---\n\n## 📖 项目简介\n\n家庭相册是一个专为家庭设计的私密照片管理系统。支持多家庭成员共享相册、照片上传/拍照、收藏管理，并内置 AI 智能助手提供温馨互动。所有数据存储在本地，保护家庭隐私。\n\n### ✨ 核心功能\n\n| 功能模块 | 描述 |\n|---------|------|\n| 📁 **相册管理** | 创建、重命名、删除相册，自定义封面 |\n| 📤 **照片上传** | 支持批量上传，记录拍摄时间、归属成员、备注 |\n| 📷 **拍照功能** | 调用摄像头直接拍照并上传（需 HTTPS 环境） |\n| 🔍 **照片搜索** | 按名称、归属人、上传者、日期范围筛选 |\n| 💖 **收藏管理** | 创建收藏夹，照片加入收藏/移出，支持多个收藏夹 |\n| 👨‍👩‍👧 **家庭成员** | 多成员管理，照片记录归属人和上传者 |\n| 🤖 **AI 助手** | 内置 AI 对话功能，支持 OpenAI / Ollama 等多种提供商 |\n| 🔐 **登录鉴权** | JWT Token 认证，SHA256 + bcrypt 双重密码加密 |\n\n---\n\n## 🏗️ 技术架构\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   前端 (React 19)                    │\n│  Ant Design 6 · React Router 7 · Axios · Less       │\n│                    :3000 (craco)                     │\n└──────────────────────┬──────────────────────────────┘\n                       │  /api/*  /uploads/*\n                       ▼\n┌─────────────────────────────────────────────────────┐\n│                 后端 (Flask 2.3)                      │\n│  PyJWT · bcrypt · PyMySQL · Werkzeug · python-dotenv│\n│                    :5000                              │\n└───────┬─────────────────────────┬───────────────────┘\n        ▼                         ▼\n┌───────────────┐      ┌──────────────────┐\n│   MySQL 5.7+  │      │  本地文件系统     │\n│  family_photo │      │  uploads/photos  │\n│               │      │  uploads/covers  │\n└───────────────┘      └──────────────────┘\n```\n\n---\n\n## 📂 项目结构\n\n```\nPhotoManager/\n├── family-photo-backend/          # 🔧 后端 (Flask)\n│   ├── config/\n│   │   ├── config.py              # 数据库/JWT/密码加密配置\n│   │   └── log_config.py          # 日志配置（按天轮转）\n│   ├── src/\n│   │   ├── main.py                # Flask 应用入口\n│   │   ├── auth.py                # 登录/登出/Token 鉴权\n│   │   ├── album.py               # 相册 CRUD + 封面上传\n│   │   ├── photo.py               # 照片上传/搜索/删除\n│   │   ├── favorite.py            # 收藏夹 & 收藏照片管理\n│   │   ├── member.py              # 家庭成员查询\n│   │   ├── file.py                # 静态文件服务（路径遍历防护）\n│   │   ├── chat.py                # AI 对话接口\n│   │   ├── ai_service.py          # AI 服务（OpenAI/Ollama）\n│   │   └── utils.py               # 数据库连接 & 工具函数\n│   ├── sql/\n│   │   └── table_info.sql         # 数据库建表 SQL\n│   ├── uploads/                   # 上传文件存储\n│   │   ├── photos/                # 照片文件（按 album_id 分目录）\n│   │   └── covers/                # 相册封面\n│   ├── logs/                      # 日志文件（自动生成）\n│   ├── .env.example               # 环境变量模板\n│   └── requirements.txt           # Python 依赖\n│\n├── family-photo-frontend/         # 🎨 前端 (React)\n│   ├── src/\n│   │   ├── pages/\n│   │   │   ├── Login/             # 登录页\n│   │   │   ├── AlbumList/         # 相册列表\n│   │   │   ├── AlbumDetail/       # 相册详情\n│   │   │   │   ├── components/\n│   │   │   │   │   ├── AlbumPhotoList/  # 照片列表（分页）\n│   │   │   │   │   ├── UploadArare/     # 照片上传区\n│   │   │   │   │   └── PhotoCapture/    # 摄像头拍照\n│   │   │   │   └── popwin/\n│   │   │   │       ├── FilterPopwin/          # 搜索筛选弹窗\n│   │   │   │       └── FavoriteConfirmModal/  # 收藏确认弹窗\n│   │   │   ├── CreateAlbum/       # 创建相册\n│   │   │   └── FavoriteManager/   # 收藏管理\n│   │   ├── components/\n│   │   │   ├── PrivateRoute.js    # 路由守卫\n│   │   │   ├── HeaderComponent.js # 顶部导航\n│   │   │   ├── AiChat/           # AI 对话悬浮窗\n│   │   │   └── ButtonWrapper/    # 按钮封装\n│   │   ├── contexts/\n│   │   │   └── MemberContext.js   # 当前登录成员上下文\n│   │   ├── utils/\n│   │   │   ├── request.js         # Axios 封装（Token 拦截器）\n│   │   │   └── dateUtil.js        # 日期格式化工具\n│   │   └── App.js                 # 路由配置入口\n│   ├── craco.config.js            # Craco 配置（Less/代理）\n│   └── package.json\n│\n└── README.md\n```\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Python | 3.8+ |\n| Node.js | 16+ |\n| MySQL | 5.7+ |\n| npm / yarn | 最新稳定版 |\n\n### 1️⃣ 克隆项目\n\n```bash\ngit clone <your-repo-url>\ncd PhotoManager\n```\n\n### 2️⃣ 初始化数据库\n\n```bash\n# 登录 MySQL 创建数据库\nmysql -u root -p\n\nCREATE DATABASE family_photo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nUSE family_photo;\n\n# 导入建表 SQL（新建数据库时使用）\nsource family-photo-backend/sql/table_info.sql;\n\n# （可选）插入测试家庭成员\nINSERT INTO family_member (name, relation, username, password, email) VALUES\n('爸爸', 'father', 'father', '此处填SHA256哈希', 'father@example.com'),\n('妈妈', 'mother', 'mother', '此处填SHA256哈希', 'mother@example.com');\n```\n\n> 💡 密码存储流程：**前端 SHA256** → **后端 bcrypt 加密** → 存入数据库。  \n> 初始密码可先用 `config/config.py` 中的 `encrypt_password()` 函数生成哈希。\n\n### 3️⃣ 启动后端\n\n```bash\ncd family-photo-backend\n\n# 创建虚拟环境（推荐）\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 配置环境变量（必须！）\ncp .env.example .env\n# 编辑 .env，填入以下必要配置：\n#   DB_PASSWORD  — 数据库密码\n#   JWT_SECRET   — JWT 密钥（用 python -c \"import secrets; print(secrets.token_hex(32))\" 生成）\n#   AI_API_KEY   — AI 服务密钥（可选）\n\n# 启动服务\npython -m src.main\n# 后端运行在 http://localhost:5000\n```\n\n### 4️⃣ 启动前端\n\n```bash\ncd family-photo-frontend\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm start\n# 前端运行在 http://localhost:3000\n# 已配置代理：/api/* 和 /uploads/* 自动转发到后端 5000 端口\n```\n\n---\n\n## ⚙️ 环境变量配置\n\n在 `family-photo-backend/.env` 中配置（参考 `.env.example`）：\n\n```bash\n# ── 数据库配置（必填！）─────────────────────\nDB_HOST=localhost\nDB_USER=root\nDB_PASSWORD=你的数据库密码\nDB_NAME=family_photo\n\n# ── JWT 密钥（必填！）──────────────────────\n# 生成方式：python -c \"import secrets; print(secrets.token_hex(32))\"\nJWT_SECRET=你的JWT密钥\nJWT_EXPIRE_HOURS=24\n\n# ── AI 服务配置 ──────────────────────────────\n# 提供商：openai（默认）| ollama（本地部署，无需 API Key）\nAI_PROVIDER=openai\n\n# OpenAI / DeepSeek / 通义千问\nAI_API_KEY=sk-xxx\nAI_API_BASE=https://api.openai.com/v1\nAI_MODEL=gpt-3.5-turbo\n\n# ── 使用 Ollama 本地部署时，改为以下配置 ───────\n# AI_PROVIDER=ollama\n# AI_MODEL=llama3\n# AI_API_BASE=http://localhost:11434\n\n# ── 通用 ─────────────────────────────────────\nAI_TIMEOUT=60\n\n# ── Flask 环境 ───────────────────────────────\nFLASK_ENV=dev\n```\n\n> ⚠️ **安全提示：**  \n> - `DB_PASSWORD` 和 `JWT_SECRET` 为必填项，未配置时服务启动会报错  \n> - `.env` 文件已在 `.gitignore` 中，不会被提交到代码仓库  \n> - 生产环境请务必使用强随机字符串作为 `JWT_SECRET`\n\n---\n\n## 🗄️ 数据库设计\n\n```\nfamily_member (家庭成员)\n    │\n    ├──< album (相册)\n    │       │\n    │       └──< photo (照片)\n    │               │\n    │               └──< favorite_photo (收藏记录) >── favorite_folder (收藏夹)\n    │\n    └──< ai_chat_message (AI 聊天记录)\n```\n\n| 表名 | 说明 | 关键字段 |\n|------|------|---------|\n| `family_member` | 家庭成员 / 登录账号 | `username`(唯一), `password`(bcrypt), **`is_admin`**(权限标识) |\n| `album` | 相册 | `album_name`, `cover_path`, **`creator_id`**(创建者), `last_upload_user_id` |\n| `photo` | 照片 | `file_path`, `album_id`, `member_id`(归属), `operator_id`(上传者) |\n| `favorite_folder` | 收藏夹 | `folder_name`, `member_id`, `is_default` |\n| `favorite_photo` | 收藏记录 | `folder_id`, `photo_id`, `member_id`（唯一约束防重复） |\n| `ai_chat_message` | AI 聊天记录 | `member_id`, `role`(user/assistant), `content` |\n\n> 加粗字段为本次新增。完整建表 SQL 见 `family-photo-backend/sql/table_info.sql`\n\n---\n\n## 📡 API 接口\n\n### 认证\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/login` | 登录（返回 JWT Token） |\n| POST | `/api/logout` | 登出 |\n\n### 相册\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/albums` | ✅ | 获取所有相册列表 |\n| POST | `/api/album/create` | ✅ | 创建相册（可上传封面） |\n| POST | `/api/album/rename` | ✅ | 修改相册名称 |\n| POST | `/api/album/delete` | ✅ | 删除相册（级联删除照片） |\n| POST | `/api/album/cover/upload` | ✅ | 上传/更换相册封面 |\n| GET | `/api/photos/album/:id` | ✅ | 获取相册下照片（分页） |\n\n### 照片\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| POST | `/api/photos/upload` | ✅ | 上传照片 |\n| POST | `/api/photos/delete` | ✅ | 删除照片 |\n| GET | `/api/photos/search` | ✅ | 搜索照片（支持多条件筛选） |\n\n### 收藏\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/favorite/folders` | ✅ | 获取收藏夹列表 |\n| POST | `/api/favorite/folders` | ✅ | 创建收藏夹 |\n| PUT | `/api/favorite/folders/:id` | ✅ | 修改收藏夹名称 |\n| DELETE | `/api/favorite/folders/:id` | ✅ | 删除收藏夹 |\n| POST | `/api/favorite/photos` | ✅ | 照片加入收藏 |\n| DELETE | `/api/favorite/photos` | ✅ | 照片移出收藏 |\n| GET | `/api/favorite/photos/:folder_id` | ✅ | 获取收藏夹内照片 |\n\n### 成员 & AI\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/current-member` | ✅ | 获取当前登录成员信息 |\n| GET | `/api/members` | ✅ | 获取所有家庭成员 |\n| GET | `/api/chat/history` | ✅ | 获取聊天记录（默认近 3 个月） |\n| POST | `/api/chat/send` | ✅ | 发送消息 & 获取 AI 回复 |\n| GET | `/api/chat/models` | ✅ | 查询 AI 提供商 & 可用模型 |\n| POST | `/api/chat/clear` | ✅ | 清空聊天记录 |\n\n### 静态文件\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/uploads/photos/:filename` | ✅ | 获取照片文件 |\n| GET | `/uploads/covers/:filename` | ✅ | 获取封面文件 |\n\n---\n\n## 🔐 安全机制\n\n| 层面 | 措施 |\n|------|------|\n| **认证** | JWT Token（HS256，24h 过期），`@login_required` 装饰器保护所有接口 |\n| **密码** | 前端 SHA256 + 后端 bcrypt（salt rounds=12）双重加密 |\n| **权限隔离** | `is_admin` 字段区分管理员/普通用户，普通用户只能操作自己创建的相册及照片 |\n| **文件上传** | 扩展名白名单校验、`secure_filename` 过滤、唯一文件名防覆盖 |\n| **路径安全** | 上传目录限制 + `_safe_path()` 绝对路径校验，防止路径遍历 |\n| **数据校验** | `album_id` 等参数强制正整数校验，存在性校验防止对不存在资源操作 |\n| **SQL 注入** | 全部使用 PyMySQL 参数化查询 (`%s`) |\n| **CORS** | Flask-CORS 配置 `supports_credentials=True` |\n\n---\n\n## 👥 权限体系\n\n### 角色说明\n\n| 角色 | `is_admin` 值 | 权限范围 |\n|------|--------------|---------|\n| **管理员** | `1` | 查看所有相册，操作所有资源 |\n| **普通成员** | `0`（默认） | 只能查看/操作**自己创建的**相册及照片 |\n\n### 权限配置\n\n在数据库中手动设置：\n\n```sql\n-- 将某用户设为管理员\nUPDATE family_member SET is_admin = 1 WHERE username = 'father';\n\n-- 取消管理员权限\nUPDATE family_member SET is_admin = 0 WHERE username = 'father';\n\n-- 查看所有成员的权限\nSELECT id, name, username, is_admin FROM family_member;\n```\n\n### 权限覆盖范围\n\n| 操作 | 管理员 | 普通成员 |\n|------|--------|---------|\n| 查看相册列表 | 所有相册 | 仅自己创建的 |\n| 查看相册照片 | 任意相册 | 仅自己创建的相册 |\n| 创建相册 | ✅ | ✅（自动成为创建者） |\n| 重命名/删除相册 | 任意相册 | 仅自己创建的 |\n| 更换相册封面 | 任意相册 | 仅自己创建的 |\n| 上传照片 | 任意相册 | 仅自己创建的相册 |\n| 删除照片 | 任意照片 | 仅自己相册中的照片 |\n| 搜索照片 | 任意相册 | 仅自己创建的相册 |\n| 收藏/取消收藏 | ✅ | ✅（收藏为个人行为，无需权限） |\n\n---\n\n## 🤖 AI 助手\n\n支持三种 AI 提供商，通过环境变量 `AI_PROVIDER` 切换：\n\n| 提供商 | 配置方式 | 特点 |\n|--------|---------|------|\n| **OpenAI** | 配置 `AI_API_KEY` + `AI_API_BASE` | 支持 OpenAI / DeepSeek / 通义千问等兼容接口 |\n| **Ollama** | `AI_PROVIDER=ollama` | 本地部署，无需 API Key，完全离线 |\n| **模拟模式** | 不配置 `AI_API_KEY` | 自动使用预设回复，方便体验功能 |\n\n---\n\n## 📸 功能预览\n\n| 页面 | 功能 |\n|------|------|\n| 🔑 登录页 | 温馨风格登录，SHA256 密码加密传输 |\n| 📁 相册列表 | 展示所有相册，显示封面、最后上传人和时间 |\n| 🖼️ 相册详情 | 照片网格展示、分页加载、搜索筛选 |\n| 📤 上传区域 | 填写归属成员、拍摄时间、备注后批量上传 |\n| 📷 拍照上传 | 调用摄像头拍照 → 预览 → 选择归属人 → 上传 |\n| 💖 收藏管理 | 收藏夹列表 + 收藏照片网格，支持增删改 |\n| 🤖 AI 助手 | 全局悬浮对话窗，聊天记录按账号隔离 |\n\n---\n\n## 🛠️ 开发说明\n\n### 前端代理配置（`craco.config.js`）\n\n```javascript\n// 开发环境下自动代理到后端\n'/api'      → http://localhost:5000/api\n'/uploads'  → http://localhost:5000/uploads\n```\n\n### 日志系统\n\n- 日志目录：`family-photo-backend/logs/`\n- `info.log`：常规操作日志（保留 30 天）\n- `error.log`：错误日志（保留 90 天）\n- 按天自动轮转，Windows 下安全处理文件锁定\n\n### 密码加密流程\n\n```\n用户输入明文密码\n    │\n    ▼\n前端 CryptoJS.SHA256(password)  ──→  SHA256 哈希\n    │\n    ▼\nPOST /api/login  { password: sha256_hash }\n    │\n    ▼\n后端 bcrypt.checkpw(sha256_hash, db_bcrypt_hash)  ──→  验证结果\n```\n\n---\n\n## 📋 待办事项\n\n- [ ] 实现 Token 黑名单机制，使 Logout 真正生效\n- [ ] 添加照片 EXIF 信息自动提取（拍摄时间、GPS 等）\n- [ ] 支持照片压缩上传，减少存储空间\n- [ ] 添加照片分享功能（生成临时链接）\n\n---\n\n## 📄 License\n\nMIT License © 2026 Family Photo Manager"}, "da8bc81128da1c501ef5b7f9432e9480b2020993": {"t": 1785771645.0000422, "n": 11146, "h": "2eacf59d05c05175", "c": "<div align=\"center\">\n\n# 📷 家庭相册 Family Photo Manager\n\n**记录每一个温馨瞬间，让家人之间的距离更近一点 💖**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask)](https://flask.palletsprojects.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)\n[![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170F8?logo=ant-design)](https://ant.design/)\n[![MySQL](https://img.shields.io/badge/MySQL-5.7+-4479A1?logo=mysql)](https://www.mysql.com/)\n\n</div>\n\n---\n\n## 📖 项目简介\n\n家庭相册是一个专为家庭设计的私密照片管理系统。支持多家庭成员共享相册、照片上传/拍照、收藏管理，并内置 AI 智能助手提供温馨互动。所有数据存储在本地，保护家庭隐私。\n\n### ✨ 核心功能\n\n| 功能模块 | 描述 |\n|---------|------|\n| 📁 **相册管理** | 创建、重命名、删除相册，自定义封面 |\n| 📤 **照片上传** | 支持批量上传，记录拍摄时间、归属成员、备注 |\n| 📷 **拍照功能** | 调用摄像头直接拍照并上传（需 HTTPS 环境） |\n| 🔍 **照片搜索** | 按名称、归属人、上传者、日期范围筛选 |\n| 💖 **收藏管理** | 创建收藏夹，照片加入收藏/移出，支持多个收藏夹 |\n| 👨‍👩‍👧 **家庭成员** | 多成员管理，照片记录归属人和上传者 |\n| 🤖 **AI 助手** | 内置 AI 对话功能，支持 OpenAI / Ollama 等多种提供商 |\n| 🔐 **登录鉴权** | JWT Token 认证，SHA256 + bcrypt 双重密码加密 |\n\n---\n\n## 🏗️ 技术架构\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   前端 (React 19)                    │\n│  Ant Design 6 · React Router 7 · Axios · Less       │\n│                    :3000 (craco)                     │\n└──────────────────────┬──────────────────────────────┘\n                       │  /api/*  /uploads/*\n                       ▼\n┌─────────────────────────────────────────────────────┐\n│                 后端 (Flask 2.3)                      │\n│  PyJWT · bcrypt · PyMySQL · Werkzeug · python-dotenv│\n│                    :5000                              │\n└───────┬─────────────────────────┬───────────────────┘\n        ▼                         ▼\n┌───────────────┐      ┌──────────────────┐\n│   MySQL 5.7+  │      │  本地文件系统     │\n│  family_photo │      │  uploads/photos  │\n│               │      │  uploads/covers  │\n└───────────────┘      └──────────────────┘\n```\n\n---\n\n## 📂 项目结构\n\n```\nPhotoManager/\n├── family-photo-backend/          # 🔧 后端 (Flask)\n│   ├── config/\n│   │   ├── config.py              # 数据库/JWT/密码加密配置\n│   │   └── log_config.py          # 日志配置（按天轮转）\n│   ├── src/\n│   │   ├── main.py                # Flask 应用入口\n│   │   ├── auth.py                # 登录/登出/Token 鉴权\n│   │   ├── album.py               # 相册 CRUD + 封面上传\n│   │   ├── photo.py               # 照片上传/搜索/删除\n│   │   ├── favorite.py            # 收藏夹 & 收藏照片管理\n│   │   ├── member.py              # 家庭成员查询\n│   │   ├── file.py                # 静态文件服务（路径遍历防护）\n│   │   ├── chat.py                # AI 对话接口\n│   │   ├── ai_service.py          # AI 服务（OpenAI/Ollama）\n│   │   └── utils.py               # 数据库连接 & 工具函数\n│   ├── sql/\n│   │   └── table_info.sql         # 数据库建表 SQL\n│   ├── uploads/                   # 上传文件存储\n│   │   ├── photos/                # 照片文件（按 album_id 分目录）\n│   │   └── covers/                # 相册封面\n│   ├── logs/                      # 日志文件（自动生成）\n│   ├── .env.example               # 环境变量模板\n│   └── requirements.txt           # Python 依赖\n│\n├── family-photo-frontend/         # 🎨 前端 (React)\n│   ├── src/\n│   │   ├── pages/\n│   │   │   ├── Login/             # 登录页\n│   │   │   ├── AlbumList/         # 相册列表\n│   │   │   ├── AlbumDetail/       # 相册详情\n│   │   │   │   ├── components/\n│   │   │   │   │   ├── AlbumPhotoList/  # 照片列表（分页）\n│   │   │   │   │   ├── UploadArare/     # 照片上传区\n│   │   │   │   │   └── PhotoCapture/    # 摄像头拍照\n│   │   │   │   └── popwin/\n│   │   │   │       ├── FilterPopwin/          # 搜索筛选弹窗\n│   │   │   │       └── FavoriteConfirmModal/  # 收藏确认弹窗\n│   │   │   ├── CreateAlbum/       # 创建相册\n│   │   │   └── FavoriteManager/   # 收藏管理\n│   │   ├── components/\n│   │   │   ├── PrivateRoute.js    # 路由守卫\n│   │   │   ├── HeaderComponent.js # 顶部导航\n│   │   │   ├── AiChat/           # AI 对话悬浮窗\n│   │   │   └── ButtonWrapper/    # 按钮封装\n│   │   ├── contexts/\n│   │   │   └── MemberContext.js   # 当前登录成员上下文\n│   │   ├── utils/\n│   │   │   ├── request.js         # Axios 封装（Token 拦截器）\n│   │   │   └── dateUtil.js        # 日期格式化工具\n│   │   └── App.js                 # 路由配置入口\n│   ├── craco.config.js            # Craco 配置（Less/代理）\n│   └── package.json\n│\n└── README.md\n```\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Python | 3.8+ |\n| Node.js | 16+ |\n| MySQL | 5.7+ |\n| npm / yarn | 最新稳定版 |\n\n### 1️⃣ 克隆项目\n\n```bash\ngit clone <your-repo-url>\ncd PhotoManager\n```\n\n### 2️⃣ 初始化数据库\n\n```bash\n# 登录 MySQL 创建数据库\nmysql -u root -p\n\nCREATE DATABASE family_photo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nUSE family_photo;\n\n# 导入建表 SQL（新建数据库时使用）\nsource family-photo-backend/sql/table_info.sql;\n\n# （可选）插入测试家庭成员\nINSERT INTO family_member (name, relation, username, password, email) VALUES\n('爸爸', 'father', 'father', '此处填SHA256哈希', 'father@example.com'),\n('妈妈', 'mother', 'mother', '此处填SHA256哈希', 'mother@example.com');\n```\n\n> 💡 密码存储流程：**前端 SHA256** → **后端 bcrypt 加密** → 存入数据库。  \n> 初始密码可先用 `config/config.py` 中的 `encrypt_password()` 函数生成哈希。\n\n### 3️⃣ 启动后端\n\n```bash\ncd family-photo-backend\n\n# 创建虚拟环境（推荐）\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 配置环境变量\ncp .env.example .env\n# 编辑 .env 填入数据库密码和 AI 配置\n\n# 修改 config/config.py 中的数据库连接信息\n# DB_CONFIG = { 'host': 'localhost', 'user': 'root', 'password': '你的密码', ... }\n\n# 启动服务\npython -m src.main\n# 后端运行在 http://localhost:5000\n```\n\n### 4️⃣ 启动前端\n\n```bash\ncd family-photo-frontend\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm start\n# 前端运行在 http://localhost:3000\n# 已配置代理：/api/* 和 /uploads/* 自动转发到后端 5000 端口\n```\n\n---\n\n## ⚙️ 环境变量配置\n\n在 `family-photo-backend/.env` 中配置：\n\n```bash\n# ── AI 服务配置 ──────────────────────────────\n# 提供商：openai（默认）| ollama（本地部署，无需 API Key）\nAI_PROVIDER=openai\n\n# OpenAI / DeepSeek / 通义千问\nAI_API_KEY=sk-xxx\nAI_API_BASE=https://api.openai.com/v1\nAI_MODEL=gpt-3.5-turbo\n\n# ── 使用 Ollama 本地部署时，改为以下配置 ───────\n# AI_PROVIDER=ollama\n# AI_MODEL=llama3\n# AI_API_BASE=http://localhost:11434\n\n# ── 通用 ─────────────────────────────────────\nAI_TIMEOUT=60\n\n# ── Flask 环境 ───────────────────────────────\nFLASK_ENV=dev\n```\n\n---\n\n## 🗄️ 数据库设计\n\n```\nfamily_member (家庭成员)\n    │\n    ├──< album (相册)\n    │       │\n    │       └──< photo (照片)\n    │               │\n    │               └──< favorite_photo (收藏记录) >── favorite_folder (收藏夹)\n    │\n    └──< ai_chat_message (AI 聊天记录)\n```\n\n| 表名 | 说明 | 关键字段 |\n|------|------|---------|\n| `family_member` | 家庭成员 / 登录账号 | `username`(唯一), `password`(bcrypt), **`is_admin`**(权限标识) |\n| `album` | 相册 | `album_name`, `cover_path`, **`creator_id`**(创建者), `last_upload_user_id` |\n| `photo` | 照片 | `file_path`, `album_id`, `member_id`(归属), `operator_id`(上传者) |\n| `favorite_folder` | 收藏夹 | `folder_name`, `member_id`, `is_default` |\n| `favorite_photo` | 收藏记录 | `folder_id`, `photo_id`, `member_id`（唯一约束防重复） |\n| `ai_chat_message` | AI 聊天记录 | `member_id`, `role`(user/assistant), `content` |\n\n> 加粗字段为本次新增。完整建表 SQL 见 `family-photo-backend/sql/table_info.sql`\n\n---\n\n## 📡 API 接口\n\n### 认证\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/login` | 登录（返回 JWT Token） |\n| POST | `/api/logout` | 登出 |\n\n### 相册\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/albums` | ✅ | 获取所有相册列表 |\n| POST | `/api/album/create` | ✅ | 创建相册（可上传封面） |\n| POST | `/api/album/rename` | ✅ | 修改相册名称 |\n| POST | `/api/album/delete` | ✅ | 删除相册（级联删除照片） |\n| POST | `/api/album/cover/upload` | ✅ | 上传/更换相册封面 |\n| GET | `/api/photos/album/:id` | ✅ | 获取相册下照片（分页） |\n\n### 照片\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| POST | `/api/photos/upload` | ✅ | 上传照片 |\n| POST | `/api/photos/delete` | ✅ | 删除照片 |\n| GET | `/api/photos/search` | ✅ | 搜索照片（支持多条件筛选） |\n\n### 收藏\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/favorite/folders` | ✅ | 获取收藏夹列表 |\n| POST | `/api/favorite/folders` | ✅ | 创建收藏夹 |\n| PUT | `/api/favorite/folders/:id` | ✅ | 修改收藏夹名称 |\n| DELETE | `/api/favorite/folders/:id` | ✅ | 删除收藏夹 |\n| POST | `/api/favorite/photos` | ✅ | 照片加入收藏 |\n| DELETE | `/api/favorite/photos` | ✅ | 照片移出收藏 |\n| GET | `/api/favorite/photos/:folder_id` | ✅ | 获取收藏夹内照片 |\n\n### 成员 & AI\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/current-member` | ✅ | 获取当前登录成员信息 |\n| GET | `/api/members` | ✅ | 获取所有家庭成员 |\n| GET | `/api/chat/history` | ✅ | 获取聊天记录（默认近 3 个月） |\n| POST | `/api/chat/send` | ✅ | 发送消息 & 获取 AI 回复 |\n| GET | `/api/chat/models` | ✅ | 查询 AI 提供商 & 可用模型 |\n| POST | `/api/chat/clear` | ✅ | 清空聊天记录 |\n\n### 静态文件\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/uploads/photos/:filename` | ✅ | 获取照片文件 |\n| GET | `/uploads/covers/:filename` | ✅ | 获取封面文件 |\n\n---\n\n## 🔐 安全机制\n\n| 层面 | 措施 |\n|------|------|\n| **认证** | JWT Token（HS256，24h 过期），`@login_required` 装饰器保护所有接口 |\n| **密码** | 前端 SHA256 + 后端 bcrypt（salt rounds=12）双重加密 |\n| **权限隔离** | `is_admin` 字段区分管理员/普通用户，普通用户只能操作自己创建的相册及照片 |\n| **文件上传** | 扩展名白名单校验、`secure_filename` 过滤、唯一文件名防覆盖 |\n| **路径安全** | 上传目录限制 + `_safe_path()` 绝对路径校验，防止路径遍历 |\n| **数据校验** | `album_id` 等参数强制正整数校验，存在性校验防止对不存在资源操作 |\n| **SQL 注入** | 全部使用 PyMySQL 参数化查询 (`%s`) |\n| **CORS** | Flask-CORS 配置 `supports_credentials=True` |\n\n---\n\n## 👥 权限体系\n\n### 角色说明\n\n| 角色 | `is_admin` 值 | 权限范围 |\n|------|--------------|---------|\n| **管理员** | `1` | 查看所有相册，操作所有资源 |\n| **普通成员** | `0`（默认） | 只能查看/操作**自己创建的**相册及照片 |\n\n### 权限配置\n\n在数据库中手动设置：\n\n```sql\n-- 将某用户设为管理员\nUPDATE family_member SET is_admin = 1 WHERE username = 'father';\n\n-- 取消管理员权限\nUPDATE family_member SET is_admin = 0 WHERE username = 'father';\n\n-- 查看所有成员的权限\nSELECT id, name, username, is_admin FROM family_member;\n```\n\n### 权限覆盖范围\n\n| 操作 | 管理员 | 普通成员 |\n|------|--------|---------|\n| 查看相册列表 | 所有相册 | 仅自己创建的 |\n| 查看相册照片 | 任意相册 | 仅自己创建的相册 |\n| 创建相册 | ✅ | ✅（自动成为创建者） |\n| 重命名/删除相册 | 任意相册 | 仅自己创建的 |\n| 更换相册封面 | 任意相册 | 仅自己创建的 |\n| 上传照片 | 任意相册 | 仅自己创建的相册 |\n| 删除照片 | 任意照片 | 仅自己相册中的照片 |\n| 搜索照片 | 任意相册 | 仅自己创建的相册 |\n| 收藏/取消收藏 | ✅ | ✅（收藏为个人行为，无需权限） |\n\n---\n\n## 🤖 AI 助手\n\n支持三种 AI 提供商，通过环境变量 `AI_PROVIDER` 切换：\n\n| 提供商 | 配置方式 | 特点 |\n|--------|---------|------|\n| **OpenAI** | 配置 `AI_API_KEY` + `AI_API_BASE` | 支持 OpenAI / DeepSeek / 通义千问等兼容接口 |\n| **Ollama** | `AI_PROVIDER=ollama` | 本地部署，无需 API Key，完全离线 |\n| **模拟模式** | 不配置 `AI_API_KEY` | 自动使用预设回复，方便体验功能 |\n\n---\n\n## 📸 功能预览\n\n| 页面 | 功能 |\n|------|------|\n| 🔑 登录页 | 温馨风格登录，SHA256 密码加密传输 |\n| 📁 相册列表 | 展示所有相册，显示封面、最后上传人和时间 |\n| 🖼️ 相册详情 | 照片网格展示、分页加载、搜索筛选 |\n| 📤 上传区域 | 填写归属成员、拍摄时间、备注后批量上传 |\n| 📷 拍照上传 | 调用摄像头拍照 → 预览 → 选择归属人 → 上传 |\n| 💖 收藏管理 | 收藏夹列表 + 收藏照片网格，支持增删改 |\n| 🤖 AI 助手 | 全局悬浮对话窗，聊天记录按账号隔离 |\n\n---\n\n## 🛠️ 开发说明\n\n### 前端代理配置（`craco.config.js`）\n\n```javascript\n// 开发环境下自动代理到后端\n'/api'      → http://localhost:5000/api\n'/uploads'  → http://localhost:5000/uploads\n```\n\n### 日志系统\n\n- 日志目录：`family-photo-backend/logs/`\n- `info.log`：常规操作日志（保留 30 天）\n- `error.log`：错误日志（保留 90 天）\n- 按天自动轮转，Windows 下安全处理文件锁定\n\n### 密码加密流程\n\n```\n用户输入明文密码\n    │\n    ▼\n前端 CryptoJS.SHA256(password)  ──→  SHA256 哈希\n    │\n    ▼\nPOST /api/login  { password: sha256_hash }\n    │\n    ▼\n后端 bcrypt.checkpw(sha256_hash, db_bcrypt_hash)  ──→  验证结果\n```\n\n---\n\n## 📋 待办事项\n\n- [ ] 实现 Token 黑名单机制，使 Logout 真正生效\n- [ ] 添加相册/照片的访问权限控制（按成员隔离）\n- [ ] 将数据库密码和 JWT 密钥迁移到环境变量\n- [ ] 前端 Token 改用 HttpOnly Cookie 传递，避免 URL 暴露\n- [ ] 添加照片 EXIF 信息自动提取（拍摄时间、GPS 等）\n- [ ] 支持照片压缩上传，减少存储空间\n- [ ] 添加照片分享功能（生成临时链接）\n\n---\n\n## 📄 License\n\nMIT License © 2026 Family Photo Manager"}, "0aa5d81b56e4d304b430f28bb0de91f9d83db520": {"t": 1785771648.1729136, "n": 10278, "h": "c23fc6b52522f050", "c": "<div align=\"center\">\n\n# 📷 家庭相册 Family Photo Manager\n\n**记录每一个温馨瞬间，让家人之间的距离更近一点 💖**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue?logo=python)](https://www.python.org/)\n[![Flask](https://img.shields.io/badge/Flask-2.3-green?logo=flask)](https://flask.palletsprojects.com/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)](https://react.dev/)\n[![Ant Design](https://img.shields.io/badge/Ant%20Design-6-0170F8?logo=ant-design)](https://ant.design/)\n[![MySQL](https://img.shields.io/badge/MySQL-5.7+-4479A1?logo=mysql)](https://www.mysql.com/)\n\n</div>\n\n---\n\n## 📖 项目简介\n\n家庭相册是一个专为家庭设计的私密照片管理系统。支持多家庭成员共享相册、照片上传/拍照、收藏管理，并内置 AI 智能助手提供温馨互动。所有数据存储在本地，保护家庭隐私。\n\n### ✨ 核心功能\n\n| 功能模块 | 描述 |\n|---------|------|\n| 📁 **相册管理** | 创建、重命名、删除相册，自定义封面 |\n| 📤 **照片上传** | 支持批量上传，记录拍摄时间、归属成员、备注 |\n| 📷 **拍照功能** | 调用摄像头直接拍照并上传（需 HTTPS 环境） |\n| 🔍 **照片搜索** | 按名称、归属人、上传者、日期范围筛选 |\n| 💖 **收藏管理** | 创建收藏夹，照片加入收藏/移出，支持多个收藏夹 |\n| 👨‍👩‍👧 **家庭成员** | 多成员管理，照片记录归属人和上传者 |\n| 🤖 **AI 助手** | 内置 AI 对话功能，支持 OpenAI / Ollama 等多种提供商 |\n| 🔐 **登录鉴权** | JWT Token 认证，SHA256 + bcrypt 双重密码加密 |\n\n---\n\n## 🏗️ 技术架构\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   前端 (React 19)                    │\n│  Ant Design 6 · React Router 7 · Axios · Less       │\n│                    :3000 (craco)                     │\n└──────────────────────┬──────────────────────────────┘\n                       │  /api/*  /uploads/*\n                       ▼\n┌─────────────────────────────────────────────────────┐\n│                 后端 (Flask 2.3)                      │\n│  PyJWT · bcrypt · PyMySQL · Werkzeug · python-dotenv│\n│                    :5000                              │\n└───────┬─────────────────────────┬───────────────────┘\n        ▼                         ▼\n┌───────────────┐      ┌──────────────────┐\n│   MySQL 5.7+  │      │  本地文件系统     │\n│  family_photo │      │  uploads/photos  │\n│               │      │  uploads/covers  │\n└───────────────┘      └──────────────────┘\n```\n\n---\n\n## 📂 项目结构\n\n```\nPhotoManager/\n├── family-photo-backend/          # 🔧 后端 (Flask)\n│   ├── config/\n│   │   ├── config.py              # 数据库/JWT/密码加密配置\n│   │   └── log_config.py          # 日志配置（按天轮转）\n│   ├── src/\n│   │   ├── main.py                # Flask 应用入口\n│   │   ├── auth.py                # 登录/登出/Token 鉴权\n│   │   ├── album.py               # 相册 CRUD + 封面上传\n│   │   ├── photo.py               # 照片上传/搜索/删除\n│   │   ├── favorite.py            # 收藏夹 & 收藏照片管理\n│   │   ├── member.py              # 家庭成员查询\n│   │   ├── file.py                # 静态文件服务（路径遍历防护）\n│   │   ├── chat.py                # AI 对话接口\n│   │   ├── ai_service.py          # AI 服务（OpenAI/Ollama）\n│   │   └── utils.py               # 数据库连接 & 工具函数\n│   ├── sql/\n│   │   └── table_info.sql         # 数据库建表 SQL\n│   ├── uploads/                   # 上传文件存储\n│   │   ├── photos/                # 照片文件（按 album_id 分目录）\n│   │   └── covers/                # 相册封面\n│   ├── logs/                      # 日志文件（自动生成）\n│   ├── .env.example               # 环境变量模板\n│   └── requirements.txt           # Python 依赖\n│\n├── family-photo-frontend/         # 🎨 前端 (React)\n│   ├── src/\n│   │   ├── pages/\n│   │   │   ├── Login/             # 登录页\n│   │   │   ├── AlbumList/         # 相册列表\n│   │   │   ├── AlbumDetail/       # 相册详情\n│   │   │   │   ├── components/\n│   │   │   │   │   ├── AlbumPhotoList/  # 照片列表（分页）\n│   │   │   │   │   ├── UploadArare/     # 照片上传区\n│   │   │   │   │   └── PhotoCapture/    # 摄像头拍照\n│   │   │   │   └── popwin/\n│   │   │   │       ├── FilterPopwin/          # 搜索筛选弹窗\n│   │   │   │       └── FavoriteConfirmModal/  # 收藏确认弹窗\n│   │   │   ├── CreateAlbum/       # 创建相册\n│   │   │   └── FavoriteManager/   # 收藏管理\n│   │   ├── components/\n│   │   │   ├── PrivateRoute.js    # 路由守卫\n│   │   │   ├── HeaderComponent.js # 顶部导航\n│   │   │   ├── AiChat/           # AI 对话悬浮窗\n│   │   │   └── ButtonWrapper/    # 按钮封装\n│   │   ├── contexts/\n│   │   │   └── MemberContext.js   # 当前登录成员上下文\n│   │   ├── utils/\n│   │   │   ├── request.js         # Axios 封装（Token 拦截器）\n│   │   │   └── dateUtil.js        # 日期格式化工具\n│   │   └── App.js                 # 路由配置入口\n│   ├── craco.config.js            # Craco 配置（Less/代理）\n│   └── package.json\n│\n└── README.md\n```\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Python | 3.8+ |\n| Node.js | 16+ |\n| MySQL | 5.7+ |\n| npm / yarn | 最新稳定版 |\n\n### 1️⃣ 克隆项目\n\n```bash\ngit clone <your-repo-url>\ncd PhotoManager\n```\n\n### 2️⃣ 初始化数据库\n\n```bash\n# 登录 MySQL 创建数据库\nmysql -u root -p\n\nCREATE DATABASE family_photo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\nUSE family_photo;\n\n# 导入建表 SQL\nsource family-photo-backend/sql/table_info.sql;\n\n# （可选）插入测试家庭成员\nINSERT INTO family_member (name, relation, username, password, email) VALUES\n('爸爸', 'father', 'father', '此处填SHA256哈希', 'father@example.com'),\n('妈妈', 'mother', 'mother', '此处填SHA256哈希', 'mother@example.com');\n```\n\n> 💡 密码存储流程：**前端 SHA256** → **后端 bcrypt 加密** → 存入数据库。  \n> 初始密码可先用 `config/config.py` 中的 `encrypt_password()` 函数生成哈希。\n\n### 3️⃣ 启动后端\n\n```bash\ncd family-photo-backend\n\n# 创建虚拟环境（推荐）\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS/Linux:\nsource venv/bin/activate\n\n# 安装依赖\npip install -r requirements.txt\n\n# 配置环境变量\ncp .env.example .env\n# 编辑 .env 填入数据库密码和 AI 配置\n\n# 修改 config/config.py 中的数据库连接信息\n# DB_CONFIG = { 'host': 'localhost', 'user': 'root', 'password': '你的密码', ... }\n\n# 启动服务\npython -m src.main\n# 后端运行在 http://localhost:5000\n```\n\n### 4️⃣ 启动前端\n\n```bash\ncd family-photo-frontend\n\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm start\n# 前端运行在 http://localhost:3000\n# 已配置代理：/api/* 和 /uploads/* 自动转发到后端 5000 端口\n```\n\n---\n\n## ⚙️ 环境变量配置\n\n在 `family-photo-backend/.env` 中配置：\n\n```bash\n# ── AI 服务配置 ──────────────────────────────\n# 提供商：openai（默认）| ollama（本地部署，无需 API Key）\nAI_PROVIDER=openai\n\n# OpenAI / DeepSeek / 通义千问\nAI_API_KEY=sk-xxx\nAI_API_BASE=https://api.openai.com/v1\nAI_MODEL=gpt-3.5-turbo\n\n# ── 使用 Ollama 本地部署时，改为以下配置 ───────\n# AI_PROVIDER=ollama\n# AI_MODEL=llama3\n# AI_API_BASE=http://localhost:11434\n\n# ── 通用 ─────────────────────────────────────\nAI_TIMEOUT=60\n\n# ── Flask 环境 ───────────────────────────────\nFLASK_ENV=dev\n```\n\n---\n\n## 🗄️ 数据库设计\n\n```\nfamily_member (家庭成员)\n    │\n    ├──< album (相册)\n    │       │\n    │       └──< photo (照片)\n    │               │\n    │               └──< favorite_photo (收藏记录) >── favorite_folder (收藏夹)\n    │\n    └──< ai_chat_message (AI 聊天记录)\n```\n\n| 表名 | 说明 | 关键字段 |\n|------|------|---------|\n| `family_member` | 家庭成员 / 登录账号 | `username`(唯一), `password`(bcrypt) |\n| `album` | 相册 | `album_name`, `cover_path`, `last_upload_user_id` |\n| `photo` | 照片 | `file_path`, `album_id`, `member_id`(归属), `operator_id`(上传者) |\n| `favorite_folder` | 收藏夹 | `folder_name`, `member_id`, `is_default` |\n| `favorite_photo` | 收藏记录 | `folder_id`, `photo_id`, `member_id`（唯一约束防重复） |\n| `ai_chat_message` | AI 聊天记录 | `member_id`, `role`(user/assistant), `content` |\n\n> 完整建表 SQL 见 `family-photo-backend/sql/table_info.sql`\n\n---\n\n## 📡 API 接口\n\n### 认证\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| POST | `/api/login` | 登录（返回 JWT Token） |\n| POST | `/api/logout` | 登出 |\n\n### 相册\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/albums` | ✅ | 获取所有相册列表 |\n| POST | `/api/album/create` | ✅ | 创建相册（可上传封面） |\n| POST | `/api/album/rename` | ✅ | 修改相册名称 |\n| POST | `/api/album/delete` | ✅ | 删除相册（级联删除照片） |\n| POST | `/api/album/cover/upload` | ✅ | 上传/更换相册封面 |\n| GET | `/api/photos/album/:id` | ✅ | 获取相册下照片（分页） |\n\n### 照片\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| POST | `/api/photos/upload` | ✅ | 上传照片 |\n| POST | `/api/photos/delete` | ✅ | 删除照片 |\n| GET | `/api/photos/search` | ✅ | 搜索照片（支持多条件筛选） |\n\n### 收藏\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/favorite/folders` | ✅ | 获取收藏夹列表 |\n| POST | `/api/favorite/folders` | ✅ | 创建收藏夹 |\n| PUT | `/api/favorite/folders/:id` | ✅ | 修改收藏夹名称 |\n| DELETE | `/api/favorite/folders/:id` | ✅ | 删除收藏夹 |\n| POST | `/api/favorite/photos` | ✅ | 照片加入收藏 |\n| DELETE | `/api/favorite/photos` | ✅ | 照片移出收藏 |\n| GET | `/api/favorite/photos/:folder_id` | ✅ | 获取收藏夹内照片 |\n\n### 成员 & AI\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/api/current-member` | ✅ | 获取当前登录成员信息 |\n| GET | `/api/members` | ✅ | 获取所有家庭成员 |\n| GET | `/api/chat/history` | ✅ | 获取聊天记录（默认近 3 个月） |\n| POST | `/api/chat/send` | ✅ | 发送消息 & 获取 AI 回复 |\n| GET | `/api/chat/models` | ✅ | 查询 AI 提供商 & 可用模型 |\n| POST | `/api/chat/clear` | ✅ | 清空聊天记录 |\n\n### 静态文件\n\n| 方法 | 路径 | 鉴权 | 说明 |\n|------|------|------|------|\n| GET | `/uploads/photos/:filename` | ✅ | 获取照片文件 |\n| GET | `/uploads/covers/:filename` | ✅ | 获取封面文件 |\n\n---\n\n## 🔐 安全机制\n\n| 层面 | 措施 |\n|------|------|\n| **认证** | JWT Token（HS256，24h 过期），`@login_required` 装饰器保护所有接口 |\n| **密码** | 前端 SHA256 + 后端 bcrypt（salt rounds=12）双重加密 |\n| **文件上传** | 扩展名白名单校验、`secure_filename` 过滤、唯一文件名防覆盖 |\n| **路径安全** | 上传目录限制 + `_safe_path()` 绝对路径校验，防止路径遍历 |\n| **数据校验** | `album_id` 等参数强制正整数校验，存在性校验防止对不存在资源操作 |\n| **SQL 注入** | 全部使用 PyMySQL 参数化查询 (`%s`) |\n| **CORS** | Flask-CORS 配置 `supports_credentials=True` |\n\n---\n\n## 🤖 AI 助手\n\n支持三种 AI 提供商，通过环境变量 `AI_PROVIDER` 切换：\n\n| 提供商 | 配置方式 | 特点 |\n|--------|---------|------|\n| **OpenAI** | 配置 `AI_API_KEY` + `AI_API_BASE` | 支持 OpenAI / DeepSeek / 通义千问等兼容接口 |\n| **Ollama** | `AI_PROVIDER=ollama` | 本地部署，无需 API Key，完全离线 |\n| **模拟模式** | 不配置 `AI_API_KEY` | 自动使用预设回复，方便体验功能 |\n\n---\n\n## 📸 功能预览\n\n| 页面 | 功能 |\n|------|------|\n| 🔑 登录页 | 温馨风格登录，SHA256 密码加密传输 |\n| 📁 相册列表 | 展示所有相册，显示封面、最后上传人和时间 |\n| 🖼️ 相册详情 | 照片网格展示、分页加载、搜索筛选 |\n| 📤 上传区域 | 填写归属成员、拍摄时间、备注后批量上传 |\n| 📷 拍照上传 | 调用摄像头拍照 → 预览 → 选择归属人 → 上传 |\n| 💖 收藏管理 | 收藏夹列表 + 收藏照片网格，支持增删改 |\n| 🤖 AI 助手 | 全局悬浮对话窗，聊天记录按账号隔离 |\n\n---\n\n## 🛠️ 开发说明\n\n### 前端代理配置（`craco.config.js`）\n\n```javascript\n// 开发环境下自动代理到后端\n'/api'      → http://localhost:5000/api\n'/uploads'  → http://localhost:5000/uploads\n```\n\n### 日志系统\n\n- 日志目录：`family-photo-backend/logs/`\n- `info.log`：常规操作日志（保留 30 天）\n- `error.log`：错误日志（保留 90 天）\n- 按天自动轮转，Windows 下安全处理文件锁定\n\n### 密码加密流程\n\n```\n用户输入明文密码\n    │\n    ▼\n前端 CryptoJS.SHA256(password)  ──→  SHA256 哈希\n    │\n    ▼\nPOST /api/login  { password: sha256_hash }\n    │\n    ▼\n后端 bcrypt.checkpw(sha256_hash, db_bcrypt_hash)  ──→  验证结果\n```\n\n---\n\n## 📋 待办事项\n\n- [ ] 实现 Token 黑名单机制，使 Logout 真正生效\n- [ ] 添加相册/照片的访问权限控制（按成员隔离）\n- [ ] 将数据库密码和 JWT 密钥迁移到环境变量\n- [ ] 前端 Token 改用 HttpOnly Cookie 传递，避免 URL 暴露\n- [ ] 添加照片 EXIF 信息自动提取（拍摄时间、GPS 等）\n- [ ] 支持照片压缩上传，减少存储空间\n- [ ] 添加照片分享功能（生成临时链接）\n\n---\n\n## 📄 License\n\nMIT License © 2026 Family Photo Manager"}, "e1a416675c1e98239e1344166314c35445cf7309": {"t": 1785771651.5670063, "n": 14, "h": "0f7000c56434d403", "c": "# PhotoManager"}}}}