Photo Grader — 照片评级器

照片评级器 应用专业级别的色彩分级到相机照片，通过RawTherapee CLI，驱动由JSON参数。 引擎 RawTherapee CLI是唯一的处理引擎，提供： 功能 RawTherapee 解码多算法（AMAZE、IGT等） 锐化 RL去卷积（Richardson-Lucy） 噪声减少 IWT/天文去噪 镜头校正 lensfun自动 色彩管理 ProPhoto内部管道 相机匹配 自动匹配曲线（~50台相机） 输出质量 专业 支持格式 所有RAW格式：NEF、CR2、CR3、ARW、RAF、ORF、RW2、DNG、PEF、SRW、3FR、IIQ、X3F等。 以及：JPEG（.jpg/.jpeg）和Apple HEIC/HEIF（.heic/.heif）。 注意：RAW文件提供全16位编辑范围，最大化质量。JPG/HEIC是8位——分级范围更有限，曝光调整应更保守。 依赖 声明文件：requirements.txt 首选venv：在运行脚本之前，激活项目根虚拟环境（例如.venv/）。如果它不存在，先创建一个： # 创建venv并安装依赖项（推荐） python3 -m venv .venv source .venv/bin/activate pip install -r photo-grader/requirements.txt # 或使用技能的设置脚本（检查+安装） bash photo-grader/scripts/setup_deps.sh # 在每个会话之前，激活venv source .venv/bin/activate RawTherapee CLI（必需） # macOS # 从官方包安装RawTherapee，然后将独立的rawtherapee-cli复制到PATH目录（例如~/.local/bin）。 rawtherapee-cli -h # 验证它打印“RawTherapee，版本...，命令行” # Debian/Ubuntu sudo apt install rawtherapee-cli # Fedora/RHEL sudo dnf install RawTherapee macOS注意：始终使用rawtherapee-cli -h验证。如果它以133/SIGTRAP退出，macOS可能在启动前阻止了它。这在代理通过Homebrew安装RawTherapee并且用户尚未明确打开/授权应用程序或CLI时很常见。用户安装和授权的Homebrew CLI可以工作；否则使用RawTherapee包中的官方独立rawtherapee-cli。 配置 将config.example.toml复制到config.toml并编辑以设置您的目录。请参阅config.example.toml以获取所有可用选项。 使用 # 使用grading_params.json中的绝对路径（不需要--raw-dir） python3 scripts/grade.py grading_params.json --output ~/Photos/graded # 使用相对文件名的参数（需要--raw-dir） python3 scripts/grade.py grading_params.json \ --raw-dir ~/Photos/RAW --output ~/Photos/graded # 全分辨率 python3 scripts/grade.py grading_params.json --no-resize # 统一模式：将一组参数应用于目录中的所有文件 # （适用于时间轴或具有相同设置的批处理） python3 scripts/grade.py grading_params.json \ --uniform-dir ~/data/timelapse --output ~/data/output/graded # 预览 python3 scripts/grade.py grading_params.json --dry-run # 仅导出PP3（用于手动检查或外部使用） python3 scripts/grade.py grading_params.json --pp3-only --pp3-output ./pp3_files/ # 快速导出模式（跳过重型模块以提高速度） python3 scripts/grade.py grading_params.json --fast-export # 控制镜头校正和相机匹配 python3 scripts/grade.py grading_params.json --lens-corr python3 scripts/grade.py grading_params.json --no-lens-corr python3 scripts/grade.py grading_params.json --auto-match python3 scripts/grade.py grading_params.json --no-auto-match 选项 描述 默认 params_json 分级参数JSON 必需 --raw-dir RAW文件目录（仅对于相对路径） 从配置 --uniform-dir 将第一组参数应用于目录中的所有文件 — --output 输出目录 从配置 --quality JPEG质量（1-100） 95 --workers 并行工作者 自动（最大8） --overwrite 覆盖现有文件 关闭 --dry-run 仅预览 关闭 --pp3-only 仅生成PP3文件，不渲染 关闭 --pp3-output PP3仅输出目录 ./pp3/ --fast-export 使用RT快速导出模式（跳过重型模块） 关闭 --lens-corr 启用/禁用镜头校正 从配置 --auto-match 启用/禁用自动匹配相机曲线 从配置 注意：--uniform-dir忽略JSON中的文件字段，并将第一组参数应用于目录中的每个支持的照片。适用于时间轴序列，其中所有帧共享一个分级预设。 色彩分级功能 所有标准Lightroom参数都支持智能映射： 完全支持 Exposure（基于停止） 对比度 高光/阴影/白色/黑色 白平衡（温度/色调） 生动度和饱和度 参数曲线 HSL每通道调整（8个通道） 三向色彩分级 锐化（RL去卷积） 噪声减少（IWT/天文） 暗角 胶片颗粒 RawTherapee特定功能 自动匹配相机配置文件：匹配~50个相机模型的相机JPEG音调 镜头校正：通过lensfun数据库自动 快速导出模式：跳过重型模块以提高速度 16位输出：TIFF/PNG在