为什么在Swagger模式中忽略过滤器属性？

我试图构建一个简单的招摇模型：

resources:
  - kind: PlayersDB
    api_version: players/v2
    path: players
    attributes:
    ...
    status:
      - name: status
        type: string
        x-extensible-enum: [HEALTHY, INJURED]
        ...
        example: HEALTHY
        required: true
        filters:
          - type: SearchFilter
            strategy: exact
            include_on:
              - list

由于某些原因，生成的HTML不会在查询参数下呈现状态过滤器。这让我觉得我做得不对

也就是说，当我将模式编辑为：

resources:
  - kind: PlayersDB
    api_version: players/v2
    path: players
    attributes:
    ...
    status:
      - name: status
        type: string
        x-extensible-enum: [HEALTHY, INJURED]
        ...
        example: HEALTHY
        required: true
    filters:
      - property: status
        type: SearchFilter
        field: status
        strategy: exact
        example: HEALTHY
        include_on:
          - list

过滤器被渲染

一些上下文：对于spec.yaml->html，我使用的是

redoccli

（这是一个用于OpenAPI->html包的cli工具）

问题是，是可以呈现#1，还是OpenAPI格式不支持它

我确实阅读了上的

对象和属性示例

部分，但没有找到很多与过滤器相关的信息