Photo Guide

摄影指导技能 - 当用户上传照片并询问如何拍出类似效果、拍摄参数、后期调色等摄影相关问题时使用此技能。分析照片的视觉特征，推断拍摄参数，提供后期调色指导、照片优化建议和学习关键词。

摄影指导技能 (photo-guide)

概述

面向摄影新手的照片分析工具。用户上传一张照片后，Agent 分析其视觉特征，推断拍摄参数，提供后期调色方向、优化建议和学习关键词。

触发条件

当用户同时满足以下两个条件时激活此技能：

1. 提供了图片（上传文件或图片链接）
2. 表达了对摄影指导的需求，例如：
   • 「这张照片怎么拍的？」
   • 「教我拍出这种效果」
   • 「这张照片的光圈/快门是多少？」
   • 「怎么调这种色调？」
   • 「帮我分析一下这张照片」

工作流程

第零步：检查并安装依赖

在开始分析前，检查 Python 依赖是否已安装：

python3 -c "import PIL" 2>/dev/null || pip install -r requirements.txt

• 如果 PIL 已安装 → 跳过，直接进入第一步
• 如果未安装 → 执行 pip install -r requirements.txt 安装依赖，安装完成后继续

第一步：尝试提取 EXIF 信息

如果用户提供的是本地图片文件，运行 EXIF 提取脚本：

python3 scripts/extract_exif.py <图片路径>

脚本输出 JSON 格式：

• has_exif: true → 记录真实参数（光圈、快门、ISO、焦距、相机型号），后续作为校验基准
• has_exif: false → 进入纯视觉推断模式

注意：如果用户发送的是截图或网络图片，可能没有 EXIF 信息，这很正常。

第二步：五维度视觉分析

仔细观察照片，从五个维度分析并推断拍摄参数：

维度	观察要点	推断的参数
景深	背景模糊程度、虚化效果、主体与背景的分离感	光圈范围
动态	是否有运动模糊、水流的丝滑感、飞溅的水花凝固	快门速度
光影	光源方向（顺光/侧光/逆光）、光线硬度、整体曝光水平	ISO、布光方式
色彩	色调倾向（冷/暖/中性）、饱和度高低、对比度强弱	后期调色方向
构图	拍摄视角（平视/俯拍/仰拍）、画面透视感、主体大小占比	焦段、拍摄角度

推断时查阅 references/photography-basics.md 中的参数参考表，确保推断值在合理范围内。

第三步：匹配风格模板

根据照片的整体感觉，从 references/style-templates.md 中找到最接近的摄影风格（如人像糖水片、日系清新、城市街拍等），用模板中的参数范围交叉验证第二步的推断结果。如果推断值和模板差距较大，优先采用模板范围并在报告中说明。

第四步：生成分析报告

按照以下模板输出结构化报告：

📷 照片分析报告
━━━━━━━━━━━━━━━

📋 画面概述
- 照片类型：[人像 / 风光 / 街拍 / 美食 / 夜景 / ...]
- 主要元素：[用通俗语言描述画面中的主体和环境]
- 拍摄环境：[室内/室外、白天/傍晚/夜晚、天气 等]

⚙️ 拍摄参数
| 参数     | 推断值          | 推断理由              |
| -------- | --------------- | --------------------- |
| 光圈     | [范围]          | [观察到什么特征]       |
| 快门速度 | [范围]          | [观察到什么特征]       |
| ISO      | [范围]          | [观察到什么特征]       |
| 焦段     | [范围]          | [观察到什么特征]       |
| 拍摄角度 | [角度]          | [观察到什么特征]       |

（如有 EXIF 数据，增加「实际值」列与推断值对比）

💡 拍摄技巧要点
- [用通俗语言解释为什么用这些参数组合]
- [给新手可操作的实用建议，如「下次试试蹲低一点拍」]

🔧 照片优化建议
（仅在有明显可改进之处时出现，否则跳过此部分）
- [指出具体问题，如「画面稍微偏暗」]
- [给出具体改进建议，如「可以提高 0.3-0.5 档曝光」]

🎨 后期调色建议
- 色调方向：[冷调 / 暖调 / 中性 / 日系 / 胶片 / 电影感 等]
- 曝光调整：[建议微调方向和幅度]
- 对比度：[建议]
- 色彩倾向：[具体色彩倾向]
- 推荐风格预设：[可在 Lightroom/修图 App 中搜索的关键词]

🎛️ 拍摄设置建议
（大部分场景出现。仅在创意/抽象照片等无法给出明确设置建议时跳过）
- 拍摄模式：[A档光圈优先 / S档快门优先 / M档全手动]
  → [一句话解释为什么选这个模式]
- 对焦模式：[AF-S单次 / AF-C连续 / MF手动]
  → [一句话解释]
- 测光模式：[评价测光 / 点测光 / 中央重点测光]
  → [一句话解释]
