StudyPulse.Desktop 创建或打开
选择一个本地目录作为 StudyPulse Workspace。已有 Workspace 可以直接打开，目录结构和数据一起保留。
A small beginning
简单入场 · 自主掌控
StudyPulse Desktop 快速入门指南。
第一次打开时创建或选择一个 Workspace。之后，学习记录、资料、Agent Notebook 和备份都围绕它展开；AI 是一个可以稍后连接的选项。
01 / The first four steps
四步完成工作区 初始化与配置。
Desktop 先让你选择数据放在哪里，再让你决定哪些功能需要 AI。
先记录，再观察
从 Today、任务、考试、错题、学习计时或日记开始；Trends 和 Reports 会在本地数据积累后给出更清楚的节奏。
需要时再连接
在 Settings 连接 Cloud AI 或 BYOK。生成和分析功能会使用选定 provider，Learning Reports 和本地学习记录不依赖 AI。
带走自己的结构
导出 .studypulsebackup。导入时先检查 schema、记录、冲突和警告，并在 Replace 恢复前保留 recovery point。
02 / A day in the workspace
高效联动的 日常学习操作路径。
每个页面写回同一份 Workspace 数据，所以一次学习 session 可以在 Today、Trends、Reports 和下一次计划里继续产生意义。
01
Plan 制定目标
从任务、考试或 Reverse Planner 的目标开始，先决定今天要把注意力放在哪里。
02
Focus 专注计时
用计时器完成一个学习 session，记录时间投入和任务进度。
03
Review 错题复习
把错题加入文字闪卡，按 Again、Hard、Good、Easy 反馈下一次复习间隔。
04
Reflect 日记反思
在日记中记录心情、精力和 Markdown 内容，再回到 Trends 看见长期变化。
05
Report 总结归档
查看 7 天或 30 天报告，并导出 Markdown、HTML、PNG 或打印 PDF。
03 / 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 分钟的模拟考试，自动保存作答并记录行为分析。
04 / Backup and migration
跨平台数据备份 与平滑迁移。
macOS 与 Windows 复用同一套 Workspace 格式。推荐从 macOS 导出 .studypulsebackup，再在 Windows 导入；系统凭据不会随备份迁移，需要在新设备重新连接。
备份的是 Workspace，不是系统凭据。
这样备份可以迁移学习数据，同时不会把 API key 或登录 token 打包进去。
migration
.studypulsebackup
1. export Workspace (.studypulsebackup)
2. move the backup file to new device
3. inspect schema, records and warnings
4. review potential conflicts
5. auto-create a recovery point snapshot
6. apply Replace restore into target folder
7. reconnect Cloud AI or BYOK securely
Read the boundaries