跳转到主要内容
集成与工作流程

TaskForge 循环任务完整指南

TaskForge 支持两种强大的循环任务格式:Markdown 和 TaskNotes。每种格式为不同的工作流程提供独特的优势。本指南解释了两者的工作原理、关键差异以及何时使用每种格式。

为什么要有两种格式?

TaskForge 提供两种不同的循环任务方法,每种都针对不同的用例进行了优化:

Markdown 格式

非常适合日常笔记和项目文件中的简单循环任务。使用自然语言并在完成时创建新的任务实例。非常适合需要可见历史记录的任务。

TaskNotes 格式

适用于每个文件一个任务的详细循环工作流程。在 YAML 前言中使用 RRULE 格式,并在 complete_instances 数组中跟踪完成情况。非常适合需要丰富元数据和一致调度的任务。

一目了然:主要差异

功能 Markdown TaskNotes
配置 自然语言加 🔁 表情符号 YAML 前言中的 RRULE 格式
完成跟踪 状态更改为"已完成" complete_instances 数组(状态不变)
实例创建 完成时创建新任务 就地更新(同一任务)
基准日期 自动确定(截止日期 > 预定日期 > 开始日期) 始终使用预定日期
截止日期偏移 不保持 保持(默认:启用)
取消完成行为 状态改回(新实例保留) 从 complete_instances 中移除,回滚日期
COUNT 限制 🔢 表情符号加数字或位置/总数 RRULE 中的 COUNT 参数
最适合 简单循环任务,可见历史记录 详细工作流程,丰富元数据

快速入门:模板

Markdown 格式

使用自然语言直接在 Markdown 文件中添加循环任务:

- [ ] Review weekly goals 🔁 every Monday 📅 2025-11-10
- [ ] Water plants 🔁 every 3 days ⏳ 2025-11-10
- [ ] Pay rent 🔁 every month on the 1st 📅 2025-12-01
- [ ] Backup files 🔁 every week when done 🛫 2025-11-10
- [ ] Team standup 🔁 every weekday 📅 2025-11-10
- [ ] Quarterly review 🔁 every 3 months 🔢 4 📅 2025-12-01

TaskNotes 格式

为详细的循环工作流程创建带有 YAML 前言的每个文件一个任务:

---
title: Review weekly goals
status: todo
scheduled: 2025-11-10
due: 2025-11-10 17:00
recurrence: FREQ=WEEKLY;BYDAY=MO
tags:
  - work
  - review
complete_instances: []
---

## Notes
Review progress on all active projects.

刚接触 TaskNotes?查看我们的 TaskNotes 集成指南 了解每个文件一个任务的格式和 YAML 前言基础知识。

循环工作原理

了解 TaskForge 如何计算下一次出现对两种格式都至关重要。关键概念是基准日期, 完成循环任务时会推进的日期。

Markdown:自动基准确定

Markdown 任务使用优先级规则自动确定基准日期:

优先级:截止日期 > 预定日期 > 开始日期

如果存在截止日期,则成为基准日期。否则,使用预定日期。仅当截止日期和预定日期都不存在时才使用开始日期。

TaskNotes:始终使用预定日期

TaskNotes 循环任务始终使用预定日期作为循环计算的基准。无论其他日期字段如何,这都提供一致、可预测的行为。

对于 TaskNotes 循环任务,预定日期是必需的。完成任务时,TaskForge 会将完成日期添加到 complete_instances 数组,从预定日期计算下一次出现,并将预定日期更新为下一个未完成的出现。

完成跟踪

两种格式采用根本不同的方法来跟踪任务完成情况。

Markdown:完成时创建新实例

完成 Markdown 循环任务时,原始任务的状态更改为"已完成",并创建一个带有下一次出现日期的新任务实例,插入到文件中原始任务之后。

在文件中创建已完成任务的可见历史记录,非常适合跟踪随时间推移的进度。

TaskNotes:完成实例数组

完成 TaskNotes 循环任务时,完成日期会添加到 complete_instances 数组,状态字段永远不会更改,预定日期推进到下一个未完成的出现。首次完成时会自动将 DTSTART 添加到循环中。

维护一个带有 complete_instances 数组中完整历史记录的单个任务文件。状态永远不会更改,因此任务始终显示在待办事项列表中。

何时使用哪种格式

使用 Markdown 当:

  • 您希望在文件中看到已完成任务的可见历史记录
  • 您更喜欢自然语言而不是 RRULE 语法
  • 您需要基于完成的循环
  • 您正在处理日常笔记或项目文件

使用 TaskNotes 当:

  • 您想要一个带有完整历史记录的单个任务文件
  • 您需要丰富的元数据
  • 您希望自动维护截止日期偏移
  • 您更喜欢每个文件一个任务的组织方式

TaskForge支持哪些重复模式?

TaskForge对两种格式都支持广泛的重复模式。以下是所有可用选项的完整概述:

每日模式

每日重复为日常任务提供简单的计划安排。选项包括每天、每N天和每个工作日(周一至周五)。使用每日模式来管理习惯、例行事项和需要定期完成的任务。

每周模式

每周重复为在特定工作日重复的任务提供灵活的计划安排。选项包括每周、每N周、每周一、特定工作日如周一三五,或任意工作日组合。

每月模式

每月重复让您精确控制任务在哪一天重复。选项包括每月、每N个月、特定日期如1日或15日、月末最后一天、相对工作日如第二个周二,或多个日期。

每年模式

每年模式适用于年度事件和回顾。您可以设置任务每年、每N年或在特定月份重复。非常适合年度回顾、生日提醒或季节性任务。

基于完成的模式

基于完成的重复从您实际完成任务的日期计算下一次发生,而不是从原始截止日期。在Markdown格式中使用"when done"或"after completion"等短语。这对于发生间隔比固定时间表更重要的任务特别有用。

次数限制和结束日期

您可以限制任务的重复次数。在Markdown格式中,使用计数表情符号后跟数字。在TaskNotes中,使用RRULE中的COUNT参数。您还可以设置结束日期,使任务在特定日期后停止重复。

第N个工作日模式

对于落在月份中相对某天的任务,TaskForge支持第N个工作日模式。您可以将任务安排在每月的第一个周一、最后一个周五、第二个周二或任何类似组合。

准备好了解更多?

探索这些相关指南以掌握 TaskForge:

两种格式都共享相同的循环引擎,无论您选择哪种格式,调度方式都完全相同。而且您永远不会被锁定, 您可以在同一个 vault 中混合使用两种格式,并随着需求的变化在它们之间迁移。 探索所有循环功能在帮助中心获取设置支持.

Azhar Dewji
Azhar Dewji · · Updated July 8, 2026

软件工程师,拥有 10+ 年使用 Swift、Kotlin 和 Flutter 开发移动端与桌面应用的经验。独立开发者,现居 Toronto, Canada。TaskForge 的作者。 了解更多