How should Ornamental Fish Color Brightness Assessment | 观赏鱼体色鲜艳度评估 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Ornamental Fish Color Brightness Assessment | 观赏鱼体色鲜艳度评估

Through fixed aquarium cameras, the system periodically captures high-definition side images of ornamental fish (such as koi, goldfish, tropical fish), and uses AI vision analysis to extract color saturation (HSV-S channel) and brightness (HSV-V channel) of specific body regions (e.g. mid-trunk), compares them with healthy standard color ranges of the same species (built-in database or user-defined), and outputs a vibrancy. | 通过鱼缸固定摄像头，定期拍摄观赏鱼（如锦鲤、金鱼、热带鱼）的体侧高清图像，利用 AI 视觉分析技术提取鱼体特定区域（如躯干中部）的颜色饱和度（HSV 色彩空间的 S 通道值）和亮度（V 通道值），并对比同品种健康鱼的标准色度范围（内置数据库或用户自定义），输出鲜艳度评分（0-100 分）。当评分低于阈值（如 < 50）时，提示'体色暗淡'，可能为疾病、营养不良或水质不良的信号。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.7k

Updated

Oct 10, 2026

Version

1.0.12

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.7K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.12release · observed Oct 3, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-fish-color-brightness-assessment-analysis

Install using `clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-fish-color-brightness-assessment-analysis` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/smyx-sunjinhui/smyx-fish-color-brightness-assessment-analysis before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-fish-color-brightness-assessment-an/snapshot"

Documentation

CLAWHUB

160,000 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: "smyx-fish-color-brightness-assessment-analysis"
description: "Through fixed aquarium cameras, the system periodically captures high-definition side images of ornamental fish (such as koi, goldfish, tropical fish), and uses AI vision analysis to extract color saturation (HSV-S channel) and brightness (HSV-V channel) of specific body regions (e.g. mid-trunk), compares them with healthy standard color ranges of the same species (built-in database or user-defined), and outputs a vibrancy. | 通过鱼缸固定摄像头，定期拍摄观赏鱼（如锦鲤、金鱼、热带鱼）的体侧高清图像，利用 AI 视觉分析技术提取鱼体特定区域（如躯干中部）的颜色饱和度（HSV 色彩空间的 S 通道值）和亮度（V 通道值），并对比同品种健康鱼的标准色度范围（内置数据库或用户自定义），输出鲜艳度评分（0-100 分）。当评分低于阈值（如 < 50）时，提示'体色暗淡'，可能为疾病、营养不良或水质不良的信号。"
version: "1.0.17"
license: "MIT-0"
---

# 🌈 Ornamental Fish Color Brightness Assessment | 观赏鱼体色鲜艳度评估
> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询

---

## 🧭 技能概览 | Overview

| 模块 | 内容 |
|---|---|
| 🏷️ 技能名称 | **观赏鱼体色鲜艳度评估** |
| 🎯 核心目标 | 通过鱼缸固定摄像头，定期拍摄观赏鱼（如锦鲤、金鱼、热带鱼）的体侧高清图像，利用 AI 视觉分析技术提取鱼体特定区域（如躯干中部）的颜色饱和度（HSV 色彩空间的 S 通道值）和亮度（V 通道值），并对比同品种健康鱼的标准色度范围（内置数据库或用户自定义），输出鲜艳度评分（0-100 分）。当评分低于阈值（如 < 50）时，提示'体色暗淡'，可能为疾病、营养不良或水质不良的信号。 |
| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |
| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |
| 🧩 场景码 | `SMYX_FISH_COLOR_BRIGHTNESS_ASSESSMENT_ANALYSIS` |

Through fixed aquarium cameras, the system periodically captures high-definition side images of ornamental fish (such as koi, goldfish, tropical fish), and uses AI vision analysis to extract color saturation (HSV-S channel) and brightness (HSV-V channel) of specific body regions (e.g. mid-trunk), compares them with healthy standard color ranges of the same species (built-in database or user-defined), and outputs a vibrancy score (0-100). When the score is below a threshold (e.g. <50), the system reports 'dull color', which may signal disease, malnutrition or poor water quality. Application scenarios: home aquariums, public aquariums, ornamental fish farms. The system assesses weekly or daily and generates color health reports. Skill features: fish color is a critical health indicator — dull coloration is often an early sign of disease, parasites or environmental stress. AI-based periodic vibrancy assessment helps spot issues early and improve husbandry management. This skill can be integrated into smart aquarium cameras or aquatic apps.

