Vikunja（自定义核心）

面向生产环境的自定义 Vikunja 技能。

设置

bash
export VIKUNJA_URL=https://your-vikunja-host
export VIKUNJA_TOKEN=

脚本路径：

bash
{baseDir}/scripts/vikunja.sh

核心任务命令

bash
{baseDir}/scripts/vikunja.sh health
{baseDir}/scripts/vikunja.sh list --project Inbox --limit 25
{baseDir}/scripts/vikunja.sh create --project Inbox --title Call vendor --due 2026-03-15 --priority 4
{baseDir}/scripts/vikunja.sh update --id 123 --title Updated title --priority 5 --reminder 2026-03-14
{baseDir}/scripts/vikunja.sh move --id 123 --project Ops --view Kanban --bucket In Progress
{baseDir}/scripts/vikunja.sh complete --id 123
{baseDir}/scripts/vikunja.sh bulk-update --ids 101,102,103 --priority 3 --done false

评论

bash
{baseDir}/scripts/vikunja.sh comments list --task-id 123
{baseDir}/scripts/vikunja.sh comments add --task-id 123 --comment Initial note
{baseDir}/scripts/vikunja.sh comments update --task-id 123 --comment-id 9 --comment Edited note
{baseDir}/scripts/vikunja.sh comments delete --task-id 123 --comment-id 9

标签

bash

全局标签

任务标签

负责人

bash
{baseDir}/scripts/vikunja.sh assignees list --task-id 123
{baseDir}/scripts/vikunja.sh assignees add --task-id 123 --user-id 1
{baseDir}/scripts/vikunja.sh assignees remove --task-id 123 --user-id 1

视图和看板列

bash
{baseDir}/scripts/vikunja.sh views list --project Inbox
{baseDir}/scripts/vikunja.sh views create --project Inbox --title Kanban --kind kanban

{baseDir}/scripts/vikunja.sh buckets list --project Inbox --view Kanban
{baseDir}/scripts/vikunja.sh buckets create --project Inbox --view Kanban --title In Progress

项目 Webhook

bash
{baseDir}/scripts/vikunja.sh webhooks list --project Inbox
{baseDir}/scripts/vikunja.sh webhooks create --project Inbox --target-url http://localhost:8787/hook --event task.created --event task.updated
{baseDir}/scripts/vikunja.sh webhooks delete --project Inbox --webhook-id 7

附件

bash
{baseDir}/scripts/vikunja.sh attachments list --task-id 123
{baseDir}/scripts/vikunja.sh attachments upload --task-id 123 --file /tmp/proof.pdf
{baseDir}/scripts/vikunja.sh attachments download --task-id 123 --attachment-id 44 --output /tmp/proof-copy.pdf
{baseDir}/scripts/vikunja.sh attachments delete --task-id 123 --attachment-id 44

关联关系

bash
{baseDir}/scripts/vikunja.sh relations add --task-id 123 --other-task-id 456 --kind blocks
{baseDir}/scripts/vikunja.sh relations remove --task-id 123 --other-task-id 456 --kind blocks

已保存筛选器

bash
{baseDir}/scripts/vikunja.sh filters list
{baseDir}/scripts/vikunja.sh filters create --title Today High --filter done = false && priority >= 4 && due_date < now/d + 1d
{baseDir}/scripts/vikunja.sh filters get --id 3
{baseDir}/scripts/vikunja.sh filters update --id 3 --title Today Critical
{baseDir}/scripts/vikunja.sh filters delete --id 3

通知 + 订阅

bash
{baseDir}/scripts/vikunja.sh notifications list
{baseDir}/scripts/vikunja.sh notifications mark --id 8
{baseDir}/scripts/vikunja.sh notifications mark

{baseDir}/scripts/vikunja.sh subscriptions subscribe --entity project --entity-id 12
{baseDir}/scripts/vikunja.sh subscriptions unsubscribe --entity project --entity-id 12

API 令牌

bash
{baseDir}/scripts/vikunja.sh tokens list
{baseDir}/scripts/vikunja.sh tokens create --title automation --expires-at 2026-12-31 --permissions-json {tasks:[read_all]}
{baseDir}/scripts/vikunja.sh tokens delete --token-id 5

冒烟测试框架

bash

示例（可选）：加载本地环境辅助文件

source ~/.config/vikunja/.vikunjaskillenv