113 lines
5.5 KiB
Markdown
113 lines
5.5 KiB
Markdown
# 知习 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-*
|
||
```
|