Habit Tracker

Name: Habit Tracker
Rating: 3.5 (1 reviews)
Author: zsc-glitch

By zsc-glitch ⭐ 1 stars 👁 6 views ▲ 0 votes

习惯追踪器 - 记录习惯、追踪连续天数、养成好习惯 - OpenClaw Plugin

GitHub

Install

npm install @zsc-glitch/habit-tracker

README

# Habit Tracker 🔥

习惯追踪器 - 记录习惯、追踪连续天数、养成好习惯

## 安装

```bash
npm install @zsc-glitch/habit-tracker
```

## 功能

### 核心功能
- ✅ **习惯记录** - 快速打卡，记录完成情况
- ✅ **连续追踪** - 自动计算 streak，激励坚持
- ✅ **目标设置** - 设置每周目标次数
- ✅ **统计报告** - 习惯完成率、趋势分析
- ✅ **打卡历史** - 日历视图，一目了然

### 新增功能 (v2.0)
- ✏️ **编辑习惯** - 修改名称、类别、频率、目标、图标、颜色
- 📦 **归档功能** - 暂停追踪但保留数据，随时恢复
- 🎨 **自定义外观** - 支持自定义颜色和图标
- 📅 **历史日历** - 可视化查看月度打卡记录
- 🔥 **改进的 Streak 算法** - 更准确地计算连续天数

## 使用

### 添加习惯
```
habit_add(name: string, category?: string, frequency?: string, goal?: number, emoji?: string, color?: string)
```

示例：
- `habit_add({ name: "每天运动" })`
- `habit_add({ name: "阅读", category: "learning", emoji: "📖", color: "#3498db" })`
- `habit_add({ name: "冥想", frequency: "daily", goal: 7 })`

### 打卡
```
habit_checkin(name: string, note?: string)
```

示例：
- `habit_checkin({ name: "运动" })`
- `habit_checkin({ name: "阅读", note: "读了30页" })`

### 查看状态
```
habit_status(name?: string, includeArchived?: boolean)
```

示例：
- `habit_status({})` - 查看所有活跃习惯
- `habit_status({ name: "运动" })` - 查看单个习惯
- `habit_status({ includeArchived: true })` - 包含已归档习惯

### 编辑习惯
```
habit_edit(name: string, newName?: string, category?: string, frequency?: string, goal?: number, emoji?: string, color?: string)
```

示例：
- `habit_edit({ name: "运动", newName: "健身" })`
- `habit_edit({ name: "阅读", goal: 5, emoji: "📚" })`

### 查看历史
```
habit_history(name: string, year?: number, month?: number)
```

示例：
- `habit_history({ name: "运动" })` - 本月历史
- `habit_history({ name: "运动", year: 2026, month: 2 })` - 指定月份

### 归档/恢复
```
habit_archive(name: string)
habit_unarchive(name: string)
```

示例：
- `habit_archive({ name: "运动" })` - 归档习惯
- `habit_unarchive({ name: "运动" })` - 恢复追踪

### 生成报告
```
habit_report(period: "week" | "month" | "year")
```

示例：
- `habit_report({ period: "week" })` - 本周报告
- `habit_report({ period: "month" })` - 本月报告

### 删除习惯
```
habit_delete(name: string, confirm?: boolean)
```

示例：
- `habit_delete({ name: "运动" })` - 预览删除
- `habit_delete({ name: "运动", confirm: true })` - 确认删除

## 工具列表

| 工具 | 描述 |
|------|------|
| `habit_add` | 添加新习惯 |
| `habit_checkin` | 习惯打卡 |
| `habit_status` | 查看状态 |
| `habit_edit` | 编辑习惯 |
| `habit_history` | 查看打卡历史日历 |
| `habit_archive` | 归档习惯 |
| `habit_unarchive` | 恢复习惯 |
| `habit_report` | 生成报告 |
| `habit_delete` | 删除习惯 |

## 类别

| 类别 | ID | 默认图标 | 默认颜色 |
|------|-----|---------|---------|
| 健康 | health | 💪 | #4CAF50 |
| 学习 | learning | 📚 | #2196F3 |
| 心理 | mindfulness | 🧘 | #9C27B0 |
| 生活 | life | 🏠 | #FF9800 |
| 自定义 | custom | ⭐ | #607D8B |

## 数据存储

习惯数据存储在 `~/.habit-tracker/` 目录：

```
~/.habit-tracker/
├── habits.json      # 习惯配置
├── checkins/        # 打卡记录
│   ├── 2026-03-30.json
│   └── ...
└── stats.json       # 统计数据
```

## Streak 计算规则

### 每日习惯
- 最近一次打卡必须是今天或昨天
- 从最近一次打卡往前计算连续天数
- 断开一天，streak 重置为 0

### 每周习惯
- 最近一次打卡必须在最近 7 天内
- 每次打卡间隔不超过 7 天即视为连续

## 更新日志

### v2.0.0
- ✨ 新增 `habit_edit` 编辑习惯功能
- ✨ 新增 `habit_history` 查看打卡历史日历
- ✨ 新增 `habit_archive` / `habit_unarchive` 归档功能
- 🎨 支持自定义颜色和图标
- 🔥 改进 streak 计算算法，处理边界情况
- 📊 报告增加日均打卡数据
- 🐛 修复 streak 计算错误
- 🐛 修复归档习惯仍可打卡的问题

### v1.0.0
- 🎉 初始版本
- 基础习惯追踪功能
- streak 计算和报告生成

## License

MIT

---

## ☕ 支持开发者

如果这些工具对你有帮助，欢迎请我喝杯咖啡 ☕

![微信赞赏码](https://raw.githubusercontent.com/zsc-glitch/assets/main/wechat-pay.png)

---

Made with 🔥 by [小影](https://github.com/zsc-glitch)

tools