# 知习 ZhiXi — iOS App

AI-first 系统化学习 App，SwiftUI + 深色主题。

## 导航关系

```
Splash（2s 自动跳转）
  ↓
Welcome（欢迎页）→ 已有账号 → Login
  ↓ 开始使用
Login（手机号/邮箱登录）
  ↓ 登录成功
Onboarding（4 步引导：输入知识 / 主动输出 / AI 分析 / 掌握知识）
  ↓ 下一步
GoalSetup（学习目标 / 方法 / 时间）
  ↓ 开始学习
┌──────────────────────────────────────────────────────┐
│                  5-Tab 主界面                         │
│                                                      │
│  [AI]       [知识库]      [学习]      [分析]    [我的] │
│   │            │            │           │         │   │
│   ├─ 开始回答   ├─ 卡片点击   ├─ 任务点击   │         │   │
│   │  → Daily   │  → Detail  │  → Recall  │         │   │
│   │   Thinking │            │  / Feedbk  │         │   │
│   │            ├─ 创建      │            │         │   │
│   ├─ 快捷操作   │  → Create  │            │         │   │
│   │  → Recall  │            │            │         │   │
│   │  / Weak    │  ┌ 知识点    │            │         │   │
│   │            │  ├ Detail   │            │         │   │
│   └─ 互动列表   │  │  → KnwlD │            │         │   │
│      → AIChat  │  ├ Add       │            │         │   │
│                │  ├ Import    │            │         │   │
│                │  └ Edit      │            │         │   │
└──────────────────────────────────────────────────────┘
```

## 页面清单（对照 React 原型 22 页）

| # | 页面 | 文件 | 状态 |
|---|------|------|------|
| 1 | Splash 启动页 | `AIStudyAppApp.swift` → `SplashPage` | ✅ |
| 2 | Welcome 欢迎页 | `AIStudyAppApp.swift` → `WelcomePage` | ✅ |
| 3 | Login 登录页 | `AIStudyAppApp.swift` → `LoginPage` | ✅ |
| 4 | Onboarding 引导页 | `AIStudyAppApp.swift` → `OnboardingPage` | ✅ |
| 5 | GoalSetup 目标设置 | `AIStudyAppApp.swift` → `GoalSetupPage` | ✅ |
| 6 | AIHome AI 首页 | `Features/AI/AIHomeView.swift` | ✅ |
| 7 | LibraryHome 知识库首页 | `Features/Library/LibraryHomeView.swift` | ✅ |
| 8 | StudyHome 学习工作台 | `Features/Study/StudyHomeView.swift` | ✅ |
| 9 | AnalysisHome 学习分析 | `Features/Analysis/AnalysisHomeView.swift` | ✅ |
| 10 | Profile 我的 | `Features/Profile/ProfileView.swift` | ✅ |
| 11 | AIChat AI 对话 | `Features/AI/DailyThinkingPage.swift` → `AIChatPage` | ✅ |
| 14 | DailyThinking 今日思考 | `Features/AI/DailyThinkingPage.swift` | ✅ |
| 13 | RecallTest 回忆测试 | `Features/AI/DailyThinkingPage.swift` → `RecallTestPage` | ✅ |
| 16 | WeakPoints 薄弱点分析 | `Features/AI/DailyThinkingPage.swift` → `WeakPointsPage` | ✅ |
| 15 | AIFeedback AI 反馈 | `Features/AI/DailyThinkingPage.swift` → `AIFeedbackPageView` | ✅ |
| 18 | CreateLibrary 创建知识库 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 19 | LibraryDetail 知识库详情 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 20 | AddKnowledge 添加知识点 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 21 | Import 导入资料 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 22 | KnowledgeDetail 知识点详情 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 23 | EditKnowledge 编辑知识点 | `Features/Library/LibrarySubpages.swift` | ✅ |

## 项目结构

```
AIStudyApp/
├── AIStudyAppApp.swift        # 根路由 + Splash/Welcome/Login/Onboarding/GoalSetup
├── ContentView.swift           # 5-Tab 主界面 + ZXTabBar + ZXIconBtn + ZXScoreBox + ZXAIInputBar
├── Core/
│   └── DesignSystem/
│       └── DesignTokens.swift  # 颜色 / 渐变 / 圆角 / 间距 / 字号
└── Features/
    ├── AI/
    │   ├── AIHomeView.swift            # AI 首页
    │   └── DailyThinkingPage.swift     # 今日思考 / AI 对话 / 回忆测试 / 薄弱点 / AI 反馈
    ├── Library/
    │   ├── LibraryHomeView.swift       # 知识库首页
    │   └── LibrarySubpages.swift       # 创建 / 详情 / 添加 / 导入 / 知识点详情 / 编辑
    ├── Study/
    │   └── StudyHomeView.swift         # 学习工作台
    ├── Analysis/
    │   └── AnalysisHomeView.swift      # 学习分析
    └── Profile/
        └── ProfileView.swift           # 我的页
```

## 设计系统

| 类别 | Token | 值 |
|------|-------|-----|
| 主背景 | `Color.zxBg0` | `#0F0F1A` |
| 页面渐变 | `ZXGradient.page` | `#0F0F1A → #12122A` |
| 品牌紫 | `Color.zxPurple` | `#7C6EFA` |
| 品牌橙 | `Color.zxOrange` | `#F97316` |
| 文字主色 | `Color.zxF0` | `#F0F0FF` |
| 卡片圆角 | `ZXRadius.xl3` | `20` |
| 按钮高度 | `ZXSize.buttonH` | `42` |
| 页面水平间距 | `ZXSpacing.pageHPadding` | `20` |
| 状态栏高度 | `ZXSpacing.statusBarH` | `44` |
| TabBar 高度 | `ZXSpacing.tabBarH` | `83` |

以上全部从 React 原型 1:1 像素级提取。

## 运行

Xcode 打开 `AIStudyApp.xcodeproj`，选择 iPhone 17 Pro 模拟器，`Cmd+R`。

```
Clean Build 之前先：
rm -rf ~/Library/Developer/Xcode/DerivedData/AIStudyApp-*
```