睡梦易析睡眠质量分析

要解决什么问题

家庭或机构里常见的睡眠评估依赖穿戴设备或专业多导睡眠图，成本高、佩戴不适，也不利于长期居家监测。若你手头只有固定机位拍摄的睡眠监测视频，仍需要得到可读的睡眠分期、体动与夜间觉醒统计，并对阻塞性睡眠呼吸暂停（OSAHS）等高风险信号做筛查，本技能面向的就是这类场景：把视频交给云端分析管线，拿回结构化报告，而不是凭主观感受猜睡眠质量。

技能如何工作

能力边界在 SKILL 约定内，主要包括：

• 睡眠阶段识别：区分入睡、浅睡（N1/N2）、深睡（N3）、快速眼动（REM）
• 体动与觉醒：统计微细体动、夜间觉醒次数
• 呼吸相关风险：结合呼吸节律变化，对 OSAHS 等异常做智能筛查与预警
• 历史报告查询：通过云端接口列出历史分析记录（禁止从本地 memory/ 或 LanceDB 汇总历史）

典型流程是：准备 mp4/avi/mov 视频（建议不少于 30 分钟、画面稳定且能拍到全身）→ 必须先取得有效 open-id（不可自行编造）→ 在技能根目录调用 scripts.sleep_quality_analysis.py，用 --input 或 --url 提交素材，必要时用 --list --open-id 拉取报告清单并以 Markdown 表格展示（含 reportImageUrl 链接）。

适用边界与注意点

• 视频单文件上限 10MB；网络 URL 由 API 侧下载，无需你本地先拉文件
• 输出含睡眠结构、呼吸健康与体动特征，仅作健康管理参考，不能替代医用睡眠监测与医生诊断
• 历史查询失败时也不得回退到本地记忆；api-key 可选，传入则需保证鉴权成功