AIStudyApp 现状与缺口分析 - 第一篇：现有资源盘点
生成日期：2026-05-11
后端地址：http://81.70.187.179:3001
一、项目文件结构
AIStudyApp/
├── AIStudyAppApp.swift # 应用入口，含 5 步 Onboarding 流程
├── ContentView.swift # 主 Tab 框架（5 个 Tab + 自定义底部栏）
│
├── Core/
│ ├── DesignSystem/DesignTokens.swift # 颜色/渐变/间距/字体全局设计令牌
│ ├── Models/APIModels.swift # 20+ DTO 数据模型
│ ├── Network/
│ │ ├── APIClient.swift # 通用 HTTP 客户端（actor, async/await）
│ │ ├── APIConfig.swift # baseURL 配置
│ │ └── APIError.swift # 错误枚举（网络/服务端/解码/认证）
│ └── Services/APIService.swift # 8 个服务类，15 个公开方法
│
├── Features/
│ ├── AI/
│ │ ├── AIHomeView.swift # AI 首页 + ZXQuickAction + ZXAIInteractionRow 组件
│ │ └── DailyThinkingPage.swift # 每日思考题 + RecallTestPage / WeakPointsPage /
│ │ # AIFeedbackPageView / AIChatPage 子页面
│ ├── Analysis/
│ │ └── AnalysisHomeView.swift # 学习分析页 + ZXChartView 折线图 + ZXWeakRow 薄弱点
│ ├── Library/
│ │ ├── LibraryHomeView.swift # 知识库列表首页
│ │ └── LibrarySubpages.swift # CreateLibraryPage / LibraryDetailPage /
│ │ # AddKnowledgePage / KnowledgeDetailPage /
│ │ # ImportPage / EditKnowledgePage
│ ├── Profile/
│ │ └── ProfileView.swift # 个人中心页
│ └── Study/
│ └── StudyHomeView.swift # 学习工作台 + 今日任务 + 周活跃柱状图
│
└── Info.plist # 手动管理（ATS例外 / Bundle元数据等）
二、5 个 Tab 页面清单
| Tab |
标签 |
SF Symbol |
View |
| 1 |
AI |
brain.head.profile |
AIHomeView |
| 2 |
知识库 |
books.vertical.fill |
LibraryHomeView |
| 3 |
学习 |
bolt.fill |
StudyHomeView |
| 4 |
分析 |
chart.bar.fill |
AnalysisHomeView |
| 5 |
我的 |
person.fill |
ProfileView |
三、所有页面/子页面总览（共 21 个）
AI 模块（1 主 + 4 子）
| 页面 |
数据来源 |
核心功能 |
| AIHomeView |
🔴硬编码 |
API 状态检测、思考题卡片、快捷操作、互动记录、提问输入栏 |
| DailyThinkingPage |
🔴硬编码 |
AI 思考题展示 + 回答提交 |
| RecallTestPage |
🔴硬编码 |
回忆测试输入 |
| WeakPointsPage |
🔴硬编码 |
薄弱知识点静态列表 |
| AIFeedbackPageView |
🔴硬编码 |
AI 反馈评分 + 操作入口 |
| AIChatPage |
🔴硬编码 |
AI 对话气泡界面 |
知识库模块（1 主 + 6 子）
| 页面 |
数据来源 |
核心功能 |
| LibraryHomeView |
🔴硬编码 |
知识库列表 + 搜索框 + 创建入口 |
| CreateLibraryPage |
🔴静态 |
创建表单（名称+描述） |
| LibraryDetailPage |
🔴硬编码 |
知识点静态列表 |
| AddKnowledgePage |
🔴静态 |
添加知识点表单 |
| KnowledgeDetailPage |
🔴硬编码 |
知识点详情+标签+复习/费曼入口 |
| ImportPage |
🔴静态 |
导入方式选择（拍照/文件/链接/相册） |
| EditKnowledgePage |
🔴静态 |
编辑知识点表单 |
学习模块（1 主）
| 页面 |
数据来源 |
核心功能 |
| StudyHomeView |
🔴硬编码 |
今日进度环、任务列表（5个任务）、本周活跃柱状图 |
分析模块（1 主）
| 页面 |
数据来源 |
核心功能 |
| AnalysisHomeView |
🔴硬编码 |
4项统计徽章、掌握度7日折线图、薄弱知识点列表 |
个人中心（1 主）
| 页面 |
数据来源 |
核心功能 |
| ProfileView |
🔴硬编码 |
个人卡片、菜单列表、成就徽章 |
启动流程（5 步 Onboarding）
| 步骤 |
页面 |
功能 |
| Step 0 |
SplashPage |
品牌开屏，2 秒自动跳转 |
| Step 1 |
WelcomePage |
3 大功能介绍 |
| Step 2 |
LoginPage |
手机号/邮箱 + 密码表单 + 微信/Apple 登录入口 |
| Step 3 |
OnboardingPage |
4 步功能轮播 |
| Step 4 |
GoalSetupPage |
学习目标/方法/每日时长选择 |
四、APIService 已封装方法（15 个）
| 服务类 |
方法 |
接口 |
| WaitlistService |
join(...) |
POST /waitlist |
|
stats() |
GET /waitlist/stats |
| AuthService |
appleLogin(...) |
POST /auth/apple |
|
logout() |
POST /auth/logout |
| UserService |
myProfile() |
GET /users/me |
|
updateProfile(...) |
PATCH /users/me |
| KnowledgeBaseService |
list() |
GET /knowledge-bases |
|
create(...) |
POST /knowledge-bases |
|
detail(id:) |
GET /knowledge-bases/:id |
| KnowledgeItemService |
list(baseId:) |
GET /knowledge-items |
|
detail(id:) |
GET /knowledge-items/:id |
|
create(...) |
POST /knowledge-items |
| AIAnalysisService |
analyze(...) |
POST /ai-analysis |
| ActivityService |
summary() |
GET /activity/summary |
| ReviewService |
due() |
GET /reviews/due |
| FocusItemService |
list() |
GET /focus-items |
| FeedbackService |
submit(...) |
POST /feedback |
五、后端接口 vs App 覆盖对照表
| 后端模块 |
接口数 |
App 覆盖 |
状态 |
| System |
3 |
0 |
❌ 无 |
| Auth |
3 |
2（Service 有，View 未接） |
🔶 |
| Users |
3 |
2（Service 有，View 未接） |
🔶 |
| KnowledgeBase |
5 |
3（Service 有，View 未接） |
🔶 |
| KnowledgeItems |
4 |
3（Service 有，View 未接） |
🔶 |
| DocumentImport |
2 |
0 |
❌ 无 |
| LearningSession |
3 |
0 |
❌ 无 |
| ActiveRecall |
2 |
0 |
❌ 无 |
| AIAnalysis |
3 |
1（Service 有，View 未接） |
🔶 |
| FocusItems |
4 |
1（Service 有，View 未接） |
🔶 |
| Review |
2 |
1（Service 有，View 未接） |
🔶 |
| LearningActivity |
2 |
1（Service 有，View 未接） |
🔶 |
| Notifications |
2 |
0 |
❌ 无 |
| Feedback |
4 |
1（Service 有，View 未接） |
🔶 |
| Waitlist |
3 |
2（Service 有，View 未接） |
🔶 |
覆盖率：Service 层 15/48 = 31%，View 层实际接入 0/48 = 0%
WangDL
a96d6cb159