From 101370883b72d029ddf1e87f1eb0f40afde45b2b Mon Sep 17 00:00:00 2001 From: Claude Code Date: Sun, 29 Mar 2026 06:04:50 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=8F=90=E5=8F=96=20BMAD=20=E6=96=B9?= =?UTF-8?q?=E6=B3=95=E5=92=8C=E6=8A=80=E8=83=BD=E5=88=B0=E7=8B=AC=E7=AB=8B?= =?UTF-8?q?=E5=88=86=E6=94=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dev-container-config.json | 6 - .gitignore | 17 +- PROJECT_INFO.md | 38 - README.md | 2 - ai-tutor-requirements.md | 1092 ---------------- package-lock.json | 77 -- package.json | 5 - planning-artifacts/prd.md | 1082 ---------------- planning-artifacts/ux-design-specification.md | 1094 ----------------- prototype/README.md | 114 -- prototype/admin-index.html | 181 --- prototype/docs-index.html | 329 ----- prototype/index.html | 310 ----- prototype/markdown-template.html | 181 --- prototype/md-view.html | 79 -- prototype/mobile-index.html | 140 --- prototype/pages/admin/dashboard.html | 302 ----- .../pages/admin/knowledge-management.html | 302 ----- prototype/pages/admin/quiz-records.html | 251 ---- prototype/pages/admin/settings.html | 235 ---- prototype/pages/admin/student-management.html | 269 ---- prototype/pages/admin/task-management.html | 318 ----- prototype/pages/mobile/ai-quiz.html | 267 ---- prototype/pages/mobile/card-recite.html | 248 ---- prototype/pages/mobile/home.html | 288 ----- prototype/pages/mobile/memory-curve.html | 333 ----- prototype/pages/mobile/profile.html | 330 ----- prototype/pages/mobile/quiz-report.html | 300 ----- prototype/server.js | 195 --- prototype/start.sh | 26 - prototype/view-doc.html | 297 ----- 31 files changed, 1 insertion(+), 8707 deletions(-) delete mode 100644 .dev-container-config.json delete mode 100644 PROJECT_INFO.md delete mode 100644 README.md delete mode 100644 ai-tutor-requirements.md delete mode 100644 package-lock.json delete mode 100644 package.json delete mode 100644 planning-artifacts/prd.md delete mode 100644 planning-artifacts/ux-design-specification.md delete mode 100644 prototype/README.md delete mode 100644 prototype/admin-index.html delete mode 100644 prototype/docs-index.html delete mode 100644 prototype/index.html delete mode 100644 prototype/markdown-template.html delete mode 100644 prototype/md-view.html delete mode 100644 prototype/mobile-index.html delete mode 100644 prototype/pages/admin/dashboard.html delete mode 100644 prototype/pages/admin/knowledge-management.html delete mode 100644 prototype/pages/admin/quiz-records.html delete mode 100644 prototype/pages/admin/settings.html delete mode 100644 prototype/pages/admin/student-management.html delete mode 100644 prototype/pages/admin/task-management.html delete mode 100644 prototype/pages/mobile/ai-quiz.html delete mode 100644 prototype/pages/mobile/card-recite.html delete mode 100644 prototype/pages/mobile/home.html delete mode 100644 prototype/pages/mobile/memory-curve.html delete mode 100644 prototype/pages/mobile/profile.html delete mode 100644 prototype/pages/mobile/quiz-report.html delete mode 100644 prototype/server.js delete mode 100644 prototype/start.sh delete mode 100644 prototype/view-doc.html diff --git a/.dev-container-config.json b/.dev-container-config.json deleted file mode 100644 index c4fd5d1..0000000 --- a/.dev-container-config.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "autoShutdown": { - "enabled": false, - "idleTimeoutMinutes": 30 - } -} \ No newline at end of file diff --git a/.gitignore b/.gitignore index 8de323a..e7d5bdd 100644 --- a/.gitignore +++ b/.gitignore @@ -1,16 +1 @@ -# 日志目录 -prototype/logs/ -prototype-mobile/logs/ -*.log - -# 临时文件 -.claude-nohup-*.out -.claude-wrapper-*.sh -.tmp-input-msg-*.txt - -# 备份文件 -*.backup -*.bak - -# 技能包(保留但不需要提交) -.claude/skills/*.tar.gz +.nfs* diff --git a/PROJECT_INFO.md b/PROJECT_INFO.md deleted file mode 100644 index a8ee904..0000000 --- a/PROJECT_INFO.md +++ /dev/null @@ -1,38 +0,0 @@ -# 📋 AI 智能抽背助手 - 项目信息 - -## 🏢 工作空间信息 -- **工作空间 ID**: 226 -- **工作空间名称**: AI智能抽背助手 -- **创建时间**: 2026-03-28T11:06:14.039Z - -## 📦 模板信息 -- **模板 ID**: 244 -- **模板名称**: AI智能抽背助手Web应用 -- **创建时间**: 2026-03-28T11:07:15.689Z - -## 🐳 容器配置 -- **容器组配置 ID**: 11 (8v16G_node_sshd_pg2g_redis_minio) -- **容器状态**: 🟢 Running - -## 🌐 访问地址 -- **VSCode**: `d8d-ai-vscode-23964-226-244-template-6-group.dev.d8d.fun` -- **应用端口8080**: `d8d-ai-vscode-8080-226-244-template-6-group.dev.d8d.fun` - -## 📂 工作目录 -- **工作目录**: `/mnt/code/226-244-template-6` -- **需求文档**: `ai-tutor-requirements.md` (564行,22K) - -## 🤖 AI 助手 -- **助手名称**: @nextjs-admin -- **助手 JID**: `agent-dbe15e72-5a99-4181-b305-49e7ad1f94c7` - -## 🎯 项目描述 -用于开发AI智能抽背助手的全栈Web应用。支持语音抽背、记忆曲线、卡片式学习、挖空填空等功能。 - -### 技术栈 -- Next.js + React + TypeScript + Tailwind CSS -- PostgreSQL + Redis + MinIO -- AI服务: Ollama (可选) - ---- -**文档生成时间**: 2026-03-28T11:14:00Z diff --git a/README.md b/README.md deleted file mode 100644 index a4c3a93..0000000 --- a/README.md +++ /dev/null @@ -1,2 +0,0 @@ -# blank - diff --git a/ai-tutor-requirements.md b/ai-tutor-requirements.md deleted file mode 100644 index 4f1b7f6..0000000 --- a/ai-tutor-requirements.md +++ /dev/null @@ -1,1092 +0,0 @@ -# 📋 AI 智能抽背助手 - 需求文档 - -## 一、用户管理模块 - -### 1.1 注册登录 -- **需求描述**: - 1. 支持手机号、邮箱注册登录(含验证码验证) - 2. 接入微信、QQ、微博第三方快捷登录 -- **使用场景**: 新用户首次使用 APP;老用户返回登录 -- **技术要求**: - - 密码需加密存储,符合隐私合规要求 - -### 1.2 个人信息编辑 -- **需求描述**: - 1. 支持头像上传(可裁剪、压缩)、昵称修改 - 2. 可编辑性别、个人简介,完善个人资料 -- **使用场景**: 用户首次登录后完善资料;后续想修改个人展示信息 -- **技术要求**: - - 头像需支持主流图片格式(JPG/PNG),限制文件大小(如≤5MB) - -### 1.3 账号设置 -- **需求描述**: - 1. 提供修改密码功能(需验证原密码/验证码) - 2. 支持更换绑定手机号(需原手机号验证) -- **使用场景**: 用户忘记密码需重置;手机号变更需更新绑定 -- **技术要求**: - - 更换手机号时需双重验证,确保账号安全 - ---- - -## 二、收藏与分享模块 - -### 2.1 题目收藏 -- **需求描述**: - 1. 用户可收藏重要/典型题目,添加收藏标签(如"高频考点") - 2. 收藏题目按标签分类,支持快速查找 -- **使用场景**: 用户遇到易混淆题目想标记;想收藏高频考点题目方便复习 -- **技术要求**: - - 收藏列表需支持批量操作(如批量取消收藏) - -### 2.2 分享功能 -- **需求描述**: - 1. 支持分享题目(含解析)、考试结果、学习心得 - 2. 可分享至微信、QQ、微博等第三方平台 -- **使用场景**: 用户想和同学交流题目;想分享考试成绩、学习经验 -- **技术要求**: - - 分享内容需自带 APP 入口链接,方便接收者跳转查看 - ---- - -## 三、任务制定模块 - -### 3.1 学习任务与提醒 -- **需求描述**: - 1. 用户可自主设置学习任务(如"每天刷 50 道题") - 2. 任务对应时间点,通过手机通知栏推送学习提醒 -- **使用场景**: 用户想养成规律学习习惯;需要定时提醒避免忘记复习 -- **技术要求**: - - 支持任务完成标记,提醒频率可设置(如每天固定时间) - ---- - -## 四、AI 语音抽背模块 - -### 4.1 抽背模式设定 -- **需求描述**: - 1. 支持语音/文字输入提问,选择抽背范围(学科章节、错题本、收藏题) - 2. 可设置抽背方式(顺序/随机)、抽背间隔时间(如每 30 秒一题) -- **使用场景**: 用户想通过语音互动抽背;想针对性抽背某部分内容,控制抽背节奏 -- **UI/UX 设计规格**: - - **主入口界面设计**: - - 顶部:虚拟人物展示区域(占屏幕约30%高度),增强亲和力 - - 中部:4个抽背考点选择按钮(2x2网格布局),快速进入抽背 - - 底部:固定导航栏(3个Tab:抽背、AI交互、个人中心) - - 主操作按钮:"点击进行抽背"(醒目样式,居中或底部突出位置) - - **抽背工作台界面**: - - 抽背范围选择:单选按钮组,包含"学段章节"、"未掌握知识点"、"收藏"三个选项 - - 抽背模式选择:单选按钮,支持"顺序"/"随机"切换 - - 抽背间隔设置:预设时间选项(如30秒、60秒、90秒),支持自定义 - - 交互模式:采用单选按钮交互,点击即选中并高亮显示 - - **视觉风格**: - - 背景色:白色为主,保持简洁清爽 - - 主色调:建议使用蓝色或绿色系(代表学习、成长) - - 字体:清晰易读的无衬线字体 - - 间距:合理的留白,避免拥挤感 - -### 4.2 抽背过程交互 -- **需求描述**: - 1. 以语音/文字形式展示抽背内容(如"请背诵牛顿第二定律") - 2. 用户作答后,AI 即时判断正误,错误则给出正确答案+解析 - 3. 自动标记错误内容为"待再次抽背" -- **使用场景**: 用户进行实时抽背,检验背诵效果;想知道背诵错误的内容及原因 -- **技术要求**: - - 语音播报需清晰,语速可调节(如正常/慢速) -- **UI/UX 设计规格**: - - **AI智能抽背助手界面**: - - 顶部:设置入口(齿轮图标),支持快速调整参数 - - 中部上方:AI助教引导语显示区(如"你好!我是你的AI助教,准备好了吗?") - - 中部核心:当前抽背题目显示(大字号,清晰易读) - - 语音交互区: - - 麦克风按钮(大尺寸,居中或底部突出位置) - - 实时状态显示:"正在倾听..."(语音输入中) - - 语音转文字显示区:实时显示用户说话内容 - - 反馈区:AI判断结果(正确/错误),错误时显示正确答案和解析 - - **交互流程**: - 1. 进入抽背界面 → AI问候并说明抽背主题 - 2. 显示第一题 → 用户点击麦克风按钮开始回答 - 3. 实时语音转文字 → 用户可看到自己的回答内容 - 4. AI即时判断 → 显示正误反馈 - 5. 错误时 → 显示正确答案+解析,自动标记为"待再次抽背" - 6. 下一题 → 自动或手动切换 - - **视觉反馈**: - - 麦克风按钮:点击时高亮或动画效果 - - 正确答案:绿色勾号或成功提示 - - 错误答案:红色叉号或温和的错误提示 - - 语音波形动画(可选):增强交互感 - -### 4.3 抽背结果反馈 -- **需求描述**: - 1. 抽背结束生成报告(正确率、错误题目、用时) - 2. 提供复习建议(如关联知识点回顾、推荐练习题目) -- **使用场景**: 用户完成抽背后想总结效果;需要知道后续如何巩固抽背内容 -- **技术要求**: - - 报告需突出错误点,建议需具体可执行(如"复习第三章第二节后再抽背") -- **UI/UX 设计规格**: - - **抽背报告页界面**: - - 顶部标题:报告标题(如"报告显示已记文字") - - 报告元信息: - - 报告生成时间 - - 报告保存时长提示(如"报告将保存30天") - - 核心数据展示区(建议使用卡片或图表): - - 总体正确率(大号数字+百分比) - - 总用时(分钟/秒) - - 抽背题目总数 - - 正确/错误题目数量 - - 详细分析区: - - 错误题目列表(可展开查看详情) - - 错误知识点统计(按章节或类别分组) - - 表现趋势图(可选):多次抽背的正确率变化曲线 - - 复习建议区: - - 基于错误知识点的具体建议 - - 推荐复习章节或内容 - - 推荐练习题目链接 - - 底部操作栏: - - 返回按钮(抽屉图标) - - 个人中心入口 - - 分享报告按钮(可选) - - 重新抽背按钮(可选) - - **数据可视化建议**: - - 正确率:使用环形图或进度条 - - 错误分布:使用柱状图或饼图 - - 时间趋势:使用折线图 - - **交互设计**: - - 错误题目可点击跳转到对应的知识点学习 - - 支持导出报告(PDF或图片格式) - - 支持历史报告对比 - -### 4.4 记忆曲线助力 -- **需求描述**: - 1. AI 依据艾宾浩斯记忆曲线,记录用户抽背数据 - 2. 在遗忘临界点(如 1 天后、3 天后)推送再次抽背提醒 -- **使用场景**: 用户想长期记忆知识点,避免遗忘;需要科学的复习时间规划 -- **技术要求**: - - 需精准计算遗忘周期,提醒时间需合理(如避免深夜推送) -- **UI/UX 设计规格**: - - **记忆曲线提醒界面**: - - 推送通知设计: - - 标题:温馨的提醒语(如"该复习啦!"、"记忆巩固时间到啦") - - 内容:具体要复习的知识点名称 - - 操作按钮:"开始复习"、"稍后提醒"、"已掌握" - - 记忆曲线可视化(可选): - - 展示知识点的记忆强度变化曲线 - - 标注当前所处的记忆阶段 - - 预测下次遗忘时间点 - - 复习计划日历: - - 以日历形式展示复习时间安排 - - 用不同颜色标记复习状态(待复习、已完成、已掌握) - - 支持查看历史复习记录 - - **提醒时间设置**: - - 默认提醒时间:上午9-10点、下午3-4点、晚上7-8点 - - 支持用户自定义提醒时间段 - - 避免在以下时间段推送:22:00-8:00(睡眠时间) - - **复习优先级**: - - 即将遗忘的知识点标记为"紧急复习" - - 新学的内容标记为"初次复习" - - 已掌握的内容标记为"巩固复习" - - **数据记录**: - - 记录每次抽背的时间、正确率 - - 计算知识点的记忆强度 - - 自动调整下次复习时间间隔 - -### 4.5 抽背内容后台查询 -- **需求描述**: - 1. 后台可查看用户抽背记录(抽背内容、正确率、错误点) - 2. 支持按用户、时间筛选查询 -- **使用场景**: 班主任想了解学生抽背情况;管理员统计班级整体抽背效果 -- **技术要求**: - - 数据需实时同步,支持导出(如 Excel),方便统计分析 -- **UI/UX 设计规格**: - - **后台管理界面**: - - 顶部筛选区: - - 用户选择(支持搜索、多选) - - 时间范围选择(日期区间选择器) - - 学科/章节筛选 - - 抽背类型筛选(初次复习、巩固复习等) - - 数据概览卡片: - - 总抽背次数 - - 平均正确率 - - 活跃用户数 - - 今日抽背次数 - - 详细数据表格: - - 列:用户姓名、抽背时间、抽背内容、正确率、用时、错误知识点 - - 支持排序、分页 - - 支持点击查看详情 - - 数据可视化: - - 班级整体正确率趋势图 - - 个人表现对比图 - - 错误知识点分布图 - - 操作按钮: - - 导出Excel/CSV - - 发送报告给家长/学生 - - 批量提醒复习 - - **权限管理**: - - 班主任:可查看本班学生数据 - - 管理员:可查看所有数据 - - 学生:只能查看自己的数据 - - **数据统计维度**: - - 按学生:个人抽背记录、进步趋势 - - 按班级:班级整体表现、平均正确率 - - 按知识点:易错知识点排行 - - 按时间:日/周/月抽背活跃度 - ---- - -## 五、要点背诵模块 - -### 5.1 文字抽背(卡片式) -- **需求描述**: - 1. 将知识点生成卡片形式,展示核心内容 - 2. 用户可标记"已记住"/"未记住",未记住卡片自动进入待复习列表 -- **使用场景**: 用户想通过卡片快速记忆知识点;想筛选未记住的内容重点背诵 -- **技术要求**: - - 卡片支持左右滑动切换,可自定义卡片背景色(可选) - -### 5.2 音频带背(挖空交互) -- **需求描述**: - 1. 知识点支持挖空处理(如"麻黄汤的组成包括麻黄、桂枝、杏仁和______,其核心功效为______、宣肺平喘,主治______证。") - 2. 底部提供"看答案"/"隐藏答案"按钮,支持用户朗诵知识点(音频录制可选) - 3. 挖空内容在下方显示,用户可点击正确内容填入 -- **使用场景**: 用户想通过填空强化记忆;想通过朗诵加深知识点印象 -- **技术要求**: - - 音频带背需支持暂停/重播,填入答案后即时判断正误 - -### 5.3 关联试题 -- **需求描述**: - 1. 针对当前背诵知识点,推荐关联试题 - 2. 点击可跳转至试题页面,进行练习巩固 -- **使用场景**: 用户背完知识点后,想通过做题检验应用能力;想拓展知识点相关题目 -- **技术要求**: - - 关联试题需精准匹配知识点,避免无关题目推送 - ---- - -## 📊 需求总结 - -**核心功能模块**: 5 个 -**主要功能点**: 15+ 个 -**技术特点**: -- AI 智能抽背(语音/文字) -- 艾宾浩斯记忆曲线 -- 卡片式学习 -- 挖空填空交互 -- 第三方登录集成 -- 社交分享功能 - ---- - -## 六、UI 设计分析总结 - -### 6.1 核心界面结构 - -基于 UI 设计稿分析,系统包含 4 个核心界面: - -#### **界面 1:主入口/抽背启动页** -- **功能定位**:系统入口,快速启动抽背 -- **核心元素**: - - 虚拟人物展示区(顶部,占30%高度) - - 4个抽背考点选择按钮(2x2网格布局) - - "点击进行抽背"主操作按钮 - - 底部3Tab导航(抽背、AI交互、个人中心) -- **设计风格**:简洁白色背景,突出核心操作 - -#### **界面 2:AI智能抽背助手** -- **功能定位**:语音交互抽背核心界面 -- **核心元素**: - - 设置入口(齿轮图标) - - AI助教引导语显示区 - - 当前抽背题目显示(大字号) - - 麦克风按钮(大尺寸,突出显示) - - 实时语音转文字显示区 - - AI判断反馈区(正确/错误+解析) -- **交互特点**:语音为主,实时反馈 - -#### **界面 3:抽背工作台** -- **功能定位**:抽背参数配置界面 -- **核心元素**: - - 抽背范围选择(学段章节/未掌握知识点/收藏) - - 抽背模式选择(顺序/随机) - - 抽背间隔设置(30秒/60秒/90秒) -- **交互模式**:单选按钮组,点击即选中 - -#### **界面 4:抽背报告页** -- **功能定位**:抽背结果展示与分析 -- **核心元素**: - - 报告标题和元信息(时间、保存时长) - - 核心数据展示(正确率、用时、题目数) - - 详细分析区(错误题目、知识点统计) - - 复习建议区 - - 底部操作栏(返回、个人中心、分享) -- **待完善**:图表可视化、数据对比功能 - -### 6.2 UI/UX 设计原则 - -#### **视觉设计** -- **色彩方案**: - - 主色调:蓝色/绿色系(代表学习、成长) - - 背景色:白色为主,保持简洁清爽 - - 强调色:用于重要操作按钮和反馈提示 -- **字体规范**: - - 使用无衬线字体,清晰易读 - - 题目文字:大字号(18-24pt) - - 正文内容:中等字号(14-16pt) - - 辅助信息:小字号(10-12pt) -- **间距布局**: - - 合理留白,避免拥挤 - - 元素间距统一(8px/16px/24px网格) - - 重要内容区域突出显示 - -#### **交互设计** -- **操作反馈**: - - 按钮点击:高亮或动画效果 - - 正确答案:绿色勾号或成功提示 - - 错误答案:红色叉号或温和提示 - - 语音输入:波形动画或状态文字 -- **流程优化**: - - 减少操作步骤,快速进入抽背 - - 支持语音快捷操作 - - 提供默认配置,降低设置门槛 -- **无障碍设计**: - - 支持语音播报和语音输入 - - 高对比度模式(可选) - - 大字体模式(可选) - -#### **响应式设计** -- **移动端优先**:主要使用场景为手机 -- **适配不同屏幕**: - - 小屏手机(< 5.5英寸) - - 大屏手机(5.5-6.5英寸) - - 平板设备(> 7英寸) -- **横竖屏切换**:支持自动适配 - -### 6.3 待优化功能点 - -1. **数据可视化增强**: - - 添加图表展示(正确率趋势、错误分布) - - 记忆曲线可视化 - - 学习进度仪表板 - -2. **社交互动功能**: - - 抽背结果分享到社交平台 - - 学习成就徽章系统 - - 排行榜(班级/全校) - -3. **个性化推荐**: - - 基于学习历史的智能推荐 - - 个性化复习计划生成 - - 学习难度自适应调整 - -4. **离线功能**: - - 支持离线下载题库 - - 离线抽背模式 - - 数据同步机制 - ---- - ---- - -## 📅 创建信息 - -- **创建日期**: 2026-03-28 -- **来源文件**: 需求.xls + UI设计稿分析 -- **整理人**: AI 智能抽背助手开发团队 -- **更新日期**: 2026-03-28(整合第二组UI详细分析 - 6个界面详细内容已整合到第七节) -- **状态**: ✅ 已完成UI分析(全部10个界面详细分析已整合到本文档) - -### UI 分析报告 -- **第一组**: 主入口界面分析(4个界面,第一张大图) -- **第二组**: 完整6界面详细分析(6个界面,第二张大图) - 详见下文第七节 - ---- - -## 七、第二组 UI 设计分析(基于真实图片) - -### 7.1 分析概述 - -**分析日期**:2026-03-28 -**图片来源**:AI 智能抽背助手 UI 设计稿 -**分析模式**:分步分析+错峰写入 -**需求文档**:/workspace/group/docs/ai-tutor-requirements.md - -**识别界面总数**:6 个独立 UI 界面 - -### 7.2 界面清单 - -| 界面编号 | 界面名称 | 坐标范围 | 功能定位 | -|---------|---------|---------|---------| -| 界面 1 | 首页 | X:88-222, Y:75-508 | 学习概览、任务、记忆曲线、高频考点 | -| 界面 2 | 知识点目录页 | X:247-382, Y:75-508 | 知识点列表导航 | -| 界面 3 | 音频带背详情页(挖空) | X:429-564, Y:75-508 | 音频+挖空填空学习 | -| 界面 4 | 卡片背诵详情页 | X:599-734, Y:75-508 | 卡片翻转学习 | -| 界面 5 | 答题详情页 | X:805-940, Y:75-508 | 选择题练习 | -| 界面 6 | 答题关联知识点页 | X:599-734, Y:542-975 | 关联知识点网格展示 | - -### 7.2.1 界面1:首页 - 详细分析 - -#### 功能定位 -该界面是 **AI 智能抽背助手的首页**,核心功能是**展示学习任务、高频考点及记忆辅助工具**,为用户提供"任务驱动+知识点记忆"的学习入口,支持快速进入抽背、考点查看及 AI 生成任务等核心功能。 - -#### 界面元素(详细拆解) - -**顶部状态栏**: -- 时间:`09:41`(左上角) -- 状态图标:信号、Wi-Fi、电池(右上角) -- 标题栏:`考研`(下拉菜单,左上角,用于切换学习场景) - -**学习概览模块**: -- 标题:`学习概览(2026-03-13)`(白色背景卡片,顶部) -- 统计数据: - - `已记忆知识点:128`(左,小字) - - `未记忆知识点:45次`(中,小字) - - `待复习:12`(右,小字,红色数字突出) - -**学习任务模块**: -- 标题:`学习计划制定`(浅蓝色背景,顶部) -- 提示文字:`您有新的学习任务`(浅蓝色背景,居中) -- 功能按钮: - - `要点背诵`(图标+文字,左) - - `卡片式抽背`(按钮,左) - - `音频带背(挖空)`(按钮,右) - -**记忆曲线提醒模块**: -- 标题:`记忆曲线提醒`(白色背景,顶部) -- 内容:`临界点复习:麻黄汤功效`(小字,左) -- 操作按钮:`去背诵`(小字,右) - -**高频考点模块**: -- 标题:`高频考点`(白色背景,顶部) -- 内容:`高频考点1`(小字,左) -- 操作按钮:`去学习`(小字,右) - -**底部导航栏**: -- 图标+文字: - - `首页`(房子图标,左) - - `智能抽背`(机器人图标,中,当前选中) - - `我的`(人形图标,右) - -#### 布局结构 -- **顶部**:状态栏(时间、信号)+ 标题栏(`考研`下拉) -- **中间**:垂直排列的 4 个模块(学习概览→学习任务→记忆曲线提醒→高频考点),每个模块为独立卡片,间距均匀 -- **底部**:固定导航栏(首页/智能抽背/我的),居中显示当前选中项(`智能抽背`) - -#### 交互模式 -- **下拉菜单**:点击`考研`可切换学习场景(如"考研""医学"等) -- **按钮点击**: - - `要点背诵`/`卡片式抽背`/`音频带背(挖空)`:进入对应抽背模式 - - `去背诵`/`去学习`:跳转至具体背诵/学习页面 -- **导航栏切换**:点击`首页`/`我的`可切换至对应页面(当前在`智能抽背`页) - -#### 视觉风格 -- **颜色**: - - 主色调:白色(背景)、浅蓝色(学习任务模块,突出重点) - - 强调色:红色(`待复习:12`)、黑色(文字)、灰色(辅助文字) -- **字体**: - - 标题:sans-serif(如"学习概览"),字号较大(14-16px) - - 正文:sans-serif(如"已记忆知识点"),字号较小(12px) -- **间距**:模块间间距约 10px,卡片内元素间距约 5px,导航栏图标与文字间距约 3px - -#### 具体文字内容(全量) -- 状态栏:`09:41` -- 标题栏:`考研` -- 学习概览:`学习概览(2026-03-13)`、`已记忆知识点:128`、`未记忆知识点:45次`、`待复习:12` -- 学习任务:`学习计划制定`、`您有新的学习任务`、`要点背诵`、`卡片式抽背`、`音频带背(挖空)` -- 记忆曲线提醒:`记忆曲线提醒`、`临界点复习:麻黄汤功效`、`去背诵` -- 高频考点:`高频考点`、`高频考点1`、`去学习` -- 底部导航:`首页`、`智能抽背`、`我的` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:首页展示学习概览、任务通知,符合"任务制定模块"需求(3.1 学习任务与提醒) -- ✅ **符合**:记忆曲线提醒功能,符合"记忆曲线助力"需求(4.4) -- ✅ **符合**:高频考点入口,符合"要点背诵模块"需求(5.1) -- ✅ **符合**:底部导航(首页/智能抽背/我的),符合"主入口界面设计"需求(4.1) - -**交互维度**: -- ✅ **符合**:按钮点击交互,操作简洁快速 -- ✅ **符合**:下拉切换学习场景,支持多场景使用 -- ✅ **符合**:底部固定导航栏,方便快速切换页面 - -**设计维度**: -- ✅ **符合**:白色背景为主,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,模块间距均匀(符合需求文档 6.2) -- ✅ **符合**:重要信息突出显示(红色`待复习:12`) - -**改进建议**: -1. 学习任务模块使用浅蓝色背景,建议统一使用白色背景或更柔和的颜色 -2. 可以添加虚拟人物展示区,增强亲和力(需求文档 4.1 提到"虚拟人物展示区域(占屏幕约30%高度)") -3. 可以添加"点击进行抽背"主操作按钮,更突出抽背入口(需求文档 4.1) - ---- - -### 7.2.2 界面2:知识点目录页 - 详细分析 - -#### 功能定位 -该界面是**知识点目录列表页面**,核心功能是**展示可学习的知识点条目**,用户可通过列表快速查找并进入具体知识点的学习页面。这是一个典型的内容导航页,支持用户浏览和选择学习内容。 - -#### 界面元素(详细拆解) - -**顶部状态栏**: -- 时间:`09:41`(左侧) -- 状态图标:信号图标(4G/Wi-Fi)、电池电量图标(右侧) -- 背景色:白色 - -**知识点目录卡片(核心元素)**: -- 数量:5个卡片,垂直排列 -- 结构:每个卡片均为圆角矩形 - - 边框:浅灰色(#E0E0E0) - - 内部背景:纯白色(#FFFFFF) - - 标题:`知识点目录`(居中,黑色,常规粗细,字号略大于卡片内其他文字) - - 内容区域:当前为占位状态(空白),预留用于填充具体知识点名称(如"中医基础理论-阴阳学说"等) - -**底部导航栏**: -- 位置:界面最下方,固定布局 -- 元素: - - `首页`:房子图标(左侧)+ 文字标注(黑色,小字号) - - `智能背诵`:机器人图标(中间,代表AI功能)+ 文字标注(黑色,小字号) - - `我的`:人形图标(右侧)+ 文字标注(黑色,小字号) -- 背景:白色 -- 图标与文字颜色:黑色 - -#### 布局结构 -- **顶部**:状态栏(时间、信号、电池) -- **中间**:垂直列表,5个知识点目录卡片,间距均匀,占据主要屏幕空间 -- **底部**:固定导航栏(首页/智能背诵/我的),图标+文字组合 - -#### 交互模式 -- **知识点目录卡片**:支持点击交互,点击后跳转至对应知识点的详细学习页面(如"阴阳失调的基本概念"详情页) -- **导航栏图标**:支持点击交互 - - 点击`首页`:返回主页面 - - 点击`智能背诵`:进入AI背诵功能页 - - 点击`我的`:进入个人中心 - -#### 视觉风格 -- **颜色**: - - 背景色:白色(#FFFFFF) - - 卡片边框:浅灰色(#E0E0E0) - - 文字颜色:黑色(无彩色文字,保持界面简洁) - - 导航栏:图标与文字均为黑色,与白色背景形成强烈对比 -- **字体**: - - 卡片标题:sans-serif,常规粗细,字号略大 - - 导航栏文字:sans-serif,小字号 -- **形状**:卡片为圆角矩形,符合现代移动端设计风格 - -#### 具体文字内容(全量) -- 状态栏:`09:41` -- 知识点目录卡片(5个):`知识点目录`(每个卡片标题) -- 底部导航:`首页`、`智能背诵`、`我的` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:知识点目录列表,符合"要点背诵模块"需求(5.1 文字抽背功能需要知识点选择入口) -- ✅ **符合**:底部导航栏(首页/智能背诵/我的),符合"主入口界面设计"需求(4.1) -- ⚠️ **部分符合**:当前卡片为占位状态,未显示具体知识点名称(如"中医基础理论-阴阳学说"),需要实际数据填充 - -**交互维度**: -- ✅ **符合**:点击卡片进入详情页,交互逻辑清晰 -- ✅ **符合**:底部固定导航栏,方便快速切换页面 -- ✅ **符合**:列表式布局,支持快速浏览和选择 - -**设计维度**: -- ✅ **符合**:白色背景,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,卡片间距均匀(符合需求文档 6.2) -- ✅ **符合**:无彩色文字,黑色与白色对比清晰,确保可读性 -- ✅ **符合**:移动端优先,垂直列表布局适合手机屏幕 - -**改进建议**: -1. **卡片内容**:当前卡片为占位状态,建议填充实际知识点名称(如"中医基础理论-阴阳学说""麻黄汤功效"等) -2. **卡片样式**:可以添加知识点数量标签(如"包含12个要点")或学习进度指示器(如"已完成60%") -3. **筛选/排序功能**:建议添加顶部筛选栏(按科目、按学习进度等排序),方便用户快速找到目标知识点 -4. **搜索功能**:建议添加搜索框,支持关键词搜索知识点 -5. **颜色应用**:需求文档建议使用蓝色/绿色主色调,当前界面纯黑白,可以考虑在选中状态或进度指示中使用品牌色 - ---- - -### 7.2.3 界面3:音频带背详情页(挖空)- 详细分析 - -#### 功能定位 -该界面是**音频带背(挖空)详情页**,核心功能是**通过音频+挖空填空的方式进行知识点背诵**。这是"要点背诵模块"的核心功能之一(需求文档5.2),支持用户听音频填空,结合视觉和听觉双重输入,增强记忆效果。 - -#### 界面元素(详细拆解) - -**顶部导航栏**: -- **返回按钮**:左上角,黑色向左箭头图标,用于返回上一页面 -- **标题**:居中显示`音频带背(挖空)`,黑色字体,字号略大 -- **设置图标**:右上角,黑色齿轮图标,用于进入设置页面 - -**核心内容区域(挖空题目)**: -- **题目标题**:左上角显示`听音填空:方剂学`,黑色字体,字号中等,说明题目类型 -- **题目内容**: - - 文本:`麻黄汤的组成包括麻黄、桂枝、杏仁和______,其核心功效为______、宣肺平喘,主治______证。` - - 挖空处:3处,用灰色下划线表示,提示用户需填写答案 -- **音频控制**:题目标题右侧有`播放原声`按钮(白色背景,黑色文字),用于播放题目音频 - -**答案选项区域**: -- **提示文字**:`点击选择输入:`(灰色字体,引导用户操作) -- **选项按钮**(圆形按钮,白色背景,黑色文字,灰色边框): - - 第一行:`甘草`、`发汗解表`、`风寒表实`、`大枣` - - 第二行:`清热解毒`、`(空按钮)` -- 按钮布局:横向排列,间距均匀 - -**操作按钮区域**: -- **左侧按钮**:`显示答案`(白色背景,黑色文字,灰色边框),用于查看正确答案 -- **右侧按钮**:`已记住`(黑色背景,白色文字),用于标记该知识点已掌握 -- 按钮样式:矩形,圆角设计,尺寸适中 - -**底部信息区域**: -- **提示文字**:`下一题`(灰色,小字号),提示用户可切换至下一题 -- **AI提示**:`(方剂学):麻黄汤禁忌证`(灰色,极小字号),AI生成的相关知识点提示 - -#### 布局结构 -- **顶部**:导航栏(返回、标题、设置) -- **中上部**:题目内容区(标题+挖空题目+音频控制) -- **中部**:答案选项区(提示文字+6个选项按钮,分2行排列) -- **中下部**:操作按钮区(显示答案、已记住,左右排列) -- **底部**:信息提示区(下一题、AI提示) - -#### 交互模式 -- **音频播放**:点击`播放原声`按钮,播放题目音频(需求文档5.2"音频带背(挖空)") -- **填空答题**:点击选项按钮,选择答案填入挖空处(需求文档5.2"挖空交互") -- **显示答案**:点击`显示答案`按钮,查看正确答案 -- **标记已记住**:点击`已记住`按钮,标记该知识点已掌握(影响记忆曲线算法) -- **返回**:点击左上角返回按钮,返回上一页面 -- **设置**:点击右上角设置图标,进入设置页面 - -#### 视觉风格 -- **颜色**: - - 背景色:白色(#FFFFFF) - - 文字颜色:黑色(主要内容)、灰色(提示文字、挖空下划线) - - 按钮背景:白色(普通按钮)、黑色(强调按钮"已记住") - - 按钮文字:黑色(普通按钮)、白色(强调按钮"已记住") - - 按钮边框:灰色(#E0E0E0) -- **字体**: - - 标题:sans-serif,字号略大(14-16px) - - 题目内容:sans-serif,字号中等(12-14px) - - 提示文字:sans-serif,字号较小(10-12px) -- **形状**:选项按钮为圆形,操作按钮为圆角矩形 - -#### 具体文字内容(全量) -- 导航栏:`音频带背(挖空)` -- 题目标题:`听音填空:方剂学` -- 题目内容:`麻黄汤的组成包括麻黄、桂枝、杏仁和______,其核心功效为______、宣肺平喘,主治______证。` -- 音频控制:`播放原声` -- 提示文字:`点击选择输入:` -- 选项按钮:`甘草`、`发汗解表`、`风寒表实`、`大枣`、`清热解毒`、`(空)` -- 操作按钮:`显示答案`、`已记住` -- 底部信息:`下一题`、`(方剂学):麻黄汤禁忌证` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:音频带背(挖空)功能,完全符合需求文档5.2"音频带背(挖空)"要求 -- ✅ **符合**:播放原声按钮,符合需求文档5.2"支持音频辅助学习" -- ✅ **符合**:挖空填空交互,符合需求文档5.2"挖空交互" -- ✅ **符合**:显示答案功能,符合需求文档5.2"答案反馈" -- ✅ **符合**:已记住按钮,符合需求文档4.4"记忆曲线助力"(标记掌握状态) -- ✅ **符合**:AI提示功能,符合需求文档4.3"抽背结果反馈"(AI智能推荐) - -**交互维度**: -- ✅ **符合**:音频+视觉双重输入,符合需求文档4.2"语音为主,实时反馈" -- ✅ **符合**:点击选项按钮选择答案,操作简洁直观 -- ✅ **符合**:显示答案+已记住按钮,提供明确反馈路径 -- ✅ **符合**:下一题提示,支持连续学习 - -**设计维度**: -- ✅ **符合**:白色背景,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,从上到下逻辑清晰(符合需求文档 6.2) -- ✅ **符合**:重要按钮突出显示(黑色背景"已记住"按钮) -- ✅ **符合**:移动端优先,按钮尺寸适中,点击区域合理 - -**改进建议**: -1. **音频播放状态**:建议添加音频播放进度条或播放动画(如波形图),增强音频播放反馈 -2. **已填空答案显示**:建议选中答案后,在挖空处显示已填内容(而非仅按钮变色) -3. **答案验证**:建议在填空完成后,实时验证答案正确性(用绿色/红色提示对错) -4. **颜色应用**:需求文档建议使用蓝色/绿色主色调,当前界面纯黑白,可以在正确/错误反馈中使用绿色/红色 -5. **键盘支持**:如果是平板或桌面端,建议支持键盘输入答案(而非仅点击按钮) - ---- - -### 7.2.4 界面4:卡片背诵详情页 - 详细分析 - -#### 功能定位 -该界面是**卡片背诵详情页**,核心功能是**通过卡片翻转或展开的方式展示知识点内容**,用户可查看详情并标记掌握状态。这是"要点背诵模块"的核心功能之一(需求文档5.1),支持文字抽背(卡片式)学习模式。 - -#### 界面元素(详细拆解) - -**顶部标题栏**: -- **返回按钮**:左上角,黑色"×"图标,用于退出当前页面 -- **标题**:居中显示`卡片背诵`,黑色字体,字号略大,明确页面功能 -- **设置按钮**:右上角,黑色齿轮图标,用于调整背诵相关设置(如字体、音量等) - -**中间内容区**: -- **进度条**:标题栏下方,黑色细条,显示`4/12`(共12张卡片,当前为第4张) -- **卡片内容**: - - 卡片为白色矩形,边框为浅灰色 - - 标题:`阴阳失调的基本概念`(黑色字体,字号较大,居中显示,突出核心知识点) - - 提示文字:`点击查看详情`(灰色小字,引导用户进一步了解内容) - -**底部操作栏**: -- **左侧按钮**:`未记住`(白色背景,黑色文字,矩形按钮),用于标记当前卡片未掌握 -- **右侧按钮**:`已记住`(黑色背景,白色文字,矩形按钮),用于标记当前卡片已掌握 -- 按钮交互:两者为互斥选择(单选),用户需根据对知识点的掌握情况点击对应按钮 - -#### 布局结构 -- **顶部**:标题栏(返回、标题、设置) -- **中上部**:进度条(显示当前进度4/12) -- **中部**:卡片内容区(标题"阴阳失调的基本概念"+"点击查看详情"提示) -- **底部**:操作栏(未记住/已记住按钮,左右排列) - -#### 交互模式 -- **查看详情**:点击卡片或"点击查看详情"提示,展开卡片详情(翻转或展开动画) -- **标记未记住**:点击`未记住`按钮,标记当前卡片未掌握(进入复习队列) -- **标记已记住**:点击`已记住`按钮,标记当前卡片已掌握(影响记忆曲线算法) -- **返回**:点击左上角"×"按钮,退出当前页面 -- **设置**:点击右上角齿轮图标,进入设置页面 - -#### 视觉风格 -- **颜色**: - - 背景色:白色(#FFFFFF) - - 文字颜色:黑色(主要内容)、灰色(提示文字) - - 按钮背景:白色(普通按钮"未记住")、黑色(强调按钮"已记住") - - 按钮文字:黑色(普通按钮)、白色(强调按钮) - - 卡片边框:浅灰色(#E0E0E0) -- **字体**: - - 标题:sans-serif,字号较大(14-16px),加粗 - - 提示文字:sans-serif,字号较小(10-12px) -- **形状**:卡片为矩形,按钮为矩形(圆角设计) - -#### 具体文字内容(全量) -- 标题栏:`卡片背诵` -- 进度条:`4/12` -- 卡片标题:`阴阳失调的基本概念` -- 提示文字:`点击查看详情` -- 操作按钮:`未记住`、`已记住` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:卡片背诵功能,完全符合需求文档5.1"文字抽背(卡片式)"要求 -- ✅ **符合**:进度显示(4/12),符合需求文档5.1"进度跟踪" -- ✅ **符合**:已记住/未记住按钮,符合需求文档4.4"记忆曲线助力"(标记掌握状态) -- ✅ **符合**:点击查看详情,符合需求文档5.1"卡片翻转或展开查看答案" - -**交互维度**: -- ✅ **符合**:点击卡片查看详情,交互直观 -- ✅ **符合**:未记住/已记住按钮提供明确反馈路径 -- ✅ **符合**:操作简洁,符合需求文档4.2"操作简洁" - -**设计维度**: -- ✅ **符合**:白色背景,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,内容区占比最大(符合需求文档 6.2) -- ✅ **符合**:重要按钮突出显示(黑色背景"已记住"按钮) -- ✅ **符合**:移动端优先,按钮尺寸适中,点击区域合理 - -**改进建议**: -1. **卡片翻转动画**:建议添加卡片翻转动画(正面→反面),增强视觉反馈(需求文档5.1"卡片翻转") -2. **详情内容展示**:当前仅显示标题,建议在详情页展示完整知识点内容(如"阴阳失调是指阴阳之间失去平衡...") -3. **滑动操作**:建议支持左右滑动切换上一张/下一张卡片,提升操作效率 -4. **颜色应用**:需求文档建议使用蓝色/绿色主色调,当前界面纯黑白,可以在已记住状态中使用绿色 -5. **进度可视化**:建议添加进度环或进度条动画,增强进度感知 - ---- - -### 7.2.5 界面5:答题详情页 - 详细分析 - -#### 功能定位 -该界面是**答题详情页**,核心功能是**展示试题内容、答案选项及提交答案后的反馈**。这是"要点背诵模块"的关联试题功能(需求文档5.3),支持用户通过答题巩固知识点,标记掌握状态。 - -#### 界面元素(详细拆解) - -**顶部标题栏**: -- **关闭按钮**:左上角,黑色"×"图标,用于退出答题页 -- **标题**:居中显示`答题`,黑色字体,字号略大 -- **设置按钮**:右上角,黑色齿轮图标,用于调整答题设置 - -**答题区域**: -- **进度条**:顶部黑色细条,显示当前答题进度(如`4/12`,表示第4题,共12题) -- **题目卡片**: - - 卡片背景:白色背景,浅灰色边框,圆角矩形设计 - - 题目标题:`麻黄汤禁忌症()`(黑色字体,加粗) - - 选项: - - `A.选项`(黑色字体,左对齐) - - `B.选项`(黑色字体,左对齐) - - `C.选项`(黑色字体,左对齐) - - `D.选项`(黑色字体,左对齐) - -**底部操作按钮**: -- **左侧按钮**:`未记住`(白色背景,黑色文字,黑色边框),用于标记未记住该题目 -- **右侧按钮**:`已记住`(黑色背景,白色文字),用于标记已记住该题目 - -#### 布局结构 -- **顶部**:标题栏(关闭、标题、设置) -- **中上部**:进度条(显示当前进度4/12) -- **中部**:答题卡片(题目标题+选项A/B/C/D) -- **底部**:操作栏(未记住/已记住按钮,左右排列) - -#### 交互模式 -- **关闭答题**:点击左上角"×"按钮,退出答题页 -- **选择答案**:点击选项(A/B/C/D),提交答案 -- **标记未记住**:点击`未记住`按钮,标记当前题目未掌握(进入复习队列) -- **标记已记住**:点击`已记住`按钮,标记当前题目已掌握(影响记忆曲线算法) -- **设置**:点击右上角齿轮图标,进入答题设置页面 - -#### 视觉风格 -- **颜色**: - - 背景色:白色(#FFFFFF) - - 文字颜色:黑色(主要内容) - - 按钮背景:白色(普通按钮"未记住")、黑色(强调按钮"已记住") - - 按钮文字:黑色(普通按钮)、白色(强调按钮) - - 卡片边框:浅灰色(#E0E0E0) -- **字体**: - - 标题:sans-serif,字号较大(14-16px),加粗 - - 选项:sans-serif,字号中等(12-14px) -- **形状**:卡片为圆角矩形,按钮为矩形(圆角设计) - -#### 具体文字内容(全量) -- 标题栏:`答题` -- 进度条:`4/12` -- 题目标题:`麻黄汤禁忌症()` -- 选项:`A.选项`、`B.选项`、`C.选项`、`D.选项` -- 操作按钮:`未记住`、`已记住` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:答题功能,完全符合需求文档5.3"关联试题"要求 -- ✅ **符合**:进度显示(4/12),符合需求文档5.3"进度跟踪" -- ✅ **符合**:已记住/未记住按钮,符合需求文档4.4"记忆曲线助力"(标记掌握状态) -- ✅ **符合**:选项选择(A/B/C/D),符合需求文档5.3"选择题答题" - -**交互维度**: -- ✅ **符合**:点击选项提交答案,交互直观 -- ✅ **符合**:未记住/已记住按钮提供明确反馈路径 -- ✅ **符合**:操作简洁,符合需求文档4.2"操作简洁" - -**设计维度**: -- ✅ **符合**:白色背景,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,垂直居中布局(符合需求文档 6.2) -- ✅ **符合**:重要按钮突出显示(黑色背景"已记住"按钮) -- ✅ **符合**:移动端优先,按钮尺寸适中,点击区域合理 - -**改进建议**: -1. **选项内容**:当前选项为占位状态(A.选项、B.选项等),建议填充实际选项内容(如"A.发热恶寒""B.疮家术后"等) -2. **答案验证**:建议在提交答案后,实时显示正确/错误反馈(用绿色/红色标记) -3. **解析展示**:建议添加答案解析区域,解释正确答案原因 -4. **颜色应用**:需求文档建议使用蓝色/绿色主色调,当前界面纯黑白,可以在正确/错误反馈中使用绿色/红色 -5. **答题进度可视化**:建议添加进度环或进度条动画,增强进度感知 -6. **多题型支持**:当前仅支持选择题,建议支持多选题、判断题等多种题型 - ---- - -### 7.2.6 界面6:答题关联知识点页 - 详细分析 - -#### 功能定位 -该界面是**答题关联知识点页**,核心功能是**展示与当前题目相关的知识点卡片**,帮助用户快速查看关联知识点内容,加深理解。这是"要点背诵模块"的关联试题功能(需求文档5.3),支持答题时快速跳转到相关知识点详情。 - -#### 界面元素(详细拆解) - -**顶部导航栏**: -- **关闭按钮**:左上角,黑色"×"图标,点击可退出当前页面 -- **标题**:居中显示`答题`,黑色字体,字号略大,明确当前页面功能 -- **设置图标**:右上角,齿轮形状,黑色,点击可进入设置选项 - -**知识点关联区域(核心内容)**: -- **布局**:采用**网格布局**,分为2行4列,共8个知识点卡片 -- **卡片样式**: - - 形状:矩形 - - 背景:白色 - - 边框:浅灰色(#E5E5E5) - - 文字:黑色,居中显示 -- **内容**:每个卡片显示`麻黄汤`(知识点名称),卡片间有轻微间距,整体排列整齐 - -**底部操作栏**: -- **左侧按钮**:`有疑问`(白色背景,黑色文字),点击可提交疑问 -- **右侧按钮**:`返回题`(黑色背景,白色文字),点击可返回上一题 - -#### 布局结构 -- **顶部**:导航栏(关闭、标题、设置) -- **中部**:知识点关联区域(2行4列网格布局,8个知识点卡片) -- **底部**:操作栏(有疑问/返回题按钮,左右排列) - -#### 交互模式 -- **关闭页面**:点击左上角"×"按钮,退出当前页面 -- **查看知识点详情**:点击知识点卡片(如"麻黄汤"),跳转到该知识点的详情页 -- **提交疑问**:点击`有疑问`按钮,提交关于当前题目的疑问(可能进入疑问反馈页) -- **返回上一题**:点击`返回题`按钮,返回上一题继续答题 - -#### 视觉风格 -- **颜色**: - - 背景色:白色(#FFFFFF) - - 文字颜色:黑色(主要内容) - - 按钮背景:白色(普通按钮"有疑问")、黑色(强调按钮"返回题") - - 按钮文字:黑色(普通按钮)、白色(强调按钮) - - 卡片边框:浅灰色(#E5E5E5) -- **字体**: - - 标题:sans-serif,字号略大(14-16px) - - 卡片文字:sans-serif,字号中等(12-14px) -- **形状**:卡片为矩形,按钮为矩形(圆角设计) - -#### 具体文字内容(全量) -- 导航栏:`答题` -- 知识点卡片(8个):`麻黄汤`(每个卡片) -- 操作按钮:`有疑问`、`返回题` - -#### 需求符合度评估 - -**功能维度**: -- ✅ **符合**:答题关联知识点功能,完全符合需求文档5.3"关联试题"要求 -- ✅ **符合**:网格布局展示多个知识点卡片,符合需求文档5.3"关联知识点展示" -- ✅ **符合**:点击卡片跳转详情,符合需求文档5.3"快速查看关联知识点" -- ✅ **符合**:有疑问按钮,符合需求文档2.2"收藏与分享模块"(疑问反馈) -- ✅ **符合**:返回题按钮,符合答题流程需求 - -**交互维度**: -- ✅ **符合**:点击卡片查看详情,交互直观 -- ✅ **符合**:有疑问/返回题按钮提供明确操作路径 -- ✅ **符合**:网格布局便于快速浏览多个知识点 - -**设计维度**: -- ✅ **符合**:白色背景,保持简洁清爽(符合需求文档 4.1) -- ✅ **符合**:合理留白,卡片间距均匀(符合需求文档 6.2) -- ✅ **符合**:重要按钮突出显示(黑色背景"返回题"按钮) -- ✅ **符合**:移动端优先,网格布局适合手机屏幕 - -**改进建议**: -1. **知识点差异化**:当前所有卡片显示相同内容("麻黄汤"),建议显示不同知识点名称(如"桂枝""杏仁""甘草"等) -2. **卡片内容丰富化**:建议在卡片中添加更多信息(如知识点标签、学习进度、关联题目数量等) -3. **筛选/排序功能**:建议添加顶部筛选栏(按科目、按关联度等排序),方便用户快速找到目标知识点 -4. **颜色应用**:需求文档建议使用蓝色/绿色主色调,当前界面纯黑白,可以在卡片选中状态或已掌握状态中使用品牌色 -5. **搜索功能**:建议添加搜索框,支持关键词搜索知识点 -6. **分页加载**:如果关联知识点很多,建议添加分页或滚动加载功能 - ---- - -### 7.3 需求符合度总评 - -#### ✅ 优秀符合项 - -1. **功能完整性** - - ✅ 覆盖所有核心功能模块(用户管理、任务制定、AI语音抽背、要点背诵) - - ✅ 支持需求文档中的所有学习模式(卡片式、音频带背、挖空、选择题) - - ✅ 记忆曲线功能完整(已记住/未记住标记、临界点复习提醒) - -2. **交互一致性** - - ✅ 统一的底部导航栏(首页/智能抽背/我的) - - ✅ 统一的操作按钮(未记住/已记住、显示答案/返回) - - ✅ 统一的导航模式(返回、设置按钮位置一致) - -3. **设计统一性** - - ✅ 白色背景,黑色文字,保持简洁清爽 - - ✅ 圆角矩形卡片,符合现代移动端设计风格 - - ✅ 合理留白,清晰层级 - -#### ⚠️ 待改进项 - -1. **视觉设计** - - ⚠️ 需求文档建议使用蓝色/绿色主色调,当前界面纯黑白 - - 💡 建议在强调状态(正确/错误、已掌握、未掌握)中使用品牌色 - - 💡 建议添加颜色渐变、阴影等视觉增强效果 - -2. **交互反馈** - - ⚠️ 缺少动画效果(卡片翻转、音频播放波形、进度环等) - - 💡 建议添加实时反馈(答案验证、进度更新、状态提示) - - 💡 建议添加手势交互(滑动切换卡片、长按显示操作菜单) - -3. **内容完整性** - - ⚠️ 部分界面为占位状态(知识点目录卡片、答题选项等) - - 💡 建议填充实际内容数据(具体知识点名称、选项内容、解析文本等) - -4. **功能增强** - - ⚠️ 缺少搜索功能(知识点搜索、题目搜索) - - 💡 建议添加筛选/排序功能(按科目、按进度、按关联度) - - 💡 建议添加虚拟人物展示(需求文档4.1提到"虚拟人物展示区域") - -### 7.4 设计建议优先级 - -#### 🔴 高优先级(必须实现) - -1. **填充实际内容** - - 当前状态:部分界面为占位状态(如"知识点目录""A.选项"等) - - 改进建议:填充实际数据(具体知识点名称、选项内容、解析文本等) - - 预期效果:用户可以看到完整的学习内容,提升使用体验 - -2. **添加颜色应用** - - 当前状态:界面纯黑白,缺少品牌色 - - 改进建议:在关键状态(正确/错误、已掌握、进度)中使用蓝色/绿色主色调 - - 预期效果:增强视觉吸引力,提升品牌识别度 - -3. **完善交互反馈** - - 当前状态:缺少动画效果和实时反馈 - - 改进建议:添加答案验证、进度更新、动画效果等实时反馈 - - 预期效果:用户可以清楚了解操作结果,提升交互体验 - -#### 🟡 中优先级(建议实现) - -1. **搜索功能** - - 当前状态:无搜索功能 - - 改进建议:添加搜索框,支持关键词搜索知识点和题目 - - 预期效果:用户可以快速找到目标内容 - -2. **筛选/排序** - - 当前状态:无筛选排序功能 - - 改进建议:添加筛选栏,支持按科目、进度、关联度排序 - - 预期效果:用户可以按需排序,提高学习效率 - -3. **虚拟人物展示** - - 当前状态:首页无虚拟人物展示区 - - 改进建议:在首页添加虚拟人物展示区(需求文档4.1) - - 预期效果:增强亲和力,提升用户体验 - -#### 🟢 低优先级(可选实现) - -1. **键盘支持** - - 当前状态:仅支持触摸操作 - - 改进建议:在平板或桌面端支持键盘输入 - - 预期效果:提升桌面端使用体验 - -2. **多题型支持** - - 当前状态:仅支持选择题 - - 改进建议:扩展支持多选题、判断题、填空题等 - - 预期效果:丰富学习模式,提升学习效果 - -3. **分页加载** - - 当前状态:无分页加载 - - 改进建议:如果内容很多,添加分页或滚动加载 - - 预期效果:优化性能,提升大数据量场景体验 - -### 7.5 核心发现 - -#### 优势 - -1. **功能覆盖全面**:6个界面覆盖了需求文档中的所有核心功能模块 -2. **交互逻辑清晰**:操作简洁直观,符合用户预期 -3. **设计风格统一**:符合移动端优先原则,保持一致性 - -#### 关键改进方向 - -1. **补充品牌色应用**(蓝色/绿色主色调) -2. **增强交互反馈**(动画、实时验证) -3. **完善内容数据**(替换占位内容) - -### 7.6 总体评分 - -⭐⭐⭐⭐(4/5星) - -**评分说明**: -- 功能完整性:⭐⭐⭐⭐⭐(5/5) -- 交互一致性:⭐⭐⭐⭐⭐(5/5) -- 设计统一性:⭐⭐⭐⭐(4/5) -- 视觉吸引力:⭐⭐⭐(3/5) -- 内容完整性:⭐⭐⭐(3/5) - -**平均分**:4.0/5.0 - ---- - -## 📅 更新记录 - -- **2026-03-28**: 添加第二组UI分析(基于真实图片的6个界面详细分析) -- **分析工具**: ui-layout-analyzer skill (分步分析+错峰写入模式) -- **分析模式**: 基于需求文档的需求符合度评估 -- **报告状态**: ✅ 已完成UI分析 diff --git a/package-lock.json b/package-lock.json deleted file mode 100644 index 538d779..0000000 --- a/package-lock.json +++ /dev/null @@ -1,77 +0,0 @@ -{ - "name": "226-244-template-6", - "lockfileVersion": 3, - "requires": true, - "packages": { - "": { - "dependencies": { - "markdown-it": "^14.1.1" - } - }, - "node_modules/argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "license": "Python-2.0" - }, - "node_modules/entities": { - "version": "4.5.0", - "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", - "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", - "license": "BSD-2-Clause", - "engines": { - "node": ">=0.12" - }, - "funding": { - "url": "https://github.com/fb55/entities?sponsor=1" - } - }, - "node_modules/linkify-it": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-5.0.0.tgz", - "integrity": "sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ==", - "license": "MIT", - "dependencies": { - "uc.micro": "^2.0.0" - } - }, - "node_modules/markdown-it": { - "version": "14.1.1", - "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-14.1.1.tgz", - "integrity": "sha512-BuU2qnTti9YKgK5N+IeMubp14ZUKUUw7yeJbkjtosvHiP0AZ5c8IAgEMk79D0eC8F23r4Ac/q8cAIFdm2FtyoA==", - "license": "MIT", - "dependencies": { - "argparse": "^2.0.1", - "entities": "^4.4.0", - "linkify-it": "^5.0.0", - "mdurl": "^2.0.0", - "punycode.js": "^2.3.1", - "uc.micro": "^2.1.0" - }, - "bin": { - "markdown-it": "bin/markdown-it.mjs" - } - }, - "node_modules/mdurl": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/mdurl/-/mdurl-2.0.0.tgz", - "integrity": "sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==", - "license": "MIT" - }, - "node_modules/punycode.js": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode.js/-/punycode.js-2.3.1.tgz", - "integrity": "sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==", - "license": "MIT", - "engines": { - "node": ">=6" - } - }, - "node_modules/uc.micro": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-2.1.0.tgz", - "integrity": "sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A==", - "license": "MIT" - } - } -} diff --git a/package.json b/package.json deleted file mode 100644 index 2869939..0000000 --- a/package.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "dependencies": { - "markdown-it": "^14.1.1" - } -} diff --git a/planning-artifacts/prd.md b/planning-artifacts/prd.md deleted file mode 100644 index 4a45121..0000000 --- a/planning-artifacts/prd.md +++ /dev/null @@ -1,1082 +0,0 @@ ---- -stepsCompleted: ['step-01-init', 'step-02-discovery', 'step-02b-vision', 'step-02c-executive-summary', 'step-03-success', 'step-04-journeys', 'step-05-domain', 'step-06-innovation', 'step-07-project-type', 'step-08-scoping', 'step-09-functional', 'step-10-nonfunctional', 'step-11-polish', 'step-12-complete'] -inputDocuments: - - path: '/mnt/code/226-244-template-6/ai-tutor-requirements.md' - type: 'requirements' - loadedAt: '2026-03-28T12:30:00Z' -documentCounts: - briefs: 0 - research: 0 - brainstorming: 0 - projectDocs: 1 -workflowType: 'prd' -projectName: 'AI 智能抽背助手' -author: 'BMAD & Claude' -date: '2026-03-28' -classification: - projectType: 'mobile_app' - domain: 'edtech' - complexity: 'medium_high' - projectContext: 'greenfield' ---- - -# Product Requirements Document - AI 智能抽背助手 - -**Author:** BMAD & Claude -**Date:** 2026-03-28 -**Version:** 1.0 - ---- - -## 📋 执行摘要 - -### 产品愿景 - -**AI 智能抽背助手** 是一款基于微信小程序的智能学习辅助应用,通过 AI 驱动的艾宾浩斯遗忘曲线算法,在用户即将遗忘知识点的关键时刻主动推送精准复习,将复习从"被动任务"转变为"主动救星"。 - -**核心理念:** 不是"学得不够",而是"复习时机不对"。 - -### 目标用户 - -- **K12 学生**:背诵古诗词、英语单词、历史知识点 -- **大学生**:专业课程知识点记忆、考试复习 -- **职业考试考生**:教师资格证、会计师、法律职业资格等备考 - -### 核心差异化 - -| 维度 | 传统应用 | AI 智能抽背助手 | -|------|----------|-----------------| -| 复习机制 | 固定间隔 / 用户手动设置 | **AI 根据个体遗忘曲线自动优化** | -| 交互方式 | 被动点击选择 | **主动式 AI 语音对话抽背** | -| 知识关联 | 无关联 | **智能关联相关知识点,形成知识网络** | -| 学习场景 | 静态学习 | **主动抽背 + 被动复习双模式结合** | - -**一句话价值主张:** "AI 懂你何时会忘,在遗忘前精准复习" - ---- - - -## 🎯 项目分类与确认 - -### 项目类型确认 - -| 分类维度 | 分类结果 | 确认依据 | -|---------|---------|---------| -| **项目类型** | Mobile App(微信小程序) | 目标用户主要使用微信,降低使用门槛 | -| **领域** | EdTech(教育科技) | K12/职业考试学习辅助工具 | -| **复杂度** | Medium-High(中高) | AI 语音交互 + 个性化算法 + 知识图谱 | -| **项目背景** | Greenfield(绿地项目) | 全新产品,无历史包袱 | -| **目标市场** | 中国市场 | 主要面向中文用户,适配微信生态 | - -### 项目类型决策分析 - -**为什么选择微信小程序?** - -| 因素 | 分析 | -|------|------| -| **用户触达** | 微信月活 13 亿,覆盖 95%+ 目标用户 | -| **开发成本** | 无需下载安装,降低获客成本 | -| **跨平台** | 一套代码覆盖 iOS + Android | -| **分享裂变** | 天然支持社交分享,利于 K-factor > 1 | -| **支付便捷** | 微信支付集成,付费转化率高 | - -**为什么不是其他选项?** - -| 选项 | 为什么不选 | -|------|-----------| -| **原生 App** | 开发成本高(iOS + Android),下载门槛高 | -| **H5 网页** | 体验不如小程序,无法利用微信生态 | -| **快应用** | 用户基数小,生态不成熟 | - -### 复杂度评估 - -| 复杂度维度 | 评估 | 说明 | -|-----------|------|------| -| **技术复杂度** | 中高 | AI 集成、语音识别、个性化算法 | -| **业务复杂度** | 中 | 教育领域,业务逻辑相对清晰 | -| **集成复杂度** | 中 | 需集成微信 SDK、AI API、支付等 | -| **数据复杂度** | 中高 | 个性化数据、知识图谱、学习分析 | - -### 项目边界确认 - -**在范围内(做什么):** -- ✅ K12 学科知识抽背(语文、英语、历史等) -- ✅ 职业考试知识点抽背(教师资格证、会计师等) -- ✅ AI 语音对话抽背 -- ✅ 个性化复习提醒 -- ✅ 学习数据统计与分析 - -**不在范围内(不做什么):** -- ❌ 视频课程内容(不做内容生产) -- ❌ 在线直播教学(不做实时互动) -- ❌ 题库搜题(不做搜题功能) -- ❌ 社交社区(MVP 不做,Phase 2 考虑) -- ❌ 企业版/B2B(专注 C 端用户) - -### 领域关键关注点 - -- **学生隐私合规**:COPPA/FERPA、《个人信息保护法》 -- **内容质量管控**:教育专家审核,AI 辅助生成 -- **无障碍设计**:WCAG AA 标准,支持语音交互 -- **记忆曲线算法**:基于艾宾浩斯曲线,有学术支撑 - ---- - - -## 🎯 成功标准 - -### 用户成功 - -**核心成功时刻:考试成功** - -用户在考试中发现自己能够轻松回忆起通过 AI 智能抽背助手学习的知识点,从"背了忘、忘了背"的循环中解脱出来,体验到"这 APP 太管用了"的价值感受。 - -**关键感受:** -- 不是"我学了很多",而是"我记住了,考试用上了" -- 学习效果的可视化反馈带来成就感 -- 从被动学习转变为主动掌握 - -### 商业成功 - -- **用户留存率**:次日留存 > 40%,7日留存 > 25% -- **用户活跃度**:DAU/MAU > 0.3(月活跃用户中30%日活) -- **病毒系数**:K-factor > 1.0(通过分享功能带来自然增长) -- **付费转化率**:免费用户 → 付费会员转化率 > 5% - -### 技术成功 - -- **AI 准确率**:语音识别准确率 > 95%,答案判定准确率 > 90% -- **系统性能**:API 响应时间 < 500ms(P95),抽背交互延迟 < 1s -- **记忆曲线算法**:复习提醒时机匹配度 > 85%(用户反馈"提醒时机恰当") -- **系统稳定性**: uptime > 99.5% - ---- - -## 👥 用户旅程 - -### 主要用户类型 - -1. **高中生小明(16岁)**:备战期末考试,需要背诵大量古诗词和英语单词 -2. **大学生张芳(20岁)**:准备教师资格证考试,需要记忆教育学知识点 -3. **职业考生李华(28岁)**:备考会计师,需要记忆会计准则和公式 - -### 旅程一:高中生小明(期末考试冲刺) - -**场景**:距离期末考试还有2周,小明发现自己背过的古诗词又忘了 - -**旅程步骤**: -1. **注册登录**:通过微信快捷登录,系统引导完善年级、学科信息 -2. **首次抽背**:选择"古诗词"模块,AI 语音提问"请背诵《望岳》" -3. **实时反馈**:小明回答后,AI 指出"忘记了'会当凌绝顶'这句",标记为待复习 -4. **复习提醒**:第二天晚上8点,推送"该复习《望岳》啦!" -5. **考试成功**:期末考试古诗题全对,小明感叹"这 APP 太神了!" - -**关键体验点**: -- AI 语音交互自然流畅 -- 复习提醒时机精准(确实在快要忘的时候推送) -- 可视化进度反馈(记忆曲线图)带来成就感 - -### 旅程二:大学生张芳(职业资格考试) - -**场景**:张芳白天上课,只能利用碎片时间复习 - -**旅程步骤**: -1. **任务制定**:设置"每天刷50道教育学题目"任务 -2. **碎片时间抽背**:在等公交车时,打开小程序进行5分钟快速抽背 -3. **挖空填空**:遇到难记的知识点,使用挖空模式强化记忆 -4. **关联试题**:背完知识点后,直接跳转关联试题检验应用能力 -5. **学习统计**:周末查看学习报告,发现"教育心理学"章节错误率最高 -6. **针对性复习**:重点复习教育心理学,下次抽背正确率提升30% - -**关键体验点**: -- 支持碎片化学习(5分钟也能完成一次抽背) -- 多种学习模式(抽背、挖空、卡片)适应不同场景 -- 数据驱动的学习分析帮助精准提升 - -### 旅程三:故障恢复场景 - -**场景**:用户在使用过程中遇到问题 - -**处理流程**: -1. **语音识别失败**:系统提示"抱歉没听清,请再说一次",提供文字输入备选 -2. **网络异常**:本地缓存已抽背内容,网络恢复后自动同步 -3. **AI 判定错误**:提供"申诉"按钮,用户可反馈"我答对了",系统记录并优化算法 - ---- - -## 🌍 领域分析 - -### EdTech 行业背景 - -**市场规模:** -- 全球 EdTech 市场规模预计 2025 年达到 4040 亿美元 -- 中国在线教育市场规模超过 4000 亿元人民币 -- K12 在线教育渗透率超过 35% - -**行业趋势:** -1. **AI 个性化学习**:从"一刀切"转向"因材施教" -2. **碎片化学习**:利用碎片时间进行高效学习 -3. **游戏化学习**:通过激励机制提升学习动力 -4. **多模态交互**:语音、AR/VR 等交互方式普及 - -### 目标领域细分 - -| 细分领域 | 市场特点 | 用户痛点 | AI 智能抽背助手定位 | -|---------|---------|---------|-------------------| -| **K12 教育** | 竞争激烈,家长付费意愿强 | 记忆负担重,遗忘快 | **核心目标市场** | -| **职业考试** | 刚需强,客单价高 | 工作学习冲突,时间少 | **重点拓展市场** | -| **语言学习** | 市场大,竞争激烈 | 需要持续练习 | **差异化补充** | -| **兴趣爱好** | 付费意愿相对较低 | 缺乏系统性 | **未来探索** | - -### 竞品分析 - -| 竞品 | 核心功能 | 优势 | 劣势 | 我们的差异化 | -|------|---------|------|------|-------------| -| **Anki** | 间隔重复卡片 | 成熟算法,开源社区 | 界面陈旧,学习曲线陡峭 | **AI 语音交互 + 艾宾浩斯算法** | -| **百词斩** | 图片记忆单词 | 用户量大,内容丰富 | 仅限英语单词 | **全学科知识抽背** | -| **Quizlet** | 学习卡片和测验 | 国际化,功能丰富 | 付费墙,国内访问受限 | **本土化 + 免费基础功能** | -| **作业帮/小猿搜题** | 搜题答疑 | 用户基础大 | 主要解决"不会做",而非"记不住" | **专注记忆巩固** | - -### 领域特定挑战 - -**教育科技领域的特殊挑战:** - -1. **学生隐私保护** - - 需符合 COPPA(儿童在线隐私保护法) - - 需符合中国《个人信息保护法》 - - 未成年用户需监护人同意 - -2. **内容质量管控** - - 知识点内容需经过教育专家审核 - - 避免 AI 生成错误或误导性内容 - - 建立内容更新和纠错机制 - -3. **认知科学依据** - - 记忆曲线算法需有学术支撑 - - 复习效果需可量化验证 - - 避免过度营销承诺 - -4. **教育公平性** - - 避免"数字鸿沟"加剧 - - 基础功能免费,降低使用门槛 - - 支持离线功能,减少网络依赖 - -### 监管合规要求 - -| 合规领域 | 要求 | 应对措施 | -|---------|------|---------| -| **数据安全** | 等保三级认证 | 数据加密存储,定期安全审计 | -| **内容合规** | 教育部内容审核机制 | 建立内容审核团队,对接审核平台 | -| **隐私保护** | 《个人信息保护法》 | 明确隐私政策,用户数据可导出/删除 | -| **未成年人保护** | 防沉迷机制 | 限制使用时长,夜间模式提醒休息 | - ---- - -## 💡 创新分析 - -### 核心创新点 - -#### 1. AI 驱动的个性化遗忘曲线 - -**传统方法:** -- 固定间隔复习(1天、3天、7天) -- 所有用户使用相同间隔 - -**我们的创新:** -``` -个性化遗忘曲线算法 -├── 基于个体表现动态调整 -│ ├── 答对次数多 → 延长间隔 -│ ├── 答错或犹豫 → 缩短间隔 -│ └── 遗忘高峰前 → 提前提醒 -├── 考虑因素 -│ ├── 知识点难度系数 -│ ├── 用户历史记忆表现 -│ ├── 时间段记忆效率(早上/晚上) -│ └── 相似知识点干扰效应 -└── 持续优化 - ├── 每次抽背后更新模型 - └── 100次抽背后准确度 > 85% -``` - -**技术实现:** -- 基础算法:艾宾浩斯遗忘曲线 -- 优化算法:贝叶斯知识追踪(BKT) -- 机器学习:XGBoost 预测遗忘概率 - -#### 2. 主动式 AI 语音对话抽背 - -**传统方法:** -- 被动式卡片翻转(Anki) -- 静默式选择题测验 - -**我们的创新:** -- **AI 主动提问**:模拟老师抽背场景,更有压力感和参与感 -- **语音交互**:解放双手,适合碎片时间 -- **多模态反馈**:语音 + 文字 + 表情 三重反馈 -- **自然对话**:支持追问、提示、鼓励等对话技巧 - -**技术实现:** -- 语音识别:Web Speech API / 微信语音识别 SDK -- 自然语言理解:LLM(GPT-4 / Claude) -- 语音合成:TTS(文字转语音) - -#### 3. 知识图谱智能关联 - -**传统方法:** -- 知识点独立学习 -- 无关联推荐 - -**我们的创新:** -``` -知识图谱关联 -├── 同类知识点 -│ └── "《望岳》→ 其他杜甫诗作" -├── 前置知识点 -│ └── "《望岳》→ 杜甫生平背景" -├── 相关试题 -│ └── "《望岳》→ 历年考题" -└── 易混淆点 - └── "《望岳》vs《春望》" -``` - -**用户价值:** -- 从"点状记忆"到"网状记忆" -- 提高知识迁移能力 -- 减少遗忘率(关联记忆更牢固) - -#### 4. 双模式学习设计 - -| 模式 | 适用场景 | 设计特点 | -|------|---------|---------| -| **主动抽背模式** | 深度学习,强化记忆 | AI 主动提问,语音对话,有压力感 | -| **被动复习模式** | 碎片时间,轻松巩固 | 卡片滑动,挖空填空,无压力 | - -**创新价值:** -- 不同场景切换不同模式 -- 避免单一模式疲劳 -- 提高用户粘性(日活 > 月活) - -### 技术创新 - -| 技术领域 | 创新点 | 技术方案 | -|---------|--------|---------| -| **NLP** | 答案语义理解 | LLM + Few-shot Learning | -| **语音** | 中文语音识别优化 | 微信语音识别 + 自定义纠错模型 | -| **算法** | 个性化记忆曲线 | 艾宾浩斯 + BKT + XGBoost | -| **推荐** | 知识图谱关联 | Neo4j 图数据库 +协同过滤 | - -### 模式创新 - -**从"工具"到"伙伴":** -- 传统学习应用:工具属性,冷冰冰 -- AI 智能抽背助手:伙伴属性,有温度 - -**设计体现:** -- AI 虚拟人物形象(可自定义) -- 对话式交互("小明同学,今天该复习啦") -- 情感化反馈("太棒了!" "没关系,再试试") - ---- - -## 🎨 产品范围 - -### MVP - 最小可行产品(Phase 1) - -#### 模块 1:用户管理 - -| 功能 | 优先级 | 描述 | -|------|--------|------| -| **注册登录** | P0 | 手机号/邮箱注册(验证码验证)\n微信/QQ/微博第三方快捷登录 | -| **个人信息编辑** | P1 | 头像上传(裁剪、压缩)\n昵称修改\n性别、个人简介编辑 | -| **账号设置** | P1 | 修改密码(验证原密码/验证码)\n更换绑定手机号(双重验证) | - -**技术要求:** -- 密码加密存储(bcrypt) -- JWT Token 认证 -- 符合隐私合规(GDPR/COPPA) - ---- - -#### 模块 2:收藏与分享 - -| 功能 | 优先级 | 描述 | -|------|--------|------| -| **题目收藏** | P0 | 收藏题目\n添加收藏标签(如"高频考点")\n按标签分类筛选 | -| **分享功能** | P1 | 分享题目(含解析)\n分享考试结果\n分享学习心得\n支持微信、QQ、微博分享 | - -**技术要求:** -- 分享内容自带 APP 入口链接(Deep Link) -- 收藏列表支持批量操作 - ---- - -#### 模块 3:任务制定 - -| 功能 | 优先级 | 描述 | -|------|--------|------| -| **学习任务设置** | P0 | 设置每日学习任务(如"每天刷50道题")\n任务对应时间点 | -| **学习提醒** | P0 | 手机通知栏推送提醒\n支持任务完成标记 | - -**技术要求:** -- 支持自定义提醒频率 -- 本地通知调度(iOS/Android Push) - ---- - -#### 模块 4:AI 语音抽背(核心模块) - -| 子功能 | 优先级 | 描述 | -|--------|--------|------| -| **4.1 抽背模式设定** | P0 | 语音/文字输入提问\n选择抽背范围(学科章节、错题本、收藏题)\n抽背方式(顺序/随机)\n抽背间隔时间(30秒/60秒/90秒/自定义) | -| **4.2 抽背过程交互** | P0 | 语音/文字展示抽背内容\nAI 即时判断正误\n错误时给出正确答案+解析\n自动标记错误内容为"待再次抽背"\n语音播报(语速可调节) | -| **4.3 抽背结果反馈** | P0 | 生成抽背报告(正确率、错误题目、用时)\n提供复习建议(关联知识点回顾、推荐练习题目)\n报告保存30天 | -| **4.4 记忆曲线助力** | P0 | 艾宾浩斯记忆曲线算法\n在遗忘临界点推送再次抽背提醒(1天后、3天后、7天后、15天后)\n记忆曲线可视化 | -| **4.5 抽背内容后台查询** | P1 | 后台查看用户抽背记录\n按用户、时间筛选查询\n数据导出(Excel) | - -**UI/UX 设计规格:** -- **主入口界面**:虚拟人物展示区(30%高度)+ 4个抽背考点按钮(2x2网格)+ "点击进行抽背"主按钮 -- **AI抽背界面**:设置入口 + AI引导语 + 当前题目显示 + 麦克风按钮 + 实时语音转文字 + 反馈区 -- **抽背报告页**:正确率环形图 + 错误题目列表 + 复习建议 + 操作按钮(返回、分享、重新抽背) -- **记忆曲线界面**:复习计划日历 + 记忆强度曲线 + 复习优先级标记 -- **后台管理界面**:数据概览卡片 + 详细数据表格 + 可视化图表 - -**技术要求:** -- 语音识别准确率 > 95% -- AI 答案判定准确率 > 90% -- 记忆曲线算法基于艾宾浩斯遗忘曲线 -- 避免在 22:00-8:00 推送提醒 - ---- - -#### 模块 5:要点背诵 - -| 子功能 | 优先级 | 描述 | -|--------|--------|------| -| **5.1 文字抽背(卡片式)** | P0 | 知识点卡片形式展示\n左右滑动切换卡片\n标记"已记住"/"未记住"\n未记住卡片自动进入待复习列表 | -| **5.2 音频带背(挖空交互)** | P1 | 知识点挖空处理(如"麻黄汤的组成包括麻黄、桂枝、杏仁和______")\n"看答案"/"隐藏答案"按钮\n支持朗诵知识点(音频录制)\n填入答案后即时判断正误 | -| **5.3 关联试题** | P1 | 针对当前背诵知识点推荐关联试题\n点击跳转至试题页面 | - -**技术要求:** -- 卡片支持自定义背景色 -- 音频带背支持暂停/重播 -- 关联试题精准匹配知识点 - ---- - -## 📋 功能需求详细规格 - -### 功能需求概述 - -本产品包含 5 大核心模块,共 25+ 个子功能点。以下是详细的功能规格说明。 - -### 模块 1:用户管理(User Management) - -#### 1.1 注册登录(FR-UM-001) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-UM-001-01 | 手机号注册 | 输入手机号 → 接收验证码 → 验证通过 → 创建账号 | P0 | -| FR-UM-001-02 | 微信快捷登录 | 点击微信登录 → 授权 → 自动创建/绑定账号 | P0 | -| FR-UM-001-03 | QQ/微博登录 | 点击第三方登录 → 授权 → 自动创建/绑定账号 | P1 | -| FR-UM-001-04 | 自动登录 | 7天内免登录,Token 自动刷新 | P0 | - -**数据字段:** -- User.id(主键) -- User.phoneNumber(手机号,唯一) -- User.nickname(昵称) -- User.avatar(头像URL) -- User.thirdPartyAuth(第三方授权信息,JSON) - -#### 1.2 个人信息编辑(FR-UM-002) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-UM-002-01 | 头像上传 | 支持拍照/相册选择 → 自动裁剪压缩 → 上传成功 | P1 | -| FR-UM-002-02 | 昵称修改 | 2-20个字符,支持emoji,不可重复 | P1 | -| FR-UM-002-03 | 个人信息 | 性别、年级、学科偏好设置 | P1 | - -**约束条件:** -- 头像大小限制:< 5MB -- 支持格式:JPG、PNG、WEBP -- 头像自动压缩至 200x200px - -#### 1.3 账号设置(FR-UM-003) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-UM-003-01 | 修改密码 | 验证原密码 → 输入新密码 → 确认新密码 → 修改成功 | P1 | -| FR-UM-003-02 | 找回密码 | 手机验证码 → 设置新密码 | P0 | -| FR-UM-003-03 | 更换手机号 | 验证原手机号 → 验证新手机号 → 更换成功 | P1 | -| FR-UM-003-04 | 账号注销 | 确认注销 → 数据删除/匿名化 → 注销成功 | P0 | - ---- - -### 模块 2:收藏与分享(Favorite & Share) - -#### 2.1 题目收藏(FR-FS-001) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-FS-001-01 | 收藏题目 | 点击收藏图标 → 添加到收藏列表 → 反馈提示 | P0 | -| FR-FS-001-02 | 添加标签 | 收藏时可添加标签(如"高频考点") | P0 | -| FR-FS-001-03 | 按标签筛选 | 选择标签 → 显示该标签下所有收藏 | P0 | -| FR-FS-001-04 | 批量操作 | 长按进入编辑模式 → 批量删除/移动标签 | P1 | - -**数据字段:** -- Favorite.id(主键) -- Favorite.userId(用户ID,外键) -- Favorite.knowledgePointId(知识点ID,外键) -- Favorite.tags(标签,JSON数组) -- Favorite.createdAt(收藏时间) - -#### 2.2 分享功能(FR-FS-002) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-FS-002-01 | 分享题目 | 生成分享卡片(含题目+解析)→ 分享到微信 | P1 | -| FR-FS-002-02 | 分享抽背结果 | 生成成绩报告卡片 → 分享到朋友圈 | P1 | -| FR-FS-002-03 | 分享学习心得 | 自定义文字 + 成就徽章 → 分享 | P1 | -| FR-FS-002-04 | Deep Link | 点击分享链接 → 打开小程序对应页面 | P0 | - -**分享内容格式:** -``` -【AI 智能抽背助手】 -今天抽背了 20 道古诗词,正确率 85%! -已连续学习 7 天,获得"坚持达人"徽章 🏅 -快来一起学习吧! -[小程序卡片] -``` - ---- - -### 模块 3:任务制定(Study Task) - -#### 3.1 学习任务设置(FR-ST-001) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-ST-001-01 | 创建每日任务 | 设置任务描述(如"每天刷50道题")→ 保存 | P0 | -| FR-ST-001-02 | 设置任务时间 | 选择提醒时间点(如"每天晚上8点") | P0 | -| FR-ST-001-03 | 选择任务范围 | 选择学科/章节 → 设置题目数量 | P0 | -| FR-ST-001-04 | 编辑/删除任务 | 长按任务 → 编辑/删除选项 | P1 | - -**任务类型:** -- 每日抽背任务(AI 主动抽背) -- 每日复习任务(卡片复习) -- 每日练习任务(试题练习) - -#### 3.2 学习提醒(FR-ST-002) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-ST-002-01 | 推送提醒 | 到达设定时间 → 小程序消息推送 | P0 | -| FR-ST-002-02 | 提醒内容 | "小明同学,今天还有50道题未完成,加油!" | P0 | -| FR-ST-002-03 | 完成标记 | 完成任务 → 自动标记 → 取消当天后续提醒 | P0 | -| FR-ST-002-04 | 免打扰时段 | 22:00-8:00 不推送提醒 | P0 | - ---- - -### 模块 4:AI 语音抽背(核心模块) - -#### 4.1 抽背模式设定(FR-QZ-001) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-QZ-001-01 | 语音/文字输入选择 | 切换输入模式 → 保存偏好设置 | P0 | -| FR-QZ-001-02 | 选择抽背范围 | 选择学科/章节/错题本/收藏题 → 确认 | P0 | -| FR-QZ-001-03 | 抽背方式选择 | 顺序抽背 / 随机抽背 → 确认 | P0 | -| FR-QZ-001-04 | 抽背间隔设置 | 30秒 / 60秒 / 90秒 / 自定义 → 确认 | P0 | -| FR-QZ-001-05 | 题目数量设置 | 设置抽背题目数量(10/20/50/自定义) | P0 | - -#### 4.2 抽背过程交互(FR-QZ-002) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-QZ-002-01 | AI 语音提问 | AI 虚拟人物 → 语音播报题目 | P0 | -| FR-QZ-002-02 | 文字展示题目 | 题目文字同步显示 → 支持字体缩放 | P0 | -| FR-QZ-002-03 | 语音识别答案 | 用户说话 → 实时转文字 → 显示在屏幕 | P0 | -| FR-QZ-002-04 | AI 判断正误 | 对比答案 → 判断正确/错误/部分正确 | P0 | -| FR-QZ-002-05 | 错误反馈 | 错误时 → 显示正确答案 + 解析 → 语音播报 | P0 | -| FR-QZ-002-06 | 自动标记重背 | 答错题目 → 自动加入"待再次抽背"列表 | P0 | -| FR-QZ-002-07 | 暂停/继续 | 点击暂停 → 停止抽背 → 点击继续 → 恢复 | P0 | -| FR-QZ-002-08 | 退出确认 | 点击退出 → 确认对话框 → 确认后退出 | P0 | - -**交互流程:** -``` -1. AI 提问:"请背诵《望岳》" -2. 用户回答:"会当凌绝顶,一览众山小" -3. 实时转文字显示 -4. AI 判断:正确! -5. 反馈:"太棒了!完全正确!" - 或 -4. AI 判断:错误! -5. 反馈:"很接近,但少了'会当凌绝顶,'" -``` - -#### 4.3 抽背结果反馈(FR-QZ-003) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-QZ-003-01 | 生成抽背报告 | 正确率 + 错误题目 + 用时 + 知识点覆盖 | P0 | -| FR-QZ-003-02 | 正确率环形图 | 可视化显示正确率百分比 | P0 | -| FR-QZ-003-03 | 错误题目列表 | 列出所有答错题目 → 可点击查看详情 | P0 | -| FR-QZ-003-04 | 复习建议 | 基于错误率推荐复习重点 | P0 | -| FR-QZ-003-05 | 报告保存 | 报告自动保存30天 → 可查看历史报告 | P0 | -| FR-QZ-003-06 | 分享报告 | 生成分享卡片 → 分享到微信 | P1 | - -#### 4.4 记忆曲线助力(FR-QZ-004) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-QZ-004-01 | 艾宾浩斯算法 | 1天/3天/7天/15天 复习间隔 | P0 | -| FR-QZ-004-02 | 个性化调整 | 根据用户表现动态调整间隔 | P0 | -| FR-QZ-004-03 | 遗忘临界点提醒 | 在遗忘前推送复习提醒 | P0 | -| FR-QZ-004-04 | 记忆曲线可视化 | 图表显示记忆强度变化 | P0 | -| FR-QZ-004-05 | 复习计划日历 | 日历视图显示复习计划 | P0 | - -**复习间隔算法:** -``` -基础间隔:[1天, 3天, 7天, 15天, 30天] - -个性化调整: -- 答对 → 间隔 × 1.2 -- 答错 → 间隔 × 0.5 -- 犹豫 → 间隔 × 0.8 - -最小间隔:6小时 -最大间隔:90天 -``` - -#### 4.5 抽背内容后台查询(FR-QZ-005) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-QZ-005-01 | 用户抽背记录 | 按用户查询所有抽背记录 | P1 | -| FR-QZ-005-02 | 时间筛选 | 按日期范围筛选记录 | P1 | -| FR-QZ-005-03 | 数据导出 | 导出 Excel 格式数据 | P1 | -| FR-QZ-005-04 | 数据统计 | 正确率趋势图、活跃度统计 | P1 | - ---- - -### 模块 5:要点背诵(Key Point Recitation) - -#### 5.1 文字抽背卡片(FR-KP-001) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-KP-001-01 | 知识点卡片展示 | 卡片正面显示问题,背面显示答案 | P0 | -| FR-KP-001-02 | 左右滑动切换 | 左滑标记"已记住",右滑标记"未记住" | P0 | -| FR-KP-001-03 | 点击翻面 | 点击卡片 → 翻转显示答案 | P0 | -| FR-KP-001-04 | 未记住自动复习 | 未记住卡片 → 自动加入待复习列表 | P0 | -| FR-KP-001-05 | 卡片进度 | 显示当前卡片位置(如"15/50") | P0 | -| FR-KP-001-06 | 自定义背景 | 选择卡片背景颜色/图片 | P1 | - -#### 5.2 音频带背挖空(FR-KP-002) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-KP-002-01 | 知识点挖空 | 自动识别关键词 → 挖空处理(如"麻黄、桂枝、杏仁和____") | P1 | -| FR-KP-002-02 | 看答案按钮 | 点击 → 显示挖空处答案 | P1 | -| FR-KP-002-03 | 隐藏答案按钮 | 点击 → 隐藏答案 | P1 | -| FR-KP-002-04 | 音频录制 | 用户录制自己背诵 → 保存 | P1 | -| FR-KP-002-05 | 填入答案判断 | 输入答案 → 即时判断正误 | P1 | -| FR-KP-002-06 | 音频播放控制 | 播放/暂停/重播/语速调节 | P1 | - -#### 5.3 关联试题(FR-KP-003) - -| 需求ID | 功能描述 | 验收标准 | 优先级 | -|--------|---------|---------|--------| -| FR-KP-003-01 | 推荐关联试题 | 背诵知识点 → 推荐相关试题 | P1 | -| FR-KP-003-02 | 点击跳转 | 点击试题 → 跳转至试题页面 | P1 | -| FR-KP-003-03 | 精准匹配 | 试题与知识点精准对应 | P1 | -| FR-KP-003-04 | 难度分级 | 试题按难度分级(简单/中等/困难) | P1 | - ---- - -### 功能需求总结 - -| 模块 | P0 功能 | P1 功能 | 总计 | -|------|---------|---------|------| -| 用户管理 | 4 | 7 | 11 | -| 收藏与分享 | 5 | 3 | 8 | -| 任务制定 | 8 | 2 | 10 | -| AI 语音抽背 | 24 | 4 | 28 | -| 要点背诵 | 11 | 7 | 18 | -| **合计** | **52** | **23** | **75** | - ---- - -### 增长功能(MVP 后期 / Phase 2) - -| 功能 | 描述 | -|------|------| -| **学习统计模块** | 数据可视化\n学习报告生成\n学习成就系统(徽章、排行榜) | -| **社区互动模块** | 题目分享社区\n评论、点赞功能\n用户关注系统 | -| **模拟考试模块** | 智能组卷\n计时考试\n成绩分析 | - ---- - -### 愿景功能(未来 / Phase 3+) - -| 功能 | 描述 | -|------|------| -| **AI 学习助手** | 24/7 AI 答疑\n个性化学习路径推荐 | -| **多语言支持** | 支持英语、日语等多语言学习 | -| **VR/AR 学习** | 沉浸式学习体验 | - ---- - - -## ⚙️ 非功能需求 - -### 性能要求 - -| 指标 | 目标值 | 测量方法 | -|------|--------|---------| -| **API 响应时间** | P95 < 500ms | APM 监控(如 Sentry、DataDog) | -| **抽背交互延迟** | < 1s | 从用户说话到 AI 反馈的端到端延迟 | -| **页面加载时间** | 首屏 < 2s | Lighthouse 性能评分 | -| **语音识别延迟** | < 500ms | 从语音输入到文字显示 | -| **系统可用性** | > 99.5% | 月度 uptime 统计 | -| **并发支持** | 10,000 DAU | 压力测试验证 | - ---- - -### 安全性要求 - -| 要求 | 描述 | -|------|------| -| **数据加密** | 传输层加密(TLS 1.3)\n存储层加密(AES-256) | -| **身份认证** | JWT Token 认证\nToken 过期时间:7天\n支持 Refresh Token | -| **密码安全** | bcrypt 加密(cost factor >= 10)\n密码强度验证(至少8位,包含字母+数字) | -| **隐私合规** | 符合 GDPR、COPPA、FERPA\n用户数据可导出/删除(GDPR "Right to be Forgotten") | -| **内容审核** | AI 生成内容需经过敏感词过滤\n用户上传内容需人工审核机制 | -| **防护机制** | API 限流(100 req/min per user)\n防 SQL 注入、XSS 攻击 | - ---- - -### 可访问性要求 - -| 要求 | 描述 | -|------|------| -| **WCAG 2.1** | 达到 AA 级标准 | -| **屏幕阅读器** | 支持 VoiceOver、TalkBack | -| **字体大小** | 支持系统字体缩放(最大 200%) | -| **色彩对比度** | 文字与背景对比度 >= 4.5:1 | -| **语音交互** | 作为无障碍的补充交互方式 | - ---- - -### 兼容性要求 - -| 平台 | 版本要求 | -|------|----------| -| **微信** | 微信版本 >= 8.0 | -| **iOS** | iOS >= 13.0(iPhone 6s 及以上) | -| **Android** | Android >= 8.0(API Level 26) | -| **浏览器** | Chrome >= 90、Safari >= 14、Edge >= 90 | - ---- - -### 可维护性要求 - -| 要求 | 描述 | -|------|------| -| **代码质量** | TypeScript 严格模式\n单元测试覆盖率 > 80% | -| **文档** | API 文档(Swagger/OpenAPI)\n代码注释覆盖率 > 60% | -| **日志监控** | 结构化日志(JSON 格式)\n集成 Sentry 错误追踪 | -| **部署** | CI/CD 自动化部署\n支持蓝绿部署/金丝雀发布 | - ---- - -### 可用性要求 - -| 要求 | 描述 | 验收标准 | -|------|------|---------| -| **易学性** | 新用户首次使用无需帮助即可完成核心功能 | 80% 新用户在 5 分钟内完成首次抽背 | -| **效率性** | 熟练用户可快速完成常用操作 | 常用操作 < 3 次点击 | -| **容错性** | 操作错误时有明确提示和恢复机制 | 误操作可撤销或二次确认 | -| **满意度** | 用户对产品的整体满意度 | SUS 评分 > 75 | - -**NFR-US-001:易学性** -- 首次使用引导:3步引导流程 -- 功能提示:首次使用功能时显示气泡提示 -- 帮助中心:内置 FAQ 和视频教程 - -**NFR-US-002:效率性** -- 快捷操作:支持手势操作(左滑/右滑) -- 智能推荐:根据使用习惯推荐下一步操作 -- 批量操作:收藏、删除支持批量处理 - ---- - -### 数据要求 - -| 要求 | 描述 | -|------|------| -| **数据备份** | 每日自动备份,保留30天 | -| **数据恢复** | 支持 RTO < 1小时,RPO < 5分钟 | -| **数据导出** | 用户可导出个人数据(JSON/CSV 格式) | -| **数据删除** | 支持 GDPR "被遗忘权",30天内彻底删除 | -| **数据保留** | 抽背记录保留 1 年,报告保留 90 天 | - ---- - -### 国际化和本地化要求 - -| 要求 | 描述 | -|------|------| -| **语言支持** | MVP 阶段仅支持简体中文 | -| **时区处理** | 根据用户时区显示本地时间 | -| **货币显示** | 支持 CNY(人民币)显示 | -| **日期格式** | 支持中国日期格式(YYYY年MM月DD日) | - -**Phase 2 计划:** -- 支持繁体中文(台湾、香港) -- 支持英语(国际版) - ---- - -### 可测试性要求 - -| 要求 | 描述 | -|------|------| -| **单元测试** | 核心业务逻辑测试覆盖率 > 80% | -| **集成测试** | API 接口测试覆盖率 > 70% | -| **E2E 测试** | 核心用户旅程自动化测试 | -| **性能测试** | 每次发布前进行压力测试 | -| **安全测试** | 每季度进行渗透测试 | - ---- - -### 容量和扩展性要求 - -| 要求 | 描述 | -|------|------| -| **用户规模** | MVP 支持 10,000 DAU | -| **存储容量** | 每用户平均 50MB,支持 50万 用户 | -| **网络带宽** | API 峰值带宽 > 1 Gbps | -| **水平扩展** | 支持通过增加实例扩展容量 | -| **数据库扩展** | 支持读写分离和分库分表 | - -**扩展策略:** -- 应用层:无状态设计,支持水平扩展 -- 数据库层:主从复制,读写分离 -- 缓存层:Redis 集群 -- 文件存储:对象存储(OSS) - ---- - -### 监控和告警要求 - -| 要求 | 描述 | -|------|------| -| **应用监控** | APM 监控(响应时间、错误率、吞吐量) | -| **业务监控** | 用户活跃度、抽背完成率、付费转化率 | -| **系统监控** | CPU、内存、磁盘、网络 | -| **日志监控** | 错误日志实时告警 | -| **告警规则** | P0 级别 5分钟内响应,P1 级别 30分钟内响应 | - -**告警渠道:** -- 钉钉/企业微信群 -- 短信告警(仅 P0) -- 邮件告警(P0/P1) - ---- - -## 🏗️ 技术架构概览 - -### 前端技术栈 - -| 技术 | 用途 | -|------|------| -| **框架** | Next.js 14(App Router) | -| **UI 库** | React 18 + Tailwind CSS | -| **状态管理** | Zustand / Jotai | -| **语音识别** | Web Speech API / 微信语音识别 SDK | -| **数据可视化** | Recharts / ECharts | - -### 后端技术栈 - -| 技术 | 用途 | -|------|------| -| **框架** | NestJS(Node.js) | -| **数据库** | PostgreSQL 15+ | -| **缓存** | Redis 7+ | -| **对象存储** | MinIO(自托管) / AWS S3 | -| **AI 服务** | OpenAI API / Anthropic Claude API / Ollama(自托管) | -| **任务队列** | BullMQ(基于 Redis) | - -### 基础设施 - -| 组件 | 描述 | -|------|------| -| **容器化** | Docker + Docker Compose | -| **反向代理** | Nginx | -| **监控** | Prometheus + Grafana | -| **日志** | ELK Stack(Elasticsearch + Logstash + Kibana) | -| **CI/CD** | GitHub Actions | - ---- - -## 📊 数据模型概览 - -### 核心实体 - -| 实体 | 描述 | -|------|------| -| **User** | 用户(ID、昵称、头像、第三方账号绑定) | -| **KnowledgePoint** | 知识点(ID、标题、内容、学科、章节) | -| **QuizSession** | 抽背会话(ID、用户ID、开始时间、结束时间、正确率) | -| **QuizRecord** | 抽背记录(ID、会话ID、知识点ID、用户答案、正确性) | -| **ReviewPlan** | 复习计划(ID、用户ID、知识点ID、复习时间、记忆强度) | -| **Favorite** | 收藏(ID、用户ID、知识点ID、标签) | -| **StudyTask** | 学习任务(ID、用户ID、任务描述、提醒时间、完成状态) | - ---- - -## 🚀 下一步行动 - -### 立即行动 - -1. ✅ **UX 设计** - 创建界面原型和交互设计 -2. ✅ **技术架构设计** - 详细设计系统架构和数据模型 -3. ✅ **生成 Epics 和 Stories** - 将 PRD 拆分为可执行的开发任务 - -### 后续步骤 - -4. Sprint 0 规划 -5. 开始 MVP 开发 - ---- - -## 📝 变更记录 - -| 版本 | 日期 | 变更内容 | 作者 | -|------|------|---------|------| -| 1.0 | 2026-03-28 | 初始版本,完成 BMAD PRD 工作流前 6 步 | BMAD & Claude | -| 1.1 | 2026-03-28 | 完整版 PRD,完成全部 12 步 BMAD 工作流 | BMAD & Claude | - ---- - -## ✅ PRD 完成总结 - -### BMAD 工作流完成状态 - -| 步骤 | 名称 | 状态 | 说明 | -|------|------|------|------| -| step-01 | Init | ✅ | 项目初始化,配置加载 | -| step-02 | Discovery | ✅ | 需求发现,文档加载 | -| step-02b | Vision | ✅ | 产品愿景定义 | -| step-02c | Executive Summary | ✅ | 执行摘要编写 | -| step-03 | Success Criteria | ✅ | 成功标准定义 | -| step-04 | User Journeys | ✅ | 用户旅程分析 | -| step-05 | Domain Analysis | ✅ | 领域分析(EdTech 行业) | -| step-06 | Innovation Analysis | ✅ | 创新分析(4 大核心创新) | -| step-07 | Project Type | ✅ | 项目类型确认(微信小程序) | -| step-08 | Scoping | ✅ | 范围界定(MVP + 增长 + 愿景) | -| step-09 | Functional Requirements | ✅ | 功能需求详细规格(75 个功能点) | -| step-10 | Non-Functional Requirements | ✅ | 非功能需求(9 大类别) | -| step-11 | Polish | ✅ | 文档润色和优化 | -| step-12 | Complete | ✅ | 完成标记和验证 | - -### PRD 文档内容概览 - -**本文档包含以下完整内容:** - -#### 1. 产品定义 -- ✅ 产品愿景和价值主张 -- ✅ 目标用户(K12 学生、大学生、职业考生) -- ✅ 核心差异化(AI 驱动的个性化遗忘曲线) - -#### 2. 领域分析 -- ✅ EdTech 行业背景和市场规模 -- ✅ 目标领域细分 -- ✅ 竞品分析(Anki、百词斩、Quizlet) -- ✅ 领域特定挑战(隐私保护、内容质量、认知科学) -- ✅ 监管合规要求 - -#### 3. 创新分析 -- ✅ AI 驱动的个性化遗忘曲线 -- ✅ 主动式 AI 语音对话抽背 -- ✅ 知识图谱智能关联 -- ✅ 双模式学习设计 - -#### 4. 成功标准 -- ✅ 用户成功(考试成功时刻) -- ✅ 商业成功(留存率、活跃度、病毒系数、付费转化) -- ✅ 技术成功(AI 准确率、系统性能、记忆曲线算法) - -#### 5. 功能需求(75 个功能点) -- ✅ 模块 1:用户管理(11 个功能) -- ✅ 模块 2:收藏与分享(8 个功能) -- ✅ 模块 3:任务制定(10 个功能) -- ✅ 模块 4:AI 语音抽背(28 个功能) -- ✅ 模块 5:要点背诵(18 个功能) - -#### 6. 非功能需求(9 大类别) -- ✅ 性能要求(API 响应、交互延迟、系统可用性) -- ✅ 安全性要求(数据加密、身份认证、隐私合规) -- ✅ 可访问性要求(WCAG 2.1 AA 级) -- ✅ 兼容性要求(微信、iOS、Android) -- ✅ 可维护性要求(代码质量、文档、日志监控) -- ✅ 可用性要求(易学性、效率性、容错性、满意度) -- ✅ 数据要求(备份、恢复、导出、删除) -- ✅ 国际化和本地化要求 -- ✅ 可测试性要求 -- ✅ 容量和扩展性要求 -- ✅ 监控和告警要求 - -#### 7. 技术架构 -- ✅ 前端技术栈(Next.js 14、React 18、Tailwind CSS) -- ✅ 后端技术栈(NestJS、PostgreSQL、Redis、AI API) -- ✅ 基础设施(Docker、Nginx、Prometheus、ELK) -- ✅ 数据模型概览(7 个核心实体) - -### 文档统计 - -| 指标 | 数值 | -|------|------| -| **总行数** | ~1000+ 行 | -| **章节数** | 15 个主要章节 | -| **功能需求** | 75 个(P0: 52, P1: 23) | -| **非功能需求** | 9 大类别,50+ 条具体要求 | -| **用户旅程** | 3 个完整场景 + 1 个故障恢复场景 | - -### 下一步行动 - -**推荐优先级:** - -1. **UX 设计** 🎨 - - 创建界面原型 - - 设计交互流程 - - 定义设计系统 - -2. **技术架构设计** 🏗️ - - 详细系统架构设计 - - 数据库设计(ER 图) - - API 接口设计 - -3. **生成 Epics 和 Stories** 📋 - - 将 PRD 拆分为 Epics - - 创建可执行的 User Stories - - 定义验收标准 - -4. **Sprint 0 规划** 🚀 - - 团队组建 - - 开发环境搭建 - - 第一批 Story 估算 - ---- - -**PRD 文档已完成!** 🎉 - -所有 12 步 BMAD PRD 创建工作流已全部完成,文档已通过完整性和一致性验证。 - -**使用 BMAD 技能继续:** -- 创建 UX 设计:`lets create UX design` -- 创建技术架构:`lets create architecture` -- 生成 Epics 和 Stories:`create the epics and stories list` - ---- diff --git a/planning-artifacts/ux-design-specification.md b/planning-artifacts/ux-design-specification.md deleted file mode 100644 index 1a38f74..0000000 --- a/planning-artifacts/ux-design-specification.md +++ /dev/null @@ -1,1094 +0,0 @@ ---- -stepsCompleted: ['step-01-init', 'step-02-discovery', 'step-03-core-experience', 'step-04-emotional-response', 'step-05-inspiration', 'step-06-design-system', 'step-07-defining-experience', 'step-08-visual-foundation', 'step-09-design-directions', 'step-10-user-journeys', 'step-11-component-strategy', 'step-12-ux-patterns', 'step-13-responsive-accessibility', 'step-14-complete'] -inputDocuments: - - path: '/mnt/code/226-244-template-6/ai-tutor-requirements.md' - type: 'requirements' - loadedAt: '2026-03-28T13:00:00Z' -documentCounts: - briefs: 0 - prds: 0 - projectDocs: 1 -workflowType: 'ux-design' -projectName: 'AI 智能抽背助手' -author: 'BMAD & Claude' -date: '2026-03-28' -lastStep: 14 -status: 'complete' ---- - -# UX 设计规范 - AI 智能抽背助手 - -**作者:** BMAD & Claude -**日期:** 2026-03-28 -**版本:** 1.0 -**状态:** 已完成 - ---- - -## 执行摘要 - -### 项目愿景 - -AI 智能抽背助手是一款面向考研、医学考试等学习场景的微信小程序,通过 AI 智能抽背、艾宾浩斯记忆曲线、卡片式学习和挖空填空等多种学习模式,帮助用户高效记忆知识点,提升学习效果。 - -### 目标用户 - -**主要用户群体:** -- 考研学生:需要系统化复习和记忆大量知识点 -- 医学考生:需要记忆方剂、中药、病理等专业内容 -- 其他应试学习者:需要高效记忆方法的学习者 - -**用户特征:** -- 学习压力大,时间紧张 -- 需要科学的学习方法辅助 -- 对移动端学习有强烈需求 -- 重视学习效果反馈 - -### 核心设计挑战 - -1. **学习效率与体验平衡**:如何让抽背过程既高效又不枯燥? -2. **记忆曲线可视化**:如何将抽象的记忆曲线直观呈现给用户? -3. **多模式学习统一性**:如何确保卡片式、挖空、语音抽背等不同模式体验一致? -4. **个性化与标准化**:如何平衡个性化推荐与标准化学习路径? - -### 设计机会 - -1. **游戏化学习**:通过成就、进度等元素提升学习动力 -2. **智能推荐**:基于遗忘曲线的精准复习提醒 -3. **社交学习**:分享学习成果,与同伴竞争 -4. **情感化设计**:通过友好的AI助教角色减轻学习压力 - ---- - -## 1. 核心用户体验 - -### 1.1 核心体验定义 - -**"一键开启智能抽背,让记忆更科学"** - -AI 智能抽背助手的核心体验是让用户通过最简单的操作——点击"开始抽背"按钮,即可进入由 AI 驱动的智能抽背流程。系统会根据用户的学习历史、记忆曲线状态,自动选择最适合的知识点进行抽背,并实时反馈学习效果。 - -### 1.2 平台策略 - -**主要平台:** 微信小程序 - -**选择理由:** -- 用户无需下载安装,降低使用门槛 -- 与微信生态无缝集成(分享、通知) -- 跨平台一致性体验 -- 开发和维护成本可控 - -**次要平台:** 后台管理系统(Web端) - -**平台特性:** -- 移动端优先设计 -- 触摸为主,语音为辅 -- 支持离线模式(缓存题库) -- 响应式布局适配不同屏幕 - -### 1.3 无缝交互设计 - -**一键启动抽背:** -- 首页大按钮"开始抽背",点击即可进入抽背流程 -- 系统自动选择抽背范围(基于学习进度和遗忘曲线) -- 无需复杂配置,开箱即用 - -**智能语音交互:** -- 点击麦克风按钮即可语音回答 -- 实时语音转文字,用户可见回答内容 -- AI 即时判断正误,无需等待 - -**流畅卡片切换:** -- 左右滑动切换卡片 -- 点击"已记住"/"未记住"自动进入下一题 -- 进度实时显示,心中有数 - -### 1.4 关键成功时刻 - -1. **首次启动成功**:新用户打开小程序,3秒内理解如何开始抽背 -2. **首次正确反馈**:用户首次回答问题,AI 给出即时正向反馈 -3. **记忆曲线生效**:用户收到遗忘点提醒,复习后感觉"真的记住了" -4. **学习成果可见**:用户查看抽背报告,看到自己的进步曲线 -5. **社交分享时刻**:用户分享学习成果到朋友圈,获得点赞 - -### 1.5 体验设计原则 - -1. **简洁至上**:减少操作步骤,让用户专注于学习本身 -2. **即时反馈**:每个操作都有清晰的视觉或听觉反馈 -3. **智能辅助**:AI 在后台默默优化,前台体验自然流畅 -4. **正向激励**:通过成就、进度、鼓励性语言提升学习动力 -5. **科学记忆**:基于艾宾浩斯记忆曲线,让复习更高效 - ---- - -## 2. 情感响应设计 - -### 2.1 主要情感目标 - -**核心情感:自信与掌控** - -用户在使用 AI 智能抽背助手时,应该感到: -- **自信**:相信自己的学习方法是科学的 -- **掌控**:清楚自己的学习进度和薄弱环节 -- **高效**:时间用在刀刃上,不浪费 -- **鼓励**:即使答错也能得到正向引导 - -### 2.2 情感旅程映射 - -| 阶段 | 用户情感 | 设计响应 | -|------|---------|---------| -| 发现产品 | 好奇与期待 | 简洁的首页,清晰的价值主张 | -| 首次使用 | 紧张与不确定 | 友好的AI助教引导语,详细的操作提示 | -| 核心学习 | 专注与投入 | 沉浸式界面,减少干扰元素 | -| 答题正确 | 成就与满足 | 明确的成功反馈(绿色勾号+鼓励文字) | -| 答题错误 | 挫败与困惑 | 温和的错误提示+正确答案+解析 | -| 完成学习 | 成就与轻松 | 详细的报告,可视化的进步 | -| 收到提醒 | 被关心与重视 | 个性化的提醒语,明确复习内容 | -| 长期使用 | 信任与依赖 | 稳定的体验,持续的学习效果 | - -### 2.3 微情感设计 - -| 情感维度 | 正向目标 | 负向避免 | 设计实现 | -|---------|---------|---------|---------| -| 信心 | 清晰的进度指示 | 不确定性 | 实时进度条、已完成计数 | -| 信任 | 准确的记忆预测 | 失败的预测 | 基于真实数据的科学算法 | -| 激励 | 成就感、进步感 | 平淡无奇 | 徽章系统、进度对比图 | -| 宽慰 | 友好的错误提示 | 打击感 | 温和的红色提示、鼓励文字 | -| 期待 | 对下一次学习的期待 | 厌倦感 | 多样化的学习模式、惊喜元素 | - -### 2.4 情感设计原则 - -1. **错误不是失败**:答错时强调"学习机会"而非"失败" -2. **进步可视化**:通过图表、数字让进步看得见 -3. **个性化关怀**:AI 助教使用用户昵称,针对性鼓励 -4. **庆祝小成就**:每完成一个小目标都有庆祝反馈 -5. **长期陪伴**:记忆曲线提醒体现"我一直在关心你" - ---- - -## 3. UX 模式分析与灵感 - -### 3.1 灵感产品分析 - -**Anki (间隔重复学习)** -- 可借鉴:成熟的间隔重复算法,卡片翻转交互 -- 创新点:加入 AI 语音抽背,更丰富的反馈 - -**Quizlet (学习卡片)** -- 可借鉴:简洁的卡片界面,多种学习模式 -- 创新点:基于艾宾浩斯曲线的智能提醒,挖空填空 - -**Duolingo (游戏化学习)** -- 可借鉴:成就系统,进度可视化,连续学习打卡 -- 创新点:应用到知识记忆场景,社交分享 - -**Notion (知识管理)** -- 可借鉴:清晰的分类结构,灵活的内容组织 -- 创新点:专门为学习优化的知识点管理 - -### 3.2 可迁移的 UX 模式 - -**导航模式:** -- 底部三Tab导航(首页/智能抽背/我的)- 移动端标准模式 -- 卡片堆叠式浏览 - 类似 Anki 的卡片复习 -- 滑动切换手势 - 提升操作效率 - -**交互模式:** -- 点击+滑动混合操作 - 降低学习成本 -- 语音按钮长按录音 - 符合用户对语音交互的预期 -- 双按钮选择(已记住/未记住)- 简化决策 - -**视觉模式:** -- 大字号题目显示 - 突出核心内容 -- 进度环/进度条 - 清晰的进度感知 -- 颜色编码(绿色=正确,红色=错误,橙色=待复习)- 快速识别 - -**反馈模式:** -- 即时反馈动画 - 提升操作满足感 -- 详细解析展开 - 按需获取更多信息 -- 报告可视化图表 - 一目了然的学习效果 - -### 3.3 避免的反模式 - -1. **复杂的初始设置**:不要让用户在首次使用时做大量配置 -2. **隐藏的进度信息**:不要让用户猜测自己的学习进度 -3. **突兀的错误提示**:不要用刺眼的红色或严厉的措辞 -4. **单一的学习模式**:不要强制用户只用一种方式学习 -5. **缺失的离线支持**:不要让网络问题影响学习连续性 - -### 3.4 设计灵感策略 - -**直接采用:** -- Anki 的间隔重复算法(基于艾宾浩斯曲线) -- 移动端标准的底部导航模式 -- 卡片翻转/展开交互 - -**创新改进:** -- AI 语音抽背(语音识别+语义理解) -- 挖空填空交互(音频+填空双重输入) -- 记忆曲线可视化(让遗忘曲线看得见) - -**完全创新:** -- AI 助教角色(拟人化的学习伙伴) -- 多模式融合抽背(语音+卡片+挖空) -- 智能考点推荐(基于错题和薄弱点) - ---- - -## 4. 设计系统选择 - -### 4.1 设计系统决策 - -**选择:微信小程序原生设计语言 + Vant Weapp 组件库** - -### 4.2 选择理由 - -1. **平台一致性**:完全符合微信小程序设计规范,用户零学习成本 -2. **开发效率**:Vant Weapp 提供丰富的组件,加速开发 -3. **成熟稳定**:经过大量项目验证,稳定可靠 -4. **文档完善**:社区活跃,问题容易解决 -5. **定制能力**:支持主题定制,可满足品牌化需求 - -### 4.3 实施方法 - -**组件使用策略:** -- 基础组件(Button、Cell、Icon等):直接使用 Vant -- 业务组件(抽背卡片、挖空填空等):自定义开发 -- 布局组件(Flex、Grid等):基于 Vant 定制 - -**主题定制:** -- 使用 CSS 变量定义品牌色 -- 覆盖 Vant 默认样式变量 -- 保持组件交互行为不变 - -### 4.4 自定义策略 - -**需要自定义的组件:** -1. 抽背卡片组件(支持翻转、滑动) -2. 挖空填空组件(音频播放+填空交互) -3. 记忆曲线图表组件 -4. 语音波形动画组件 -5. AI 助教对话气泡组件 - ---- - -## 5. 核心交互体验 - -### 5.1 定义性体验 - -**"点击麦克风,说出答案,AI 即时反馈"** - -这是 AI 智能抽背助手区别于其他学习应用的核心交互。用户不需要打字,不需要点击选项,只需要像和真人对话一样说出答案,AI 就能理解并给出反馈。 - -### 5.2 用户心智模型 - -**用户对抽背的预期:** -- 像老师提问一样自然 -- 可以用自己的话回答,不用死记硬背 -- 答错了能得到解释,不只是对错 -- 不会的内容会被标记,稍后会再问 - -**当前解决方案的痛点:** -- 需要自己安排复习时间 -- 不知道哪些内容快忘了 -- 复习时没有针对性 -- 缺乏学习成就感 - -### 5.3 成功标准 - -用户说"这个好用了"的时刻: -- **语音识别准确**:说的话能被正确识别 -- **语义理解到位**:AI 理解回答的意思,不只是关键词匹配 -- **反馈及时**:回答后立刻得到反馈 -- **解析有用**:错误时给出的解析真的能帮助理解 -- **再复习有效**:被标记的内容真的在合适时机再次出现 - -### 5.4 新颖 vs 已知模式 - -**使用已知模式:** -- 语音按钮:符合用户对语音输入的预期 -- 即时反馈:用户对"立刻知道结果"有明确预期 - -**创新点:** -- 语义理解:不只是关键词匹配,而是理解回答的含义 -- 记忆曲线集成:复习提醒基于科学算法,不是随机 -- 多模式融合:语音、卡片、挖空无缝切换 - -### 5.5 体验机制详解 - -**1. 启动阶段** -- 触发:点击"开始抽背"按钮 -- 反馈:页面转场动画,进入抽背界面 -- AI 助教:显示问候语"你好!我是你的AI助教,今天我们来复习XX内容" - -**2. 交互阶段** -- 提示:显示抽背题目(大字号,清晰易读) -- 输入:用户点击麦克风按钮,开始语音输入 -- 状态:按钮变为"正在倾听...",波形动画 -- 转换:实时显示语音转文字结果 -- 判断:AI 分析回答,判断正误 - -**3. 反馈阶段** -- 正确:绿色勾号 + "太棒了!回答正确" -- 错误:温和提示 + 正确答案 + 详细解析 -- 自动标记:错误内容自动加入"待复习"列表 - -**4. 完成阶段** -- 进度:显示"已完成X题,共Y题" -- 选项:继续抽背 / 查看报告 / 返回首页 -- 报告:生成详细报告(正确率、用时、错误分析) - ---- - -## 6. 视觉设计基础 - -### 6.1 色彩系统 - -**主色调(品牌色):** -- 主色:`#1890FF`(科技蓝)- 代表智慧、信任 -- 辅助色:`#52C41A`(成功绿)- 正确、已完成 -- 警告色:`#FAAD14`(提醒橙)- 待复习、警告 -- 错误色:`#F5222D`(错误红)- 错误、重要提示 - -**中性色:** -- 文字主色:`#262626`(深灰) -- 文字辅色:`#8C8C8C`(中灰) -- 文字禁用:`#BFBFBF`(浅灰) -- 背景色:`#FFFFFF`(纯白) -- 浅背景:`#F5F5F5`(浅灰) -- 分割线:`#E8E8E8`(极浅灰) - -**语义色应用:** -- 记忆状态:新学(蓝色)→ 复习中(橙色)→ 已掌握(绿色) -- 答题反馈:正确(绿色背景)、错误(浅红背景)、进行中(蓝色边框) - -### 6.2 字体系统 - -**字体家族:** -- 主字体:`-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif` -- 数字字体:`DIN Alternate, Roboto, sans-serif`(用于数据展示) - -**字号规范:** -| 用途 | 字号 | 行高 | 字重 | -|------|------|------|------| -| 大标题 | 24px | 1.3 | Medium | -| 标题 | 18px | 1.4 | Medium | -| 副标题 | 16px | 1.5 | Regular | -| 正文 | 14px | 1.6 | Regular | -| 辅助文字 | 12px | 1.5 | Regular | -| 说明文字 | 10px | 1.4 | Regular | - -### 6.3 间距与布局 - -**间距单位(8px基准):** -- xs: 4px -- sm: 8px -- md: 16px -- lg: 24px -- xl: 32px -- xxl: 48px - -**卡片内边距:** -- 标准卡片:16px -- 紧凑卡片:12px -- 宽松卡片:20px - -**元素间距:** -- 段落间距:16px -- 列表项间距:12px -- 表单字段间距:20px - -### 6.4 无障碍考虑 - -- 所有文字与背景对比度 ≥ 4.5:1(WCAG AA标准) -- 触摸目标最小尺寸:44x44px -- 支持系统字体缩放 -- 颜色不作为唯一的信息传递方式 - ---- - -## 7. 设计方向决策 - -### 7.1 设计方向选择 - -**选择方向:简洁专业型** - -采用简洁的白底为主色调,辅以蓝色品牌色,突出内容本身,减少视觉干扰。整体风格专业、可信,符合教育产品的定位。 - -### 7.2 设计原则 - -1. **内容为王**:知识点内容占据最大视觉比重 -2. **层次清晰**:通过字号、颜色、间距建立清晰的信息层级 -3. **操作明确**:主要操作按钮大而醒目,次要操作低调 -4. **反馈及时**:每个操作都有视觉或动画反馈 -5. **情感友好**:使用圆角、柔和的色彩降低学习的紧张感 - -### 7.3 核心界面设计方向 - -**首页:** -- 顶部:学习概览卡片(今日数据) -- 中部:快速入口(4个抽背考点按钮) -- 底部:固定导航栏 - -**抽背界面:** -- 顶部:AI 助教引导语 -- 中部:当前题目(大字号) -- 底部:操作区(麦克风按钮+已记住/未记住) - -**报告页:** -- 顶部:核心数据(正确率大号显示) -- 中部:图表可视化 -- 底部:操作按钮 - -### 7.4 实施方法 - -- 使用 Vant Weapp 作为组件基础 -- 自定义业务组件时遵循相同的设计语言 -- 建立 Figma 设计规范文档 -- 开发前进行视觉评审 - ---- - -## 8. 用户旅程流程 - -### 8.1 首次使用旅程 - -```mermaid -graph TD - A[打开小程序] --> B[授权登录] - B --> C[完善个人信息] - C --> D[选择学习场景] - D --> E[AI 助教欢迎引导] - E --> F[首次抽背体验] - F --> G{体验如何?} - G -->|好| H[开始正式学习] - G -->|一般| I[调整设置] - H --> J[完成首次抽背] - I --> F - J --> K[查看首次报告] - K --> L[设置学习提醒] - L --> M[成为活跃用户] -``` - -### 8.2 日常抽背旅程 - -```mermaid -graph TD - A[打开小程序] --> B[首页查看今日任务] - B --> C{有提醒?} - C -->|是| D[点击去背诵] - C -->|否| E[点击开始抽背] - D --> F[进入抽背界面] - E --> F - F --> G[查看题目] - G --> H{选择回答方式} - H -->|语音| I[点击麦克风] - H -->|文字| J[点击文字输入] - I --> K[语音回答] - J --> L[文字回答] - K --> M[AI 判断] - L --> M - M --> N{正确?} - N -->|是| O[绿色反馈] - N -->|否| P[红色反馈+解析] - O --> Q{继续?} - P --> Q - Q -->|是| R[下一题] - Q -->|否| S[查看报告] - R --> G - S --> T[报告分析] - T --> U[退出/分享] -``` - -### 8.3 挖空填空旅程 - -```mermaid -graph TD - A[选择音频带背] --> B[进入挖空界面] - B --> C[播放原声音频] - C --> D[显示挖空题目] - D --> E[查看选项] - E --> F[点击选择答案] - F --> G{是否正确?} - G -->|是| H[填入正确] - G -->|否| I[提示错误] - H --> J{完成所有填空?} - I --> E - J -->|否| E - J -->|是| K[显示完整答案] - K --> L{已记住?} - L -->|是| M[标记已记住] - L -->|否| N[标记未记住] - M --> O[下一题] - N --> O -``` - -### 8.4 旅程模式 - -**导航模式:** -- 返回按钮:左上角,所有二级页面统一 -- 设置按钮:右上角,齿轮图标 -- 底部导航:首页/智能抽背/我的,固定 - -**决策模式:** -- 已记住/未记住:双按钮,互斥选择 -- 继续退出:模态弹窗确认 -- 答案选项:点击即选中,高亮显示 - -**反馈模式:** -- 即时反馈:操作后300ms内显示 -- 成功反馈:绿色+动画 -- 错误反馈:浅红色+解析 -- 加载状态:骨架屏或加载动画 - ---- - -## 9. 组件策略 - -### 9.1 设计系统组件(来自 Vant Weapp) - -**可直接使用:** -- Button(按钮):主操作、次操作、文字按钮 -- Cell(单元格):列表项、卡片内容 -- Icon(图标):状态图标、操作图标 -- Dialog(对话框):确认弹窗 -- Toast(轻提示):操作反馈 -- Loading(加载):加载状态 -- Progress(进度条):学习进度 - -**需要定制:** -- 调整颜色变量以符合品牌色 -- 调整圆角、间距以符合设计规范 - -### 9.2 自定义组件 - -#### 9.2.1 抽背卡片组件 (QuizCard) - -**用途:** 显示抽背题目,支持翻转和滑动 - -**状态:** -- 默认:显示题目 -- 翻转:显示答案和解析 -- 正确:绿色高亮 -- 错误:红色高亮 - -**交互:** -- 点击卡片:翻转查看答案 -- 左右滑动:切换上一题/下一题 -- 长按:显示操作菜单 - -#### 9.2.2 挖空填空组件 (FillBlank) - -**用途:** 音频带背挖空填空交互 - -**结构:** -- 题目区域:带下划线的挖空处 -- 音频按钮:播放原声 -- 选项区域:圆形按钮网格 -- 操作按钮:显示答案/已记住 - -**交互:** -- 点击选项:填入挖空处 -- 播放音频:显示播放状态 -- 完成填空:验证答案 - -#### 9.2.3 记忆曲线组件 (MemoryCurve) - -**用途:** 可视化展示记忆强度和复习时间点 - -**结构:** -- 曲线图:记忆强度变化 -- 标记点:复习时间点 -- 当前位置:用户当前所处阶段 - -**交互:** -- 点击标记点:查看该次复习详情 -- 长按曲线:显示数据详情 - -#### 9.2.4 AI 助教组件 (AITutor) - -**用途:** 显示 AI 助教的对话和引导 - -**结构:** -- 头像:AI 助教形象 -- 气泡:对话内容 -- 动画:说话时的波形动画 - -**交互:** -- 点击头像:播放问候语 -- 长按气泡:复制内容 - -### 9.3 实施路线图 - -**第一阶段(核心组件):** -- 抽背卡片组件 - 所有抽背模式的基础 -- 挖空填空组件 - 音频带背核心 -- AI 助教组件 - 品牌特色 - -**第二阶段(支持组件):** -- 记忆曲线组件 - 数据可视化 -- 报告图表组件 - 学习效果展示 -- 提醒设置组件 - 个性化配置 - -**第三阶段(增强组件):** -- 社交分享组件 - 分享学习成果 -- 排行榜组件 - 竞争激励 -- 成就徽章组件 - 游戏化元素 - ---- - -## 10. UX 一致性模式 - -### 10.1 按钮层级 - -**主要按钮(Primary Button):** -- 用途:页面主要操作(开始抽背、提交答案等) -- 样式:品牌色背景,白色文字,圆角8px -- 尺寸:高度44px,宽度自适应或全宽 - -**次要按钮(Secondary Button):** -- 用途:辅助操作(查看详情、取消等) -- 样式:白色背景,品牌色边框,品牌色文字 -- 尺寸:高度44px - -**文字按钮(Text Button):** -- 用途:低优先级操作(跳过、稍后等) -- 样式:透明背景,灰色文字 -- 尺寸:高度40px - -### 10.2 反馈模式 - -**成功反馈:** -- 图标:绿色勾号 -- 文字:描述性成功信息 -- 动画:勾号弹出动画 -- 位置:页面中心或顶部 - -**错误反馈:** -- 图标:红色叉号或感叹号 -- 文字:温和的错误描述+解决建议 -- 背景:浅红色(#FFF2F0) -- 位置:相关元素附近 - -**警告反馈:** -- 图标:橙色感叹号 -- 文字:警告信息 -- 背景:浅橙色(#FFF7E6) -- 位置:顶部提示栏 - -**信息反馈:** -- 图标:蓝色信息图标 -- 文字:提示信息 -- 背景:浅蓝色(#E6F7FF) -- 位置:页面顶部 - -### 10.3 表单模式 - -**输入框:** -- 默认状态:灰色边框,浅灰占位文字 -- 聚焦状态:品牌色边框 -- 错误状态:红色边框,错误提示文字 -- 禁用状态:灰色背景,不可编辑 - -**验证规则:** -- 即时验证:失去焦点时验证 -- 错误提示:输入框下方红色文字 -- 成功提示:绿色勾号图标 - -### 10.4 导航模式 - -**底部导航:** -- 3个Tab:首页、智能抽背、我的 -- 选中状态:品牌色图标+文字 -- 未选中状态:灰色图标+文字 -- 图标尺寸:24x24px -- 动画:选中时轻微放大 - -**返回导航:** -- 位置:所有二级页面左上角 -- 图标:向左箭头 -- 尺寸:44x44px点击区域 - -### 10.5 模态与弹窗 - -**确认弹窗:** -- 标题:描述操作 -- 内容:确认信息 -- 按钮:取消(左)/ 确定(右,品牌色) - -**底部操作面板:** -- 从底部滑入 -- 显示操作选项列表 -- 点击外部或取消关闭 - -### 10.6 空状态与加载 - -**空状态:** -- 图标:相关主题插画 -- 文字:描述性文字 -- 操作:引导用户操作 - -**加载状态:** -- 页面级:骨架屏 -- 组件级:加载动画 -- 按钮级:按钮内加载图标 - ---- - -## 11. 响应式与无障碍 - -### 11.1 响应式策略 - -**移动优先设计:** -- 基准设计:iPhone 12(390x844px) -- 小屏适配:iPhone SE(375x667px) -- 大屏优化:iPhone 14 Pro Max(430x932px) - -**断点策略:** -```css -/* 小屏手机 */ -@media (max-width: 374px) { } - -/* 标准手机 */ -@media (min-width: 375px) and (max-width: 413px) { } - -/* 大屏手机 */ -@media (min-width: 414px) { } - -/* 平板 */ -@media (min-width: 768px) { - /* 两栏布局,侧边导航 */ -} -``` - -**布局适配:** -- 小屏:单列布局,隐藏次要信息 -- 标准:单列布局,完整信息 -- 大屏:单列布局,增加留白 -- 平板:两栏布局,侧边导航 - -### 11.2 无障碍策略 - -**WCAG 2.1 AA 级别合规:** - -**色彩对比度:** -- 正常文字:至少 4.5:1 -- 大文字(18px+):至少 3:1 -- 图标/图形:至少 3:1 - -**键盘导航:** -- 所有交互元素可键盘访问 -- 清晰的焦点指示器 -- 合理的 Tab 顺序 -- Skip Links 跳过重复内容 - -**屏幕阅读器:** -- 语义化 HTML 结构 -- ARIA 标签和角色 -- Alt 文字描述图片 -- 状态变化通知 - -**触摸目标:** -- 最小尺寸:44x44px -- 间距:相邻目标至少8px间距 - -**其他:** -- 支持系统字体缩放(最大200%) -- 不依赖颜色传递信息 -- 表单错误关联提示 -- 动画可暂停(减少动画设置) - -### 11.3 测试策略 - -**响应式测试:** -- 真机测试:iPhone SE、12、14 Pro Max -- 微信开发者工具模拟器 -- 不同网络环境测试 - -**无障碍测试:** -- iOS VoiceOver 测试 -- Android TalkBack 测试 -- 色盲模拟器测试 -- 键盘导航测试 - ---- - -## 12. 6个核心界面详细设计 - -### 12.1 界面1:首页 - -**功能定位:** 学习入口与概览 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ 09:41 信号 电池 │ 状态栏 -├─────────────────────────────┤ -│ [考研 ▼] │ 场景选择 -├─────────────────────────────┤ -│ 学习概览(2026-03-13) │ 学习概览卡片 -│ 已记忆:128 未记忆:45 待复习:12 │ -├─────────────────────────────┤ -│ 学习计划制定 [您有新的任务] │ 任务模块 -│ [要点背诵] [卡片式抽背] │ -│ [音频带背(挖空)] │ -├─────────────────────────────┤ -│ 记忆曲线提醒 │ 记忆曲线卡片 -│ 临界点复习:麻黄汤功效 [去背诵]│ -├─────────────────────────────┤ -│ 高频考点 │ 高频考点卡片 -│ 高频考点1 [去学习] │ -├─────────────────────────────┤ -│ [首页] [智能抽背] [我的] │ 底部导航 -└─────────────────────────────┘ -``` - -**交互说明:** -- 场景选择:点击下拉切换学习场景(考研/医学/其他) -- 数字高亮:待复习数字用红色突出显示 -- 按钮点击:所有"去"字按钮跳转对应页面 - -### 12.2 界面2:知识点目录页 - -**功能定位:** 知识点列表导航 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ 09:41 信号 电池 │ -├─────────────────────────────┤ -│ [知识点目录] │ 卡片1 -│ │ -├─────────────────────────────┤ -│ [知识点目录] │ 卡片2 -│ │ -├─────────────────────────────┤ -│ [知识点目录] │ 卡片3 -│ │ -├─────────────────────────────┤ -│ [知识点目录] │ 卡片4 -│ │ -├─────────────────────────────┤ -│ [知识点目录] │ 卡片5 -│ │ -├─────────────────────────────┤ -│ [首页] [智能背诵] [我的] │ -└─────────────────────────────┘ -``` - -**交互说明:** -- 卡片点击:进入对应知识点详情页 -- 长按卡片:显示操作菜单(收藏/分享/移除) - -### 12.3 界面3:音频带背详情页(挖空) - -**功能定位:** 音频+挖空填空学习 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ [←] 音频带背(挖空) [⚙] │ 导航栏 -├─────────────────────────────┤ -│ 听音填空:方剂学 [播放原声] │ 题目标题 -├─────────────────────────────┤ -│ 麻黄汤的组成包括麻黄、桂枝、 │ -│ 杏仁和______,其核心功效为 │ 挖空题目 -│ ______、宣肺平喘,主治______证。│ -├─────────────────────────────┤ -│ 点击选择输入: │ 提示文字 -│ [甘草] [发汗解表] [风寒表实] [大枣]│ 选项 -│ [清热解毒] [ ] │ -├─────────────────────────────┤ -│ [显示答案] [已记住]│ 操作按钮 -├─────────────────────────────┤ -│ 下一题 │ 底部提示 -│ (方剂学):麻黄汤禁忌证 │ AI提示 -└─────────────────────────────┘ -``` - -**交互说明:** -- 播放原声:点击播放音频,显示播放进度 -- 填空:点击选项按钮,填入挖空处 -- 显示答案:展开显示完整答案 -- 已记住:标记掌握状态,进入下一题 - -### 12.4 界面4:卡片背诵详情页 - -**功能定位:** 卡片翻转学习 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ [×] 卡片背诵 [⚙] │ -├─────────────────────────────┤ -│ ━━━━━━━━━━━━━━━━━━━━━ 4/12 │ 进度条 -├─────────────────────────────┤ -│ ┌─────────────────────────┐ │ -│ │ │ │ -│ │ 阴阳失调的基本概念 │ │ 卡片 -│ │ │ │ -│ │ 点击查看详情 │ │ -│ │ │ │ -│ └─────────────────────────┘ │ -├─────────────────────────────┤ -│ [未记住] [已记住]│ -└─────────────────────────────┘ -``` - -**交互说明:** -- 点击卡片:翻转显示详细内容 -- 滑动:左滑上一张,右滑下一张 -- 未记住/已记住:标记状态并切换 - -### 12.5 界面5:答题详情页 - -**功能定位:** 选择题练习 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ [×] 答题 [⚙] │ -├─────────────────────────────┤ -│ ━━━━━━━━━━━━━━━━━━━━━ 4/12 │ -├─────────────────────────────┤ -│ ┌─────────────────────────┐ │ -│ │ 麻黄汤禁忌症() │ │ 题目卡片 -│ │ │ │ -│ │ ○ A. 选项 │ │ -│ │ ○ B. 选项 │ │ 选项 -│ │ ○ C. 选项 │ │ -│ │ ○ D. 选项 │ │ -│ └─────────────────────────┘ │ -├─────────────────────────────┤ -│ [未记住] [已记住]│ -└─────────────────────────────┘ -``` - -**交互说明:** -- 选择选项:点击即选中,高亮显示 -- 提交答案:选择后自动提交 -- 立即反馈:正确绿色,错误红色+解析 - -### 12.6 界面6:答题关联知识点页 - -**功能定位:** 关联知识点网格展示 - -**布局结构:** -``` -┌─────────────────────────────┐ -│ [×] 答题 [⚙] │ -├─────────────────────────────┤ -│ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐│ -│ │麻黄汤│ │桂枝 │ │杏仁 │ │甘草 ││ 知识点网格 -│ └─────┘ └─────┘ └─────┘ └─────┘│ -│ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐│ -│ │麻黄汤│ │桂枝 │ │杏仁 │ │甘草 ││ -│ └─────┘ └─────┘ └─────┘ └─────┘│ -├─────────────────────────────┤ -│ [有疑问] [返回题] │ -└─────────────────────────────┘ -``` - -**交互说明:** -- 点击卡片:进入对应知识点详情 -- 有疑问:提交疑问反馈 -- 返回题:返回答题页面 - ---- - -## 13. 后台管理界面设计 - -### 13.1 功能定位 - -班主任/管理员查看学生抽背数据,生成学习报告,管理学习内容。 - -### 13.2 布局结构 - -``` -┌──────────────────────────────────────────┐ -│ AI 智能抽背助手 - 后台管理 [管理员▼] │ -├──────────────────────────────────────────┤ -│ [数据概览] [学生管理] [内容管理] [系统设置]│ -├──────────────────────────────────────────┤ -│ │ -│ ┌────────────┐ ┌────────────┐ │ -│ │总抽背次数 │ │平均正确率 │ │ -│ │ 1,234 │ │ 78% │ │ -│ └────────────┘ └────────────┘ │ -│ │ -│ 筛选: [用户▼] [时间范围▼] [学科▼] │ -│ │ -│ ┌────────────────────────────────────┐ │ -│ │ 用户 │ 时间 │ 内容 │ 正确率│ 操作│ │ -│ ├──────┼────────┼──────┼───────┼────┤ │ -│ │ 张三 │03-28 │方剂学 │ 85% │详情│ │ -│ │ 李四 │03-28 │中药学 │ 72% │详情│ │ -│ │ ... │ ... │ ... │ ... │... │ │ -│ └────────────────────────────────────┘ │ -│ │ -│ [导出Excel] [发送报告] [批量提醒] │ -└──────────────────────────────────────────┘ -``` - -### 13.3 核心功能 - -1. **数据概览**:总抽背次数、平均正确率、活跃用户数 -2. **筛选查询**:按用户、时间、学科筛选 -3. **详细数据**:抽背记录列表,支持查看详情 -4. **数据导出**:导出Excel/CSV报告 -5. **报告发送**:发送报告给家长/学生 - ---- - -## 14. 交付清单 - -### 14.1 设计文档 - -- ✅ UX 设计规范(本文档) -- ✅ 6个核心界面详细设计 -- ✅ 用户旅程流程图 -- ✅ 组件规范文档 - -### 14.2 设计资源 - -- Figma 设计文件(待创建) -- 图标资源库(待整理) -- 图片素材规范(待定义) - -### 14.3 开发交付 - -- 设计系统文档(Vant Weapp + 自定义组件) -- 组件 API 文档 -- 样式变量表(CSS Variables) -- 无障碍合规检查清单 - ---- - -## 附录 - -### A. 术语表 - -| 术语 | 定义 | -|------|------| -| 抽背 | AI 提问,用户回答的学习模式 | -| 挖空 | 知识点中部分内容留空,需用户填入 | -| 记忆曲线 | 艾宾浩斯遗忘曲线,用于确定复习时间 | -| 知识点 | 学习的最小单元,如"麻黄汤功效" | - -### B. 参考资源 - -- 艾宾浩斯记忆曲线研究 -- WCAG 2.1 无障碍标准 -- 微信小程序设计规范 -- Vant Weapp 组件库文档 - -### C. 更新记录 - -| 日期 | 版本 | 更新内容 | -|------|------|----------| -| 2026-03-28 | 1.0 | 初始版本,完整UX设计规范 | - ---- - -**文档状态:** 已完成 -**下一步行动:** 视觉设计 / 原型制作 / 开发准备 diff --git a/prototype/README.md b/prototype/README.md deleted file mode 100644 index de74a73..0000000 --- a/prototype/README.md +++ /dev/null @@ -1,114 +0,0 @@ -# AI 智能抽背助手 - 原型系统 - -基于 PRD 和 UX 设计规范自动生成的原型系统。 - -## 📁 文件结构 - -``` -prototype/ -├── index.html # 统一入口页面 -├── admin-index.html # 平铺展示入口(所有页面同时显示) -├── docs-index.html # 文档中心 -├── server.js # 本地预览服务器 -├── start.sh # 启动脚本 -└── pages/admin/ - ├── dashboard.html # 数据概览 - ├── quiz-records.html # 抽背记录查询 - ├── student-management.html # 学生管理 - ├── knowledge-management.html # 知识点管理 - ├── task-management.html # 学习任务管理 - └── settings.html # 系统设置 -``` - -## 🚀 快速开始 - -### 方式一:使用 Node.js 服务器(推荐) - -```bash -# 进入原型目录 -cd prototype/ - -# 启动服务器 -node server.js - -# 或使用启动脚本(Linux/Mac) -./start.sh -``` - -服务器将在 `http://localhost:8080` 启动,浏览器会自动打开。 - -### 方式二:直接打开 HTML 文件 - -直接用浏览器打开以下任一文件: - -- `index.html` - 统一入口页面 -- `admin-index.html` - 平铺展示页面 -- `docs-index.html` - 文档中心 - -## 📄 页面说明 - -### 入口页面 - -| 页面 | 说明 | URL | -|------|------|-----| -| 统一入口 | 展示项目介绍和页面列表 | `/index.html` | -| 平铺展示 | 所有页面同时显示,一目了然 | `/admin-index.html` | -| 文档中心 | 查看 PRD、UX 设计规范等文档 | `/docs-index.html` | - -### 后台管理页面 - -| 页面 | 功能 | URL | -|------|------|-----| -| 数据概览 | 总抽背次数、平均正确率、活跃用户数、趋势图 | `/pages/admin/dashboard.html` | -| 抽背记录查询 | 按用户/时间筛选,数据表格,导出功能 | `/pages/admin/quiz-records.html` | -| 学生管理 | 学生列表,添加/编辑学生 | `/pages/admin/student-management.html` | -| 知识点管理 | 知识点列表,添加/编辑知识点 | `/pages/admin/knowledge-management.html` | -| 学习任务管理 | 任务列表,创建/编辑任务 | `/pages/admin/task-management.html` | -| 系统设置 | 基本设置、抽背设置、提醒设置、数据管理 | `/pages/admin/settings.html` | - -## 🎨 设计规范 - -### 色彩系统 - -| 颜色 | 用途 | 色值 | -|------|------|------| -| 主色 | 品牌、导航、按钮 | `#1890FF` | -| 成功色 | 正确、已完成 | `#52C41A` | -| 警告色 | 待复习、警告 | `#FAAD14` | -| 错误色 | 错误、重要提示 | `#F5222D` | -| 文字主色 | 主要文字 | `#262626` | -| 文字辅色 | 次要文字 | `#8C8C8C` | -| 背景色 | 页面背景 | `#FFFFFF` / `#F5F5F5` | - -### 字体规范 - -| 用途 | 字号 | 字重 | -|------|------|------| -| 大标题 | 24px | Medium | -| 标题 | 18px | Medium | -| 副标题 | 16px | Regular | -| 正文 | 14px | Regular | -| 辅助文字 | 12px | Regular | - -## 📚 参考文档 - -- [PRD 文档](../{output_folder}/planning-artifacts/prd.md) -- [UX 设计规范](../{output_folder}/planning-artifacts/ux-design-specification.md) -- [需求文档](../ai-tutor-requirements.md) - -## 🛠️ 技术栈 - -- **样式框架**: Tailwind CSS (CDN) -- **图标库**: Font Awesome 6.4.0 -- **字体**: 系统默认字体栈 - -## 📝 生成信息 - -- **生成工具**: generate-prototype-grid skill -- **生成日期**: 2026-03-28 -- **项目名称**: AI 智能抽背助手 -- **模式**: 桌面端管理后台 - ---- - -*本文档由 generate-prototype-grid 技能自动生成* diff --git a/prototype/admin-index.html b/prototype/admin-index.html deleted file mode 100644 index f37e9bd..0000000 --- a/prototype/admin-index.html +++ /dev/null @@ -1,181 +0,0 @@ - - - - - - AI 智能抽背助手 - 原型系统(平铺展示) - - - - - - -
-
-
-
- -
-

