视图系统

理解过滤规则

目录

过滤条件是视图的核心:它决定显示哪些任务。每条过滤规则都用一个运算符把一个字段与一个值进行比较——你可以任意组合多条规则。

过滤规则的结构

字段            运算符      值
────────────    ────────    ────────────
截止日期        不晚于      @today+3d
状态            是          进行中
已逾期          是          是

把每一行当作一句话来读:“截止日期不晚于从今天起三天后。”你在过滤器编辑器(高级模式)中选择字段、运算符和值。视图文件中使用技术名称记录同样的规则,例如 due_date · lte · @today+3d;下面的表格同时列出两者。

字段参考

字段菜单分为三组:字段、虚拟字段,以及——如果你创建了的话——自定属性。

字段

字段 键 含义
标题 title 任务的标题
状态 status 进行中、等待中、已暂停、已完成、已放弃、将来,以及待验收和待答复(AI 智能体交回)
分配给 assigned_to 人类或 AI
委派 delegation 执行、起草、询问
规格 spec_status 草稿或可交给智能体
交回处理 handback_reply 你对交回的最近一次回应:已验收、退回修改、已答复、已自己接手、已放弃
截止日期 due_date 截止日期
计划日 do_date 你打算着手处理任务的日期
里程碑 milestone 任务所属的里程碑
等待对象 waiting_for 自由文本:任务在等待谁或什么
标签 tags 有效标签——包括从项目和里程碑继承的标签(见下文)
创建者 / 完成者 created_by / completed_by 人类或 AI
完成日期 completed_date 完成日期
创建时间 / 修改时间 created / modified 文件的时间戳
顺序 sequence_order 任务在其列表中的位置

虚拟字段(计算得出)

这些字段不在文件中,而是根据其他字段计算得出。它们的键以 @ 开头。

字段 键 含义
可开始 @is_available 任务进行中、未推迟、项目进行中;在顺序执行的项目中,只有第一个进行中的任务
下一步行动(项目) @is_project_next 项目的下一步行动,跨越各里程碑(参阅仅下一步行动)
下一步行动(里程碑) @is_milestone_next 每个里程碑的下一步行动
已逾期 @is_overdue 任务进行中且截止日期已过——附带时间时从该分钟起,否则从次日起
今天截止 @is_due_today 截止日期是今天
本周截止 @is_due_this_week 截止日期在本周内
智能体交回 @is_handback AI 智能体已交回该任务(待验收或待答复)
等待中 @is_waiting 状态为等待中
重复任务 @is_recurring 任务会重复
在收件箱中 @is_inbox 任务位于收件箱中
独立任务 @is_single 任务不属于项目,位于某个领域或文件夹中
有截止日期 / 有计划日 @has_due_date / @has_do_date 已设置该日期
有规格 @has_spec 任务有规格
有里程碑 @has_milestone 任务位于某个里程碑中
距截止天数 @days_until_due 距截止日期的天数(负数 = 已逾期,空 = 无日期)
项目 / 里程碑 / 领域 / 文件夹 @project_title / @milestone_title / @area_name / @folder_name 相应所在位置的名称
任务标签 @task_tags 仅直接设置在任务上的标签

标签与任务标签: 标签字段检查有效标签(任务 + 项目 + 里程碑),并且还会考虑标签层级:上级标签也会找到所有带有其下级标签的任务。如果只想检查直接设置在任务上的标签,请使用任务标签。

此外,视图引擎在视图文件中还能识别 project、area、folder、defer_date(推迟日期)和 @effective_tags——当 AI 智能体直接编写视图时很有用。

自定属性

如果你在设置中定义了自定属性,它们会出现在字段菜单的自定属性下。在视图 YAML 中,它们写作 attributes.键名——例如 attributes.kunde(运算符是,值 ACME),或带有 @today 等日期表达式的 attributes.abnahme。排序和分组也提供这些属性。

运算符

提供哪些运算符取决于字段。每个字段还额外提供为空和不为空(无需值)。

字段类型 编辑器中的运算符 键
文本 是、不是、包含、不包含(不区分大小写) eq、neq、contains、not_contains
日期 是、不是、晚于、不早于、早于、不晚于 eq、neq、gt、gte、lt、lte
数字 是、不是、大于、大于或等于、小于、小于或等于 eq、neq、gt、gte、lt、lte
选择(状态、分配给…) 是、不是 eq、neq
是/否(例如已逾期) 是,值为是或否 eq
标签、任务标签 包含其中之一、包含全部、不包含其中任何一个 any_of、all_of、none_of
空值检查 为空、不为空 is_empty、is_not_empty

在视图文件中,还可以使用 starts_with(以…开头,不区分大小写)。

日期表达式

在日期过滤条件中,你可以输入一个动态表达式作为值,代替固定日期(2026-03-01)。每次执行视图时,表达式都会重新计算。

单个时间点

表达式 含义
@today 今天
@tomorrow 明天
@yesterday 昨天
@today+Nd / @today-Nd 今天加上或减去 N 天(例如 @today+3d)
@today+Nw / @today-Nw 今天加上或减去 N 周
@today+Nm / @today-Nm 今天加上或减去 N 个月

时间段

表达式 含义
@this_week 本周
@next_week 下周
@this_month 当前日历月
@next_7d 从今天到 7 天后
@next_30d 从今天到 30 天后
@past_7d 从 7 天前到今天

时间段要搭配运算符是使用——App 会检查日期是否落在该时间段内(包括开始和结束日期)。一周从哪天开始,取决于设备的地区设置(例如在德国为周一)。

示例——未来三天内截止的任务: 字段截止日期,运算符不晚于,值 @today+3d。这样你就能看到未来三天内截止的所有任务——包括已逾期的任务。

组合规则

每个过滤分组都以一个选择开始,决定其中的规则如何组合:

条件关系 键 含义
满足所有条件 all 且——必须满足所有规则
满足任一条件 any 或——至少满足一条规则
不满足任何条件 none 非——不得满足任何规则

点按条件可添加一个条件,点按子分组可添加一个嵌套分组——例如在“且”分组中再建一个“或”分组。

示例——今天的重要任务: 满足所有条件: - 可开始 是 是 - 子分组——满足任一条件: - 今天截止 是 是 - 已逾期 是 是

结果:只显示今天截止或已逾期、且可开始的任务。

简单模式与高级模式

简单——在快速配置中,今天、已逾期、等待中和进行中按钮会一步设置好过滤条件、分组和排序。在下方可以逐项选择:

  • 任务:全部、进行中、今天截止、已逾期、等待中、收件箱
  • 分组:无、项目、领域、文件夹、状态
  • 排序:截止日期、计划日(均为升序)、创建时间、修改时间(均为降序)或手动

高级——由你自己搭建过滤树,并把视图拆分为多个分区:带名称的部分,各有自己的过滤条件、排序和分组。点按添加分区可再添加一个。每个分区还有以下选项:

选项 作用
图标 分区名称旁的图标
每个项目最多显示任务数 每个项目最多显示这么多任务
为空时隐藏 没有结果时隐藏该分区
默认折叠 分区以折叠状态开始

如果一个分区的过滤条件只检查一个标签,你就可以在这样的分区之间拖移任务来更改标签(参阅通过拖放重新整理)。

分区与看板:看板、多栏视图和仪表板不使用分区,也没有高级过滤器;切换到其中一种显示方式时,分区会被移除。