观赏鱼体色鲜艳度评估

要解决什么问题

观赏鱼体色是品系价值与日常健康观察的重要信号，但肉眼对比容易受光照、白平衡和个体差异干扰。锦鲤昭和三色看的是黑色覆盖而非单纯饱和度，神仙鱼「银河系」更关注斑点分布——用一套通用阈值很容易误判。繁殖期婚姻色、应激暗淡、投喂后短时增色、鱼龄自然褪色等生理性变化，也需要和「真的偏淡」区分开。

技能如何工作

技能面向鱼缸固定摄像头采集的体侧高清图或短视频（建议 ≥1080p，视野内放置白卡/灰卡/ColorChecker），在技能根目录调用 python -m scripts.smyx_fish_color_brightness_assessment_analysis 完成分析。

核心流程包括：

• 基于白参考做白平衡与光照归一化（未校正则返回 color_signal_unreliable，评分不可信）
• 在鱼体指定区域（如躯干中部）提取 HSV 的 S（饱和度） 与 V（亮度）
• 按 species_subtype（如锦鲤红白、大正三色、昭和三色、神仙鱼银河系等）匹配内置或自定义品系基线，输出 0–100 的 vibrancy_score_0_100
• 结合 4 级提醒策略给出养殖管理向建议（非疾病诊断）

查看历史时须用 --list 从云端 API 拉取完整记录，并以 Markdown 表格呈现；不得从本地 memory 或人工汇总拼凑清单。

适用边界与注意点

• 输入支持常见图片/视频格式，单文件 ≤10MB；鱼体需侧面可见、短暂静止，光照建议 5000–6500K 中性白
• 白参考未检出、分割置信度 <0.7、过暗过曝或姿态不合格时，应重拍而非硬出分
• 禁止输出具体疾病诊断、药物剂量、饲料品牌；禁止伪造或夸大 HSV/评分指标
• 结果按 tank_id + fish_id + 时间戳归档；图像长期留存需遵守 ≤30 天等政策约束
• 任何加热、换水、灯光等设备操作只能建议，须由用户自行确认