Sleek项目中的日期过滤表达式语法解析与优化建议

在开源任务管理工具Sleek的使用过程中，日期过滤表达式是用户进行高级搜索的重要功能。近期社区发现并修复了文档中关于日期过滤表达式的一个关键语法问题，这对提升用户体验具有重要意义。

语法变更背景

Sleek项目早期版本中，日期过滤表达式使用due和t作为关键字，无需添加冒号后缀。例如用户可以简单地使用due < tomorrow这样的语法进行日期过滤。然而，这种设计在实际使用中遇到了问题——当用户需要匹配以字母"t"开头的自由文本时，系统会错误地将其识别为日期关键字。

为解决这一问题，开发团队在PR #435中对语法进行了修改，要求所有关键字后必须添加冒号。这一变更使得表达式语法更加明确，避免了与普通文本的冲突。例如新的正确语法变为due: < tomorrow。

文档同步问题

尽管核心功能已经更新，但项目Wiki中的"Filter Expressions for Advanced Search"指南未能及时同步这一变更。这导致许多用户按照文档示例操作时遇到表达式无效的问题。典型的例子包括：

• 旧文档示例：+bills and due < tomorrow
• 实际有效语法：+bills and due: < tomorrow

这种文档与实际功能不同步的情况给用户带来了困惑，特别是对新用户而言，他们往往会首先参考官方文档进行学习。

语法一致性讨论

在修复文档的过程中，开发团队还注意到优先级(priority)过滤表达式的语法特殊性。与其他属性不同，优先级过滤仍然保持无冒号的原始语法形式，例如pri == A而非pri: == A。这种设计是有意为之的，因为：

1. 优先级在todo.txt格式中本身就是特殊语法（如(A)）
2. 用户可以直接使用(A)这样的形式进行匹配
3. 只有在需要不等式比较时才需要使用pri关键字

这种差异化的设计虽然打破了完全的一致性，但从语义角度考虑更为合理，因为优先级并非标签属性，而是任务的内置属性。

表达式功能现状

目前Sleek的过滤表达式支持以下主要功能：

1. 日期过滤：due: < tomorrow+1w
2. 标签过滤：+project1 or +project2
3. 优先级过滤：pri > B
4. 文本匹配：description ~ "重要会议"
5. 逻辑组合：(due: < today) and (pri == A)

用户实践建议

对于Sleek用户，在使用高级过滤功能时建议注意以下几点：

1. 所有日期相关过滤必须使用冒号后缀（due:）
2. 优先级过滤不使用冒号（pri）
3. 复杂表达式建议使用括号明确优先级
4. 日期运算支持相对日期（如tomorrow+1d）

通过这次文档修正，Sleek项目的过滤表达式功能变得更加清晰易用。这也提醒我们，在软件开发过程中，功能变更与文档更新需要保持同步，才能为用户提供最佳的使用体验。