bun-do — 你的本地任务后端

“添加 P1 任务：更新护照，截止日期为 3 月 30 日，每年重复一次，需支付 €85”

bun-do 是一款以本地优先（local-first）为设计理念的待办事项应用。提供运行在 http://localhost:8000 的 REST API。所有数据均以 JSON 格式持久化至本地磁盘，**无任何数据离开你的设备**。

启动：bun-do start（安装命令：bun install -g bun-do）
数据目录：~/.bun-do/（可覆盖：设置环境变量 BUNDO_DATA_DIR）
端口：8000（可覆盖：使用 --port=PORT 参数）

用户如何表达需求（映射为对应 API 调用）

重要提示：发送请求前，务必先将相对日期（如 “tomorrow”、“next Friday”）解析为标准格式 YYYY-MM-DD。

API 参考文档

任务字段说明

{
  "title": "字符串（必填）",
  "date": "YYYY-MM-DD（默认为当天）",
  "priority": "P0 | P1 | P2 | P3（默认为 P2）",
  "type": "task | deadline | reminder | payment（默认为 task）",
  "notes": "字符串",
  "done": false,
  "amount": "字符串（仅用于 payment 类型）",
  "currency": "CHF | USD | EUR | BRL（默认为 CHF）",
  "recurrence": null | {"type": "weekly", "dow": 0-6} | {"type": "monthly", "day": 1-31} | {"type": "yearly", "month": 1-12, "day": 1-31}
}

优先级含义：P0 = 关键任务 / 立即中断当前工作；P1 = 高优 / 今日必须完成；P2 = 普通任务；P3 = 待办池（backlog），不显示在日历中。
任务类型说明：task = 可执行动作；deadline = 硬性截止日期；reminder = 提醒类信息（FYI）；payment = 账单/发票跟踪。
重复任务逻辑：当一个重复任务被标记为完成时，系统将自动创建下一次发生实例。

cURL 使用示例

任意操作前 —— 检查服务是否运行

curl -sf http://localhost:8000/api/tasks > /dev/null && echo "OK" || echo "Server not running — run: bun-do start"

添加一个任务

curl -s -X POST http://localhost:8000/api/tasks 
  -H 'Content-Type: application/json' 
  -d '{"title": "Buy milk", "date": "2026-03-01", "priority": "P2"}'

添加一个周期性付款任务

curl -s -X POST http://localhost:8000/api/tasks 
  -H 'Content-Type: application/json' 
  -d '{"title": "Server hosting", "date": "2026-03-01", "priority": "P1", "type": "payment", "amount": "29", "currency": "USD", "recurrence": {"type": "monthly", "day": 1}}'

根据标题查找任务 → 获取 ID

curl -s http://localhost:8000/api/tasks | python3 -c "
import sys, json
for t in json.load(sys.stdin)['tasks']:
    if 'SEARCH' in t['title'].lower(): print(t['id'], t['title'])
"

编辑任务（仅发送需变更的字段）

curl -s -X PUT http://localhost:8000/api/tasks/TASK_ID 
  -H 'Content-Type: application/json' 
  -d '{"priority": "P0", "date": "2026-03-15"}'

标记任务为已完成

curl -s -X PUT http://localhost:8000/api/tasks/TASK_ID 
  -H 'Content-Type: application/json' 
  -d '{"done": true}'

删除任务

curl -s -X DELETE http://localhost:8000/api/tasks/TASK_ID

添加子任务

curl -s -X POST http://localhost:8000/api/tasks/TASK_ID/subtasks 
  -H 'Content-Type: application/json' 
  -d '{"title": "Step one"}'

记录项目进展

curl -s -X POST http://localhost:8000/api/projects/PROJECT_ID/entries 
  -H 'Content-Type: application/json' 
  -d '{"summary": "Shipped v1.3 with MCP server and OpenClaw skill"}'

主动式自动化模式

以下模式可用于实现定时或自主行为：

晨间简报：GET /api/tasks，筛选今日任务 + 已逾期任务，并按优先级汇总呈现。
每日收尾：将当日已完成任务标记为 done=true，并向活跃项目中添加进展日志条目。
周度回顾：列出全部任务，高亮标出已逾期、以及尚未取得进展的 P0/P1 任务。
付款预测：筛选所有 type=payment 的任务，按月份分组并汇总金额。

使用规则

• 每次调用 API 前，务必确认服务正在运行。
• 切勿猜测任务 ID —— 务必先通过标题搜索，再使用返回的 UUID。
• 日期字段必须为 YYYY-MM-DD 格式。请在发送请求前将 “tomorrow”、“next Monday” 等相对时间表达式解析为绝对日期。
• 执行 PUT 请求时，仅需提交需要修改的字段。
• 成功响应中，API 将返回创建或更新后的完整对象。
• GET /api/tasks 默认会将已逾期的非付款类任务自动归入今日视图（即 date 字段仍保持原值，但逻辑上视为今日任务）。