创建或打开
选择一个本地目录作为 StudyPulse Workspace。已有 Workspace 可以直接打开，目录结构和数据一起保留。
A small beginning
从一个工作区开始， 慢慢建立自己的节奏。
第一次打开时创建或选择一个 Workspace。之后，学习记录、资料、Agent Notebook 和备份都围绕它展开；AI 是一个可以稍后连接的选项。
The first four steps
没有复杂的入场仪式， 只有几个清楚的选择。
Desktop 先让你选择数据放在哪里，再让你决定哪些功能需要 AI。
先记录，再观察
从 Today、任务、考试、错题、学习计时或日记开始；Trends 和 Reports 会在本地数据积累后给出更清楚的节奏。
需要时再连接
在 Settings 连接 Cloud AI 或 BYOK。生成和分析功能会使用选定 provider，Learning Reports 和本地学习记录不依赖 AI。
带走自己的结构
导出 .studypulsebackup。导入时先检查 schema、记录、冲突和警告，并在 Replace 恢复前保留 recovery point。
A day in the Workspace
把页面之间的距离， 缩短成一个动作。
每个页面写回同一份 Workspace 数据，所以一次学习 session 可以在 Today、Trends、Reports 和下一次计划里继续产生意义。
01Plan从任务、考试或 Reverse Planner 的目标开始，先决定今天要把注意力放在哪里。
02Focus用计时器完成一个学习 session，记录时间投入和任务进度。
03Review把错题加入文字闪卡，按 Again、Hard、Good、Easy 反馈下一次复习间隔。
04Reflect在日记中记录心情、精力和 Markdown 内容，再回到 Trends 看见长期变化。
05Report查看 7 天或 30 天报告，并导出 Markdown、HTML、PNG 或打印 PDF。
Choose an AI path
两种连接方式， 一个本地工作区。
Cloud AI 和 BYOK 不能同时处于 active 状态。切换 provider 时，客户端会清理对应的活动连接和已保存凭据。
Cloud AI点击 Sign in，打开安全登录流程，通过 studypulse://auth/callback 回到桌面客户端。
BYOK填写 Base URL、Model 和 API key。保存后 key 不会再次回显，前端只显示脱敏状态。
AI Coach把分数目标转成证据、风险和可审核的学习任务建议；批准后才写入任务。
Exam Simulator生成默认 10 道题、20 分钟的模拟考试，自动保存作答并记录行为分析。
Backup and migration
你的 Workspace， 应该能跟着你走。
macOS 与 Windows 复用同一套 Workspace 格式。推荐从 macOS 导出 .studypulsebackup，再在 Windows 导入；系统凭据不会随备份迁移，需要在新设备重新连接。
备份的是 Workspace，不是系统凭据。这样备份可以迁移学习数据，同时不会把 API key 或登录 token 打包进去。
migration.studypulsebackup
1. export Workspace
2. move the backup file
3. inspect schema and warnings
4. review conflicts
5. create a recovery point
6. apply Replace restore
7. reconnect Cloud AI or BYOKRead the boundaries