- name
- reading-tracker
- description
- 个人阅读管理与笔记系统。用于记录读书进度、管理书摘与思考、生成阅读报告。支持渐进式阅读法：书摘记录→每周回顾→月度串联。触发词："开始读"、"记录书摘"、"阅读进度"、"读完"、"复习"、"本月读了什么"。
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
当用户标记读完时，必须回答：
- 一句话总结这本书的核心观点：
> EN: One-sentence summary of the core idea:
- 认知改变：它改变了你什么想法？
> EN: Mindset shift: What changed for you?
- 行动计划：你会采取什么具体行动？
> 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 CLIscripts/generate_report.py- 报告生成 / Report generationscripts/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"
}
}