Analyzes overnight pet camera video to output sleep duration, roll-over count, startle events, and a 0-100 quality score.
12 installs
Design & media
Pet Sneeze / Cough Detection | 宠物打喷嚏/咳嗽检测
Try itDetect and classify pet sneezing or coughing from video, with optional audio, and flag abnormal frequency.
What it does
Accepts pet activity video (local file or URL) and identifies sneezing (head shake + nasal air expulsion) and coughing (neck extension + abdominal contraction), with optional audio fusion for higher accuracy. Outputs a structured report with event time, frequency, cough type (dry, wet, goose-honk, nocturnal), and a four-tier severity rating from occasional to emergency. Results are behavioral observations only and are not a medical diagnosis.
When to use it
- Daily home respiratory monitoring of cats and dogs
- Ward observation in animal hospitals
- Monitoring pets at boarding centers
- Early screening for kennel cough, allergies, or airway irritation
The skill document
💨 Pet Sneeze / Cough Detection | 宠物打喷嚏/咳嗽检测
智能分析中枢 · 图片/视频智能分析 · 结构化报告 · 历史报告云端查询
🧭 技能概览 | Overview
| 模块 | 内容 |
|---|---|
| 🏷️ 技能名称 | 宠物打喷嚏/咳嗽检测 |
| 🎯 核心目标 | 通过宠物摄像头实时分析宠物头部和胸腹部的动作，结合可选的声音分析，识别宠物是否发生打喷嚏或咳嗽行为。区分单次偶发（可能是正常清理呼吸道）与连续发作（如频繁打喷嚏、干咳、湿咳等异常模式），并记录发生时间及频率。有助于早期发现宠物呼吸道感染、过敏或异物刺激。应用场景：宠物家庭日常健康监测、宠物医院住院观察、宠物寄养中心。 |
| 🖼️ 输入类型 | 图片、视频、本地文件、网络 URL |
| 📝 输出能力 | 结构化分析报告、识别/监测结果、建议与报告链接 |
| 🧩 场景码 | SMYX_SNEEZE_COUGH_DETECTION_ANALYSIS |
AI-powered pet sneeze/cough detection from real-time camera (optional audio fusion). Analyzes head and thoracic-abdominal motion plus sound features to distinguish single occasional events (normal airway clearing) from continuous bursts (e.g. ≥3 sneezes/min, frequent dry/wet coughing) and records event time and frequency. Helps catch respiratory infection, allergy, or foreign-body irritation early. Scenarios: home health monitoring, animal hospital wards, pet boarding centers.
通过宠物摄像头实时分析宠物头部和胸腹部的动作，结合可选的声音分析，识别宠物是否发生打喷嚏或咳嗽行为。区分单次偶发（可能是正常清理呼吸道）与连续发作（如频繁打喷嚏、干咳、湿咳等异常模式），并记录发生时间及频率。有助于早期发现宠物呼吸道感染、过敏或异物刺激。应用场景：宠物家庭日常健康监测、宠物医院住院观察、宠物寄养中心。
🤖 AI 角色 | AI Role
| 角色要点 | 说明 |
|---|---|
| 说明 1 | 假设你是一个专业的宠物呼吸健康AI。你的任务是分析宠物活动的实时视频（可选配合音频），检测打喷嚏或咳嗽行为。区分单次偶发（可能是正常清理）与连续发作（异常），记录事件时间、频次和类型。不要提供医疗诊断，仅输出基于视觉和音频的客观行为识别结果。 |
🎬 技能演示 | Skill Demo
🎯 任务目标 | Goals
1. 🧩 技能用途
通过室内摄像头视频（可选叠加音频）进行打喷嚏与咳嗽行为识别，区分偶发与连续发作，记录事件时间、频次和类型
2. 🛠️ 能力范围
| 序号 | 具体能力 |
|---|---|
| 1 | 打喷嚏动作识别（头部抖动+鼻部喷气） |
| 2 | 咳嗽动作识别（颈部前伸+腹部收缩） |
| 3 | 咳嗽类型区分（干咳/湿咳） |
| 4 | 音频特征融合（可选） |
| 5 | 连续发作频次统计 |
| 6 | 单次偶发与异常发作区分 |
3. ⚡ 触发条件
| 触发类型 | 触发规则 |
|---|---|
| ✅ 默认触发 | 默认触发：当用户提供宠物活动视频需要分析时，默认触发本技能进行打喷嚏/咳嗽检测 |
| 🔎 明确分析意图 | 当用户明确需要呼吸道行为检测时，提及打喷嚏、咳嗽、干咳、湿咳、犬窝咳、鼻炎、过敏等关键词，并且上传了视频文件 |
| 📚 历史报告查询 | 当用户提及以下关键词时，自动触发历史报告查询功能 ：查看历史咳嗽报告、历史打喷嚏报告、咳嗽检测报告清单、显示所有呼吸道报告、查询咳嗽事件记录 |
4. 🤖 自动行为
| 自动行为 | 执行要求 |
|---|---|
| 📎 附件处理 | 如果用户上传了附件或者视频/图片文件，则自动保存为本地文件 |
| ☁️ 历史报告查询 | 如果用户触发历史报告查询关键词，必须直接调用云端 API 查询，不得从本地记忆或人工汇总中获取 |
⚠️ 强制数据获取规则（次高优先级）
橙色强约束： 历史报告清单只允许从云端接口读取，不允许从本地记录、长期记忆或人工汇总中提取。
必须执行：
python -m scripts.smyx_sneeze_cough_detection_analysis --list
| 类型 | 要求 |
|---|---|
| ✅ 必须 | 使用 python -m scripts.smyx_sneeze_cough_detection_analysis --list 调用 API 查询云端的历史报告数据 |
| 🚫 严格禁止 | 从本地 memory 目录读取历史会话信息 |
| 🚫 严格禁止 | 手动汇总本地记录中的报告 |
| 🚫 严格禁止 | 从长期记忆中提取报告 |
| ✅ 输出格式 | 必须统一从云端接口获取最新完整数据，然后以 Markdown 表格格式输出结果 |
📦 前置准备 | Requirements
- 依赖说明:scripts 脚本所需的依赖包及版本
requests>=2.28.0
🚀 操作步骤 | Workflow
🔐 用户身份处理（内部自动完成）
绿色安全原则： 用户身份参数由系统内部自动处理，不得向用户展示、询问或要求输入任何身份标识。
执行本技能分析或历史报告查询时，脚本会自动完成身份初始化：
| 场景 | 系统行为 |
|---|---|
| 上游系统有内部身份参数 | 由脚本静默接收并使用 |
| 上游系统未提供内部身份参数 | 脚本会自动复用本地缺省用户 |
| 本地缺省用户不存在 | 脚本会自动创建并在后续任务中复用 |
| 对用户输出 | 只展示分析进度、分析结果和报告链接，不展示内部身份值 |
🔒 关键约束
| 禁止/要求 | 说明 |
|---|---|
| 🚫 不得询问身份 | 不得提示用户输入用户名、手机号或任何内部身份参数 |
| 🚫 不得暴露身份值 | 不得在回复、报告、示例、错误提示中暴露内部身份值 |
| 🚫 不得列为用户参数 | 不得把内部身份参数列为用户需要理解或传入的参数 |
| ✅ 自动关联报告 | 历史报告查询同样由系统内部身份自动关联，用户只需表达“查看历史报告/报告清单”等意图 |
🧪 标准流程 | Standard Flow
| 步骤 | 阶段 | 执行动作 |
|---|---|---|
| 1 | 📥 准备视频输入 | 提供本地文件路径或网络 URL；确保输入内容清晰、符合技能场景要求 |
| 2 | 🔐 系统自动完成身份关联 | 无需用户输入任何身份参数；不在回复中展示内部身份值 |
| 3 | ⚙️ 执行打喷嚏/咳嗽检测 | 调用 -m scripts.smyx_sneeze_cough_detection_analysis 处理输入（必须在技能根目录下运行脚本） |
| 4 | 📊 查看检测结果 | 接收结构化分析报告，查看识别/监测结果、风险提示、建议与报告链接 |
⚙️ 脚本参数说明
| 参数 | 含义 | 备注 |
|---|---|---|
--input | 本地宠物活动视频（含音频）文件路径 | 适用于本地文件分析 |
--url | 网络宠物活动视频 URL 地址（API 服务自动下载） | API 服务自动下载网络资源 |
--pet-type | 宠物类型，可选值：cat/dog/other，默认 cat | 按需填写 |
--list | 显示打喷嚏/咳嗽检测历史报告列表清单 | 用于云端历史报告查询 |
--api-url | API 服务地址（可选，使用默认值） | 按需填写 |
--detail | 输出详细程度（basic/standard/json，默认 json） | 输出详细程度 |
--output | 结果输出文件路径（可选） | 可选 |
💨 打喷嚏 vs 咳嗽：动作特征区分
| 特征 | 打喷嚏（Sneeze） | 咳嗽（Cough） |
|---|---|---|
| 主要部位 | 头部突然前伸抖动 | 颈部前伸 + 胸腹收缩 |
| 嘴巴 | 张开喷气 | 干咳张口、湿咳可能闭合 |
| 音频特征 | 短促喷气声 | 干咳：短促刺耳；湿咳：含痰低沉 |
| 持续时间 | 极短（<1秒） | 稍长（1-3秒） |
| 常见原因 | 灰尘、过敏、鼻炎 | 犬窝咳、肺炎、气管炎、异物 |
🏥 咳嗽类型参考
| 咳嗽类型 | 特征 | 可能原因 |
|---|---|---|
| 🌬️ 干咳 | 无痰，声音清脆刺耳 | 犬窝咳、气管塌陷、过敏 |
| 💧 湿咳 | 有痰音，声音低沉浑浊 | 肺炎、支气管炎 |
| 🪶 鹅鸣咳 | 类似鹅叫声 | 气管塌陷（小型犬常见） |
| 🌙 夜间咳 | 仅在夜间或躺下时咳嗽 | 心脏病（二尖瓣疾病） |
🚨 预警分级
| 等级 | 触发条件 | 建议 |
|---|---|---|
| 🟢 偶发 | 单次打喷嚏/咳嗽，无连续 | 正常清理呼吸道，继续观察 |
| 🟡 轻度 | 连续打喷嚏 ≥3次/分钟 或 咳嗽 2-3次/小时 | 留意环境粉尘、香水等刺激源 |
| 🟠 频繁 | 打喷嚏频繁或 咳嗽 ≥5次/小时 | 建议预约兽医检查呼吸道 |
| 🔴 严重 | 咳嗽持续不断、伴喘息/呼吸困难 | ⚠️ 立即就医，警惕肺炎、心衰 |
💡 高风险品种与场景
| 类别 | 重点关注原因 |
|---|---|
| 短鼻犬（巴哥、法斗、英斗等） | 气管塌陷风险高，鹅鸣咳常见 |
| 幼犬（未完成疫苗接种） | 犬窝咳传染性强，需隔离观察 |
| 猫咪（多猫环境） | 猫疱疹病毒、杯状病毒易传播 |
| 老年犬 | 慢性支气管炎、心脏病（夜间咳嗽） |
| 换季/花粉季 | 过敏性喷嚏频发 |
🗂️ 资源索引 | Resource Index
| 资源类型 | 路径 | 用途 | 何时读取 |
|---|---|---|---|
| 🐍 必要脚本 | scripts/smyx_sneeze_cough_detection_analysis.py | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |
| 🐍 必要脚本 | scripts/config.py | 调用 API、执行分析或查询历史报告 | 执行分析或查询时使用 |
| 📘 领域参考 | references/api_doc.md | 了解 API 接口规范、字段说明和错误码 | 仅在需要了解接口规范或错误码时读取 |
⚠️ 注意事项 | Notes
| 分类 | 注意事项 |
|---|---|
| 📚 文档读取 | 仅在需要时读取参考文档，保持上下文简洁 |
| 📁 格式支持 | 视频要求：支持 mp4/avi/mov 格式，最大 10MB；建议时长 ≥ 30 秒 |
| 🔎 使用提醒 | 含音频的视频可大幅提升检测准确率，建议使用带麦克风的摄像头拍摄 |
| 🔎 使用提醒 | 摄像头需固定，视角覆盖宠物头部及胸腹部，移动拍摄可能影响检测效果 |
| 🧑⚖️ 结果性质 | 检测结果仅供行为观察参考，不提供医疗诊断；频繁发作建议及时就医 |
| 🔎 使用提醒 | 宠物打哈欠、伸懒腰等动作可能产生误检，建议结合频次和连续性综合判断 |
| 🚫 脚本限制 | 禁止临时生成脚本，只能用技能本身的脚本 |
| 🌐 网络地址 | 传入的网络地址参数，不需要下载本地，默认地址都是公网地址，API 服务会自动下载 |
| 📜 报告输出 | 当显示历史检测报告清单的时候，从接口返回 json 数据中提取字段 作为超链接地址，且自动转化为如下 Markdown |
| 📜 报告输出 | 表格输出示例 |
🧰 使用示例 | Examples
# 分析本地宠物活动视频
python -m scripts.smyx_sneeze_cough_detection_analysis --input /path/to/pet_video.mp4 --pet-type cat
# 分析网络宠物活动视频
python -m scripts.smyx_sneeze_cough_detection_analysis --url https://example.com/pet_video.mp4 --pet-type dog
# 显示历史检测报告/显示报告清单列表（自动触发关键词：查看历史咳嗽报告、打喷嚏报告清单等）
python -m scripts.smyx_sneeze_cough_detection_analysis --list
# 输出精简报告
python -m scripts.smyx_sneeze_cough_detection_analysis --input video.mp4 --pet-type cat --detail basic
# 保存结果到文件
python -m scripts.smyx_sneeze_cough_detection_analysis --input video.mp4 --pet-type cat --output result.json
Questions people ask
- Does this skill provide a medical diagnosis?
- No. It identifies respiratory behaviors from video (and optionally audio), records event time and frequency, and assigns a severity tier; it explicitly does not offer medical diagnosis.
- What video formats and duration are supported?
- mp4, avi, and mov up to 10MB. The documentation recommends clips of at least 30 seconds, with the camera fixed so the pet's head and thorax-abdomen are visible.
- Can I retrieve historical detection reports?
- Yes. Phrases such as 查看历史咳嗽报告 or 打喷嚏报告清单 trigger the script to call the cloud API via --list and return past reports as a Markdown table.
Related skills
AI-powered non-contact pet respiratory rate monitoring at rest. Detects thoracic-abdominal motion via a fixed camera, calculates breaths-per-minute, and compares against species/body-size resting norms; triggers early-warning when abnormal (e.g. dog >30 bpm, cat >40 bpm, or <8 bpm). Helps detect cardiopulmonary, respiratory or heat-stress risks early. Scenarios: home night monitoring, animal hospital wards, pet boarding centers. | 通过宠物窝或休息区固定摄像头，在宠物静息状态下分析其胸腹部起伏运动，自动计算呼吸频率（次/分钟），并与该物种/体型的正常静息呼吸范围进行对比；若检测到呼吸过快（如犬>30次/分钟，猫>40次/分钟）或过慢（<8次/分钟），则输出健康预警，建议主人观察或就医。有助于早期发现呼吸系统、心脏或热应激等潜在问题。应用场景：宠物家庭夜间监护、宠物医院住院部、宠物寄养中心。
9 installs
Detect pet vomiting and regurgitation from fixed-camera video and log event time, frequency, and vomitus type.
13 installs
Detect chest and abdomen rise-fall cycles in airline-carrier pet videos and output resting breaths/min, flagging when the rate exceeds 40 bpm.
12 installs
AI-powered pet eye anomaly detection from close-up facial images/video. Detects conjunctival redness, abnormal tearing/tear stains, and pupil/cornea opacity (cataract / corneal edema), then outputs anomaly alerts to help owners catch eye disease risks early. Scenarios: daily home health self-check, boarding center routine inspection, animal hospital triage, senior pet cataract monitoring. | 通过宠物摄像头捕捉宠物面部近景视频，利用AI视觉分析技术检测眼部充血（结膜颜色发红）、异常流泪（泪痕严重或持续性溢泪）、瞳孔区域浑浊（可能为白内障或角膜水肿）等异常征象，输出异常提示，帮助主人及早发现眼部疾病风险。适用于日常健康监测、老年宠物护理及宠物医院预检。应用场景：宠物家庭日常健康自检、宠物寄养中心巡检、宠物医院门诊初筛、老年宠物白内障监测。
9 installs
Triggers when a user provides a pet ear/scratching/head-shaking video URL or file for analysis; uses smart camera to monitor head-shaking and ear-scratching actions, automatically captures HD ear-canal images, and applies AI vision analysis to identify ear-canal color (pink/red/dark red), presence of black granular discharge (ear mites), and degree of earwax accumulation. When redness, large discharge or suspected ear mites are detected, outputs abnormality alerts and recommends owner check-up or veterinary visit. Application: pet families, boarding centers, pet hospital pre-screening. Helps early detection of ear-canal diseases and prevents deterioration. | 当用户提供宠物甩耳、挠耳或耳道抓拍视频URL或文件时，触发本技能进行耳道健康监测分析；通过智能摄像头实时监测甩耳/挠耳动作，自动触发高清抓拍耳道内部图像，利用AI视觉分析识别耳道颜色（粉红/红/暗红）、有无黑色颗粒状分泌物（耳螨）、耳垢堆积程度等异常指标；当检测到红肿、大量分泌物或疑似耳螨时，输出异常提示，建议主人进一步检查或就医，仅输出基于视觉的客观描述与建议，不提供医疗诊断。应用场景：宠物家庭日常健康监测、寄养中心批量监控、宠物医院预检。
9 installs