图片质量打分
对用户上传的图片进行质量评估,输出综合质量分数与质量等级,帮助用户判断图片是否清晰可用。
适用场景
- 用户上传一张图片,询问「这张图清晰吗」「图片质量怎么样」「能不能用」「帮我打个分」。
- 需要批量判断图片质量,筛选出可用/不可用的图片。
- 涉及证件、文档、身份证等图片的质量把关。
触发词
图片质量、清晰度、图片打分、图片能用吗、图片可用性、模糊、图片评测。
执行步骤
- 获取用户提供的图片文件(本地路径)或图片 URL。
- 调用
scripts/score_image.py,传入图片路径或 URL。 - 读取脚本返回的结构化结果,向用户解读。
调用方式
本地图片文件:
python scripts/score_image.py --file "图片路径"
图片 URL:
python scripts/score_image.py --url "https://..."
结果解读
脚本返回 JSON,关键字段:
final_result.level:最终质量等级,取值excellent(优秀)/acceptable(可接受)/poor(较差)/unusable(不可用)。final_result.score:综合分数(0-100)。model_result:模型四分类结果。rule_result:规则评分(清晰度/分辨率/对比度/曝光/裁切完整性)。final_result.needs_review:是否需要人工复核。
向用户输出时,用中文说明等级含义:
| 等级 | 中文 | 含义 |
|---|---|---|
| excellent | 优秀 | 清晰、主体完整、曝光对比度正常,可直接使用 |
| acceptable | 可接受 | 轻微模糊/偏色/压缩,关键信息仍清楚 |
| poor | 较差 | 明显质量问题,仍能判断部分信息 |
| unusable | 不可用 | 主体严重缺失或基本无法辨识 |
输出规范
- 先给出综合结论(等级 + 分数),再给分维度说明。
- 若
needs_review=true,提醒用户该图建议人工复核。 - 语言用中文,简洁明确。