TaskFlow 1.1.0 — Release Notes
This release turns TaskFlow from a single global board into a per-project inspector, powered by a community contribution (PR #4), together with a round of maintainer refinements to the new grouping UI.
Highlights
- Enhanced grouping — note-scoped queries (community contribution by @wernsting, PR #4). A group can now be scoped to a single note: configure a frontmatter property (and optionally the allowed values) and a note dropdown appears for that group. Selecting a note points every tab's Tasks query at it through Tasks'
query.file, so you can inspect one project at a time instead of the whole vault. - Configurable group task limit. Each group can cap how many tasks its tabs display. The cap is appended last, so it overrides any
limitwritten inside a tab's own query. Set it in the group config, and optionally enable an on-view limit box to tweak it without opening settings. - Limits and pickers are now optional and searchable. The on-view limit box sits behind a setting (off by default), so groups without a note selector no longer show a stray limit input. Both the note picker and the property-values picker gained search — click-to-pick stays primary, search only narrows the list.
What's changed
New features (PR #4, by @wernsting)
- Note selector: a per-group dropdown driven by a frontmatter property, restricted to notes whose value is in the configured set. Selecting a note scopes every tab in the group to that note (
query.file). - Property values filter: optionally narrow which notes are offered. Matching is case-insensitive and accepts single values or YAML lists; a note matches if any of its values is selected (if no values are selected, any non-empty value matches).
- Group task limit: a single cap appended as
limit Nto every tab's query, overriding thelimitwritten inside each tab's query (confirmed by the maintainer: the group cap wins over per-query limits). - Advanced linking: combined with Tasks'
filter by function(e.g.filter by function task.file.path === query.file.path, requires Tasks ≥ 5.1.0), a group can also collect tasks that merely relate to the selected note — via alinkfrontmatter property or a wikilink inside the task description — even though those tasks do not live in the selected note.
Refinements (maintainer)
- The on-view limit box is now a setting — Show the task-limit box on the view, off by default. Groups without a note selector no longer show a lone limit input; turn it on when you want to adjust the cap on the fly. The box edits the same value as the group config, so there is no duplicated setting.
- Group edit modal: added a Limit field, placed after Property values so the property and its values sit next to each other.
- Search added to both pickers — the note dropdown and the Property values multi-select now filter as you type. Both stay click-to-pick first: search is an optional filter, never a required step, and nothing opens a blocking modal.
Notes
- The note-scoped query relies on Tasks'
query.fileQuery Property. Keepquery.fileinsidefilter by function, or use the{{query.file.*}}placeholder — never putquery.fileon its own line (Tasks rejects it with "do not understand query"). - The selected note is kept for the current session; reopening the vault falls back to the first matching note.
- Thanks to @wernsting for the contribution and the collaborative review.
TaskFlow 1.1.0 更新说明
本次更新把 TaskFlow 从「全局看板」升级为「按项目逐篇巡检」。核心能力来自社区贡献(PR #4),另有一轮针对新分组界面的维护者优化与修复。
亮点
- 增强分组 —— 笔记限定查询(社区贡献 @wernsting,PR #4)。分组现在可以限定到某一篇笔记:配置一个 frontmatter 属性(可选再指定允许的取值)后,该分组会出现一个笔记下拉选择器;选中某篇笔记后,分组内所有标签的 Tasks 查询都会通过 Tasks 的
query.file指向该笔记,实现「一次只看一个项目」的巡检。 - 分组任务上限。每个分组可统一限制其标签最多显示多少条任务;上限以追加形式写在查询末尾,因此会覆盖标签查询内部自带的
limit。在分组配置里设定,也可按需在视图顶部开启可实时编辑的上限框。 - 上限框与选择器:可选 + 可搜索。视图顶部的上限框改为由设置项控制(默认关闭),因此没有笔记选择器的分组不会再出现孤零零一个上限输入框;笔记选择器与「属性值」选择器都新增了搜索——仍以直接点选为主,搜索只用于收窄列表。
主要变更
新功能(PR #4,@wernsting 贡献)
- 笔记选择器:由 frontmatter 属性驱动的分组级下拉框,仅列出属性取值在配置集合内的笔记;选中后把分组内所有标签的查询限定到该笔记(
query.file)。 - 属性值筛选:可选地收窄提供哪些笔记。匹配时大小写不敏感,支持单值与 YAML 列表;只要笔记的值中有任一落在选中集合里即匹配(若未选任何值,则任何非空值都匹配)。
- 分组任务上限:以
limit N形式追加到分组内每个标签查询的末尾,覆盖标签查询内部的limit(经维护者确认:分组上限优先于查询内 limit)。 - 进阶关联:配合 Tasks 的
filter by function(例如filter by function task.file.path === query.file.path,需 Tasks ≥ 5.1.0),分组还能一并收集仅仅与选中笔记相关的任务——通过linkfrontmatter 属性或任务描述里的双链——即便这些任务并不住在选中的笔记里。
优化与修复(维护者)
- 视图顶部的上限框改为设置项——「在视图顶部显示任务上限框」,默认关闭。没有笔记选择器的分组不会再出现孤零零一个上限输入框;需要随手调整上限时再打开。该输入框与分组配置编辑的是同一个值,不存在重复设置。
- 分组编辑弹窗新增「上限」字段,放在「属性值」之后,让属性与其取值相邻、逻辑更顺。
- 两个选择器都加了搜索——笔记下拉框与「属性值」多选框均支持输入即过滤。两者仍保持点选优先:搜索只是可选的过滤手段,不是必经步骤,也不会弹出阻断式弹窗。
说明
- 笔记限定查询依赖 Tasks 的
query.fileQuery Property。请务必把query.file写在filter by function内部,或使用{{query.file.*}}占位符——不要单独成行(否则 Tasks 会报 "do not understand query")。 - 选中的笔记仅在本次会话内保留;重新打开仓库后会回退到第一篇匹配的笔记。
- 感谢 @wernsting 的贡献与协作审阅。