技能介绍

要解决什么问题

安防与运维场景里，摄像头一旦全黑、过曝、偏色，或出现条纹、雪花、模糊，监控录像的可用性会迅速下降，但人工逐路盯屏成本高，也很难把「这次异常」和「上次巡检结论」对齐。

本技能面向摄像头抓拍图或监控视频帧做自动化图像质量评估：在用户上传本地文件、提供路径，或给出公网图片/视频 URL 时，识别典型画面故障并给出结构化报告；也支持按关键词触发云端历史检测报告列表查询（禁止用本地 memory 汇总替代接口数据）。

技能如何工作

检测侧覆盖常见质量问题类型，包括但不限于：

全黑 / 全白（黑屏、过曝类异常）
偏色、条纹干扰、雪花噪声、模糊
清晰度评分与质量问题分类

实现路径上，技能通过 scripts/image_quality_detection_analysis.py 调用后端 API：对输入做亮度直方图、频谱分析与色彩分布等建模，快速定位异常类型与严重程度。执行分析前需按流程获取有效的 --open-id（不得自行编造），再在技能根目录运行模块；--input / --url 二选一传入画面来源，--detail 可控制输出粒度（如 basic / standard / json）。

查询历史报告时，应使用 --list 配合 --open-id 从云端拉取完整清单，并将返回字段整理为 Markdown 表格（含报告名称、输入类型、分析时间、质量评分，以及基于 reportImageUrl 的查看链接）。

适用边界与注意点

支持格式：jpg / jpeg / png / mp4 / avi / mov，单文件上限 10MB；网络 URL 由 API 侧下载，无需本地先落盘。
分析结果用于设备维护与巡检参考，不能替代专业硬件检修。
API 密钥可选；若传入 --api-key 则需确保鉴权成功，否则按技能约定忽略鉴权相关逻辑。
技能约定禁止读取本地记忆文件或从 LanceDB 检索历史；即使接口异常也不得回退到本地汇总。