ios-projects/AIStudyApp/README.md

# 知习 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/AIChatPage.swift` | ✅ |
| 12 | DailyThinking 今日思考 | `Features/AI/DailyThinkingPage.swift` | ✅ |
| 13 | RecallTest 回忆测试 | `Features/AI/RecallTestPage.swift` | ✅ |
| 14 | WeakPoints 薄弱点分析 | `Features/AI/WeakPointsPage.swift` | ✅ |
| 15 | AIFeedback AI 反馈 | `Features/AI/AIFeedbackPageView.swift` | ✅ |
| 16 | Settings 设置 | `Features/Profile/SettingsView.swift` | ✅ |
| 17 | GoalSetting 学习目标 | `Features/Profile/GoalSettingDetailView.swift` | ✅ |
| 18 | MethodPreference 方法偏好 | `Features/Profile/MethodPreferenceView.swift` | ✅ |
| 19 | FeedbackForm 帮助反馈 | `Features/Profile/FeedbackFormView.swift` | ✅ |
| 20 | EditProfile 编辑资料 | `Features/Profile/ProfileView.swift` → `EditProfilePage` | ✅ |
| 21 | NotificationList 通知 | `Features/Profile/ProfileView.swift` → `NotificationListView` | ✅ |
| 22 | LibrarySearch 搜索知识库 | `Features/Library/LibraryHomeView.swift` | ✅ |
| 23 | LibraryDetail 知识库详情 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 24 | AddKnowledge 添加知识点 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 25 | KnowledgeDetail 知识点详情 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 26 | EditKnowledge 编辑知识点 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 27 | CreateLibrary 创建知识库 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 28 | Import 导入资料 | `Features/Library/LibrarySubpages.swift` | ✅ |
| 29 | ActiveRecall 回忆测试 | `Features/Study/StudyHomeView.swift` → `ActiveRecallView` | ✅ |
| 30 | ReviewCard 间隔复习 | `Features/Study/ReviewCardView.swift` | ✅ |
| 31 | LearningSession 学习会话 | `Features/Study/LearningSessionView.swift` | ✅ |

## 项目结构

```
AIStudyApp/
├── AIStudyAppApp.swift        # 根路由 + Splash/Welcome/Login/Onboarding/GoalSetup
├── ContentView.swift           # 5-Tab 主界面 + ZXTabBar + ZXIconBtn + ZXScoreBox + ZXAIInputBar
├── Core/
│   ├── DesignSystem/
│   │   ├── DesignTokens.swift  # 颜色 / 渐变 / 圆角 / 间距 / 字号 / zxFontScaled
│   │   └── ZXAnimations.swift  # ZXPressModifier / ZXPullToRefresh / ZXLoadingView
│   ├── Models/
│   │   └── APIModels.swift     # KnowledgeItem 等数据模型
│   └── Navigation/
│       └── Route.swift         # 统一路由枚举 + navigationDestination 映射
└── Features/
    ├── AI/
    │   ├── AIHomeView.swift         # AI 首页
    │   ├── DailyThinkingPage.swift  # 今日思考
    │   ├── AIChatPage.swift         # AI 对话
    │   ├── RecallTestPage.swift     # 回忆测试
    │   ├── WeakPointsPage.swift     # 薄弱点分析
    │   └── AIFeedbackPageView.swift # AI 反馈
    ├── Library/
    │   ├── LibraryHomeView.swift    # 知识库首页 + 搜索
    │   └── LibrarySubpages.swift    # 创建/详情/添加/导入/知识点详情/编辑
    ├── Study/
    │   ├── StudyHomeView.swift      # 学习工作台
    │   ├── ReviewCardView.swift     # 间隔复习卡片
    │   └── LearningSessionView.swift # 学习会话
    ├── Analysis/
    │   └── AnalysisHomeView.swift   # 学习分析
    └── Profile/
        ├── ProfileView.swift        # 我的页 + EditProfilePage + NotificationListView
        ├── SettingsView.swift       # 设置
        ├── GoalSettingDetailView.swift # 学习目标设置
        ├── MethodPreferenceView.swift  # 学习方法偏好
        └── FeedbackFormView.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-*
```

## 最近修复记录

### 2026-05-19 — NavigationStack 迁移 + Dynamic Type

- **路由系统重构**：全部 `NavigationLink(destination:)` → `NavigationLink(value: Route)`，新增 `Core/Navigation/Route.swift` 统一路由枚举
- **Dynamic Type 支持**：新增 `zxFontScaled` ViewModifier，基于 `@ScaledMetric`
- **手势冲突修复**：`ZXPressModifier` 从 `DragGesture` 改为 `onLongPressGesture(minimumDuration: .infinity)` 解决与 ScrollView 冲突
- **触控目标放大**：`ZXIconBtn` 36pt → 44pt
- **大文件拆分**：从 `DailyThinkingPage.swift` 拆出 4 个子页面，从 `SettingsView.swift` 拆出 3 个子页面
- **TabBar 胶囊指示器**：选中 Tab 上方紫色 Capsule 替代旧圆形指示器
- **ZXSTask 颜色模型**：`Color` → hex `String`，支持 Hashable 路由参数
- **ZXAIInputBar 重构**：提取为共享组件，padding 由调用方控制