Sleep Tracker

MediWise · 睡眠追踪 Skill

记录和汇总睡眠数据，展示睡眠规律和与内置参考值的差异。评分只用于记录展示，不是医学判断，也不提供改善或治疗建议。

睡眠质量评分标准

内置展示参考值（不用于医学判断）：

• 总时长：7-9 小时
• 深睡比例：13-23%
• REM 比例：20-25%
• 清醒时间：<10%

核心工作流

当前公开版本只用于个人本地档案。身份隔离由安装时的个人模式和 action 适配层处理，不向普通用户暴露或索取 owner_id。

1. 手动录入睡眠

用户说「昨晚睡了7小时」「记录睡眠」时使用：

# 录入总时长（最简方式，其他阶段留空）
python3 {baseDir}/scripts/sleep.py log --member-id <id> --duration 420

# 带阶段详情录入
python3 {baseDir}/scripts/sleep.py log --member-id <id> --duration 480 \
  --deep 90 --light 240 --rem 100 --awake 30

# 指定日期（默认昨天）
python3 {baseDir}/scripts/sleep.py log --member-id <id> --duration 450 --date 2026-03-26

时长换算提示：

• 用户说「7小时」→ duration=420
• 用户说「7.5小时」→ duration=450
• 用户说「7小时30分」→ duration=450

2. 查看每日睡眠

用户说「昨晚睡得怎么样」「查看睡眠」时使用：

# 查看昨晚（默认）
python3 {baseDir}/scripts/sleep.py daily --member-id <id>

# 查看指定日期
python3 {baseDir}/scripts/sleep.py daily --member-id <id> --date 2026-03-26

3. 每周睡眠趋势

用户说「这周睡眠怎么样」「睡眠趋势」时使用：

# 近7天（默认）
python3 {baseDir}/scripts/sleep.py weekly --member-id <id>

# 近14天
python3 {baseDir}/scripts/sleep.py weekly --member-id <id> --days 14

4. 历史记录

# 最近14条（默认）
python3 {baseDir}/scripts/sleep.py list --member-id <id>

# 最近30条
python3 {baseDir}/scripts/sleep.py list --member-id <id> --limit 30

数据来源

睡眠数据来自两个渠道：

1. 手动录入：通过 sleep-log action 直接输入
2. 可穿戴同步：通过 wearable-sync 从 Apple Health / Gadgetbridge 自动导入

两种来源均存储在 health_metrics 表（metric_type='sleep'），查询时统一处理。

反模式

• 不要重复录入同一天 — 系统会显示多条，建议先 daily 确认再录入
• 阶段时长之和不能超过总时长 — 否则录入报错
• 手动录入不需要精确到分钟 — 大致时长即可，质量评分有容忍范围