DeepSleep - AI Sleep Tracker & Reminder

产品概述

DeepSleep 是一款 AI 增强的睡眠追踪 iOS 应用，通过读取 Apple 健康数据和屏幕使用时间，生成个性化睡眠报告并提醒用户睡觉。

核心功能

• 📱 HealthKit 集成 - 读取睡眠数据分析睡眠质量
• ⏱️ 屏幕时间监测 - 追踪每日屏幕使用时长
• 🔔 智能提醒 - 自定义 bedtime 提醒
• 🧠 AI 报告 - 基于数据的个性化睡眠建议

差异化特点

1. 屏幕时间 + 睡眠数据结合（竞品不做）
2. LLM 驱动的个性化报告
3. 不依赖 Apple Watch，降低使用门槛

---

技术栈

类别	技术
UI	SwiftUI
架构	MVVM + @Observable
系统框架	HealthKit, FamilyControls, UserNotifications
构建工具	XcodeGen
CI/CD	GitHub Actions

---

项目结构

DeepSleep/
├── Sources/
│   ├── App/              # App 入口
│   ├── Models/           # 数据模型
│   ├── Services/         # 业务服务
│   ├── ViewModels/       # 视图模型
│   ├── Views/            # 视图
│   │   ├── Home/         # 首页
│   │   ├── Insights/     # AI 报告
│   │   └── Settings/     # 设置
│   └── Utilities/        # 工具类
└── Resources/           # 资源配置

---

快速开始

前置要求

• Xcode 16.0+
• Apple Developer Account
• iOS 16.0+ 设备或模拟器

构建步骤

# 1. 克隆项目
git clone https://github.com/YOUR_USERNAME/deepsleep.git
cd deepsleep

# 2. 生成 Xcode 项目
xcodegen generate

# 3. 用 Xcode 打开
open DeepSleep.xcodeproj

# 4. 配置签名
#    - 选择 Team
#    - 设置 Bundle Identifier

# 5. 运行
Cmd + R

CI 构建

推送到 GitHub 后，GitHub Actions 会自动构建：

git add .
git commit -m "Initial commit"
git push origin main

前往 Actions 查看构建状态：https://github.com/YOUR_USERNAME/deepsleep/actions

---

权限配置

权限	用途	配置
HealthKit	读取睡眠数据	Info.plist + Entitlements
Family Controls	读取屏幕时间	Info.plist + Entitlements
Notifications	发送提醒	自动请求

---

开发计划

• MVP: 数据读取 + 提醒
• Phase 2: AI 报告集成
• Phase 3: 趋势分析
• Phase 4: 自适应 bedtime

---

许可证

MIT License