OpenAPI oneOf显示项目两次（问题）？

Question

有抓头的问题。

我的OneOf数组“项目”在API文档中重复，如下所示：

我的猜测是问题出在实体模型的类prop或api文件中。

models / entity.json

{
  "$id": "entity.json",
  "type": "object",
  "additionalProperties": false,
  "required": ["id", "countryCode", "class"],
  "properties": {
    "id": {
      "readOnly": true,
      "allOf": [{
        "$ref": "./uuid.json"
      }],
      "description": "UUID of entity",
      "example": "49ad7378-121c-4a53-9894-dfd14a7b4877"
    },
    "countryCode": {
      "type": "string",
      "description": "Country code",
      "example": "SE",
      "pattern": "[A-Z][A-Z]"
    },
    "class": {
      "description": "Entity classification",
      "oneOf":[
        {
          "$ref": "./person.json"
        },
        {
          "$ref": "./sme.json"
        },
        {
          "$ref": "./corp.json"
        }
      ]
    },

模式/实体/api.json

"post": {
        "summary": "Create an entitiy",
        "operationId": "createEntity",
        "tags": [
          "entities"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/entity"
              }
            }
          }
        },

这就是oneOf中的模式模型的结构方式。

模型/ person.json

{
    "$id": "person.json",
    "type": "object",
    "title": "person",
    "required": [ "person" ],
    "description": "A Person",
    "properties": {
        "person": {
            "type": "object",
            "required": [ "name" ],
            "properties": {
                "name": {
                    "$ref": "./name.json",
                    "description": "Full name"
                },
                "ssn": {
                    "type": "string",
                    "description": "Social security number",
                    "example": "19710403-1123"
                },
                "address": {
                    "$ref": "./address.json"
                }
            }
        }
    }
}