睡眠质量分析

要解决的具体问题

睡眠质量分析常依赖穿戴设备或专业 PSG，但家庭或轻量医疗场景更常见的需求是：用已有摄像头视频判断睡眠结构，而不用让用户佩戴传感器。该技能面向睡眠监测视频，解决从原始视频到可读取结论的转换问题：睡眠是否进入深睡和 REM、夜间是否频繁觉醒、体动是否过多、是否存在呼吸暂停风险。

技能如何工作

核心能力包括：

• 睡眠阶段识别：区分入睡、浅睡（N1/N2）、深睡（N3）和快速眼动（REM）
• 体动与觉醒统计：输出夜间体动、觉醒次数等结构化指标
• 呼吸暂停筛查：关注 OSAHS 等高风险异常，给出风险提示
• 历史报告查询：通过 --list 从云端接口读取历史分析报告，并以 Markdown 表格输出

关键步骤通常是：

1. 准备本地视频路径或网络 URL，支持 mp4、avi、mov
2. 在技能根目录运行 python -m scripts.sleep_quality_analysis
3. 选择 --input、--url 或 --list
4. 使用 --detail 控制输出粒度，使用 --output 落盘结果

技能强调历史报告必须来自云端 API，不能从本地记忆或人工汇总中提取。用户身份由脚本内部处理，不要求用户输入或展示身份参数。

适用边界与注意点

该技能适合家庭或机构做睡眠质量参考，但不能替代专业睡眠监测设备或医生诊断。视频建议时长不少于 30 分钟，以覆盖较完整的睡眠周期。网络 URL 由 API 侧下载，调用端无需先转存本地。输出更偏健康参考，不适合作为临床确诊依据。