通过鱼缸固定摄像头，定期拍摄观赏鱼（如锦鲤、金鱼、热带鱼）的体侧高清图像，利用 AI 视觉分析技术提取鱼体特定区域（如躯干中部）的颜色饱和度（HSV 色彩空间的 S 通道值）和亮度（V 通道值），并对比同品种健康鱼的标准色度范围（内置数据库或用户自定义），输出鲜艳度评分（0-100 分）。当评分低于阈值（如 < 50）时，提示'体色暗淡'，可能为疾病、营养不良或水质不良的信号。应用场景：家庭鱼缸、水族馆、观赏鱼养殖场。系统每周或每日评估，生成体色健康报告。技能特点：鱼体颜色是健康的重要指示器，体色暗淡常为疾病、寄生虫或环境应激的早期表现。通过 AI 定期评估鲜艳度，可及时发现问题，提升养殖管理水平。该技能可集成到智能鱼缸摄像头或水族 APP 中。

## 🤖 AI 角色 | AI Role
| 角色要点 | 说明 |
|---|---|
| 说明 1 | **假设你是一个专业的水族色彩评估 AI。你的任务是分析观赏鱼体侧高清图像（≥ 1080p，鱼体侧面拍摄，视野内必须有白卡/灰卡/ColorChecker 作白平衡参考），先对图像做**白平衡校正与光照归一化**（基于白参考估算光照色温 K），然后分割鱼体并提取躯干主区域（默认 trunk_middle，可选 head / dorsal / caudal_fin）的 **HSV-S（饱和度）+ HSV-V（亮度）+ HSV-H（色相分布直方图）**，按 **species_subtype（精确到子品系，如锦鲤-大正三色 / 神仙鱼-银河系 / 孔雀鱼-礼服）匹配标准色度基线**（饱和度范围 /

_meta.json

{
  "ownerId": "kn7cyxkr2ymf7zwsrybpedg8xx83ywrj",
  "slug": "smyx-fish-color-brightness-assessment-analysis",
  "version": "1.0.12",
  "publishedAt": 1791030626329
}

references/api_doc.md

# API 接口文档

此处用于存放观赏鱼体色鲜艳度评估 API 的接口文档，待后续补充。

## 接口规范

- 基础地址：由 smyx_common 配置统一管理
- 认证方式：API Key 鉴权
- 响应格式：JSON

## 主要接口

1. `/web/health-analysis/v2/start-health-analysis` - 启动观赏鱼体色鲜艳度评估任务
2. `/web/health-analysis/v2/get-health-analysis-result` - 获取评估结果（HSV-S/V 均值 + 鲜艳度评分 + 品种基线对比）
3. `/web/health-analysis/page-health-analysis-result` - 分页查询历史评估报告
4. `/health/order/api/getReportDetailExport?id={id}` - 导出鲜艳度时间序列报告
5. （可选）`/web/companion/v2/trigger-soothing-action` - 触发联动提醒（用户 APP 推送 / 建议调整饲料/光照/水质）

## 场景代码

- `SMYX_FISH_COLOR_BRIGHTNESS_ASSESSMENT_ANALYSIS` - 观赏鱼体色鲜艳度评估

## 输入约束

- 摄像头：鱼缸固定摄像头 / 智能鱼缸内置摄像头 / 手机拍摄（侧面，垂直于鱼体侧面方向）
- 分辨率 ≥ 1080p（颜色饱和度评估需高色彩精度）
- **关键硬件要求**：**视野内必须放置已知白色参考物（白卡 / 灰卡 / 标准 ColorChecker）**，用于做**白平衡校正**与**光照归一化**（核心，否则环境灯光偏色会让评分失真）
- 拍摄角度：**鱼体侧面**（评估躯干主区域颜色），鱼体应位于视野中央，与背景对比清晰
- 光照：建议鱼缸照明常开 + **使用 5000-6500K 中性白光源**
- 鱼体拍摄时应**短暂静止**
- 多鱼缸场景按摄像头 ID 绑定到注册容器 ID
- **部署时必须录入**：鱼种 + 品系（决定标准色度数据库匹配，如锦鲤红白/大正三色/昭和三色、金鱼狮子头/兰寿、神仙鱼银河系/熊猫、孔雀鱼礼服/草尾、热带龙鱼红/金/青）
- 用户必须授权部署；公共养殖场 / 水族馆需公示告知

