= Op extends {
+ responses: { 200: { content: { 'application/json': infer D } } }
+}
+ ? D
+ : never
+
+type QueryOf = paths[P][M] extends {
+ parameters: { query?: infer Q }
+}
+ ? Q
+ : never
+
+type BodyOf
= paths[P][M] extends {
+ requestBody: { content: { 'application/json': infer B } }
+}
+ ? B
+ : never
+
+// ---- 常用响应类型 ----
+export type DashboardOverview = SuccessBody
+export type DashboardTrends = SuccessBody
+export type PracticeModules = SuccessBody
+export type Profile = SuccessBody
+export type Settings = SuccessBody
+
+// ---- 数据中枢 ----
+export const dashboardApi = {
+ overview: () => unwrap(apiClient.GET('/api/dashboard/overview')),
+ trends: (days?: number) =>
+ unwrap(apiClient.GET('/api/dashboard/trends', { params: { query: { days } } }))
+}
+
+// ---- 刷题 ----
+export const practiceApi = {
+ modules: () => unwrap(apiClient.GET('/api/practice/modules')),
+ start: (body: BodyOf<'/api/practice/start', 'post'>) =>
+ unwrap(apiClient.POST('/api/practice/start', { body })),
+ question: (sessionId: string) =>
+ unwrap(apiClient.GET('/api/practice/{sessionId}/question', { params: { path: { sessionId } } })),
+ answer: (sessionId: string, body: BodyOf<'/api/practice/{sessionId}/answer', 'post'>) =>
+ unwrap(
+ apiClient.POST('/api/practice/{sessionId}/answer', {
+ params: { path: { sessionId } },
+ body
+ })
+ ),
+ finish: (sessionId: string) =>
+ unwrap(apiClient.POST('/api/practice/{sessionId}/finish', { params: { path: { sessionId } } }))
+}
+
+// ---- 错题复习 ----
+export const reviewApi = {
+ list: (query?: QueryOf<'/api/review/list', 'get'>) =>
+ unwrap(apiClient.GET('/api/review/list', { params: { query } })),
+ submit: (id: string, answer: string) =>
+ unwrap(
+ apiClient.POST('/api/review/{id}/submit', {
+ params: { path: { id } },
+ body: { answer } as BodyOf<'/api/review/{id}/submit', 'post'>
+ })
+ ),
+ markMastered: (id: string) =>
+ unwrap(apiClient.POST('/api/review/{id}/mark-mastered', { params: { path: { id } } }))
+}
+
+// ---- 备考计划 ----
+export const plansApi = {
+ today: (date?: string) => unwrap(apiClient.GET('/api/plans/today', { params: { query: { date } } })),
+ week: (start?: string) => unwrap(apiClient.GET('/api/plans/week', { params: { query: { start } } })),
+ createTask: (body: BodyOf<'/api/plans/tasks', 'post'>) =>
+ unwrap(apiClient.POST('/api/plans/tasks', { body })),
+ toggleTask: (id: string) =>
+ unwrap(apiClient.PATCH('/api/plans/tasks/{id}/toggle', { params: { path: { id } } }))
+}
+
+// ---- 模考 ----
+export const mockApi = {
+ analysis: () => unwrap(apiClient.GET('/api/mock-exams/analysis')),
+ record: (body: BodyOf<'/api/mock-exams/record', 'post'>) =>
+ unwrap(apiClient.POST('/api/mock-exams/record', { body }))
+}
+
+// ---- 要闻 ----
+export const newsApi = {
+ list: (query?: QueryOf<'/api/news/list', 'get'>) =>
+ unwrap(apiClient.GET('/api/news/list', { params: { query } })),
+ detail: (id: string) => unwrap(apiClient.GET('/api/news/{id}', { params: { path: { id } } })),
+ importJson: (body: BodyOf<'/api/news/import/json', 'post'>) =>
+ unwrap(apiClient.POST('/api/news/import/json', { body })),
+ importRss: (body: BodyOf<'/api/news/import/rss', 'post'>) =>
+ unwrap(apiClient.POST('/api/news/import/rss', { body })),
+ importApi: (body: BodyOf<'/api/news/import/api', 'post'>) =>
+ unwrap(apiClient.POST('/api/news/import/api', { body })),
+ importUrl: (body: BodyOf<'/api/news/import/url', 'post'>) =>
+ unwrap(apiClient.POST('/api/news/import/url', { body }))
+}
+
+// ---- 题库管理 ----
+export const questionsApi = {
+ list: (query?: QueryOf<'/api/questions/list', 'get'>) =>
+ unwrap(apiClient.GET('/api/questions/list', { params: { query } })),
+ importQuestions: (body: BodyOf<'/api/questions/import', 'post'>) =>
+ unwrap(apiClient.POST('/api/questions/import', { body })),
+ exportQuestions: () => unwrap(apiClient.GET('/api/questions/export')),
+ remove: (id: string) => unwrap(apiClient.DELETE('/api/questions/{id}', { params: { path: { id } } }))
+}
+
+// ---- AI 讲解 ----
+export const aiApi = {
+ explain: (body: BodyOf<'/api/ai/explain-question', 'post'>) =>
+ unwrap(apiClient.POST('/api/ai/explain-question', { body }))
+}
+
+// ---- 个人档案 / 设置 ----
+export const profileApi = {
+ get: () => unwrap(apiClient.GET('/api/profile')),
+ patch: (body: BodyOf<'/api/profile', 'patch'>) =>
+ unwrap(apiClient.PATCH('/api/profile', { body }))
+}
+
+export const settingsApi = {
+ get: () => unwrap(apiClient.GET('/api/settings')),
+ patch: (body: BodyOf<'/api/settings', 'patch'>) =>
+ unwrap(apiClient.PATCH('/api/settings', { body }))
+}
diff --git a/client/src/components/base/AppBadge.vue b/client/src/components/base/AppBadge.vue
new file mode 100644
index 0000000..2452fcb
--- /dev/null
+++ b/client/src/components/base/AppBadge.vue
@@ -0,0 +1,46 @@
+
+
+
+
+
+
+
diff --git a/client/src/components/base/AppButton.vue b/client/src/components/base/AppButton.vue
new file mode 100644
index 0000000..69ae6c3
--- /dev/null
+++ b/client/src/components/base/AppButton.vue
@@ -0,0 +1,90 @@
+
+
+
+
+
+
+
diff --git a/client/src/components/base/AppCard.vue b/client/src/components/base/AppCard.vue
new file mode 100644
index 0000000..50e0603
--- /dev/null
+++ b/client/src/components/base/AppCard.vue
@@ -0,0 +1,76 @@
+
+
+
+
+
+
+
diff --git a/client/src/components/base/AppIcon.vue b/client/src/components/base/AppIcon.vue
new file mode 100644
index 0000000..5ec8c0d
--- /dev/null
+++ b/client/src/components/base/AppIcon.vue
@@ -0,0 +1,32 @@
+
+
+
+
+
diff --git a/client/src/components/base/icons.ts b/client/src/components/base/icons.ts
new file mode 100644
index 0000000..d1be3c8
--- /dev/null
+++ b/client/src/components/base/icons.ts
@@ -0,0 +1,113 @@
+// 线性图标集：统一 stroke 风格（见设计规范「图标」一节），禁止引入图标库依赖。
+// 使用方式：
+export type IconName =
+ | 'home'
+ | 'dashboard'
+ | 'pen'
+ | 'chart'
+ | 'calendar'
+ | 'news'
+ | 'user'
+ | 'book'
+ | 'settings'
+ | 'inbox'
+ | 'alert'
+ | 'check'
+ | 'chevron-right'
+ | 'clock'
+ | 'flame'
+ | 'target'
+
+interface IconNode {
+ tag: 'path' | 'circle' | 'rect' | 'line' | 'polyline'
+ attrs: Record
+}
+
+export const icons: Record = {
+ home: [
+ { tag: 'path', attrs: { d: 'M3 10.5 12 3l9 7.5' } },
+ { tag: 'path', attrs: { d: 'M5 9.5V21h14V9.5' } },
+ { tag: 'path', attrs: { d: 'M10 21v-6h4v6' } }
+ ],
+ dashboard: [
+ { tag: 'rect', attrs: { x: 3, y: 3, width: 7, height: 7, rx: 2 } },
+ { tag: 'rect', attrs: { x: 14, y: 3, width: 7, height: 7, rx: 2 } },
+ { tag: 'rect', attrs: { x: 3, y: 14, width: 7, height: 7, rx: 2 } },
+ { tag: 'rect', attrs: { x: 14, y: 14, width: 7, height: 7, rx: 2 } }
+ ],
+ pen: [
+ { tag: 'path', attrs: { d: 'M12 20h9' } },
+ { tag: 'path', attrs: { d: 'M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4Z' } }
+ ],
+ chart: [
+ { tag: 'path', attrs: { d: 'M3 3v18h18' } },
+ { tag: 'path', attrs: { d: 'M18 17V9' } },
+ { tag: 'path', attrs: { d: 'M13 17V5' } },
+ { tag: 'path', attrs: { d: 'M8 17v-3' } }
+ ],
+ calendar: [
+ { tag: 'rect', attrs: { x: 3, y: 4, width: 18, height: 18, rx: 2 } },
+ { tag: 'line', attrs: { x1: 16, y1: 2, x2: 16, y2: 6 } },
+ { tag: 'line', attrs: { x1: 8, y1: 2, x2: 8, y2: 6 } },
+ { tag: 'line', attrs: { x1: 3, y1: 10, x2: 21, y2: 10 } }
+ ],
+ news: [
+ { tag: 'rect', attrs: { x: 3, y: 5, width: 18, height: 15, rx: 2 } },
+ { tag: 'line', attrs: { x1: 3, y1: 10, x2: 21, y2: 10 } },
+ { tag: 'line', attrs: { x1: 7, y1: 7, x2: 11, y2: 7 } },
+ { tag: 'line', attrs: { x1: 7, y1: 14, x2: 15, y2: 14 } },
+ { tag: 'line', attrs: { x1: 7, y1: 17, x2: 11, y2: 17 } }
+ ],
+ user: [
+ { tag: 'circle', attrs: { cx: 12, cy: 8, r: 4 } },
+ { tag: 'path', attrs: { d: 'M4 21a8 8 0 0 1 16 0' } }
+ ],
+ book: [
+ { tag: 'path', attrs: { d: 'M4 19.5A2.5 2.5 0 0 1 6.5 17H20' } },
+ { tag: 'path', attrs: { d: 'M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z' } }
+ ],
+ settings: [
+ { tag: 'line', attrs: { x1: 21, y1: 4, x2: 14, y2: 4 } },
+ { tag: 'line', attrs: { x1: 10, y1: 4, x2: 3, y2: 4 } },
+ { tag: 'line', attrs: { x1: 21, y1: 12, x2: 12, y2: 12 } },
+ { tag: 'line', attrs: { x1: 8, y1: 12, x2: 3, y2: 12 } },
+ { tag: 'line', attrs: { x1: 21, y1: 20, x2: 16, y2: 20 } },
+ { tag: 'line', attrs: { x1: 12, y1: 20, x2: 3, y2: 20 } },
+ { tag: 'line', attrs: { x1: 14, y1: 2, x2: 14, y2: 6 } },
+ { tag: 'line', attrs: { x1: 8, y1: 10, x2: 8, y2: 14 } },
+ { tag: 'line', attrs: { x1: 16, y1: 18, x2: 16, y2: 22 } }
+ ],
+ inbox: [
+ { tag: 'path', attrs: { d: 'M22 12h-6l-2 3h-4l-2-3H2' } },
+ {
+ tag: 'path',
+ attrs: {
+ d: 'M5.45 5.11 2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z'
+ }
+ }
+ ],
+ alert: [
+ { tag: 'circle', attrs: { cx: 12, cy: 12, r: 10 } },
+ { tag: 'line', attrs: { x1: 12, y1: 8, x2: 12, y2: 12 } },
+ { tag: 'line', attrs: { x1: 12, y1: 16, x2: 12.01, y2: 16 } }
+ ],
+ check: [{ tag: 'path', attrs: { d: 'M20 6 9 17l-5-5' } }],
+ 'chevron-right': [{ tag: 'path', attrs: { d: 'M9 18l6-6-6-6' } }],
+ clock: [
+ { tag: 'circle', attrs: { cx: 12, cy: 12, r: 10 } },
+ { tag: 'path', attrs: { d: 'M12 6v6l4 2' } }
+ ],
+ flame: [
+ {
+ tag: 'path',
+ attrs: {
+ d: 'M8.5 14.5A2.5 2.5 0 0 0 11 12c0-1.38-.5-2-1-3-1.07-2.14-.22-4.05 2-6 .5 2.5 2 4.9 4 6.5 2 1.6 3 3.5 3 5.5a7 7 0 1 1-14 0c0-1.15.43-2.29 1-3a2.5 2.5 0 0 0 2.5 2.5z'
+ }
+ }
+ ],
+ target: [
+ { tag: 'circle', attrs: { cx: 12, cy: 12, r: 10 } },
+ { tag: 'circle', attrs: { cx: 12, cy: 12, r: 6 } },
+ { tag: 'circle', attrs: { cx: 12, cy: 12, r: 2 } }
+ ]
+}
diff --git a/client/src/components/feedback/AppEmpty.vue b/client/src/components/feedback/AppEmpty.vue
new file mode 100644
index 0000000..af181e0
--- /dev/null
+++ b/client/src/components/feedback/AppEmpty.vue
@@ -0,0 +1,60 @@
+
+
+
+
+
+
{{ title }}
+
{{ description }}
+
+
+
+
{{ title }}
+
{{ message }}
+
重试
+
✦备考中枢
-
-
diff --git a/client/src/layouts/DesktopLayout.vue b/client/src/layouts/DesktopLayout.vue
index 482383c..7c225be 100644
--- a/client/src/layouts/DesktopLayout.vue
+++ b/client/src/layouts/DesktopLayout.vue
@@ -1,9 +1,96 @@
-
+
+
+
+
+
+
diff --git a/client/src/layouts/MobileLayout.vue b/client/src/layouts/MobileLayout.vue
index 3de89b3..6ba82ef 100644
--- a/client/src/layouts/MobileLayout.vue
+++ b/client/src/layouts/MobileLayout.vue
@@ -1,8 +1,87 @@
-
+
+
+
+
+