How should Fish Isolation / Schooling Behavior Detection | 鱼类聚集/离群行为识别 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

Fish Isolation / Schooling Behavior Detection | 鱼类聚集/离群行为识别

Through fixed cameras on aquariums, the system continuously tracks the 2D position of each fish in the school, computes the school centroid (center of mass), and measures the distance from each fish to the centroid (in units of fish body length). | 通过鱼缸固定摄像头，持续跟踪鱼群中每条鱼的二维位置，计算鱼群中心（质心），并检测每条鱼与中心的距离（以鱼体长为单位）。当某条鱼偏离鱼群中心超过 10 倍体长，且持续时间超过 1 小时（或用户设定阈值）时，输出'离群行为'提示。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.5k

Updated

Oct 10, 2026

Version

1.0.10

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.5K 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.5K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.10release · observed Oct 3, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-fish-isolation-detection-analysis

Install using `clawhub skill install s17cfv2h26b7hq5w47tgfy23xx83z9x6:smyx-fish-isolation-detection-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-isolation-detection-analysis before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-smyx-sunjinhui-smyx-fish-isolation-detection-analysis/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-isolation-detection-analysis"
description: "Through fixed cameras on aquariums, the system continuously tracks the 2D position of each fish in the school, computes the school centroid (center of mass), and measures the distance from each fish to the centroid (in units of fish body length). | 通过鱼缸固定摄像头，持续跟踪鱼群中每条鱼的二维位置，计算鱼群中心（质心），并检测每条鱼与中心的距离（以鱼体长为单位）。当某条鱼偏离鱼群中心超过 10 倍体长，且持续时间超过 1 小时（或用户设定阈值）时，输出'离群行为'提示。"
version: "1.0.16"
license: "MIT-0"
---

# 🐟 Fish Isolation / Schooling Behavior Detection | 鱼类聚集/离群行为识别
> **智能分析中枢** · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询

---

## 🧭 技能概览 | Overview

| 模块 | 内容 |
|---|---|
| 🏷️ 技能名称 | **鱼类聚集/离群行为识别** |
| 🎯 核心目标 | 通过鱼缸固定摄像头，持续跟踪鱼群中每条鱼的二维位置，计算鱼群中心（质心），并检测每条鱼与中心的距离（以鱼体长为单位）。当某条鱼偏离鱼群中心超过 10 倍体长，且持续时间超过 1 小时（或用户设定阈值）时，输出'离群行为'提示。 |
| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |
| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |
| 🧩 场景码 | `SMYX_FISH_ISOLATION_DETECTION_ANALYSIS` |

Through fixed cameras on aquariums, the system continuously tracks the 2D position of each fish in the school, computes the school centroid (center of mass), and measures the distance from each fish to the centroid (in units of fish body length). When a fish drifts more than 10 body lengths away from the school center and the state lasts longer than 1 hour (or a user-defined threshold), the system outputs an 'isolation behavior' alert. This skill helps early detection of bullied, sick (e.g. parasites, bacterial infections), spawning-period solitary or environment-distressed (e.g. strong water flow, temperature gradient) individuals, prompting aquarists to inspect and intervene. Application scenarios: home aquariums, public aquariums, aquaculture ponds, quarantine tanks. The system monitors continuously and pushes reminders when prolonged isolated fish is found. Skill features: prolonged isolation is often an early signal of disease (e.g. external parasites, digestive issues) or stress from bullying. AI-based automatic identification of isolation behavior helps aquarists detect sick fish early and isolate for treatment, reducing whole-tank infection risk. This skill can be integrated into smart aquarium cameras to enhance product behavior-analysis capability.

通过鱼缸固定摄像头，持续跟踪鱼群中每条鱼的二维位置，计算鱼群中心（质心），并检测每条鱼与中心的距离（以鱼体长为单位）。当某条鱼偏离鱼群中心超过 10 倍体长，且持续时间超过 1 小时（或用户设定阈值）时，输出'离群行为'提示。该技能有助于早期发现被欺凌、生病（如寄生虫、细菌感染）、产卵期孤立或环境不适（如水流过强、温度不均）的个体，提醒养鱼者及时检查干预。应用场景：家庭鱼缸、水族馆、水产养殖池、检疫缸。系统连续监测，当发现长期离群鱼只时推送提醒。技能特点：鱼只长期离群往往是疾病的早期信号（如体表寄生虫、消化问题），或受欺凌导致应激。通过 AI 自动识别离群行为，可帮助养鱼者及早发现病鱼并隔离治疗，降低全缸感染风险。该技能可集成到智能鱼缸摄像头中，提升产品行为分析能力。

## 🤖 AI 角色 | AI Role
| 角色要点 | 说明 |
|---|---|
| 说明 1 | **假设你是一个专业的水族行为监测 AI。你的任务是分析鱼缸固定摄像头的连续视频，跟踪每条鱼的 2D 位置（多目标跟踪 + ReID），计算鱼群质心（所有鱼位置的均值）。对每条鱼，计算其与质心的欧氏距离（**以该鱼的体长为单位**，核心量化单位）。当某条鱼的距离 > 10 倍体长（用户可配置）且该状态持续时间 ≥ 1 小时（用户可配置）时，输出离群提示。按 7 类综合场景（schooling_normal / schooling_loose / isolation_short / isolation_persistent / isolation_corner_stuck / multiple_isolated_individuals / isolation_signal_unreliable）作判定，按 4 级告警策略递进（Level 1 入库/轻提醒 → Level 2 重要告警 + 目视检查体表/游姿/呼吸

_meta.json

{
  "ownerId": "kn7cyxkr2ymf7zwsrybpedg8xx83ywrj",
  "slug": "smyx-fish-isolation-detection-analysis",
  "version": "1.0.10",
  "publishedAt": 1791017560368
}

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` - 获取离群检测结果（离群个体清单 + 离群距离 + 持续时长）
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_ISOLATION_DETECTION_ANALYSIS` - 鱼类聚集/离群行为识别

## 输入约束

- 摄像头：鱼缸固定摄像头 / 养殖池上方摄像头 / 检疫缸全景摄像头，建议**俯拍或大角度斜视**（保证 2D 位置投影稳定）
- 分辨率 ≥ 720p；**帧率 ≥ 10 FPS**（位置跟踪需稳定）
- 光照：建议鱼缸照明开启 + 无强反光；水质清澈（浑浊度低）
- **核心采样窗口**：连续观察 ≥ 1 小时（用户可配置 30 分钟 - 24 小时滚动窗口）
- 视野约束：必须覆盖整个鱼缸/养殖池**完整水平投影**（任何 dead zone 都可能误判为"离群"）
- 多鱼缸/池场景按摄像头 ID 绑定到注册容器 ID
- **多鱼场景必须接入 ReID**（多目标跟踪 + 重识别），每条鱼建立稳定 fish_id
- **部署时必须录入**：鱼种清单、群体大小 N（用户输入或首次自动统计取众数）、每条鱼体长校准（像素 ↔ cm，可单次手动校准或自动学习）
- 用户必须授权部署；公共水族馆 / 养殖场需公示告知

## 关键观测信号

### 群体几何信号
- `tracked_fish_count` - 当前帧成功跟踪到的鱼数
- `total_fish_count_baseline` - 容器注册总鱼数（基线）
- `school_centroid_xy` - 鱼群质心（所有鱼 2D 位置均值）
- `school_dispersion_score` - 群体分散度（所有鱼到质心距离的标准差，体长归一化）
- `school_compactness_score` - 群体紧密度（0-100，越高越紧密；夜行鱼休息时自然偏低）

### 个体离群信号（每条 fish_id 独立）
- `fish_id` - 个体唯一标识（ReID 输出）
- `fish_body_length_px` - 该鱼当前体长（像素，自动估计）
- `fish_position_xy` - 该鱼当前 2D 位置
- `distance_to_centroid_body_lengths` - 与质心欧氏距离（**以体长为单位**，核心指标）
- `over_threshold_flag` - 是否超过阈值（默认 > 10 倍体长）
- `over_threshold_duration_min` - 持续超阈时长（分钟，跨帧累计）

### 上下文信号（避免误报）
- `is_natural_solitary_species` - 是否独居鱼种（斗鱼 / 大型龙鱼 / 部分慈鲷天然独居）
- `is_breeding_period` - 是否繁殖期（公鱼护卵 / 母鱼离群产卵）
- `is_territory_corner_fish` - 是否为领地型缸角守卫鱼（"离群"实为正常占地）
- `is_during_feeding` - 是否在投喂窗口内（短时聚拢/分散为生理性）
- `tank_has_strong_water_flow` - 是否有强水流区（被冲到角落可能误判）
- `tank_temperature_gradient_detected` - 是否检测到温度不均（鱼可能聚于舒适温区，余者"离群"）

## 综合判定

- `schooling_normal` - 群体正常聚集
- `schooling_loose` - 群体偏松散（但无明显离群个体）
- `isolation_short` - 短时离群（> 10 倍体长但 < 1 小时）
- `isolation_persistent` - **持续离群**（> 10 倍体长且 ≥ 1 小时，核心告警场景）
- `isolation_corner_stuck` - 角落呆滞（离群 + 长时间几乎不动，疑似严重不适）
- `multiple_isolated_individuals` - 多鱼同时离群（疑似全缸应激 / 水质恶化）
- `isolation_signal_unreliable` - 信号不可靠（ReID 断裂 / 视野遮挡 / 浑浊度过高 / 跟踪 < 80% 鱼数）

## 4 级告警策略递进

- Level 1（isolation_short / schooling_loose）：仅入库或用户 APP 轻提醒"观察某条鱼是否长期离群"
- Level 2（isolation_persistent，单条）：用户 APP 重要告警，建议**目视检查该鱼体表 / 游姿 / 呼吸 / 摄食活跃度**，并**评估是否隔离至检疫缸**
- Level 3（isolation_corner_stuck / 连续 ≥ 2 日 isolation_persistent）：紧急告警，**强烈建议立即隔离至检疫缸 + 检查水质（溶氧/pH/氨氮/温度梯度）**，并提示联系**当地观赏鱼兽医**
- Level 4（multiple_isolated_individuals / 同缸 ≥ 3 条同时持续离群）：最高紧急告警 + 推送家庭/管理人员所有联系人 + 强烈建议**立即全面排查（水质 + 体表 + 游姿 + 呼吸 + 摄食）+ 联系专业人员**

## 单日告警上限

- Level 1 不限 / Level 2 × 6 / Level 3 × 3 / Level 4 不设上限

## 红线约束

- **禁止**做"寄生虫 / 细菌感染 / 鳃病 / 肠炎 / 应激综合征"等具体疾病诊断
- **禁止**输出具体药物名称、剂量、给药方案
- **禁止**长期存储完整鱼缸/养殖池视频（≤ 7 天，仅入库离群事件片段与轨迹摘要；公共水族馆/养殖场按管理规定）
- **禁止**用于商业广告 / AI 训练；禁第三方共享
- **禁止**越权代用户启停隔离泵 / 加热棒 / 换水 / 投

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 16h 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.