过滤语法参考
过滤视图是整理条目的强大工具。你可以使用各种参数和运算符自定义查询。
查询结构
创建单个条件的查询时,只需指定参数和对应的值即可。
示例:
feed_id:12345
你也可以使用逻辑运算符组合多个参数。
AND
使用 AND
连接多个参数,查询结果需要满足所有条件。
示例:
获取未读且标记为“稍后阅读”的条目:
location:readlater AND seen:false
OR
使用 OR
连接多个参数,查询结果只需满足其中一个条件。
示例:
获取来自书库或最后打开时间早于 2023 年 1 月 1 日的条目:
islibrary:true OR last_opened__lt:2023-01-01
复合条件
可以使用 AND
和 OR
组合多个条件,并用括号 ()
指定运算优先级。
示例:
以下查询会返回所有未读条目中,要么在收件箱中,要么标记为“稍后阅读”的内容:
seen:false AND (location:inbox OR location:readlater)
特殊符号
如果过滤条件中包含特殊符号(如空格、冒号等)时,使用半角双引号""
将其括起来(半角双引号除外)。例如:
tag:"学习/AI"
author:"Arthur C. Clarke"
参数
基础参数
参数和值之间用半角冒号连接(参数:值
)即可设置筛选条件。
feed_id
条目所属的订阅源 ID。 可以在 settings > RSS 订阅源页面查看订阅源 ID。
author
条目作者。
file_type
条目的文件类型。 可用的文件类型包括:
article
video
audio
ebook
pdf
时间参数
时间参数需要加上运算符(参数__运算符:值
),日期格式为 YYYY-MM-DD
。
published_at
条目发布时间。
created_at
条目创建时间。
updated_at
条目最后更新时间。
last_opened
条目最后打开时间。
运算符
可用的运算符包括:
__gt
(大于)
获取时间晚于指定日期的条目。__gte
(大于等于)
获取时间等于或晚于指定日期的条目。__lt
(小于)
获取时间早于指定日期的条目。__lte
(小于等于)
获取时间等于或早于指定日期的条目。
布尔参数
使用 字段名:true/false
格式根据真/假值筛选条目。
islibrary
条目是否来自“库”。
isfeed
条目是否来自订阅源。
seen
条目是否已读。
位置参数
根据条目位置进行筛选。
location
指示条目的位置。
可用值包括:
all
:所有条目。readlater
:标记为“稍后阅读”的条目。inbox
:收件箱中的条目。
相关内容参数
根据条目是否包含特定相关内容进行筛选。
has
使用 has
参数筛选包含特定内容的条目。
可用值包括:
note
:是否包含笔记。tag
:是否包含标签。
tag
按特定标签名称筛选条目。
tag_id
按特定标签的唯一 ID 筛选条目。 可以在 settings > 标签页面查看标签 ID。