核心用法
Heartbeat Manager 是一款面向 EVA Agent 的任务监控与健康管理工具，通过定时心跳机制实现对多源任务状态的自动化追踪。用户配置完成后，以 python tools/heartbeat_run.py beat 触发单次心跳，系统依次扫描 daily.md 例行任务、todo.md 待办事项（含 @due:HH:MM 超期检测）、ongoing.json 任务状态机及 IMAP 邮件状态，最终输出 0-100 分健康度评分并同步更新 MASTER.md 主控表。支持通过 crontab 配置定时任务，实现每 30 分钟心跳、每日 0 点重置与日报、每周日晚周报的全自动化运维。
显著优点
1. 多维度智能评分：将 Daily 完成率、Todo 完成率、Ongoing 状态、邮件处理、Git 同步五大维度量化为可对比的健康度分数，低于 60 分连续 3 次即触发邮件告警，实现风险前置。
2. 智能卡死检测：基于 ongoing.json 的 history 字段，区分「推进慢」与「完全卡死」两种场景，避免过度告警，精准定位阻塞任务。
3. 原子化与容错设计：单步失败不阻断整体流程，网络异常进入 pending 队列，文件更新采用 tmp+rename 原子写入，配合文件锁防止并发冲突，保障数据完整性。
4. Git 原生集成：自动 commit + push 实现状态版本化，便于回溯审计。
潜在缺点与局限性
- 环境依赖较重：需独立 Python 环境、配置 Gmail 应用专用密码、维护 crontab，对非技术用户门槛较高。
- 邮件耦合度深：告警通道目前仅支持 SMTP/IMAP，缺乏 Slack、Webhook 等现代协作工具的原生支持。
- 评分权重固定：健康度各维度分值硬编码于配置，难以适应不同团队对工作流的差异化定义。
- 无持久化数据库：依赖 Markdown/JSON 文件存储，任务量激增时可能出现 I/O 瓶颈。
适合人群
- 个人开发者或小型技术团队，需要轻量级、可版本化的任务追踪方案
- 使用 OpenClaw/EVA Agent 生态的用户，追求自动化工作流闭环
- 偏好本地优先、数据自主可控，不愿依赖 SaaS 任务管理工具的隐私敏感型用户
常规风险
- 邮件凭证泄露：
.env文件若误提交至 Git 仓库，可能导致 Gmail 应用密码暴露，建议配合.gitignore与预提交钩子防护。 - 定时任务堆积：crontab 配置不当或心跳执行超时，可能导致任务重叠执行，需确保文件锁机制生效。
- 健康度评分误判：过度依赖自动化评分可能掩盖软性阻塞（如等待外部反馈），建议定期人工复核 MASTER.md。