# Stellia / StudyDeck iPad（儿童学习端）

原生 SwiftUI iPad 应用：从电脑 StudyDeck **拉取**已组织好的课程包，首页货架学习，进度仅保存在本机。

## 打开工程

```bash
open studydeck-ios/studydeck.xcodeproj
```

在 Xcode 中选择 **iPad** 模拟器或真机，Run（⌘R）。

- 最低系统：**iOS 17+**
- 显示名 / 首页品牌：**Stellia**（工程 target 名仍为 studydeck）
- Bundle ID：`neotao.studydeck`（可按需修改 Team / Signing）

## 与电脑配合（主导入路径）

1. 电脑与 iPad 同一 Wi-Fi。
2. 电脑打开 StudyDeck → **File → Share to iPad…** → 开启分享，记下地址/二维码。
3. iPad 打开 App → 菜单 ☰ → **添加课程** → 粘贴 `http://<电脑IP>:8787` → 获取列表 → 勾选下载。
4. 返回首页：上方为**已下载**课程（横向滑动）；点开开始学习；下方为最近学习。

> 分享服务在电脑侧、无密码；仅信任局域网使用。

## 学习闭环

1. **首页货架**：仅显示已下载课程；无 Explorer / 组课。
2. **最近学习**：大卡横滑，续学并恢复进度。
3. **Study**：AVKit + PDFKit；`video_pdf` / `pdf_audio` 等；进度本地保存，不回传电脑。

## 手动烟雾检查

见 [`SMOKE_CHECKLIST.md`](./SMOKE_CHECKLIST.md)。

## 工程结构

```
studydeck/
  App/                 # Root NavigationStack + HomeDeck
  Features/Home/       # 货架 UI
  Features/Download/   # 连接 PC 发布端并下载
  Features/Study/      # 学习播放
  Domain/              # LocalCourse、manifest、StudyMode
  Services/            # CourseLibrary、ZipUtility、CourseStore
```

旧版 Import/Explorer/LAN 上传等见 [`OBSOLETE_PARENT_DESK.md`](./OBSOLETE_PARENT_DESK.md)。