AI 智能抽背助手 - 原型系统

-

- 平铺展示模式 - 所有页面同时显示,一目了然 -

-
-
-
- -
-
- - -
-
-
-
- - 6 个页面 -
-
- - 桌面端模式 -
-
- - 后台管理系统 -
-
-
- 提示:每个 iframe 可独立滚动查看完整内容 -
-
-
- - -
- -
- 数据概览 - -
- - -
- 抽背记录查询 - -
- - -
- 学生管理 - -
- - -
- 知识点管理 - -
- - -
- 学习任务管理 - -
- - -
- 系统设置 - -
-
- - - - - diff --git a/prototype/docs-index.html b/prototype/docs-index.html deleted file mode 100644 index 2efd00e..0000000 --- a/prototype/docs-index.html +++ /dev/null @@ -1,329 +0,0 @@ - - - - - - 文档中心 - AI 智能抽背助手原型系统 - - - - - - - - - - -
-
-
-
-
-
-

文档数量

-

3

-
- -
-
-
-
-
-

页面数量

-

6

-
- -
-
-
-
-
-

功能模块

-

5

-
- -
-
-
-
-
-

更新日期

-

03-28

-
- -
-
-
-
-
- - -
-
-
- -
-

项目文档

- - -
-
-
-
-
-
-
-

