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

复合条件 ​

可以使用 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。