Vikunja

Vikunja 任务管理工具,支持查看项目和任务,并将每周已完成的任务同步到 Joplin weekly 笔记。

zrong c8c78b6 3 files · 14.8 KB Updated

File contents

Vikunja Skill

从自托管 Vikunja 实例读取任务,同步到 Joplin。

前置依赖

  • joplin skill 必须已安装(https://github.com/zrong/skills
  • Vikunja 实例需要可访问
  • agent_config.toml 中配置 [vikunja] section

环境配置

agent_config.toml 中添加:

[vikunja]
base_url = "https://nas.zengrong.net:8456/api/v1"
api_token = "<your-api-token>"

命令指南

建议使用 uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py <command> 执行。

1. 项目

  • 列出项目: list-projects

2. 任务

  • 列出任务: list-tasks [--project ID] [--done] [--week YYYY-Www] [--limit N]
    • 使用 --week 时,任务归属周按有效日期判断:若任务设置了 end_date,优先使用 end_date;否则使用 done_at

3. 同步

  • 同步到 Joplin: sync-weekly [--note "2026-03-14weeks"] [--week "2026-W14"]
    • 无参数:同步当前周
    • --note:从笔记标题解析目标周
    • --week:直接指定 ISO 周
    • 写入 daily 小节时按任务有效日期分组:优先 end_date,未设置时使用 done_at

测试流程

  1. uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-projects
  2. uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py list-tasks --done --limit 5
  3. uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py sync-weekly

zrong/skills/tree/main/vikunja commit c8c78b64dd

Frequently asked questions

npx skillmds add zrong/vikunja