Vikunja 任务管理器

通过 REST API 在自托管的 Vikunja 实例上管理任务和项目。

设置

设置以下环境变量：

bash
export VIKUNJA_URL=https://你的-vikunja-实例.com
export VIKUNJA_TOKEN=你的-api-令牌

获取 API 令牌：Vikunja → 设置 → API 令牌 → 创建令牌。

命令

列出任务

bash
{baseDir}/scripts/vikunja.sh tasks --count 10
{baseDir}/scripts/vikunja.sh tasks --project 购物 --count 5
{baseDir}/scripts/vikunja.sh tasks --search 杂货
{baseDir}/scripts/vikunja.sh tasks --sort priority --order desc

逾期任务

bash
{baseDir}/scripts/vikunja.sh overdue

即将到期的任务（未来 N 小时内）

bash
{baseDir}/scripts/vikunja.sh due --hours 24
{baseDir}/scripts/vikunja.sh due --hours 48

创建任务

bash
{baseDir}/scripts/vikunja.sh create-task --project 任务 --title 买牛奶 --due 2026-02-01 --priority 3

优先级：1（低）到 5（紧急）。截止日期格式：YYYY-MM-DD。

完成任务

bash
{baseDir}/scripts/vikunja.sh complete --id 123

获取任务详情

bash
{baseDir}/scripts/vikunja.sh task --id 123

列出项目

bash
{baseDir}/scripts/vikunja.sh projects

创建项目

bash
{baseDir}/scripts/vikunja.sh create-project --title 新项目 --description 可选描述

获取通知

bash
{baseDir}/scripts/vikunja.sh notifications

截止日期监控

要主动接收关于到期/逾期任务的通知，请设置一个定时任务：

bash
clawdbot cron add \
--name 任务到期检查 \
--cron 0 9,14 * \
--tz America/Denver \
--session isolated \
--message 检查 Vikunja 中的逾期和即将到来的任务（未来 24 小时）。如果发现任何任务，请通过列表通知我。 \
--deliver \
--channel telegram

备注

• - --project 中的项目名称不区分大小写
• 筛选表达式遵循 Vikunja 筛选语法（参见 https://vikunja.io/docs/filters）
• 所有时间均按 America/Denver 时区处理