sleep-tracker

name	sleep-tracker
description	睡眠追踪与质量分析。记录每晚睡眠时长和各阶段（深睡/浅睡/REM/清醒）， 评估睡眠质量评分，查看每日详情和每周趋势。支持手动录入和可穿戴设备自动同步。 Sleep tracking and quality analysis. Records nightly sleep duration and stages (deep/light/REM/awake), scores sleep quality, and shows daily details and weekly trends. 关键词：睡眠记录、睡眠质量、深睡、REM、睡眠趋势、睡眠分析、失眠、睡了多久、昨晚睡眠。

Sleep Tracker - 睡眠追踪

记录和分析睡眠数据，评估睡眠质量，发现睡眠规律。

睡眠质量评分标准

评分	标签	说明
85-100	优质	时长充足，各阶段比例理想
70-84	良好	基本达标，有小幅改善空间
55-69	一般	存在明显不足，建议关注
0-54	较差	睡眠质量差，需要干预

理想睡眠参考值：

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

核心工作流

强制规则：每次调用脚本必须携带 --owner-id，从会话上下文获取发送者 ID（格式 <channel>:<user_id>，如 feishu:ou_xxx 或 qqbot:12345），不得省略。

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 确认再录入
• 阶段时长之和不能超过总时长 — 否则录入报错
• 手动录入不需要精确到分钟 — 大致时长即可，质量评分有容忍范围