用途：查找用户上传到媒体库中的照片，或搜索已连接设备的相册，用于回应照片请求或需要照片作为个性化依据的场景。
主要能力：提供 /opt/hatch/bin/media-library 命令行工具，仅覆盖已上传照片。子命令包括：stats（库概览，含总数、日期范围和描述状态）、search（支持 --query、--after、--before、--lat、--long、--radius、--has-gps、--path、--limit 等筛选）、recent（按上传时间返回最近照片）、scan（返回更丰富的摘要与完整描述，需至少一个收窄选项）、get（返回单张照片的 JSON 详情）。设备照片需先调用 device.list 和 device.describe 选择可访问设备，再用其提供的 photos.search 等命令搜索和上传。
使用方式：首次使用先运行 stats，再 search 或 recent，必要时用 scan 和 get 深入；只有用户要查看图片或描述不足时才读取图像。多数查询可仅凭描述回答。已上传库搜索为本地 PostgreSQL 查询，可多角度反复尝试。关键词为隐式 OR，按 BM25 排序，支持 AND/OR/NOT 与前缀匹配；收窄结果应使用 AND、日期或 GPS 筛选。地点名称已进入搜索索引，GPS 邻近查询可先用 map.geocode 获取坐标。人物描述应使用物理特征，而非姓名。找到具体照片后应展示并确认。
适用场景：回答与个人照片相关的查找、展示、识别、日期或位置问题。
限制：命令行工具仅处理已上传照片，设备相册需另行搜索；若总数为 0 说明库为空或未设置，总数较低说明库较小；大量待处理项时文本搜索可能遗漏。需遵守权限拒绝，上传完成才算完成，分页未覆盖完应如实报告而非断定无匹配。文件名或时间相近不能单独证明照片身份。