产品需求文档 (PRD)

- 核心文档 -
-

完整的产品需求规格说明,包含项目愿景、功能需求、非功能需求、技术架构等

-
-
- -
-
-
-
-

行数

-

1,082 行

-
-
-

大小

-

40 KB

-
-
-

功能点

-

75 个

-
-
-
-
- 产品愿景 - 功能需求 - 技术架构 - 数据模型 -
- - 查看文档 - -
-
-
-
- - -
-
-
-
-
-
-
-

UX 设计规范

- 设计文档 -
-

用户体验设计规范,包含设计系统、组件规范、页面设计、响应式与无障碍等

-
-
- -
-
-
-
-

行数

-

1,094 行

-
-
-

大小

-

36 KB

-
-
-

界面数

-

6 个

-
-
-
-
- 设计系统 - 组件规范 - 色彩系统 - 无障碍 -
- - 查看文档 - -
-
-
-
- - -
-
-
-
-
-
-
-

需求文档

- 原始需求 -
-

原始需求文档,包含用户管理、收藏分享、任务制定、AI语音抽背、要点背诵等模块详细需求

-
-
- -
-
-
-
-

行数

-

1,092 行

-
-
-

大小

-

50 KB

-
-
-

模块数

-

5 个

-
-
-
-
- 用户管理 - 收藏分享 - 任务制定 - AI抽背 -
- - 查看文档 - -
-
-
-
-
- - -
-

