Skip to content

过滤语法参考

过滤视图是整理条目的强大工具。你可以使用各种参数和运算符自定义查询。

查询结构

创建单个条件的查询时,只需指定参数和对应的值即可。

示例

feed_id:12345

你也可以使用逻辑运算符组合多个参数。

AND

使用 AND 连接多个参数,查询结果需要满足所有条件。

示例

获取未读标记为“稍后阅读”的条目:

location:readlater AND seen:false

OR

使用 OR 连接多个参数,查询结果只需满足其中一个条件。

示例

获取来自书库最后打开时间早于 2023 年 1 月 1 日的条目:

islibrary:true OR last_opened__lt:2023-01-01

复合条件

可以使用 ANDOR 组合多个条件,并用括号 () 指定运算优先级。

示例

以下查询会返回所有未读条目中,要么在收件箱中,要么标记为“稍后阅读”的内容:

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。