核心功能
HabitFlow 是一款将行为科学与AI技术结合的习惯养成工具，深度整合《原子习惯》的四大定律：让提示显而易见、让渴望有吸引力、让反应简便易行、让奖励令人愉悦。
自然语言交互
用户可用口语化表达记录习惯完成情况，如"我今天冥想了"或"周一和周四去散步了"。系统通过NLP解析自动识别习惯名称与日期，置信度≥85%时自动执行，60%-84%时请求确认，低于60%则引导澄清。
智能连续打卡机制
采用宽容的连续计算逻辑：允许1天中断不打破 streak，符合真实生活节奏。支持单日、批量记录，以及完成/部分完成/跳过/错过等多状态标记。
七重AI教练人格
- flex：专业数据驱动型（默认）
- coach-blaze：热血运动教练 🔥
- luna：温柔治疗师 💜
- ava：好奇 productivity 极客 🤓
- max：佛系好友 😎
- sofi：禅意极简主义者 🌸
- the-monk：智慧哲学家 🧘
用户可随时切换人格，AI将以对应语气提供激励与指导。
主动式智能提醒
支持WhatsApp定时提醒，更可通过cron配置主动教练消息：里程碑庆祝（7/14/21/30天streak）、风险预警（高风险情境前24小时）、每周检视（周日晚7点）、模式洞察（周三模式检测）。需用户显式启用。
可视化进度追踪
生成长条形连续打卡图、90天热图等Canvas可视化报告，直观呈现习惯养成轨迹。
显著优点
- 科学依据扎实：方法论直接源自James Clear的《原子习惯》，非空泛鸡汤
- 交互门槛极低：自然语言输入免去繁琐表单，降低记录摩擦
- 人格化体验丰富：7种教练风格满足不同用户心理需求
- 技术栈现代：TypeScript + Node.js 18+，npm生态支持
- 开源MIT协议：可自由审计与二次开发
潜在局限
- 依赖Node.js环境：非技术用户安装门槛较高
- WhatsApp提醒需外部集成：未内置跨平台推送系统
- 数据本地存储：无云端同步，多设备使用受限
- AI解析置信度波动：复杂表述可能需人工确认
- proactive coaching需手动启用：自动化体验不够开箱即用
适合人群
- 希望建立运动、冥想、阅读等日常习惯的自我提升者
- 厌倦传统打卡App繁琐操作、偏好自然语言交互的用户
- 需要行为科学指导而非简单提醒的认真习惯养成者
- 喜欢游戏化人格激励、对AI教练风格有偏好的个性化用户
使用建议
首次使用时建议先选择最契合性格的教练人格，从1-2个微小习惯（2分钟规则）起步，开启proactive coaching cron jobs以获取持续动力。定期查看可视化报告，利用"习惯堆叠"技术将新习惯嫁接至既有routine。
风险提示
- 数据丢失风险：本地JSON存储无自动备份，建议定期手动备份
~/clawd/habit-flow-data目录 - 隐私注意：WhatsApp提醒需授权外部服务，敏感习惯数据可能流经第三方
- cron任务管理：主动教练任务需用户自行维护，系统升级后可能需要重新sync
- AI建议边界：教练建议基于行为科学但非医疗/心理咨询，严重习惯障碍（如成瘾）应寻求专业帮助