快速导航

- - -

页面列表

- - -

设计规范

-
-

色彩系统

-
-
-
- 主色 #1890FF -
-
-
- 成功 #52C41A -
-
-
- 警告 #FAAD14 -
-
-
- 错误 #F5222D -
-
-
-
-
-
-
- - - - - - diff --git a/prototype/index.html b/prototype/index.html deleted file mode 100644 index 694f2b0..0000000 --- a/prototype/index.html +++ /dev/null @@ -1,310 +0,0 @@ - - - - - - AI 智能抽背助手 - 原型系统入口 - - - - - - - - - - -
-
-
- - 基于 PRD 和 UX 设计规范自动生成 -
-

AI 智能抽背助手

-

- 基于 AI 驱动的艾宾浩斯遗忘曲线算法,在用户即将遗忘知识点的关键时刻主动推送精准复习 -

- -
-
- - -
-
-
-

核心功能特性

-

基于 PRD 文档定义的 5 大核心模块

-
-
-
-
- -
-

AI 语音抽背

-

支持语音/文字输入提问,AI 即时判断正误,自动标记错误内容为"待再次抽背"

-
-
-
- -
-

记忆曲线助力

-

基于艾宾浩斯遗忘曲线,在遗忘临界点推送再次抽背提醒

-
-
-
- -
-

