技能介绍

要解决什么问题

宠物不会主动汇报「昨晚睡得好不好」，但睡眠片段化、频繁翻身或夜间惊醒，往往是疼痛、焦虑或慢性病的早期信号。主人在卧室睡觉、摄像头只对着窝区时，更需要一种可重复、可量化的方式：在主要睡眠时段里区分静止（睡眠）与活动（觉醒），而不是凭印象猜。

本技能面向窝区或休息区固定机位的夜间（或宠物惯常睡眠时段）视频，输出睡眠总时长、翻身/姿势变换次数、惊醒频次，以及 0–100 的睡眠质量评分，并支持将结果沉淀为结构化报告；历史清单需通过云端接口查询，不能靠会话记忆拼凑。

技能如何工作

分析链路依赖运动检测与姿态/活动状态识别，在时间轴上累计指标，并可做深睡/浅睡时段划分（以视觉行为代理，非脑电）：

睡眠/觉醒状态：区分相对静止与明显活动
时长与事件：累计总睡眠时长，统计翻身与惊醒
综合评分：按评分区间给出「优秀」到「极差」的参考解读
输入形态：本地路径（--input）或公网视频 URL（--url），由 API 侧拉取；可选 --pet-type（cat/dog/other）

标准执行是在技能根目录调用 python -m scripts.smyx_sleep_quality_analysis_analysis；查历史报告使用 --list，且只允许从该脚本对接的云端 API 取数，再以 Markdown 表格（含报告链接字段）展示。用户身份由系统静默关联，不应在对话里索要或暴露内部身份参数。

适用边界与注意点

非医疗诊断：报告仅供睡眠健康参考；持续异常应就医，勿把评分当确诊依据。
素材要求：建议固定视角、完整覆盖休息区；夜间宜开红外/夜视；常见格式 mp4/avi/mov，文档注明单文件上限与「整夜/≥1 小时」更利于统计稳定性。
基线因人而异：成猫/成犬有参考区间，幼宠与老年宠睡眠更长属常见情况；活动时段素材不适合替代主要睡眠时段分析。
标题与能力范围：技能核心是睡眠质量（时长/翻身/惊醒）；若资料标题混入打喷嚏/咳嗽等表述，应以 SKILL 正文能力为准，勿假定未声明的检测项。