Beaver Habit Tracker

使用 Beaver Habit Tracker API 跟踪并管理您的日常习惯。

API 文档：https://beaverhabits.com/docs

配置

环境变量

获取您的 API Key

1. 登录您的 Beaver Habits 实例
2. 打开菜单 → Tools → API Tokens
3. 点击 “Generate API Token”
4. 复制生成的 Token，并将其设为 BEAVERHABITS_API_KEY 环境变量

工具

list_habits（概览）

列出所有习惯，并以每周 ASCII 表格形式展示完成情况。这是所有与习惯相关的查询的默认响应。

步骤 1 — 获取全部习惯：

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" 
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits"

步骤 2 — 对每个习惯，获取最近 5 天内的完成记录：

curl -s -H "Authorization: Bearer $BEAVERHABITS_API_KEY" 
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions?date_fmt=%25d-%25m-%25Y&date_start={start}&date_end={end}&limit=100&sort=asc"

响应格式：["16-02-2026", "18-02-2026"]（已完成日期字符串组成的数组）

步骤 3 — 渲染为 ASCII 表格：

示例输出：

              Mon   Tue   Wed   Thu   Fri   
Exercise       ✗     ✗     ✗     ✗     ✗     
English        ✓     ✗     ✗     ✗     ✗     
paipai         ✗     ✗     ✗     ✗     ✓     
Reading        ✗     ✗     ✗     ✗     ✗     
Table Tennis   ✗     ✗     ✗     ✗     ✗     

使用 ✓ 表示已完成，✗ 表示未完成。默认展示截至今日的最近 5 天数据。为保证对齐，习惯名称中的 Emoji 将被自动移除。

complete_habit

将某习惯标记为“已完成”或“未完成”（指定某一天）。

参数：

• habit_id（已解析）：通过调用 list_habits 并匹配用户提供的习惯名称自动解析。切勿向用户索取该值。
• date（必需）：日期，格式为 DD-MM-YYYY
• done（可选）：设为 true 表示完成，false 表示取消完成（默认值：true）

curl -s -X POST 
  -H "Authorization: Bearer $BEAVERHABITS_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"date": "20-02-2026", "done": true, "date_fmt": "%d-%m-%Y"}' 
  "${SERVER_URL:-https://beaverhabits.com}/api/v1/habits/{habit_id}/completions"

响应：{"day": "20-02-2026", "done": true}

使用说明

• 当用户请求“列出”、“显示”或“查看”习惯时，始终以 ASCII 表格形式返回概览（而非纯文本列表）。
• 完成或取消完成某个习惯后，必须重新渲染概览表格，以反映最新状态。
• 通过 list_habits 将习惯名称解析为 ID；切勿向用户索要 habit_id。
• 如无特别指定，默认使用当天日期进行标记；日期格式固定为 date_fmt=%d-%m-%Y。