捷径

将频繁使用的筛选器打包保存，以快速应用筛选条件

捷径将筛选表达式保存起来以便快速复用。捷径在你想要重新使用之前的筛选条件时尤为有用，例如工作事项、未完成的任务列表、最近发布的公开笔记等。

创建捷径

一般流程：

1. 在首页打开捷径弹窗

2. 给捷径起一个清晰明了的名字

3. 输入一个筛选器表达式

4. 保存到侧边栏，需要的时候点击启用

筛选器表达式语法

捷径使用 CEL（通用表达式语言 Common Expression Language）筛选表达式。一个捷径会筛选出所有被其表达式计算为 true 的笔记。

支持的字段

字段	类型	举例
content	字符串	content.contains("会议")
creator	字符串	creator == "users/john"
creator_id	整数	creator_id == 42
created_ts	整数	created_ts >= now() - 86400
updated_ts	整数	updated_ts >= now() - 3600
visibility	字符串	visibility == "PUBLIC"
pinned	布尔值	pinned
tags	字符串列表	"project/backend" in tags
tag	字符串列表别名	tag in ["work"]
has_task_list	布尔值	has_task_list
has_link	布尔值	has_link
has_code	布尔值	has_code
has_incomplete_tasks	布尔值	has_incomplete_tasks

操作符和函数

• 比较操作符： ==、!=、<、<=、>、>=

• 逻辑操作符：&&、||、!、()

• 关系操作符：tag in ["工作", "团队"]、"项目/后端" in tags、visibility in ["PUBLIC", "PROTECTED"]

• 函数：content.contains("文本")、size(tags)、now()

布尔类型的字段可以直接使用，而不需要额外的写 == true：

pinned && has_incomplete_tasks

标签匹配

当你想要匹配一个或多个标签树时，使用 tag in [...]。

tag in ["工作"]
tag in ["工作", "团队"]

tag in ["项目"] 同样匹配嵌套的标签，例如 项目/后端。

使用 tags.exists() 以支持更多标签模式：

tags.exists(t, t.startsWith("归档"))
tags.exists(t, t.endsWith("/bug"))
tags.exists(t, t.contains("待办"))

基于时间的筛选器

时间戳使用了 Unix 秒。你可以使用固定值，或与 now() 进行算数比较。

created_ts >= now() - 3600
created_ts >= now() - 7 * 86400
updated_ts >= now() - 60

捷径示例

名称	筛选器
工作待办	tag in ["工作"] && has_incomplete_tasks
公共笔记	visibility == "PUBLIC"
带链接的笔记	has_link
最近笔记	created_ts >= now() - 7 * 86400
团队更新	tag in ["团队"] && visibility == "PROTECTED"
未完成的任务	has_task_list && has_incomplete_tasks
置顶的引用	`pinned && (has_link
激活的项目	tags.exists(t, t.startsWith("项目")) && !tags.exists(t, t.startsWith("归档"))

适合使用捷径的场景

• 一个项目中的未完成的任务

• 被置顶的或高价值的笔记

• 分享前对公开笔记重新审核

• 一个时间窗口附近的笔记

• 一批包含链接或附件的笔记

捷径的管理建议

• 保持名称的简短和清晰

• 删除旧的且不再使用的捷径

• 当你标签上的词汇改变时，更新筛选条件

• 与其创建很多只用一次的捷径，不如多创建持久且好用的

使用限制

捷径是个人工作流程上的工具，多数情景时在主页使用。捷径应该根据需求而使用，体现了你最真实的使用习惯，而不是在捷径上罗列所有能用的筛选条件。

不支持的模式包括正则表达式、all()、filter()、map()以及日期字符串解析。请改用Unix时间戳或now()算术运算。