用途:从自托管 Vikunja 实例读取任务,并同步到 Joplin,用于把每周已完成任务写入 Joplin weekly 笔记。
主要能力:支持查看项目(list-projects)、查看任务(list-tasks,可按项目、完成状态、周、数量过滤),以及将每周已完成任务同步到 Joplin(sync-weekly)。使用 --week 时,任务归属周按有效日期判断:优先使用 end_date,未设置时使用 done_at。写入 daily 小节时也按该有效日期分组。
使用方式:前置依赖 joplin skill 必须已安装(https://github.com/zrong/skills),且 Vikunja 实例需要可访问。需在 agent_config.toml 中配置 [vikunja] section,包含 base_url 和 api_token 两项。命令建议通过 uv run --project vikunja/scripts vikunja/scripts/vikunja_tool.py <command> 执行。
常用命令:list-projects 列出项目;list-tasks [--project ID] [--done] [--week YYYY-Www] [--limit N] 列出任务;sync-weekly [--note "2026-03-14weeks"] [--week "2026-W14"] 同步到 Joplin,无参数时同步当前周,--note 从笔记标题解析目标周,--week 直接指定 ISO 周。
适用场景:需要将 Vikunja 中每周已完成任务汇总到 Joplin 笔记的自动化流程。
限制:依赖外部 Vikunja 实例和 joplin skill;API 地址与令牌需用户自行配置;资料未提供其他能力、收费、价格或效果说明。