要点背诵

-

卡片式背诵、音频带背挖空、关联试题推荐,多种学习模式

-
-
-
- -
-

任务制定

-

自主设置学习任务,通过手机通知栏推送学习提醒

-
-
-
- -
-

收藏与分享

-

收藏重要题目,添加标签分类,支持分享到微信、QQ等平台

-
-
-
- -
-

后台管理

-

查看抽背记录、数据统计、内容管理、系统配置

-
-
-
-
- - -
- -
- - -
- -
- - - - - - diff --git a/prototype/markdown-template.html b/prototype/markdown-template.html deleted file mode 100644 index 1b750f4..0000000 --- a/prototype/markdown-template.html +++ /dev/null @@ -1,181 +0,0 @@ - - - - - - {{title}} - - - -
-

{{title}}

-
-
-
- {{content}} -
- -
- - diff --git a/prototype/md-view.html b/prototype/md-view.html deleted file mode 100644 index 607a665..0000000 --- a/prototype/md-view.html +++ /dev/null @@ -1,79 +0,0 @@ - - - - - - 文档查看器 - - - - - - - -
-
- -

正在加载文档...

-
- - -
- - - diff --git a/prototype/mobile-index.html b/prototype/mobile-index.html deleted file mode 100644 index 9d8e8fa..0000000 --- a/prototype/mobile-index.html +++ /dev/null @@ -1,140 +0,0 @@ - - - - - - 移动端原型 - AI智能抽背助手 - - - - - - -
-

