核心用法
Soft Pillow 是一款 iOS 睡眠与梦境记录应用，本 Skill 通过 REST API 实现数据查询功能，主要用于：
- 睡眠状态检测：实时查看用户是否正在睡眠
- 睡眠记录查询：按日期范围、心情评分、步数缺失等条件筛选历史记录
- 单条详情获取：提取特定睡眠条目的完整数据，包括梦境内容、笔记、中断事件、AI 洞察等
- 梦境语义搜索：对梦境描述和笔记进行关键词搜索，支持模糊匹配
典型调用场景
| 场景 | 调用方式 |
|------|---------|
| "我最近睡得好吗？" | `GET /sleep_entries?limit=7` |
| "搜索关于飞行的梦" | `GET /search_dreams?query=flying` |
| "上周心情好的睡眠" | `GET /sleep_entries?mood=good&from_date=2026-01-01` |
显著优点
- 细粒度睡眠数据：不仅记录时长，还关联心情评分、梦境叙事、夜间中断事件，支持多维分析
- HealthKit 整合：自动同步 Apple Health 步数数据，建立运动-睡眠相关性
- 语义化梦境检索：支持自然语言关键词搜索，突破传统日期检索局限
- 隐私优先设计：数据存储于用户控制的账户，API 访问需显式授权（Bearer Token）
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| **平台锁定** | 仅支持 iOS，无 Android/Web 版本，跨平台用户无法使用 |
| **API 能力受限** | 只读查询，无法创建/修改/删除记录，功能为纯数据回顾 |
| **Token 管理负担** | 用户需手动从 App 设置页复制 API Key，无 OAuth 流程，体验较技术化 |
| **数据孤岛** | 未提及与 Whoop、Oura、Garmin 等专业睡眠硬件的互通能力 |
| **搜索精度未知** | 梦境搜索未说明是否采用向量语义检索或简单关键词匹配 |
适合人群
- iPhone 用户且已日常使用 Soft Pillow 记录睡眠
- 希望用自然语言回顾梦境模式或分析睡眠质量趋势的用户
- 需要结构化睡眠数据用于个人健康分析（需配合其他工具）
常规风险
- Token 泄露风险：
sp_开头的 Bearer Token 若被截获，可导致睡眠数据（含梦境等敏感内容）暴露 - 数据隐私边界：梦境内容可能包含深层心理信息，需确保对话环境可信
- 第三方依赖：API 可用性受制于 Soft Pillow 服务稳定性（域名
softpillow.paevita.com） - 非医疗级数据：应用定位为健康追踪，输出不宜用于睡眠障碍诊断