名称： tasktrove
描述： 通过 Tasktrove API 管理待办事项。可用于列出、创建、完成或更新任务。触发条件包括任务/待办请求，例如“我的待办列表有什么”、“添加任务”、“标记 X 为完成”、“今天有什么到期”。

Tasktrove 待办事项管理

通过自托管的 Tasktrove 实例管理任务。(GitHub)

配置

设置以下环境变量：

export TASKTROVE_HOST="http://your-server:3333"

可选地，如果你的实例需要认证：

export TASKTROVE_TOKEN="your-api-token"

快速参考

使用 CLI 脚本

# 列出今天的任务
python3 scripts/tasks.py list --today

# 列出过期任务
python3 scripts/tasks.py list --overdue

# 列出本周任务
python3 scripts/tasks.py list --week

# 添加任务
python3 scripts/tasks.py add "任务标题" --due 2026-02-10 --priority 2

# 完成任务（使用列表输出中的 ID 前缀）
python3 scripts/tasks.py complete abc123

# 搜索任务
python3 scripts/tasks.py search "关键词"

直接 API 调用

列出任务

curl -s "$TASKTROVE_HOST/api/v1/tasks"

创建任务

# 注意：API 要求所有字段，包括 id、completed、labels 等。
curl -X POST "$TASKTROVE_HOST/api/v1/tasks" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "<uuid>",
    "title": "任务标题",
    "priority": 4,
    "dueDate": "2026-02-06",
    "completed": false,
    "labels": [],
    "subtasks": [],
    "comments": [],
    "createdAt": "2026-02-06T12:00:00.000Z",
    "recurringMode": "dueDate"
  }'

完成/更新任务

# 注意：PATCH 请求发送到集合端点，ID 包含在请求体中（而非 /tasks/{id}）
curl -X PATCH "$TASKTROVE_HOST/api/v1/tasks" \
  -H "Content-Type: application/json" \
  -d '{"id": "<task-id>", "completed": true}'

删除任务

curl -X DELETE "$TASKTROVE_HOST/api/v1/tasks/<task-id>"

任务结构

优先级等级

• P1：紧急/关键
• P2：高优先级
• P3：中优先级
• P4：低优先级（默认）

注意事项

• Tasktrove 界面支持自然语言输入，但 API 需要结构化 JSON
• PATCH 操作使用集合端点，并在请求体中包含 ID
• POST 请求需要提供所有结构字段