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 中混合使用两种格式,并随着需求的变化在它们之间迁移。 探索所有循环功能 或 在帮助中心获取设置支持.
软件工程师,拥有 10+ 年使用 Swift、Kotlin 和 Flutter 开发移动端与桌面应用的经验。独立开发者,现居 Toronto, Canada。TaskForge 的作者。 了解更多