AI智能抽背助手 - 移动端原型

-

微信小程序风格 | 375×812 手机框架 | 6个核心页面

-
- - - 平铺展示模式 - - - - 蓝紫渐变主题 - - - - AI语音交互 - -
-
- - -
- -
-

首页抽背

- -
- - -
-

AI智能抽背

- -
- - -
-

抽背报告

- -
- - -
-

记忆曲线

- -
- - -
-

卡片背诵

- -
- - -
-

个人中心

- -
-
- - -
-

移动端原型系统 | 基于需求文档生成

-

生成时间: 2026-03-28 | 设计风格: 微信小程序

-
- - diff --git a/prototype/pages/admin/dashboard.html b/prototype/pages/admin/dashboard.html deleted file mode 100644 index 7ac0ff8..0000000 --- a/prototype/pages/admin/dashboard.html +++ /dev/null @@ -1,302 +0,0 @@ - - - - - - 数据概览 - AI 智能抽背助手 - - - - - - - - -
- - - - -
-

数据概览

- - -
-
-
-
-

总抽背次数

-

12,458

-

- 12.5% -

-
-
- -
-
-
- -
-
-
-

平均正确率

-

78.6%

-

- 3.2% -

-
-
- -
-
-
- -
-
-
-

活跃用户数

-

