📊 Reading Habit Tracker — 閱讀習慣追蹤系統
概述
目標導向 vs 打卡記錄——這套系統幫你：
- 📌 設定年度/月度閱讀目標（書本數/頁數/時長）
- 📋 建立書單追蹤（想讀/在讀/已讀）
- ⏱️ 記錄每次閱讀 session（頁數/時長/章節）
- 📈 每週/月自動分析：完成率、落後預警、趨勢洞察
- 🏆 達成里程碑時主動祝賀
觸發關鍵字： 閱讀目標、讀書計劃、每月閱讀、追蹤進度、閱讀統計、讀書報告、落後了嗎、本月讀完、設立目標、讀了多少
與 reading_progress.py 的差異
| 維度 | reading_progress.py | reading-habit-tracker |
|---|---|---|
| 核心概念 | 每日打卡事件 | 目標 + 計劃管理 |
| 目標設定 | 無 | 年/月/單書目標 |
| 數據顆粒 | 單次 session | session + 書本 + 總目標 |
| 報告頻率 | 手動 stats | 每週自動報告 + 落後預警 |
| 適用場景 | 維持習慣 | 達成閱讀目標 |
腳本清單
| 腳本 | 用途 |
|---|---|
scripts/goal_manager.py |
目標管理（設定/查看/刪除年度/月度/單書目標） |
scripts/session_logger.py |
Session 記錄（每次閱讀的頁數/時長/備註） |
scripts/analytics.py |
數據分析（完成率/落後預警/每週報告） |
scripts/visualizer.py |
視覺化（ASCII 進度條/終端彩色圖表） |
scripts/booklist_manager.py |
書單管理（想讀/在讀/已讀/放棄） |
使用範例
# 設定年度目標
python3 scripts/goal_manager.py set --type yearly --books 30 --pages 5000 --hours 200
# 記錄一次閱讀 session
python3 scripts/session_logger.py log \
--book "原子習慣" \
--pages 30 \
--minutes 45 \
--note "第3章完"
# 查看進度儀表板
python3 scripts/analytics.py dashboard
# 生成週報
python3 scripts/analytics.py weekly
# 管理書單
python3 scripts/booklist_manager.py add --title "深度工作" --status to-read
python3 scripts/booklist_manager.py list --status reading
數據儲存
所有數據儲存在 ~/.bookshelf-plus/habit_tracker/ 目錄：
goals.json— 目標設定sessions.json— 閱讀 session 記錄booklist.json— 書單狀態reports/— 生成的報告
Cron Job（建議）
# 每日 22:00 落後預警
openclaw cron add \
--name "reading-habit-alert" \
--schedule "0 22 * * *" \
--tz "Asia/Taipei" \
--payload-kind agentTurn \
--message "執行閱讀習慣追蹤預警：python3 ~/.qclaw/skills/reading-habit-tracker/scripts/analytics.py alert --format text。若目標落後，主動發送提醒訊息。"