习惯追踪 CLI

要解决什么问题

长期养成习惯时，纸笔或通用待办往往扛不住三件事：周期规则（每天一次 vs 每周三次）、补记与备注（昨天忘了记今天想补）、以及连续天数与完成率这类需要按日志聚合的指标。若数据散落在聊天里或表格里，复盘 streak 和趋势会很费劲。

它如何工作

habits-tracker 是一个 Node.js 命令行工具，无额外运行时依赖，习惯与打卡记录落在本地 ~/.config/habit-tracker/：habits.json 存定义，logs.json 存完成记录。

核心能力大致分四块：

• 习惯定义：创建习惯时可设 --frequency（daily / weekly / monthly）、--target（每周期目标次数）、--reminder（HH:MM）和 --description。
• 打卡记录：支持 --count、--date（YYYY-MM-DD）、--note，便于批量或补记。
• 统计与报告：可查看总完成次数、活跃天数、完成率、当前与最长连续天数；报告侧用进度条汇总各习惯。
• 提醒检查：按提醒时间判断哪些习惯到期，适合配合 cron 做定时检查或日报。

典型流程是：先 add 定义习惯 → 日常 log → 用 stats / report 看趋势 → 需要时用 edit / delete 维护列表；也可由调度任务或事件触发同一套 CLI。

适用边界与注意点

这是 本机 CLI + 本地 JSON，没有内置多设备同步或协作；备份与迁移需自行处理配置目录。提醒依赖你本机的 cron 或外部调度，时区与执行频率要自己对齐。若你需要图形界面、团队共编或云端提醒，应在上层再接别的系统；本技能更适合把「定义—记录—统计」收成一条可脚本化的流水线。