1,286

-

- 8.3% -

-
-
- -
-
-
- -
-
-
-

今日抽背次数

-

892

-

- 2.1% -

-
-
- -
-
-
-
- - -
- -
-

正确率趋势(近7天)

-
-
-
- 周一 -
-
-
- 周二 -
-
-
- 周三 -
-
-
- 周四 -
-
-
- 周五 -
-
-
- 周六 -
-
-
- 周日 -
-
-
- - -
-

错误知识点 TOP 5

-
-
- 1 -
-
- 麻黄汤功效 - 42% -
-
-
-
-
-
-
- 2 -
-
- 阴阳失调基本概念 - 38% -
-
-
-
-
-
-
- 3 -
-
- 桂枝功效 - 31% -
-
-
-
-
-
-
- 4 -
-
- 杏仁功效 - 28% -
-
-
-
-
-
-
- 5 -
-
- 甘草功效 - 25% -
-
-
-
-
-
-
-
-
- - -
-
-

最新抽背记录

- 查看全部 -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
用户抽背内容正确率用时时间
张三方剂学 - 麻黄汤85%12分30秒2026-03-28 14:32
李四中医基础 - 阴阳学说72%8分15秒2026-03-28 14:28
王五中药学 - 解表药91%15分42秒2026-03-28 14:15
-
-
-
- - diff --git a/prototype/pages/admin/knowledge-management.html b/prototype/pages/admin/knowledge-management.html deleted file mode 100644 index 7f6b57b..0000000 --- a/prototype/pages/admin/knowledge-management.html +++ /dev/null @@ -1,302 +0,0 @@ - - - - - - 知识点管理 - AI 智能抽背助手 - - - - - - - -
- - - - -
-
-

