带着具体任务进入
准备一道不会的题、一次真实错答或一份待整理的教学材料，不必先浏览所有功能。
01 · Quick start
第一次使用，先走通一轮
不要逐页试按钮。用一个真实任务完成“输入—诊断—行动—复盘”，系统才会留下有用的学习证据。
先获得诊断
让系统识别知识点、卡住的位置与错误原因，再决定是补概念、练变式还是修错因。
只完成一个动作
从建议中选择最优先的一项，完成一轮针对性训练、错题修复或题目结构化。
回到画像复盘
查看掌握度、错因和最近活动是否变化，再根据证据安排下一次学习。
02 · Workflow overview
七个动作组成 StudyFlow 全景
这是一张操作地图，不是必须逐项打卡的任务清单。学生通常沿着提问、诊断、训练、修复和复盘推进；结构化与教研属于教师工作流。
- 01开始提问
Ask · 提问
学生提交题目、困惑或作业要求，建立带上下文的学习会话。
- 02查看诊断
Diagnose · 诊断
学生识别知识断点、错误原因和最值得先处理的突破口。
- 03整理题目
Structure · 结构化
教师把题目整理为带知识点、题型、方法和解析的可复用资产。
- 04进入训练
Train · 训练
学生围绕诊断结果完成同类题、变式题、补漏题或迁移题。
- 05修复错因
Repair · 修复
学生按错因重做、解释与复习，直到同类错误不再重复出现。
- 06进入教研
Teach · 教研
教师把题目与学生错因转化为讲评顺序、讲义和分层作业。
- 07查看画像
Review · 复盘
学生回到学习画像查看证据变化，并确认下一次最优行动。
学生最短路径：提问 → 诊断 → 训练或修复 → 复盘。
教师最短路径：结构化题目 → 组织讲评 → 生成讲义或分层作业。
03 · For students
按你现在要完成的任务选择入口
不确定去哪个页面时，先匹配眼前任务。下面四条路径覆盖最常见的学习场景。
04 · For teachers
把题目资产变成可复用的教学流程
教师端适合完成课程资料组织、题目讲评、变式训练和课堂流程设计。管理课程前，请先确认账号已获得教师权限。
01建立题目资产在智能题库录入或导入题目，校对知识点、难度和解析。02设计讲评与训练从真实错因出发组织讲评顺序，将变式题加入训练或备课篮。03编写课堂讲义题型讲义突出识别、方法和易错点；新课讲义组织直觉、科学史、概念边界与课堂检测。04管理课程材料创建课程单元、关联视频与资料，并连接到知识节点。
教师课程管理会执行云端写入。没有可信角色时接口会返回 403，这是正常的权限保护。
05 · Account & sync
你的数据保存在哪里
StudyFlow 采用本地优先策略。是否登录、网络状态和服务配置会决定数据是否同步到云端。
状态保存位置你会看到什么
未登录当前浏览器显示离线模式；可以体验本地功能，不会写入个人云端表。
已登录且在线本地 + Supabase启动时拉取云端数据，修改后尝试写回；可手动重新同步。
已登录但断网当前浏览器继续使用已有本地数据，恢复网络后再手动同步。
同步失败本地仍保留状态显示同步失败；检查网络、登录状态和 Supabase 配置。
不要在公共电脑上长期保留学习数据。退出账号只会切换命名空间，不等于清除浏览器中的本地归档。
06 · Troubleshooting
常见问题
01为什么同步状态显示“离线模式”？
未登录、网络不可用或 Supabase 尚未配置时，系统会使用浏览器本地存储。登录且云端连接可用后，可以点击同步状态手动拉取云端数据。
02匿名使用的数据会自动进入新账号吗？
匿名数据和账号数据使用不同的本地命名空间。首次登录后，请根据引导选择认领匿名数据或从空白账号开始，避免覆盖已有数据。
03AI、OCR 或生成训练为什么不可用？
这些能力需要登录，并依赖服务端 AI_API_KEY 或 Mathpix 配置。接口不可用时，页面可能提供本地示例或降级提示；示例内容不等同于真实 AI 结果。
04为什么我看不到教师课程管理功能？
教师和管理员权限由服务端可信角色控制。仅修改个人资料中的角色不会获得管理权限，需要管理员在账号 app_metadata 中配置角色。
05换设备后哪些数据可以恢复？
成功写入 Supabase 的账号数据可以在登录后恢复；仅保存在 localStorage 的草稿、部分界面偏好和未同步内容不会自动跨设备迁移。