# PortraitVault 配置文件示例

# 使用方法：复制此文件为 .env 并根据实际情况修改配置

# ============================================

# 核心配置 - 照片库路径（必填）

# ============================================

# 支持单个路径或多个路径（用分号、逗号或空格分隔）

#

# Windows 开发环境示例（单个路径）:

# PHOTOS_BASE_DIR=Z:\Pictures\R

#

# Windows 开发环境示例（多个路径）:

# PHOTOS_BASE_DIR=Z:\Pictures\R;Y:\Pictures\Z

# 或者

# PHOTOS_BASE_DIR=Z:\Pictures\R Y:\Pictures\Z

# 或者

# PHOTOS_BASE_DIR=Z:\Pictures\R,Y:\Pictures\Z

#

# Linux/Mac 开发环境示例:

# PHOTOS_BASE_DIR=/home/user/Pictures/R

# PHOTOS_BASE_DIR=/home/user/Pictures/R;/mnt/nas/Pictures/Z

#

# Docker/NAS 部署环境（通常通过 docker-compose.yml 的 volume 挂载，这里使用容器内路径）:

# PHOTOS_BASE_DIR=/photos

# PHOTOS_BASE_DIR=/photos1;/photos2

# ============================================

# 服务器配置（可选）

# ============================================

# HOST=0.0.0.0

# PORT=8000

# ============================================

# 缩略图配置（可选）

# ============================================

# THUMBNAIL_SIZE=400,600

# THUMBNAIL_QUALITY=70

# 最大并发缩略图生成数量（默认：3）

# 限制同时生成的缩略图数量，避免阻塞其他请求

# 建议值：2-5（根据服务器性能调整，数值越大并发越高，但可能占用更多资源）

# MAX_THUMBNAIL_CONCURRENT=3

# ============================================

# 调试模式（可选）

# ============================================

# DEBUG=false

# ============================================

# 视频识别功能（可选）

# ============================================

# 是否启用视频文件识别和预览功能（默认：true）

# 设置为 false 可以禁用视频功能，只处理图片文件

# ENABLE_VIDEO=true

# ============================================

# 文件读取优化（可选）

# ============================================

# 是否启用异步文件读取（默认：true）

# 启用后，大文件会使用流式传输，减少内存占用，提升性能

# 设置为 false 会使用传统的 FileResponse（对小文件更简单）

# ASYNC_FILE_READ=true

# 文件读取块大小（字节，默认：8192）

# 用于流式传输时的每次读取块大小，可根据服务器性能调整

# 建议值：8192 (8KB), 16384 (16KB), 32768 (32KB)

# FILE_CHUNK_SIZE=8192

# ============================================

# Docker 环境标识（自动检测，通常不需要手动设置）

# ============================================

# DOCKER_CONTAINER=false

# ============================================

# 黑名单路径配置（可选）

# ============================================

# 排除不需要扫描的路径，多个路径用分号(;)或逗号(,)分隔

# 支持相对路径（相对于 PHOTOS_BASE_DIR）和绝对路径

#

# 示例（相对路径）:

# BLACKLIST_PATHS=人物A写真集\主题B,人物B写真集\test

#

# 示例（绝对路径）:

# BLACKLIST_PATHS=Z:\Pictures\R\人物A写真集\主题B;Z:\Pictures\R\test

#

# 示例（混合使用）:

# BLACKLIST_PATHS=人物A写真集\主题B,/photos/test,绝对路径\文件夹