知识点管理

- -
- - -
-
-
-
- -
-
-

知识点总数

-

3,456

-
-
-
-
-
-
- -
-
-

已发布

-

3,128

-
-
-
-
-
-
- -
-
-

草稿

-

328

-
-
-
-
-
-
- -
-
-

分类数

-

24

-
-
-
-
- - -
-
-
- - -
- - -
-
- - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - 知识点标题分类难度抽背次数正确率状态更新时间操作
麻黄汤的组成与功效 - 方剂学 - - 中等 - 1,234 - 68.5% - - 已发布 - 2026-03-28 -
- - - -
-
阴阳失调的基本概念 - 中医基础理论 - - 简单 - 986 - 82.3% - - 已发布 - 2026-03-27 -
- - - -
-
桂枝汤的主治病证 - 方剂学 - - 困难 - 756 - 54.2% - - 已发布 - 2026-03-26 -
- - - -
-
解表药的分类与功效 - 中药学 - - 中等 - 1,102 - 76.8% - - 草稿 - 2026-03-25 -
- - - -
-
银翘散与桑菊饮的区别 - 方剂学 - - 困难 - 623 - 61.5% - - 已发布 - 2026-03-24 -
- - - -
-
- - -
-
- 显示 1-5 条,共 3,456 条 -
-
- - - - - -
-
-
-
-
- - diff --git a/prototype/pages/admin/quiz-records.html b/prototype/pages/admin/quiz-records.html deleted file mode 100644 index dba68ee..0000000 --- a/prototype/pages/admin/quiz-records.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - 抽背记录查询 - AI 智能抽背助手 - - - - - - - - -
- - - - -
-

抽背记录查询

- - -
-
-
- - -
-
- - -
-
- - -
-
- - -
-
-
- - -
-
- - -
-
- 共 1,248 条记录 -
-
- - - -
-
- - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - 用户姓名抽背时间抽背内容正确率用时错误知识点操作
张三2026-03-28 14:32方剂学 - 麻黄汤 - 85% - 12分30秒甘草功效、炙甘草 - -
李四2026-03-28 14:28中医基础 - 阴阳学说 - 72% - 8分15秒阴阳失调概念 - -
王五2026-03-28 14:15中药学 - 解表药 - 91% - 15分42秒麻黄与桂枝区别 - -
赵六2026-03-28 13:58方剂学 - 桂枝汤 - 58% - 10分25秒桂枝汤组成、功效 - -
孙七2026-03-28 13:42方剂学 - 银翘散 - 88% - 11分18秒银翘散主治 - -
- - -
-
- 显示 1-5 条,共 1,248 条 -
-
- - - - - -
-
-
-
-
- - diff --git a/prototype/pages/admin/settings.html b/prototype/pages/admin/settings.html deleted file mode 100644 index 78e1065..0000000 --- a/prototype/pages/admin/settings.html +++ /dev/null @@ -1,235 +0,0 @@ - - - - - - 系统设置 - AI 智能抽背助手 - - - - - - - -
- - - - -
-

系统设置

- -
- -
-
-
- -
-

基本设置

-
-
-
- - -
-
- - -
-
- - -
-
-
- - -
-
-
- -
-

抽背设置

-
-
-
- - -
-
- - -
-
- - -
-
-
- - -
-
-
- -
-

提醒设置

-
-
-
-
-

启用推送通知

-

允许向用户发送学习提醒

-
- -
-
- -
- - - -
-
-
- -
- 09:00 - 15:00 - 20:00 - + 添加 -
-
-
-
- - -
-
-
- -
-

数据管理

-
-
-
- - -
-
- - -
-
-
- - -
-
-
- -
-

安全设置

-
-
-
-
-

强制 HTTPS

-

仅允许通过 HTTPS 访问

-
- -
-
-
-

启用 API 限流

-

防止恶意请求

-
- -
-
- - -
-
-
- - -
- -
-
-
-
- - diff --git a/prototype/pages/admin/student-management.html b/prototype/pages/admin/student-management.html deleted file mode 100644 index fa2396c..0000000 --- a/prototype/pages/admin/student-management.html +++ /dev/null @@ -1,269 +0,0 @@ - - - - - - 学生管理 - AI 智能抽背助手 - - - - - - - -
- - - - -
-
-

学生管理

- -
- - -
-
-
- - -
- - -
-
- - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - 学生姓名手机号班级抽背次数平均正确率最后活跃状态操作
-
-
- -
- 张三 -
-
138****1234一班156 - 82.5% - 今天 14:32 - 活跃 - -
- - - -
-
-
-
- -
- 李四 -
-
139****5678二班203 - 76.8% - 今天 14:28 - 活跃 - -
- - - -
-
-
-
- -
- 王五 -
-
136****9012一班89 - 91.2% - 今天 14:15 - 活跃 - -
- - - -
-
-
-
- -
- 赵六 -
-
137****3456三班45 - 65.3% - 3天前 - 不活跃 - -
- - - -
-
-
-
- -
- 孙七 -
-
135****7890二班178 - 79.6% - 今天 13:42 - 活跃 - -
- - - -
-
- - -
-
- 显示 1-5 条,共 1,286 条 -
-
- - - - - -
-
-
-
-
- - diff --git a/prototype/pages/admin/task-management.html b/prototype/pages/admin/task-management.html deleted file mode 100644 index e23e511..0000000 --- a/prototype/pages/admin/task-management.html +++ /dev/null @@ -1,318 +0,0 @@ - - - - - - 学习任务管理 - AI 智能抽背助手 - - - - - - - -
- - - - -
-
-

学习任务管理

- -
- - -
-
-
-
- -
-
-

任务总数

-

856

-
-
-
-
-
-
- -
-
-

进行中

-

624

-
-
-
-
-
-
- -
-
-

已完成

-

232

-
-
-
-
-
-
- -
-
-

参与人数

-

1,086

-
-
-
-
- - -
-
-
- - -
- - -
-
- - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - 任务名称类型目标参与人数完成率状态截止时间操作
每日方剂学抽背(50题) - 每日抽背 - 50题/天326 -
-
-
-
- 78% -
-
- 进行中 - 每天 22:00 -
- - - -
-
中医基础理论复习 - 每日复习 - 30知识点/天256 -
-
-
-
- 92% -
-
- 进行中 - 每天 21:00 -
- - - -
-
中药学每周测验 - 每周测验 - 100题/周186 -
-
-
-
- 45% -
-
- 进行中 - 周日 20:00 -
- - - -
-
方剂学专项训练 - 每日抽背 - 100题/天98 -
-
-
-
- 100% -
-
- 已完成 - 2026-03-20 -
- - - -
-
针灸学基础学习 - 每日复习 - 20知识点/天220 -
-
-
-
- 15% -
-
- 已过期 - 2026-03-15 -
- - - -
-
- - -
-
- 显示 1-5 条,共 856 条 -
-
- - - - - -
-
-
-
-
- - diff --git a/prototype/pages/mobile/ai-quiz.html b/prototype/pages/mobile/ai-quiz.html deleted file mode 100644 index ac0a0d0..0000000 --- a/prototype/pages/mobile/ai-quiz.html +++ /dev/null @@ -1,267 +0,0 @@ - - - - - - AI智能抽背 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- - - -

AI智能抽背

- -
- - -
- -
-
- 当前进度 - 3 / 10 题 -
-
-
-
-
- - -
- -
-
- -
-
-

你好!我是你的AI助教,准备好了吗?我们开始今天的学习吧!

-
-
- - -
-
- -
-
-

第3题:请背诵麻黄汤的组成

-
- - 方剂学 - 解表剂 -
-
-
- - -
-
-

点击麦克风开始回答...

-
-
- -
-
- - -
-
-
-
-
-
-
-
- 正在倾听... -
- - -
-
- -
-
-
- -
-

- 麻黄汤由麻黄、桂枝、杏仁、甘草四味药组成,发汗解表,宣肺平喘。 -

-
-

- 知识点解析 -

-

- 麻黄汤为发汗解表之峻剂,主治外感风寒表实证。 -

-
-
-
-
-
- - -
- -
-
- -
-
- - -
- - -
- - - -
-
- - diff --git a/prototype/pages/mobile/card-recite.html b/prototype/pages/mobile/card-recite.html deleted file mode 100644 index 92608ba..0000000 --- a/prototype/pages/mobile/card-recite.html +++ /dev/null @@ -1,248 +0,0 @@ - - - - - - 卡片背诵 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- - - -

卡片背诵

- -
- - -
- -
-
- 方剂学 - 解表剂 - 4 / 12 -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - -
-
-
- -
-

麻黄汤

-

点击卡片查看详情

-
- - 左右滑动切换 - -
-
-
- - - - - -
-
- - -
- - -
- -
- - -
- -
-
-
- - - -
- - - - diff --git a/prototype/pages/mobile/home.html b/prototype/pages/mobile/home.html deleted file mode 100644 index e86c4c8..0000000 --- a/prototype/pages/mobile/home.html +++ /dev/null @@ -1,288 +0,0 @@ - - - - - - 首页抽背 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- -
-
-
-

欢迎回来

-

小明同学

-
-
-
- -
-
-
- -
-
- 学习概览 - 2026-03-28 -
-
-
-

128

-

已记忆

-
-
-

45

-

未记忆

-
-
-

12

-

待复习

-
-
-
-
- - -
- - - -
-
-

- 记忆曲线提醒 -

- 查看全部 -
-
-
-
- -
-
-

临界点复习

-

麻黄汤功效、桂枝汤组成

-
- - 去背诵 - -
-
-
- - -
-
-

- 高频考点 -

- 更多 -
-
-
-
- 1 -
-
-

方剂学-解表剂

-

错误率 68%

-
- -
-
-
- 2 -
-
-

中医基础-阴阳学说

-

错误率 52%

-
- -
-
-
- 3 -
-
-

中药学-解表药

-

错误率 45%

-
- -
-
-
- - -
-
-

- 今日任务 -

- 2/5 完成 -
-
-
-
- -
- 完成30道题目 -
-
-
- -
- 复习错题本 -
-
-
- AI抽背20题 -
-
-
- 背诵10个知识点 -
-
-
- 查看学习报告 -
-
-
-
-
- - - -
- - diff --git a/prototype/pages/mobile/memory-curve.html b/prototype/pages/mobile/memory-curve.html deleted file mode 100644 index aa8266e..0000000 --- a/prototype/pages/mobile/memory-curve.html +++ /dev/null @@ -1,333 +0,0 @@ - - - - - - 记忆曲线 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- - - -

记忆曲线

- -
- - -
- -
-
-
- -
-
-

该复习啦!

-

你有 5 个知识点即将遗忘

-
- - 开始 - -
-
- - -
-

- 记忆强度曲线 -

- - - - - - - - - - - - - - - - - - -
- 学习时 - 20分钟后 - 1小时后 - 1天后 - 3天后 -
-
- - -
-
-

- 复习计划 -

- 2026年3月 -
-
- - - - - - - -
-
-
-
-
-
-
-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
-
-
-
- 已完成 -
-
-
- 今天 -
-
-
- 紧急 -
-
-
- - -
-

- 待复习知识点 -

-
-
-
- -
-
-

麻黄汤功效

-

紧急复习 · 今天到期

-
- - - -
-
-
- -
-
-

桂枝汤组成

-

明天到期

-
- - - -
-
-
- -
-
-

阴阳失调概念

-

3天后到期

-
- - - -
-
-
- - -
-

- 记忆统计 -

-
-
-

86

-

已牢固记忆

-
-
-

32

-

复习中

-
-
-

10

-

待巩固

-
-
-
-
- - - -
- - diff --git a/prototype/pages/mobile/profile.html b/prototype/pages/mobile/profile.html deleted file mode 100644 index eb17daf..0000000 --- a/prototype/pages/mobile/profile.html +++ /dev/null @@ -1,330 +0,0 @@ - - - - - - 个人中心 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- -
-
-

个人中心

- -
-
-
-
- -
-
-
-

小明同学

-

ID: 10086888

-
- -
-
- - -
-
-
-
-

128

-

已记忆

-
-
-

45

-

学习中

-
-
-

32

-

收藏

-
-
-

15

-

连续天数

-
-
-
-
- - -
-
-
-

本周学习

- 03/21 - 03/28 -
-
-
-
- -
-
-
- -
-
-
- -
-
-
- -
-
-
- -
-
-
- -
-
-
- -
-
-
-
- - - - - - - - -
-
-
-

- 我的成就 -

- 查看全部 -
-
-
-
- -
-

连续7天

-
-
-
- -
-

百题达人

-
-
-
- -
-

正确率90%

-
-
-
- -
-

待解锁

-
-
-
-
-
- - - -
- - diff --git a/prototype/pages/mobile/quiz-report.html b/prototype/pages/mobile/quiz-report.html deleted file mode 100644 index f8fe228..0000000 --- a/prototype/pages/mobile/quiz-report.html +++ /dev/null @@ -1,300 +0,0 @@ - - - - - - 抽背报告 - AI智能抽背助手 - - - - - -
- -
- 09:41 -
- - - -
-
- - -
- - - -

抽背报告

- -
- - -
- -
-

报告生成于 2026-03-28 09:41

-

报告将保存30天

-
- - -
-
-
-
-

70%

-

正确率

-
-
-
-
-

10

-

总题数

-
-
-

7

-

正确

-
-
-

3

-

错误

-
-
-

5:32

-

用时

-
-
-
-
- - -
-

- 表现趋势 -

-
-
-
- 周一 -
-
-
- 周二 -
-
-
- 周三 -
-
-
- 周四 -
-
-
- 今天 -
-
-

- - 比上次提升 5%,继续保持! -

-
- - -
-

- 错题分析 -

-
-
-
-
-

桂枝汤的组成

-

方剂学 - 解表剂

-
- 未掌握 -
-

- - 正确答案:桂枝、芍药、甘草、生姜、大枣 -

-
-
-
-
-

阴阳失调的基本概念

-

中医基础理论

-
- 模糊 -
-

- - 阴阳失调是指阴阳之间失去平衡协调 -

-
-
-
-
-

麻黄汤的主治病证

-

方剂学 - 解表剂

-
- 未掌握 -
-

- - 主治外感风寒表实证 -

-
-
-
- - -
-

- 复习建议 -

-
-
-
- 1 -
-
-

重点复习方剂学解表剂章节

-

建议用时:20分钟

-
-
-
-
- 2 -
-
-

使用卡片背诵模式巩固记忆

-

推荐题目:10道

-
-
-
-
- 3 -
-
-

明天同一时间进行复习

-

记忆曲线最佳复习时间

-
-
-
-
- - - -
- - - -
- - diff --git a/prototype/server.js b/prototype/server.js deleted file mode 100644 index 423c892..0000000 --- a/prototype/server.js +++ /dev/null @@ -1,195 +0,0 @@ -#!/usr/bin/env node - -/** - * AI 智能抽背助手 - 原型系统本地预览服务器 - * - * 使用方法: - * node server.js - * - * 功能: - * - 启动本地 HTTP 服务器 - * - 自动打开浏览器访问原型系统 - * - 支持热重载(修改文件后自动刷新) - * - * @author generate-prototype-grid skill - * @date 2026-03-28 - */ - -const http = require('http'); -const fs = require('fs'); -const path = require('path'); -const { exec } = require('child_process'); -const { URL } = require('url'); - -const PORT = 8080; -const PROTOTYPE_DIR = __dirname; -const PARENT_DIR = path.dirname(__dirname); - -// MIME 类型映射 -const MIME_TYPES = { - '.html': 'text/html; charset=utf-8', - '.css': 'text/css; charset=utf-8', - '.js': 'application/javascript; charset=utf-8', - '.json': 'application/json; charset=utf-8', - '.png': 'image/png', - '.jpg': 'image/jpeg', - '.jpeg': 'image/jpeg', - '.gif': 'image/gif', - '.svg': 'image/svg+xml', - '.ico': 'image/x-icon', - '.woff': 'font/woff', - '.woff2': 'font/woff2', - '.ttf': 'font/ttf', - '.md': 'text/markdown; charset=utf-8', -}; - -// 创建服务器 -const server = http.createServer((req, res) => { - // 使用 URL 模块安全解析 URL - let urlPath; - try { - const parsedUrl = new URL(req.url, `http://${req.headers.host || 'localhost'}`); - urlPath = parsedUrl.pathname || '/'; - } catch { - urlPath = '/'; - } - - // 处理根路径 - if (urlPath === '/') { - urlPath = '/index.html'; - } - - // 安全验证:防止路径遍历攻击 - // 规范化路径并检查是否在允许的目录内 - const isPlanningArtifacts = urlPath.startsWith("/planning-artifacts/"); - const baseDir = isPlanningArtifacts ? PARENT_DIR : PROTOTYPE_DIR; - const relativePath = isPlanningArtifacts ? urlPath : urlPath; - - const normalizedPath = path.normalize(path.join(baseDir, relativePath)); - if (!normalizedPath.startsWith(baseDir)) { - // 路径遍历攻击检测 - res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' }); - res.end('400 - 错误请求

400 - 错误请求

无效的路径

'); - return; - } - - const filePath = normalizedPath; - const extname = path.extname(filePath).toLowerCase(); - - // 设置响应头 - const contentType = MIME_TYPES[extname] || 'application/octet-stream'; - - // 读取并返回文件 - fs.readFile(filePath, (err, content) => { - if (err) { - if (err.code === 'ENOENT') { - // 文件不存在 - res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' }); - res.end(` - - - - - 404 - 文件未找到 - - - -
-

404

-

文件未找到

- 返回首页 -
- - - `); - } else { - // 服务器错误 - 不暴露内部错误详情 - res.writeHead(500, { 'Content-Type': 'text/html; charset=utf-8' }); - res.end('500 - 服务器错误

500 - 服务器错误

服务器内部错误,请稍后重试

'); - } - } else { - // 成功返回文件 - res.writeHead(200, { 'Content-Type': contentType }); - res.end(content); - } - }); -}); - -// 启动服务器 -server.listen(PORT, () => { - console.log('='.repeat(60)); - console.log(' AI 智能抽背助手 - 原型系统本地预览服务器'); - console.log('='.repeat(60)); - console.log(''); - console.log(` 服务器地址: http://localhost:${PORT}`); - console.log(''); - console.log(' 可用页面:'); - console.log(` - 统一入口: http://localhost:${PORT}/index.html`); - console.log(` - 平铺展示: http://localhost:${PORT}/admin-index.html`); - console.log(` - 文档中心: http://localhost:${PORT}/docs-index.html`); - console.log(''); - console.log(' 后台管理页面:'); - console.log(` - 数据概览: http://localhost:${PORT}/pages/admin/dashboard.html`); - console.log(` - 抽背记录查询: http://localhost:${PORT}/pages/admin/quiz-records.html`); - console.log(` - 学生管理: http://localhost:${PORT}/pages/admin/student-management.html`); - console.log(` - 知识点管理: http://localhost:${PORT}/pages/admin/knowledge-management.html`); - console.log(` - 学习任务管理: http://localhost:${PORT}/pages/admin/task-management.html`); - console.log(` - 系统设置: http://localhost:${PORT}/pages/admin/settings.html`); - console.log(''); - console.log(' 按 Ctrl+C 停止服务器'); - console.log('='.repeat(60)); - console.log(''); - - // 自动打开浏览器 - const openCommand = process.platform === 'win32' ? 'start' : - process.platform === 'darwin' ? 'open' : 'xdg-open'; - - exec(`${openCommand} http://localhost:${PORT}`, (error) => { - if (error) { - console.log(' 提示: 无法自动打开浏览器,请手动访问上述地址'); - } else { - console.log(' 已自动打开浏览器'); - } - console.log(''); - }); -}); - -// 优雅退出 -process.on('SIGINT', () => { - console.log(''); - console.log('正在停止服务器...'); - server.close(() => { - console.log('服务器已停止'); - process.exit(0); - }); -}); - -module.exports = server; diff --git a/prototype/start.sh b/prototype/start.sh deleted file mode 100644 index 43e691a..0000000 --- a/prototype/start.sh +++ /dev/null @@ -1,26 +0,0 @@ -#!/bin/bash - -# AI 智能抽背助手 - 原型系统启动脚本 -# -# 使用方法: -# ./start.sh -# -# @author generate-prototype-grid skill -# @date 2026-03-28 - -echo "==========================================" -echo " AI 智能抽背助手 - 原型系统启动" -echo "==========================================" -echo "" -echo "正在启动本地预览服务器..." -echo "" - -# 检查 Node.js 是否安装 -if ! command -v node &> /dev/null; then - echo "错误: 未找到 Node.js" - echo "请先安装 Node.js: https://nodejs.org/" - exit 1 -fi - -# 启动服务器 -node server.js diff --git a/prototype/view-doc.html b/prototype/view-doc.html deleted file mode 100644 index 71db66e..0000000 --- a/prototype/view-doc.html +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - 文档查看器 - AI 智能抽背助手 - - - - - - - - - - -
- -
-
-
- - - - -
- - - - - - -