- 白平衡：[自动 / 阴天 / 自定义色温 XXXXK]
  → [一句话建议]
- 曝光补偿：[+/- X 档]
  → [一句话解释]
- 连拍：[单张 / 低速连拍 / 高速连拍]
  → [一句话建议]

📊 场景设置速查
| 场景       | 拍摄模式  | 对焦    | 测光         | 连拍     |
| ---------- | --------- | ------- | ------------ | -------- |
| 人像       | A档       | AF-S    | 点测光(脸部) | 单张     |
| 运动/抓拍  | S档或M档  | AF-C    | 评价测光     | 高速连拍 |
| 风光       | A档或M档  | AF-S/MF | 评价测光     | 单张     |
| 夜景/长曝光| M档       | MF/AF-S | 评价测光     | 单张     |
| 街拍       | A档       | AF-S/AF-C| 中央重点    | 低速连拍 |
| 美食/静物  | A档       | AF-S    | 点测光       | 单张     |
| 宠物       | S档或A档  | AF-C    | 评价测光     | 高速连拍 |

推断设置时查阅 [references/photography-basics.md](references/photography-basics.md) 中的拍摄模式、对焦模式和测光模式参考表。

🔦 布光与道具建议
（仅在人像、美食、夜景、长曝光、逆光/侧逆光、室内、微距等需要控光的场景出现。纯自然光的白天风光/街拍跳过）
布光方案：
- 主光方向：[顺光/侧光/逆光/顶光] → [当前照片的光线分析]
- 补光建议：[需要/不需要]
  → [具体建议]
- 光质建议：[硬光/柔光/自然散射光]
  → [具体建议]

道具清单：
| 道具       | 必要性        | 说明                       |
| ---------- | ------------- | -------------------------- |
| [道具名]   | [必备/推荐/可选] | [使用说明]                |

常用道具触发条件：
- 三脚架：快门 < 1/30s、夜景、长曝光 → 必备
- ND 减光镜：白天长曝光（流水、云层） → 推荐
- CPL 偏振镜：风光（天空、水面反光） → 推荐
- GND 渐变镜：天地光比大（日出日落） → 可选
- 反光板：逆光/侧逆光人像 → 推荐
- 外置闪光灯：室内人像、夜景人像 → 可选
- 柔光箱/伞：室内人像、商品拍摄 → 可选
- 快门线：长曝光、星轨 → 推荐

📱 手机拍摄替代方案
（仅在 EXIF 显示手机型号或用户提到手机拍摄时出现）
参数调整：
- [针对手机硬件局限的调整建议]

拍摄技巧：
- [手机摄影专属技巧，如点击对焦后上滑调曝光]

推荐 App：
- [支持手动参数控制的手机摄影 App]

📚 推荐学习关键词
- [2-3 个适合新手搜索的学习关键词]

如果用户问到后期调色细节，可查阅 references/post-processing-guide.md 获取调色教程和参数参考。

关键原则

1. 强调推断性：除非照片包含 EXIF 数据，否则所有参数均为推测值，需明确告知用户
2. 给范围不给固定值：如「f/2.0 - f/2.8」而非「f/2.8」，因为同一效果可以由多种参数组合实现
3. 实用导向：重点是教会用户「怎么拍」，而非堆砌理论
4. 友好语气：先肯定照片的优点，再给出优化建议；避免每张照片都挑毛病
5. 通俗表达：减少专业术语，使用时附带简短解释（如「ISO 就是感光度，越高画面越亮但噪点越多」）
6. 语言跟随：使用与用户提问相同的语言输出报告，包括报告标题和各栏目名称

常见边界情况

• 无 EXIF 的图片（截图、微信/微博压缩图等）：直接进入纯视觉推断模式，告知用户这是基于画面特征的专业推测
• 模糊/画质差的图片：推断精度会降低，在报告中说明，并适当扩大参数范围
• 手机拍摄的照片：手机摄影参数可控范围有限（通常无法控制光圈），建议中应考虑手机摄影的局限性
• 多张照片分析：逐张分析，可以对比不同照片的参数差异帮助学习
• 创意/抽象照片：可能难以精确匹配风格模板，侧重于描述画面效果和可能的拍摄手法
• 视频截图：告知用户截图分辨率和 EXIF 信息通常不完整，分析精度有限

参考资源

• 摄影参数参考表：references/photography-basics.md
• 摄影风格模板：references/style-templates.md
• 后期调色教程：references/post-processing-guide.md
• EXIF 提取工具：scripts/extract_exif.py

安全与隐私

• 数据本地处理：所有分析在 Agent 本地完成，不向任何外部服务发送照片或数据
• 文件访问：仅读取用户指定的图片文件，只读不写，不修改任何照片
• 无需网络：EXIF 提取和视觉分析均不需要网络连接
• 无需密钥：不使用任何 API Key、环境变量或外部凭证