前言¶
宠物夜间是否睡得安稳，主人很难靠肉眼盯完一整晚。宠物医院和寄养中心在做住院观察时，也缺少一种能持续记录睡眠时长、翻身次数和惊醒频次的低成本手段。下面介绍的这个 Skill 面向的就是这类”长时间无人值守、需要从固定画面里统计睡眠行为”的场景。
这是什么¶
这是一个基于通用 SKILL.md 格式的数据分析类 Skill，由社区开发者 user_bb47e3e3 发布，坐标 @user_bb47e3e3/sleep-quality-analysis-analysis，当前版本 1.0.0。它解决的是这样一个问题：给定宠物窝或休息区的固定摄像头画面，自动判断宠物处于睡眠还是觉醒状态，并把整段观察期的睡眠行为汇总成可量化的指标。
SkillHub 页面显示，它分类为 data-analysis，来源为 community，当前评分 100000，下载 1032 次，安装 0 次。名称写作”Pet Sneeze / Cough Detection | 宠物睡眠质量分析（时长/翻滚次数）”，但从官方简介看，实际能力集中在睡眠时长与体动统计，标题里的”Sneeze / Cough”字样在简介中没有对应的功能描述，使用时以简介能力为准。
核心功能¶
官方简介中写明的能力有四项，均围绕固定摄像头画面做离线或准实时分析：
1、睡眠/觉醒状态判定：通过运动检测和姿态识别，判断画面中的宠物处于静止（睡眠）还是活动（觉醒）状态。
2、睡眠总时长累计：按判定结果累加整个观察时段内的睡眠时长。
3、体动统计：统计翻身次数、位置变化次数，以及惊醒（startle-awakening）频次。
4、睡眠质量评分：综合上述指标输出 0-100 分的睡眠质量评分。
简介同时说明了这套指标的用途：帮助主人识别宠物可能存在的疼痛、焦虑或疾病迹象。注意这是”辅助观察”定位，评分本身不构成诊断结论。
安装与启用¶
该 Skill 以 SKILL.md 格式分发，官方地址为 https://api.skillhub.cn/user_bb47e3e3/sleep-quality-analysis-analysis ，对应的 SkillHub 页面为 https://www.skillhub.cn/skills/user_bb47e3e3/sleep-quality-analysis-analysis 。
启用方式上，已抓取资料只提供了坐标和标签信息，没有给出命令行安装命令，也没有列出具体的配置字段。可以确认的两点是：
1、Skill 坐标为 @user_bb47e3e3/sleep-quality-analysis-analysis，需在所安装的 Agent 环境中按此坐标引用。
2、页面标签为 requires_api_key=true，说明使用前需要准备好对应的 API Key，具体在哪个配置项中填入，以官方页面或运行环境的说明为准。
本次写作时官方页面未能成功抓取，因此 Cursor、Codex CLI、Claude Code 三类环境下的安装命令差异无法核实，这里不做推测。如果你手头已有该 Skill 的安装文档，优先以文档为准。
典型用法¶
根据官方简介还原的可复现流程如下：
1、把摄像头固定在宠物窝或休息区上方，确保整个睡眠区域完整入画，宠物起身、翻身时不会离开视野。
2、在夜间或宠物的主要睡眠时段持续录制或推流，把这段视频作为输入交给 Skill。
3、Skill 在画面上依次完成运动检测与姿态识别，逐段判定睡眠与觉醒状态，并累加睡眠总时长。
4、同时统计区间内的位置变化次数与惊醒频次。
5、输出睡眠质量评分（0-100 分），以及对应的睡眠时长、翻身次数、惊醒次数明细。
输入应当是固定机位、视角稳定的视频；镜头画面抖动或宠物频繁离开画面，会直接影响运动检测和姿态识别的结果。
适用场景与注意¶
适合的场景是官方简介中列出的四类：
1、宠物家庭夜间监护：主人不在卧室时，记录宠物整晚的睡眠与体动情况。
2、老年宠物健康管理：长期追踪睡眠时长与翻身次数，为健康变化留下可比对的记录。
3、宠物医院住院观察：住院期间对动物做睡眠层面的持续观察。
4、宠物寄养中心：在寄养期间向宠物主人提供睡眠侧的照护记录。
使用时的限制和坑，主要来自能力边界和环境：
1、依赖固定机位。画面移动、角度频繁变化时，运动检测和姿态识别的判定会失真，该 Skill 不适用于手持或跟随拍摄。
2、需要 API Key。标签 requires_api_key=true 表明调用前必须完成密钥配置。
3、统计口径以”静止”和”体动”为主。浅睡、多梦这类主观状态无法区分，翻身次数与惊醒次数是行为层面的近似统计。
4、评分不能替代兽医判断。简介提到的疼痛、焦虑或疾病识别，指的是通过睡眠指标发现异常趋势，最终诊断仍需专业检查。
5、多宠物共用一个窝时，姿态识别很难把翻身归属到具体个体，这类场景下统计口径需要先明确。
结尾¶
这个 Skill 的价值在于把”盯着宠物睡觉”这件无法整晚人工完成的事，转成可量化的睡眠时长、翻身次数和惊醒频次，并给出 0-100 的睡眠质量评分。它适合固定机位、夜间长时段的观察场景，作为健康趋势记录使用。官方地址：https://api.skillhub.cn/user_bb47e3e3/sleep-quality-analysis-analysis 。