## 关键观测信号

### 白平衡校正与光照归一化（核心）
- `white_reference_type` - 白参考类型（white_card / gray_card / colorchecker / not_detected）
- `white_reference_detection_confidence` - 白参考检测置信度（0-1）
- `light_temperature_kelvin_estimated` - 估算光照色温（K）
- `wb_correction_applied` - 是否已做白平衡校正（bool）
- `light_intensity_normalized_score` - 光照强度归一化评分

### 鱼体区域分割
- `fish_id` - 鱼个体唯一标识（可选）
- `species_subtype` - 鱼种 + 品系（精确到子品系，如"锦鲤-大正三色"）
- `body_segmentation_mask_pixel_count` - 鱼体分割掩膜像素数
- `body_segmentation_confidence` - 分割置信度（0-1）
- `analysis_roi` - 分析区域（默认 trunk_middle，可选 head / dorsal / caudal_fin）

### HSV 色彩信号（核心）
- `hsv_s_mean` - 躯干区域**饱和度均值**
- `hsv_s_std` - 饱和度标准差
- `hsv_v_mean` - 躯干区域**亮度均值**
- `hsv_v_std` - 亮度标准差
- `hsv_h_dominant_hue_deg` - 主色相（0-360）
- `hsv_h_distribution_histogram` - 色相分布直方图（用于多色品种如锦鲤"红/白/黑"分区比例）

### 品种基线对比
- `species_subtype_baseline_s_range` - 该品系健康标准饱和度范围
- `species_subtype_baseline_v_range` - 该品系健康标准亮度范围
- `species_subtype_baseline_h_target_palette` - 该品系标准色相调色板
- `color_palette_match_score` - 与标准调色板的匹配度（0-100）
- `s_baseline_z_score` - 饱和度相对基线的 z-score
- `v_baseline_z_score` - 亮度相对基线的 z-score

### 鲜艳度综合评分
- `vibrancy_score_0_100` - **鲜艳度综合评分（0-100，核心输出）**
- `vibrancy_score_trend_7d` - 近 7 天评分变化趋势
- `vibrancy_score_trend_30d` - 近 30 天评分变化趋势

## 综合判定

- `color_vibrant_excellent` - 鲜艳度极佳（≥ 85）
- `color_vibrant_good` - 鲜艳度良好（70-84）
- `color_acceptable` - 可接受（50-69）
- `color_dull_mild` - **体色暗淡轻度**（35-49）
- `color_dull_severe` - **体色暗淡严重**（< 35）
- `color_baseline_unavailable` - 该品系暂无标准基线（仅输出客观 HSV 值，不评分鲜艳度）
- `color_signal_unreliable` - 信号不可靠（白参考未检出 / 分割置信度 < 0.7 / 光照过暗或过曝 / 鱼体姿态侧面不可见）

## 4 级提醒策略递进（侧重养殖管理建议，非疾病诊断）

- Level 1（excellent / good）：仅入库 + 积极反馈"鲜艳度优秀，继续保持当前管理方式"
- Level 2（acceptable / dull_mild）：重要提示，建议**评估增色饲料（中性提示"含虾青素/螺旋藻类"，禁止具体品牌）/ 检查光照（光谱完整性 + 色温 + 周期）/ 检查水质（NH3/NO2-/pH/KH）**
- Level 3（dull_severe，单次）：紧急提示，建议**立即检查体表 + 游姿 + 摄食活跃度 + 水质五项 + 投喂记录**，并联系**当地观赏鱼兽医或资深玩家**
- Level 4（dull_severe 连续 ≥ 14 天 / 同缸 ≥ 50% 个体同时严重暗淡）：最高紧急提示 + 推送所有管理人员 + 强烈建议**

skills/smyx_analysis/references/api_doc.md

# API接口文档

## 接口规范

- 基础地址：由 smyx_common 配置统一管理
- 认证方式：API Key 鉴权
- 请求格式：支持文件上传
- 响应格式：JSON

## 错误码说明

| 错误码 | 说明       |
|-----|----------|
| 400 | 请求参数错误   |
| 401 | API密钥无效  |
| 403 | 权限不足     |
| 413 | 文件过大     |
| 415 | 不支持的文件格式 |
| 500 | 服务器内部错误  |

scripts/config.yaml

{}

Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.