用途：根据用户自然语言描述调整照片的亮度、对比度和饱和度，支持“调亮一点”“变暗”“增加对比度”“让颜色更鲜艳”“去饱和”“电影感”“自然增强”“修复发灰的画面”“增加暖意”等请求。
主要能力：先校验照片存在且为 JPG/PNG 格式；分析照片当前的亮度、对比度、饱和度；调用 GPT-5 文本 API 结合提示和照片分析生成增强建议；按提示关键词（vivid/natural/dramatic）选择最匹配的方案；应用调整并保存为新文件，绝不覆盖原图；输出所应用倍率和 GPT-5 的推理说明。风格类别包括 Vivid（高饱和 1.3-1.5，提高亮度和对比）、Natural（轻微调整 1.05-1.2）、Dramatic（高对比 1.5-1.8）以及 Custom（按具体提示定制）。倍率限制在安全范围 0.5-2.0 内。
使用方式：Python 调用 from photo_color import main，传入 photo_path 和 prompt，例如 main(photo_path="photo.jpg", prompt="Make the colors more vibrant and warm")，返回 "photo-enhanced.jpg"。命令行用法：python photo_color.py <photo_path> "<prompt>" [output_path]。输出文件命名为 {original_name}-enhanced.{ext}，并显示风格名称和 GPT-5 的推理。
适用场景：日常照片色彩增强、修复发灰或偏色、营造电影感或戏剧化效果、按具体提示做亮度对比微调。
限制：需要设置 OPENROUTER_API_KEY 环境变量；照片必须为 JPG 或 PNG；建议小于 50MB。若 GPT-5 不可用，则回退到安全默认值（饱和度 ×1.2、亮度 ×1.1、对比度 ×1.1），并校验倍率是否在 0.5-2.0 范围内，对缺失文件或无效格式给出明确错误。技术实现、照片分析算法、风格和提示匹配策略等细节见 references/implementation.md，示例见 examples/common-use-cases.md。