English: Personal reading tracker with spaced repetition reviews, structured note-taking, and monthly reading calendar. Helps you remember what you read and build consistent habits. Designed for readers finishing 30–50 books/year.

Reading Tracker - 个人阅读管理系统

帮助你建立可持续的阅读习惯，对抗"读完就忘"。

English: Helps you build sustainable reading habits and combat "read and forget". Supports progressive reading: capture → weekly review → monthly synthesis.

核心工作流 / Core Workflow

1. 开始阅读 / Start Reading

用户说：开始读《书名》 → 创建书籍笔记文件 → 记录开始时间 → 设置阅读目标

EN: User says: "Start reading [Book Title]" → Create note file → Record start date → Set reading goal

2. 记录书摘 / Capture Quote

用户说：记录书摘 / 今天读到... → 提取书名、内容、思考 → 检查是否包含进度信息 → 如无进度，主动追问 → 保存到对应书籍文件 → 设置艾宾浩斯复习提醒

EN: User shares a quote/thought → Extract book, content, reflection → Ask for progress if missing → Save to book file → Schedule spaced repetition reviews

3. 完成阅读 / Finish Reading

用户说：读完《书名》 → 触发强制输出三问 → 保存核心观点、认知改变、行动计划 → 标记完成状态 → 生成本书总结

EN: User says "Finished [Book Title]" → Trigger 3 mandatory questions → Save key insight, mindset shift, action plan → Mark as complete

4. 复习提醒 / Review Reminders

通过 Cron 每周触发 → 检查 schedule.json 中到期复习项 → 推送个性化复习问题

EN: Cron-triggered weekly → Check due reviews in schedule.json → Push personalized review questions

5. 生成报告 / Generate Reports

用户说：本月读了什么 / 年度总结 → 统计阅读天数、连续记录、断档 → 生成阅读日历 → 提取跨书关联主题

EN: Monthly/yearly reports with reading calendar, streak tracking, cross-book theme analysis

数据存储结构 / Data Structure

文件路径 / File Paths

workspace/reading/
├── books/
│   └── {book-title}-{YYYY-MM}.md    # Book notes
├── reviews/
│   ├── weekly-{YYYY}-W{WW}.md       # Weekly reviews
│   └── monthly-{YYYY}-{MM}.md       # Monthly synthesis
├── library.json                      # Book index
└── schedule.json                     # Review schedule

单本书笔记格式 / Book Note Template

# 《书名》/ Book Title

## 元信息 / Metadata
- 作者/Author：{作者}
- 开始时间/Started：{YYYY-MM-DD}
- 完成时间/Finished：{YYYY-MM-DD}
- 总进度/Progress：{百分比}%
- 评分/Rating：{1-5}⭐

## 核心输出 / Key Outputs
- 一句话总结/One-sentence summary：
- 认知改变/Mindset shift：
- 行动计划/Action plan：

## 书摘与思考 / Quotes & Thoughts

### {YYYY-MM-DD} 第{X}章/Ch{X}（{进度}%）
> "{书摘内容/Quote}"

**我的想法/My thought**：{思考内容/Reflection}

## 复习记录 / Review Log
- [{日期}] {复习内容}

交互规则 / Interaction Rules

识别意图 / Intent Recognition

开始阅读 / Start:

• "开始读《原子习惯》" / "Start reading Atomic Habits"
• "我要读《深度工作》" / "I want to read Deep Work"

记录书摘 / Capture:

• "记录书摘..." / "Save this quote..."
• "第X章有句话..." / "Chapter X says..."

完成阅读 / Finish:

• "读完《书名》" / "Finished [Book Title]"
• "标记《书名》为已读" / "Mark [Book Title] as read"

查看复习 / Review:

• "今天复习什么" / "What to review today"
• "/复习" / "/review"

生成报告 / Reports:

• "本月读了什么" / "What did I read this month"
• "阅读报告" / "Reading report"

追问逻辑 / Follow-up Logic

当用户记录书摘但未提供进度时 / When progress is missing:

📝 记录成功 / Saved!

顺便问下，今天读到哪了？
（第X章 / 第X页 / 大概百分之多少？）

EN: What chapter/page are you on?

完成三问 / The 3 Questions

当用户标记读完时，必须回答：

1. 一句话总结这本书的核心观点：

   EN: One-sentence summary of the core idea:

2. 认知改变：它改变了你什么想法？

   EN: Mindset shift: What changed for you?

3. 行动计划：你会采取什么具体行动？

   EN: Action plan: What will you do differently?

报告格式 / Report Format

月报模板 / Monthly Report

📊 2025年3月阅读报告 / March 2025 Reading Report

┌─────────────────────────────────────┐
│  本月读完：2本 / Finished: 2 books    │
│  在读：1本 / Reading: 1 book          │
│  书摘记录：23条 / Quotes: 23          │
│  平均阅读速度：5天/本 / Avg: 5 days   │
└─────────────────────────────────────┘

📅 本月阅读日历 / Reading Calendar

Mo  Tu  We  Th  Fr  Sa  Su
                          ·
 ·  📖  ·  📖  📖  ·   ·
 ·  📖  ·   ·  📖  📖  ·
📖  ·  📖  ·   ·   ·   ·
 ·  📖

📖 = 有阅读记录 / Read   · = 无记录 / No record

📈 关键数字 / Key Stats
✅ 本月有记录：9天 / 15天（截至今日）
   Days with records: 9/15
⚡ 最长连续：3天（3/4 - 3/6）
   Longest streak: 3 days
😅 最长断档：4天（3/7 - 3/10）
   Longest gap: 4 days

📖 已读完 / Finished:
   1. 《原子习惯》⭐⭐⭐⭐⭐
      Atomic Habits
      核心收获：用系统设计替代意志力
      Key takeaway: Replace willpower with systems

复习算法 / Review Algorithm

基于艾宾浩斯遗忘曲线 / Spaced repetition based on Ebbinghaus:

• 第1次复习：1天后 / 1 day
• 第2次复习：3天后 / 3 days
• 第3次复习：7天后 / 7 days
• 第4次复习：30天后 / 30 days

使用脚本 / Scripts

• scripts/reading_cli.py - 核心 CLI 工具 / Core CLI
• scripts/generate_report.py - 报告生成 / Report generation
• scripts/review_scheduler.py - 复习计划 / Review scheduling

Cron 配置 / Cron Setup

每周一上午 9:00 触发复习提醒：

{
  "schedule": {
    "kind": "cron",
    "expr": "0 9 * * 1"
  },
  "payload": {
    "kind": "systemEvent",
    "text": "检查今日阅读复习任务 / Check today's reading reviews"
  }
}