Study Buddy - 智能学习伴侣

帮你制定学习计划、追踪进度、提供反馈的 AI 学习伴侣。

核心功能

1. 用户档案 - 交互式收集学习目标、时间、水平、偏好
2. 学习计划 - 基于背景生成个性化阶段性计划
3. 每日打卡 - 记录学习时长和内容
4. 进度跟踪 - 统计学习天数、连续打卡、阶段评估
5. 学习报告 - 生成周期性学习总结和评级
6. 错题本 - 记录、复习、掌握错题
7. 反馈建议 - 基于数据给出个性化建议

命令入口

# 开始学习之旅（交互式收集背景）
python3 scripts/study-buddy.py start

# 查看今日学习任务
python3 scripts/study-buddy.py today

# 学习打卡
python3 scripts/study-buddy.py checkin "学习了Python基础语法" --duration "45分钟"

# 查看学习进度
python3 scripts/study-buddy.py progress

# 查看学习计划
python3 scripts/study-buddy.py plan

# 生成学习报告
python3 scripts/study-buddy.py report

# 错题本管理
python3 scripts/study-buddy.py wrong add "二次函数求根错误"
python3 scripts/study-buddy.py wrong list
python3 scripts/study-buddy.py wrong review "错题ID"
python3 scripts/study-buddy.py wrong master "错题ID"

# 获取反馈建议
python3 scripts/study-buddy.py feedback

# 查看学习数据存储位置
python3 scripts/study-buddy.py data

数据存储

用户数据存储在: ~/.study-buddy/

• profile.json - 学习背景档案
• plans/ - 学习计划目录
• logs/ - 学习记录日志
• wrong_questions/ - 错题本
• report_YYYYMMDD.json - 学习报告

使用流程

1. 初始化: 运行 start 创建学习档案
2. 制定计划: 根据背景自动生成学习计划，使用 plan 查看
3. 每日执行: 使用 today 查看任务，checkin 打卡
4. 定期复盘: 使用 progress 查看进展，report 生成报告
5. 错题管理: 使用 wrong 命令管理错题本

目标用户

优先聚焦：高中生及家长

安全边界

• ✅ 学习计划制定、进度跟踪、打卡、反馈、学习报告
• ❌ 不提供具体学科教学内容（如数学题解答）
• ❌ 不替代老师/家长决策
• ❌ 不接外部教育平台
• ❌ 不做夸张的学习效果承诺
• ❌ 不收集敏感隐私
• ✅ 尊重用户隐私，数据本地存储
• ✅ 建议用户结合真人教师或专业课程

扩展计划（未来规划，非当前版本）

以下功能为后续迭代方向，当前 MVP 版本未实现：

• [ ] Feishu集成
• [ ] 可视化报告
• [ ] 智能提醒功能
• [ ] 多计划管理
• [ ] 数据导出功能
• [ ] 更智能的计划生成算法

参考文档

• 命令详细说明: references/commands.md
• 开发待办清单: references/todo.md