8.1 KiB
8.1 KiB
知习 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 支持：新增
zxFontScaledViewModifier，基于@ScaledMetric - 手势冲突修复：
ZXPressModifier从DragGesture改为onLongPressGesture(minimumDuration: .infinity)解决与 ScrollView 冲突 - 触控目标放大：
ZXIconBtn36pt → 44pt - 大文件拆分：从
DailyThinkingPage.swift拆出 4 个子页面，从SettingsView.swift拆出 3 个子页面 - TabBar 胶囊指示器：选中 Tab 上方紫色 Capsule 替代旧圆形指示器
- ZXSTask 颜色模型：
Color→ hexString，支持 Hashable 路由参数 - ZXAIInputBar 重构：提取为共享组件，padding 由调用方控制