Habit Flow

核心功能

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建议边界：教练建议基于行为科学但非医疗/心理咨询，严重习惯障碍（如成瘾）应寻求专业帮助

核心用法

HabitFlow 将习惯追踪从繁琐的点击操作解放为自然对话。用户只需说「今天冥想了一小时」「周一到周五都去了健身房」，系统自动解析并记录。完整功能覆盖：习惯创建与管理、自然语言打卡（支持批量补录）、连续打卡统计（智能容错机制）、可视化进度看板（Canvas热力图/连续打卡图）、多角色AI教练（从专业数据分析师到热血运动教练等7种人格）、WhatsApp定时提醒与主动激励。

显著优点

1. 自然语言交互：无需记忆指令格式，口语化输入即可识别 habit + 日期 + 数量，大幅降低使用门槛。
2. 智能容错设计：连续打卡采用「1天宽恕」算法，偶尔断签不影响长期激励，符合行为心理学中的「避免全有或全无」原则。
3. 多角色人格化教练：7种预设人格（Flex专业理性、Coach Blaze热血激励、Luna温柔疗愈等）可切换，让习惯养成过程更有情感联结。
4. 完全本地化隐私：所有数据存储于 ~/clawd/habit-flow-data/，无云端同步、无遥测上报，GDPR/CCPA合规。
5. 主动行为干预：通过 cron 系统实现里程碑庆祝、风险预警、周日复盘等推送，将被动记录升级为主动陪伴。

潜在缺点与局限

• 技术门槛：依赖 Node.js 18+ 和 npm，纯终端/命令行交互，无图形界面，对非技术用户不够友好。
• 生态封闭：仅适配 clawdbot CLI 生态，无法直接同步至 Apple Health、Notion、Habitica 等外部系统。
• T3来源风险：作者为个人开发者（tralves），虽代码开源透明，但长期维护承诺弱于企业级产品。
• 提醒渠道单一：目前仅支持 WhatsApp，无邮件/短信/系统通知等备选通道。
• 数据迁移成本：本地 JSON 存储虽安全，但跨设备同步需手动备份，缺乏官方云同步选项。

适合人群

• 偏好命令行效率的技术从业者与开发者
• 重视数据隐私、拒绝云端服务的用户
• 《原子习惯》理念实践者，需要系统性的 streak 追踪与行为反馈
• 已使用 clawdbot 生态、希望扩展个人效率工具链的用户
• 习惯养成困难、需要外部 accountability（问责机制）但讨厌社交压力的人

常规风险

• 数据丢失：本地存储无自动备份，设备损坏或误删目录将导致记录永久丢失，建议定期手动备份 ~/clawd/habit-flow-data/。
• cron 配置误操作：提醒功能需用户主动运行 sync-coaching 启用，若遗忘则无法接收主动激励；误操作可能创建重复任务。
• 人格切换混淆：AI 教练人格切换后，对话风格剧变，用户需适应不同沟通模式，极端人格（如 Coach Blaze 的高能量风格）可能造成心理负担。
• 连续打卡依赖：智能容错虽人性化，但长期 streak 数字仍可能引发「为了数字而打卡」的异化行为，需保持工具服务于目标而非相反。