{
  "openapi": "3.1.0",
  "info": {
    "title": "NexusMC 公开内容 API",
    "version": "1.0.0",
    "description": "匿名可访问的公开内容查询。"
  },
  "servers": [
    {
      "url": "http://127.0.0.1:4520"
    }
  ],
  "components": {
    "schemas": {
      "PlatformReplyNode": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "kind": {
            "type": "string"
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "authorId": {
            "type": "string"
          },
          "preview": {
            "type": "string"
          },
          "author": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "avatar": {
                "type": [
                  "string",
                  "null"
                ],
                "x-platform-site-url": true
              },
              "badges": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "color": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "avatar",
              "badges"
            ],
            "additionalProperties": false,
            "x-platform-model": "PlatformAuthor"
          },
          "parentPostId": {
            "type": [
              "string",
              "null"
            ]
          },
          "rootPostId": {
            "type": [
              "string",
              "null"
            ]
          },
          "depth": {
            "type": "number"
          },
          "createdAt": {
            "type": "string"
          },
          "createdRel": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "lastActivityAt": {
            "type": "string"
          },
          "lastActivityRel": {
            "type": "string"
          },
          "replyCount": {
            "type": "number"
          },
          "ref": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "id": {
                "type": "string"
              },
              "slug": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "summary": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cover": {
                "type": [
                  "string",
                  "null"
                ],
                "x-platform-site-url": true
              },
              "tombstone": {
                "type": "boolean"
              }
            },
            "required": [
              "type",
              "id",
              "slug",
              "title",
              "summary",
              "cover",
              "tombstone"
            ],
            "additionalProperties": false,
            "x-platform-model": "PlatformEntityReference"
          },
          "tombstone": {
            "type": "boolean"
          },
          "children": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlatformReplyNode"
            }
          },
          "childrenTotal": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "childrenNextCursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "reactions": {
            "type": "object",
            "properties": {
              "like": {
                "type": "number"
              },
              "favorite": {
                "type": "number"
              }
            },
            "required": [
              "like",
              "favorite"
            ],
            "additionalProperties": false,
            "x-platform-model": "PlatformReactions"
          }
        },
        "required": [
          "id",
          "body",
          "tombstone",
          "children",
          "childrenTotal",
          "childrenNextCursor"
        ],
        "additionalProperties": false,
        "x-platform-model": "PlatformReplyNode"
      }
    },
    "parameters": {},
    "securitySchemes": {
      "personalBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "仅逐操作白名单可选；须有 x-required-scope，凭据失效不降级匿名。"
      },
      "oauthAccessBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "与本操作所需 PAT scope 相同；不创建网站会话。"
      }
    }
  },
  "paths": {
    "/v1/site/search": {
      "get": {
        "operationId": "searchContent",
        "tags": [
          "搜索"
        ],
        "summary": "搜索公开内容",
        "description": "加载器、游戏版本和类型必须由同一条发布记录同时满足。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "required": true,
            "name": "q",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "terms",
                "phrase",
                "fuzzy"
              ]
            },
            "required": false,
            "name": "mode",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "newest",
                "popular"
              ]
            },
            "required": false,
            "name": "sort",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 12000
            },
            "required": false,
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "entity",
            "in": "query",
            "example": "resource"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "tag",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "type",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "capability",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "hits": [
                    {
                      "entityType": "resource",
                      "entityId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "sourceRevision": "1",
                      "title": "示例性能工具",
                      "summary": "这是用于展示接口结构的示例资源。",
                      "slug": "example-performance",
                      "fragmentId": "",
                      "textParts": [
                        {
                          "text": "性能",
                          "match": true
                        },
                        {
                          "text": "工具",
                          "match": false
                        }
                      ],
                      "reference": null
                    }
                  ],
                  "nextCursor": null,
                  "hasMore": false,
                  "scanBudgetExhausted": false,
                  "index": {
                    "replicaId": "example-replica",
                    "generation": "1",
                    "dataEpoch": "1",
                    "pendingCount": "0",
                    "oldestPendingAgeMs": 0
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "hits": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "entityType": {
                            "type": "string"
                          },
                          "entityId": {
                            "type": "string"
                          },
                          "sourceRevision": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "fragmentId": {
                            "type": "string"
                          },
                          "textParts": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "text": {
                                  "type": "string"
                                },
                                "match": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "text",
                                "match"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "reference": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "entityType": {
                                "type": "string",
                                "enum": [
                                  "resource"
                                ]
                              },
                              "entityId": {
                                "type": "string"
                              },
                              "tombstone": {
                                "type": "boolean"
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "entityType",
                              "entityId",
                              "tombstone",
                              "title",
                              "summary",
                              "slug"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "entityType",
                          "entityId",
                          "sourceRevision",
                          "title",
                          "summary",
                          "slug",
                          "fragmentId",
                          "textParts",
                          "reference"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "hasMore": {
                      "type": "boolean"
                    },
                    "scanBudgetExhausted": {
                      "type": "boolean"
                    },
                    "index": {
                      "type": "object",
                      "properties": {
                        "replicaId": {
                          "type": "string"
                        },
                        "generation": {
                          "type": "string"
                        },
                        "dataEpoch": {
                          "type": "string"
                        },
                        "pendingCount": {
                          "type": "string"
                        },
                        "oldestPendingAgeMs": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "replicaId",
                        "generation",
                        "dataEpoch",
                        "pendingCount",
                        "oldestPendingAgeMs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "hits",
                    "nextCursor",
                    "hasMore",
                    "scanBudgetExhausted",
                    "index"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "409": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/search"
      }
    },
    "/v1/site/search/suggest": {
      "get": {
        "operationId": "suggestContent",
        "tags": [
          "搜索"
        ],
        "summary": "获取公开内容建议",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120
            },
            "required": true,
            "name": "prefix",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值请重复传入同名参数，不支持使用逗号分隔。"
            },
            "required": false,
            "description": "多值请重复传入同名参数，不支持使用逗号分隔。",
            "name": "entity",
            "in": "query",
            "example": "resource"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 5
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "items": [
                    {
                      "entityType": "resource",
                      "entityId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "sourceRevision": "1",
                      "text": "示例性能工具",
                      "slug": "example-performance"
                    }
                  ],
                  "index": {
                    "replicaId": "example-replica",
                    "generation": "1",
                    "dataEpoch": "1",
                    "pendingCount": "0",
                    "oldestPendingAgeMs": 0
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "entityType": {
                            "type": "string"
                          },
                          "entityId": {
                            "type": "string"
                          },
                          "sourceRevision": {
                            "type": "string"
                          },
                          "text": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "entityType",
                          "entityId",
                          "sourceRevision",
                          "text",
                          "slug"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "index": {
                      "type": "object",
                      "properties": {
                        "replicaId": {
                          "type": "string"
                        },
                        "generation": {
                          "type": "string"
                        },
                        "dataEpoch": {
                          "type": "string"
                        },
                        "pendingCount": {
                          "type": "string"
                        },
                        "oldestPendingAgeMs": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "replicaId",
                        "generation",
                        "dataEpoch",
                        "pendingCount",
                        "oldestPendingAgeMs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "items",
                    "index"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/search/suggest"
      }
    },
    "/v1/site/browse": {
      "get": {
        "operationId": "browseResources",
        "tags": [
          "发现"
        ],
        "summary": "随机浏览公开资源",
        "parameters": [
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "slug": "example-performance",
                      "title": "示例性能工具",
                      "summary": "这是用于展示接口结构的示例资源。",
                      "cover": null
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "cover": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "cover"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "items"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/browse"
      }
    },
    "/v1/site/home": {
      "get": {
        "operationId": "getHome",
        "tags": [
          "发现"
        ],
        "summary": "获取首页内容",
        "parameters": [
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "intent",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "intents": [],
                  "activeIntents": [],
                  "shelves": [
                    {
                      "id": "recommended",
                      "label": "推荐资源",
                      "items": [
                        {
                          "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                          "slug": "example-performance",
                          "title": "示例性能工具",
                          "summary": "这是用于展示接口结构的示例资源。",
                          "ownerId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                          "author": null,
                          "cover": null,
                          "tags": [
                            {
                              "slug": "optimization",
                              "label": "性能优化",
                              "dimension": "gameplay"
                            }
                          ],
                          "capabilities": [
                            "download"
                          ],
                          "capabilityKeys": [
                            "download"
                          ],
                          "loaders": [
                            "fabric"
                          ],
                          "types": [
                            "mod"
                          ],
                          "releaseCount": 1,
                          "matchedReleaseCount": 1,
                          "legacyMc": [
                            "1.20.1"
                          ],
                          "postCount": 0,
                          "replyCount": 0,
                          "modpack": false,
                          "inRecipe": false
                        }
                      ]
                    }
                  ],
                  "posts": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "title": "Fabric 1.20.1 性能配置交流",
                      "body": "分享你使用的配置与测试结果。",
                      "kind": "discussion",
                      "state": null,
                      "authorId": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                    }
                  ],
                  "matchedPostCount": 1,
                  "matchedResourceCount": 1,
                  "intentLimit": 8
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "stats": {
                      "type": "object",
                      "properties": {
                        "resources": {
                          "type": "number"
                        },
                        "posts": {
                          "type": "number"
                        },
                        "users": {
                          "type": "number"
                        },
                        "builds": {
                          "type": "number"
                        },
                        "tags": {
                          "type": "number"
                        },
                        "activeToday": {
                          "type": "number"
                        },
                        "weekNew": {
                          "type": "number"
                        },
                        "unanswered": {
                          "type": "number"
                        },
                        "bounties": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "resources",
                        "posts",
                        "users",
                        "builds",
                        "tags",
                        "activeToday",
                        "weekNew",
                        "unanswered",
                        "bounties"
                      ],
                      "additionalProperties": false
                    },
                    "intents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "hint": {
                            "type": "string"
                          },
                          "resourceCount": {
                            "type": "number"
                          },
                          "postCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "hint",
                          "resourceCount",
                          "postCount"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "activeIntent": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "activeIntents": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "context": {
                      "type": "object",
                      "properties": {
                        "loader": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mc": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "loader",
                        "mc"
                      ],
                      "additionalProperties": false
                    },
                    "notice": {
                      "type": "null"
                    },
                    "editorPicks": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformResourceCard"
                      },
                      "maxItems": 0
                    },
                    "hero": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformResourceCard"
                      },
                      "maxItems": 0
                    },
                    "shelves": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "slug": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "summary": {
                                  "type": "string"
                                },
                                "ownerId": {
                                  "type": "string"
                                },
                                "author": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "id": {
                                      "type": "string"
                                    },
                                    "name": {
                                      "type": "string"
                                    },
                                    "avatar": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "x-platform-site-url": true
                                    },
                                    "badges": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "color": {
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "name",
                                    "avatar",
                                    "badges"
                                  ],
                                  "additionalProperties": false,
                                  "x-platform-model": "PlatformAuthor"
                                },
                                "cover": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "x-platform-site-url": true
                                    },
                                    "width": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "height": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "url",
                                    "width",
                                    "height"
                                  ],
                                  "additionalProperties": false,
                                  "x-platform-model": "PlatformCover"
                                },
                                "tags": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "slug": {
                                        "type": "string"
                                      },
                                      "label": {
                                        "type": "string"
                                      },
                                      "dimension": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "slug",
                                      "label",
                                      "dimension"
                                    ],
                                    "additionalProperties": false,
                                    "x-platform-model": "PlatformTag"
                                  }
                                },
                                "capabilities": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "capabilityKeys": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "loaders": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "types": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "releaseCount": {
                                  "type": "number"
                                },
                                "matchedReleaseCount": {
                                  "type": "number"
                                },
                                "legacyMc": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "postCount": {
                                  "type": "number"
                                },
                                "replyCount": {
                                  "type": "number"
                                },
                                "modpack": {
                                  "type": "boolean"
                                },
                                "inRecipe": {
                                  "type": "boolean"
                                },
                                "downloads": {
                                  "type": "number"
                                },
                                "updatedAt": {
                                  "type": "string"
                                },
                                "updatedRel": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "stub": {
                                  "type": "boolean"
                                },
                                "legacyCount": {
                                  "type": "number"
                                },
                                "hasForge": {
                                  "type": "boolean"
                                },
                                "typeLabel": {
                                  "type": "string"
                                },
                                "latestRel": {
                                  "type": "string"
                                },
                                "lastPublishedRel": {
                                  "type": "string"
                                },
                                "loaderCount": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "id",
                                "slug",
                                "title",
                                "summary",
                                "ownerId",
                                "author",
                                "cover",
                                "tags",
                                "capabilities",
                                "capabilityKeys",
                                "loaders",
                                "types",
                                "releaseCount",
                                "matchedReleaseCount",
                                "legacyMc",
                                "postCount",
                                "replyCount",
                                "modpack",
                                "inRecipe"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformHomeResource"
                            }
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "items"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "latest": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          },
                          "typeLabel": {
                            "type": "string"
                          },
                          "latestRel": {
                            "type": "string"
                          },
                          "lastPublishedRel": {
                            "type": "string"
                          },
                          "loaderCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformHomeResource"
                      }
                    },
                    "posts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          },
                          "identity": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "title",
                          "kind",
                          "state",
                          "authorId"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformHomePost"
                      }
                    },
                    "resources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          },
                          "typeLabel": {
                            "type": "string"
                          },
                          "latestRel": {
                            "type": "string"
                          },
                          "lastPublishedRel": {
                            "type": "string"
                          },
                          "loaderCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformHomeResource"
                      }
                    },
                    "trending": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          },
                          "typeLabel": {
                            "type": "string"
                          },
                          "latestRel": {
                            "type": "string"
                          },
                          "lastPublishedRel": {
                            "type": "string"
                          },
                          "loaderCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformHomeResource"
                      }
                    },
                    "popular": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          },
                          "typeLabel": {
                            "type": "string"
                          },
                          "latestRel": {
                            "type": "string"
                          },
                          "lastPublishedRel": {
                            "type": "string"
                          },
                          "loaderCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformHomeResource"
                      }
                    },
                    "recentReleases": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "resourceSlug": {
                            "type": "string"
                          },
                          "resourceTitle": {
                            "type": "string"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "versionNumber": {
                            "type": "string"
                          },
                          "releaseType": {
                            "type": "string"
                          },
                          "environment": {
                            "type": "string"
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "publishedRel": {
                            "type": "string"
                          },
                          "typeLabel": {
                            "type": "string"
                          },
                          "fileCount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "resourceSlug",
                          "resourceTitle",
                          "cover",
                          "author",
                          "versionNumber",
                          "releaseType",
                          "environment",
                          "loaders",
                          "publishedRel",
                          "typeLabel",
                          "fileCount"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "recentReplies": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "postId": {
                            "type": "string"
                          },
                          "postTitle": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "body": {
                            "type": "string"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "postId",
                          "postTitle",
                          "author",
                          "body",
                          "createdAt",
                          "createdRel"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "weekHot": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "lastReplyRel": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "author",
                          "replyCount",
                          "lastReplyRel"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "todayUsers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "avatar": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "badges": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "color": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "avatar",
                          "badges"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformAuthor"
                      }
                    },
                    "topTags": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "dimension": {
                            "type": "string"
                          },
                          "count": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "slug",
                          "label",
                          "dimension",
                          "count"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "tutorials": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "author_id": {
                            "type": "string"
                          },
                          "updated_at": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "updatedAt": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "author",
                          "updatedAt"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "needsYou": {
                      "type": "object",
                      "properties": {
                        "unanswered": {
                          "type": "number"
                        },
                        "bounties": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "unanswered",
                        "bounties"
                      ],
                      "additionalProperties": false
                    },
                    "contextOptions": {
                      "type": "object",
                      "properties": {
                        "loaders": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "dimension": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "count": {
                                "type": "number"
                              },
                              "downloads": {
                                "type": "number"
                              },
                              "sortOrder": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "value",
                              "label",
                              "count",
                              "downloads"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformContextChoice"
                          }
                        },
                        "mcs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "dimension": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "count": {
                                "type": "number"
                              },
                              "downloads": {
                                "type": "number"
                              },
                              "sortOrder": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "value",
                              "label",
                              "count",
                              "downloads"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformContextChoice"
                          }
                        }
                      },
                      "required": [
                        "loaders",
                        "mcs"
                      ],
                      "additionalProperties": false
                    },
                    "matchedPostCount": {
                      "type": "number"
                    },
                    "matchedResourceCount": {
                      "type": "number"
                    },
                    "intentLimit": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "intents",
                    "activeIntents",
                    "shelves",
                    "posts",
                    "matchedPostCount",
                    "matchedResourceCount",
                    "intentLimit"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformHome"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/home"
      }
    },
    "/v1/site/capabilities": {
      "get": {
        "operationId": "listCapabilities",
        "tags": [
          "字典"
        ],
        "summary": "列出能力定义",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": [
                  {
                    "id": "download",
                    "label": "下载",
                    "slot": "main",
                    "order": 1,
                    "renderers": [
                      "download"
                    ],
                    "defaults": {},
                    "hint": null,
                    "exposesFilter": true
                  }
                ],
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "slot": {
                        "type": "string"
                      },
                      "order": {
                        "type": "number"
                      },
                      "renderers": {
                        "x-platform-open-json": "Platform capability renderer registry metadata is extension-defined JSON."
                      },
                      "defaults": {
                        "x-platform-open-json": "Platform capability payload defaults use the capability-defined schema."
                      },
                      "hint": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "exposesFilter": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "slot",
                      "order",
                      "hint",
                      "exposesFilter"
                    ],
                    "additionalProperties": false,
                    "x-platform-model": "PlatformCapabilityDefinition"
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/capabilities"
      }
    },
    "/v1/site/blocks": {
      "get": {
        "operationId": "listBlocks",
        "tags": [
          "字典"
        ],
        "summary": "列出内容区块",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "items": [
                    {
                      "id": "resources",
                      "label": "资源",
                      "hint": null,
                      "slot": "main",
                      "order": 1
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "hint": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "slot": {
                            "type": "string"
                          },
                          "order": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "hint",
                          "slot",
                          "order"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "items"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/blocks"
      }
    },
    "/v1/site/gaps": {
      "get": {
        "operationId": "listGaps",
        "tags": [
          "发现"
        ],
        "summary": "列出资源缺口",
        "parameters": [
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "total": 0,
                  "totalReferences": 0,
                  "packCount": 0,
                  "packs": [],
                  "directionTags": [],
                  "gaps": []
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "number"
                    },
                    "totalReferences": {
                      "type": "number"
                    },
                    "packCount": {
                      "type": "number"
                    },
                    "packs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "title"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "directionTags": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "gaps": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "count": {
                            "type": "number"
                          },
                          "referencedBy": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "title"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "packCount": {
                            "type": "number"
                          },
                          "hint": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "key",
                          "name",
                          "url",
                          "count",
                          "referencedBy",
                          "packCount",
                          "hint"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "total",
                    "totalReferences",
                    "packCount",
                    "packs",
                    "directionTags",
                    "gaps"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/gaps"
      }
    },
    "/v1/site/check": {
      "get": {
        "operationId": "checkCompatibility",
        "tags": [
          "发现"
        ],
        "summary": "检查多资源构建兼容性",
        "description": "每个组合在同一条发布记录内同时满足加载器和游戏版本。",
        "parameters": [
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "minItems": 1,
                  "maxItems": 50
                }
              ]
            },
            "required": true,
            "name": "r",
            "in": "query",
            "example": [
              "example-performance",
              "example-library"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "picked": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "slug": "example-performance",
                      "title": "示例性能工具"
                    }
                  ],
                  "missing": [],
                  "combos": [
                    {
                      "loader": "fabric",
                      "mc": "1.20.1",
                      "support": 1,
                      "ok": true,
                      "slugs": [
                        "example-performance"
                      ],
                      "missing": []
                    }
                  ],
                  "totalCombos": 1,
                  "best": null,
                  "allOk": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "picked": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "missing": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "combos": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "loader": {
                            "type": "string"
                          },
                          "mc": {
                            "type": "string"
                          },
                          "support": {
                            "type": "number"
                          },
                          "ok": {
                            "type": "boolean"
                          },
                          "slugs": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "missing": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "required": [
                          "loader",
                          "mc",
                          "support",
                          "ok",
                          "slugs",
                          "missing"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformCompatibilityCombo"
                      }
                    },
                    "totalCombos": {
                      "type": "number"
                    },
                    "best": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "loader": {
                          "type": "string"
                        },
                        "mc": {
                          "type": "string"
                        },
                        "support": {
                          "type": "number"
                        },
                        "ok": {
                          "type": "boolean"
                        },
                        "slugs": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "missing": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "loader",
                        "mc",
                        "support",
                        "ok",
                        "slugs",
                        "missing"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformCompatibilityCombo"
                    },
                    "allOk": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "picked",
                    "missing",
                    "combos",
                    "totalCombos",
                    "best",
                    "allOk"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/check"
      }
    },
    "/v1/site/resources": {
      "get": {
        "operationId": "listResources",
        "tags": [
          "资源"
        ],
        "summary": "筛选公开资源",
        "description": "加载器、游戏版本和类型必须在同一条发布记录同时匹配。同一维度为 OR，跨维度为 AND。",
        "parameters": [
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "type",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "tag",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "capability",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "required": false,
            "name": "q",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "downloads",
                "updated",
                "suitable"
              ]
            },
            "required": false,
            "name": "sort",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "required": false,
            "name": "page",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "required": false,
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 128
            },
            "required": false,
            "name": "recipe",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "query": {
                    "loaders": [
                      "fabric"
                    ],
                    "mcs": [
                      "1.20.1"
                    ],
                    "types": [],
                    "tags": [],
                    "q": "性能"
                  },
                  "sort": "downloads",
                  "total": 1,
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "slug": "example-performance",
                      "title": "示例性能工具",
                      "summary": "这是用于展示接口结构的示例资源。",
                      "ownerId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "author": null,
                      "cover": null,
                      "tags": [
                        {
                          "slug": "optimization",
                          "label": "性能优化",
                          "dimension": "gameplay"
                        }
                      ],
                      "capabilities": [
                        "download"
                      ],
                      "capabilityKeys": [
                        "download"
                      ],
                      "loaders": [
                        "fabric"
                      ],
                      "types": [
                        "mod"
                      ],
                      "releaseCount": 1,
                      "matchedReleaseCount": 1,
                      "legacyMc": [
                        "1.20.1"
                      ],
                      "postCount": 0,
                      "replyCount": 0,
                      "modpack": false,
                      "inRecipe": false
                    }
                  ],
                  "facets": [
                    {
                      "id": "loader",
                      "queryKey": "loader",
                      "values": [
                        {
                          "value": "fabric"
                        }
                      ]
                    }
                  ],
                  "page": 1,
                  "limit": 10,
                  "nextCursor": null
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "query": {
                      "type": "object",
                      "properties": {
                        "loaders": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "mcs": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "types": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "q": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "loaders",
                        "mcs",
                        "types",
                        "tags",
                        "q"
                      ],
                      "additionalProperties": false
                    },
                    "sort": {
                      "type": "string"
                    },
                    "total": {
                      "type": "number"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "summary": {
                            "type": "string"
                          },
                          "ownerId": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "cover": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "url": {
                                "type": "string",
                                "x-platform-site-url": true
                              },
                              "width": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "height": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "url",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformCover"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "label",
                                "dimension"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformTag"
                            }
                          },
                          "capabilities": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "capabilityKeys": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseCount": {
                            "type": "number"
                          },
                          "matchedReleaseCount": {
                            "type": "number"
                          },
                          "legacyMc": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "postCount": {
                            "type": "number"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "modpack": {
                            "type": "boolean"
                          },
                          "inRecipe": {
                            "type": "boolean"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "updatedRel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stub": {
                            "type": "boolean"
                          },
                          "legacyCount": {
                            "type": "number"
                          },
                          "hasForge": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "summary",
                          "ownerId",
                          "author",
                          "cover",
                          "tags",
                          "capabilities",
                          "capabilityKeys",
                          "loaders",
                          "types",
                          "releaseCount",
                          "matchedReleaseCount",
                          "legacyMc",
                          "postCount",
                          "replyCount",
                          "modpack",
                          "inRecipe"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformResourceCard"
                      }
                    },
                    "facets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "queryKey": {
                            "type": "string"
                          },
                          "values": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "value": {
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "dimension": {
                                  "type": "string"
                                },
                                "sort_order": {
                                  "type": "number"
                                },
                                "is_release": {
                                  "type": [
                                    "boolean",
                                    "null"
                                  ]
                                },
                                "group_slug": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "count": {
                                  "type": "number"
                                },
                                "downloads": {
                                  "type": "number"
                                },
                                "pinned": {
                                  "type": "boolean"
                                },
                                "note": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                }
                              },
                              "required": [
                                "value"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformFacetValue"
                            }
                          }
                        },
                        "required": [
                          "id",
                          "queryKey",
                          "values"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformResourceFacet"
                      }
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "loaderLabels": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "isEmptyQuery": {
                      "type": "boolean"
                    },
                    "notice": {
                      "type": "null"
                    },
                    "recipes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "hint": {
                            "type": "string"
                          },
                          "forWho": {
                            "type": "string"
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "mc": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          },
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "slug": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "summary": {
                                  "type": "string"
                                },
                                "cover": {
                                  "type": [
                                    "object",
                                    "null"
                                  ],
                                  "properties": {
                                    "url": {
                                      "type": "string",
                                      "x-platform-site-url": true
                                    },
                                    "width": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "height": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "url",
                                    "width",
                                    "height"
                                  ],
                                  "additionalProperties": false,
                                  "x-platform-model": "PlatformCover"
                                },
                                "stub": {
                                  "type": "boolean"
                                },
                                "modpack": {
                                  "type": "boolean"
                                },
                                "loaders": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "types": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "role": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "slug",
                                "title",
                                "summary",
                                "cover",
                                "stub",
                                "modpack",
                                "loaders",
                                "types",
                                "role"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformRecipeItem"
                            }
                          },
                          "slugs": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "hint",
                          "forWho",
                          "loaders",
                          "mc",
                          "source",
                          "items",
                          "slugs"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformRecipe"
                      }
                    },
                    "activeRecipe": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        },
                        "hint": {
                          "type": "string"
                        },
                        "forWho": {
                          "type": "string"
                        },
                        "loaders": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "mc": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string"
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "slug": {
                                "type": "string"
                              },
                              "title": {
                                "type": "string"
                              },
                              "summary": {
                                "type": "string"
                              },
                              "cover": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "properties": {
                                  "url": {
                                    "type": "string",
                                    "x-platform-site-url": true
                                  },
                                  "width": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  },
                                  "height": {
                                    "type": [
                                      "number",
                                      "null"
                                    ]
                                  }
                                },
                                "required": [
                                  "url",
                                  "width",
                                  "height"
                                ],
                                "additionalProperties": false,
                                "x-platform-model": "PlatformCover"
                              },
                              "stub": {
                                "type": "boolean"
                              },
                              "modpack": {
                                "type": "boolean"
                              },
                              "loaders": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "types": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "role": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "stub",
                              "modpack",
                              "loaders",
                              "types",
                              "role"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformRecipeItem"
                          }
                        },
                        "slugs": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "id",
                        "title",
                        "hint",
                        "forWho",
                        "loaders",
                        "mc",
                        "source",
                        "items",
                        "slugs"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformRecipe"
                    },
                    "recipeDisclosure": {
                      "type": "string"
                    },
                    "unresolvedTags": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "projectionGeneration": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "query",
                    "sort",
                    "total",
                    "items",
                    "facets",
                    "page",
                    "limit",
                    "nextCursor"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformResourceList"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed"
      }
    },
    "/v1/site/resources/names": {
      "get": {
        "operationId": "findResourceNames",
        "tags": [
          "资源"
        ],
        "summary": "查找资源名称",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "q",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": [
                  {
                    "slug": "example-performance",
                    "title": "示例性能工具"
                  }
                ],
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "slug",
                      "title"
                    ],
                    "additionalProperties": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources/names",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed"
      }
    },
    "/v1/site/resources/{slug}": {
      "get": {
        "operationId": "getResource",
        "tags": [
          "资源"
        ],
        "summary": "获取资源详情及匹配发布",
        "description": "每个展示族返回最近 20 个完整合并发布单元。allReleases 仅兼容旧参数；继续加载使用发布分页接口。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "type",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "tag",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "capability",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "required": false,
            "name": "q",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "downloads",
                "updated",
                "suitable"
              ]
            },
            "required": false,
            "name": "sort",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "required": false,
            "name": "page",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "required": false,
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 128
            },
            "required": false,
            "name": "recipe",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            },
            "required": false,
            "name": "allReleases",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "release",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "slug": "example-performance",
                  "title": "示例性能工具",
                  "summary": "这是用于展示接口结构的示例资源。",
                  "body": "选择匹配的构建。",
                  "releaseCount": 1,
                  "matchedReleaseCount": 1,
                  "groups": [
                    {
                      "group": "mod",
                      "label": "模组",
                      "versionCount": 1,
                      "truncated": false,
                      "nextCursor": null,
                      "releases": [
                        {
                          "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                          "versionNumber": "1.0.0",
                          "compat": [
                            {
                              "releaseId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                              "loaders": [
                                "fabric"
                              ],
                              "mcVersions": [
                                "1.20.1"
                              ],
                              "matched": true,
                              "versionGroup": "minecraft-java"
                            }
                          ]
                        }
                      ]
                    }
                  ],
                  "matchMessage": null
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "summary": {
                      "type": "string"
                    },
                    "body": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "releaseCount": {
                      "type": "number"
                    },
                    "matchedReleaseCount": {
                      "type": "number"
                    },
                    "groups": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "group": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "versionCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "truncated": {
                            "type": "boolean"
                          },
                          "releases": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "versionNumber": {
                                  "type": "string"
                                },
                                "publishedAt": {
                                  "type": "string"
                                },
                                "publishedRel": {
                                  "type": "string"
                                },
                                "downloads": {
                                  "type": "number"
                                },
                                "name": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "releaseType": {
                                  "type": "string"
                                },
                                "environment": {
                                  "type": "string"
                                },
                                "changelog": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "installNote": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "releaseTypeLabel": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "environmentLabel": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "installTemplate": {
                                  "type": "string"
                                },
                                "loaders": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "mcVersions": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "releaseIds": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "primaryFileId": {
                                  "type": "string"
                                },
                                "files": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string"
                                      },
                                      "filename": {
                                        "type": "string"
                                      },
                                      "size": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "sha512": {
                                        "type": [
                                          "string",
                                          "null"
                                        ]
                                      },
                                      "isPrimary": {
                                        "type": "boolean"
                                      },
                                      "url": {
                                        "type": "string",
                                        "x-platform-site-url": true
                                      },
                                      "format": {
                                        "type": "string"
                                      },
                                      "release_id": {
                                        "type": "string"
                                      },
                                      "is_primary": {
                                        "type": "boolean"
                                      },
                                      "primary": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "filename",
                                      "size",
                                      "sha512",
                                      "isPrimary",
                                      "url",
                                      "format"
                                    ],
                                    "additionalProperties": false,
                                    "x-platform-model": "PlatformReleaseFile"
                                  }
                                },
                                "compat": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "releaseId": {
                                        "type": "string"
                                      },
                                      "loaders": {
                                        "type": "array",
                                        "items": {
                                          "type": "string"
                                        }
                                      },
                                      "mcVersions": {
                                        "type": "array",
                                        "items": {
                                          "type": "string"
                                        }
                                      },
                                      "matched": {
                                        "type": "boolean"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "versionGroup": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "pattern": "^[a-z][a-z0-9-]{1,63}$"
                                      }
                                    },
                                    "required": [
                                      "releaseId",
                                      "loaders",
                                      "mcVersions",
                                      "matched",
                                      "versionGroup"
                                    ],
                                    "additionalProperties": false,
                                    "x-platform-model": "PlatformReleaseCompatibility"
                                  }
                                },
                                "matched": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "id",
                                "versionNumber",
                                "compat"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformReleaseUnit"
                            }
                          },
                          "nextCursor": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "group",
                          "label",
                          "versionCount",
                          "truncated",
                          "releases",
                          "nextCursor"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReleaseGroup"
                      }
                    },
                    "matchMessage": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ownerId": {
                      "type": "string"
                    },
                    "author": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "avatar": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "x-platform-site-url": true
                        },
                        "badges": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "color": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "avatar",
                        "badges"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformAuthor"
                    },
                    "cover": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "url": {
                          "type": "string",
                          "x-platform-site-url": true
                        },
                        "width": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "height": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "url",
                        "width",
                        "height"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformCover"
                    },
                    "capabilities": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "slot": {
                            "type": "string"
                          },
                          "order": {
                            "type": "number"
                          },
                          "publicHint": {
                            "type": "string"
                          },
                          "payload": {
                            "x-platform-open-json": "Capability-specific resource payload and renderer options are author-defined JSON."
                          },
                          "renderer": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rendererLabel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "implemented": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "slot",
                          "order",
                          "publicHint",
                          "payload",
                          "renderer",
                          "rendererLabel",
                          "implemented"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformCapabilityView"
                      }
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "dimension": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "slug",
                          "label",
                          "dimension"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformTag"
                      }
                    },
                    "stub": {
                      "type": "boolean"
                    },
                    "filter": {
                      "type": "object",
                      "properties": {
                        "loader": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mc": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "type": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "loader",
                        "mc",
                        "type"
                      ],
                      "additionalProperties": false
                    },
                    "loaders": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "loaderLabels": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "mcVersions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "types": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "source_type": {
                            "type": "string"
                          },
                          "source_id": {
                            "type": "string"
                          },
                          "source_release_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "relation": {
                            "type": "string"
                          },
                          "role": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_key": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "kind": {
                            "type": "string"
                          },
                          "fragment_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "fragment_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "note": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sort_order": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "created_at": {
                            "type": "string"
                          },
                          "target_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_cover": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "target_summary": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_deleted_at": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "tombstone": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformPublicReference"
                      }
                    },
                    "bundles": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string"
                        },
                        "versionNumber": {
                          "type": "string"
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "total": {
                          "type": "number"
                        },
                        "inSiteCount": {
                          "type": "number"
                        },
                        "offSiteCount": {
                          "type": "number"
                        },
                        "fileCount": {
                          "type": "number"
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "ref": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "role": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "kind": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "href": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "name",
                              "ref",
                              "role",
                              "kind",
                              "url",
                              "href",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformReferenceItem"
                          }
                        }
                      },
                      "required": [
                        "releaseId",
                        "versionNumber",
                        "truncated",
                        "total",
                        "inSiteCount",
                        "offSiteCount",
                        "fileCount",
                        "items"
                      ],
                      "additionalProperties": false
                    },
                    "dependencies": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "required": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "ref": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "role": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "kind": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "href": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "name",
                              "ref",
                              "role",
                              "kind",
                              "url",
                              "href",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformReferenceItem"
                          }
                        },
                        "optional": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "ref": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "role": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "kind": {
                                "type": "string"
                              },
                              "url": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "href": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "name",
                              "ref",
                              "role",
                              "kind",
                              "url",
                              "href",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformReferenceItem"
                          }
                        },
                        "offSiteCount": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "required",
                        "optional",
                        "offSiteCount"
                      ],
                      "additionalProperties": false
                    },
                    "includedBy": {
                      "type": "object",
                      "properties": {
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "slug": {
                                "type": "string"
                              },
                              "title": {
                                "type": "string"
                              },
                              "versions": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "href": {
                                "type": "string",
                                "x-platform-site-url": true
                              }
                            },
                            "required": [
                              "slug",
                              "title",
                              "versions",
                              "href"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "items"
                      ],
                      "additionalProperties": false
                    },
                    "discussions": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "number"
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "state": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "author": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "properties": {
                                  "id": {
                                    "type": "string"
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "avatar": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "x-platform-site-url": true
                                  },
                                  "badges": {
                                    "type": "array",
                                    "items": {
                                      "type": "string"
                                    }
                                  },
                                  "color": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "name",
                                  "avatar",
                                  "badges"
                                ],
                                "additionalProperties": false,
                                "x-platform-model": "PlatformAuthor"
                              },
                              "replyCount": {
                                "type": "number"
                              },
                              "createdAt": {
                                "type": "string"
                              },
                              "createdRel": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "title",
                              "state",
                              "author",
                              "replyCount",
                              "createdAt",
                              "createdRel"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "total",
                        "items"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "slug",
                    "title",
                    "summary",
                    "body",
                    "releaseCount",
                    "matchedReleaseCount",
                    "groups",
                    "matchMessage"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformResourceDetail"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources/{slug}",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed"
      }
    },
    "/v1/site/resources/{slug}/releases": {
      "get": {
        "operationId": "resourceReleases",
        "tags": [
          "资源"
        ],
        "summary": "继续读取资源发布",
        "description": "displayGroup 只选择展示组，不参与检索筛选。loader、mc、type 仍在同一条原始发布记录中匹配。游标绑定资源、组、筛选和版本；内容变化后应刷新详情。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "displayGroup",
            "in": "query",
            "example": "mod"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 20
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "required": false,
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "type",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "group": "mod",
                  "label": "模组",
                  "versionCount": 1,
                  "truncated": false,
                  "releases": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "versionNumber": "1.0.0",
                      "compat": [
                        {
                          "releaseId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                          "loaders": [
                            "fabric"
                          ],
                          "mcVersions": [
                            "1.20.1"
                          ],
                          "matched": true,
                          "versionGroup": "minecraft-java"
                        }
                      ]
                    }
                  ],
                  "nextCursor": null,
                  "revision": "1:1"
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "group": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "versionCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "truncated": {
                      "type": "boolean"
                    },
                    "releases": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "versionNumber": {
                            "type": "string"
                          },
                          "publishedAt": {
                            "type": "string"
                          },
                          "publishedRel": {
                            "type": "string"
                          },
                          "downloads": {
                            "type": "number"
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "releaseType": {
                            "type": "string"
                          },
                          "environment": {
                            "type": "string"
                          },
                          "changelog": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "installNote": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "releaseTypeLabel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "environmentLabel": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "installTemplate": {
                            "type": "string"
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "mcVersions": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "releaseIds": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "primaryFileId": {
                            "type": "string"
                          },
                          "files": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "filename": {
                                  "type": "string"
                                },
                                "size": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "sha512": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                },
                                "url": {
                                  "type": "string",
                                  "x-platform-site-url": true
                                },
                                "format": {
                                  "type": "string"
                                },
                                "release_id": {
                                  "type": "string"
                                },
                                "is_primary": {
                                  "type": "boolean"
                                },
                                "primary": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "id",
                                "filename",
                                "size",
                                "sha512",
                                "isPrimary",
                                "url",
                                "format"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformReleaseFile"
                            }
                          },
                          "compat": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "releaseId": {
                                  "type": "string"
                                },
                                "loaders": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "mcVersions": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "matched": {
                                  "type": "boolean"
                                },
                                "text": {
                                  "type": "string"
                                },
                                "versionGroup": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "pattern": "^[a-z][a-z0-9-]{1,63}$"
                                }
                              },
                              "required": [
                                "releaseId",
                                "loaders",
                                "mcVersions",
                                "matched",
                                "versionGroup"
                              ],
                              "additionalProperties": false,
                              "x-platform-model": "PlatformReleaseCompatibility"
                            }
                          },
                          "matched": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "versionNumber",
                          "compat"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReleaseUnit"
                      }
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "revision": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "group",
                    "label",
                    "versionCount",
                    "truncated",
                    "releases",
                    "nextCursor",
                    "revision"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformReleasePage"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "409": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources/{slug}/releases",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed"
      }
    },
    "/v1/site/resources/{slug}/updates": {
      "get": {
        "operationId": "resourceUpdates",
        "tags": [
          "资源"
        ],
        "summary": "查询当前兼容更新构建",
        "description": "返回当前公开的原始发布记录，按发布时间倒序；loader、mc、type 必须在同一条发布记录同时满足。releaseType 默认 release；多选同维度 OR、跨维度 AND。默认 20、最大 50，hasMore 表示还有更旧构建；这是当前快照，不是历史变化游标。安装前重新复核，撤回和删除先检查可见性再判断 304。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query",
            "example": "fabric"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query",
            "example": "1.20.1"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "type",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "releaseType",
            "in": "query",
            "example": "release"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 20
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 8192
            },
            "required": false,
            "name": "if-none-match",
            "in": "header"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "headers": {
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "example": {
                  "resource": {
                    "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                    "slug": "example-performance",
                    "title": "示例性能工具"
                  },
                  "revision": "1:1:1",
                  "hasMore": false,
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "versionNumber": "1.0.0",
                      "name": null,
                      "releaseType": "release",
                      "publishedAt": "2026-10-15T00:00:00.000000Z",
                      "loaders": [
                        "fabric"
                      ],
                      "mcVersions": [
                        "1.20.1"
                      ],
                      "files": [
                        {
                          "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                          "filename": "example.jar",
                          "size": 4096,
                          "sha512": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                          "isPrimary": true,
                          "url": "/api/media/assets/01ARZ3NDEKTSV4RRFFQ69G5FAV/content",
                          "format": "jar"
                        }
                      ]
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "resource": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "slug",
                        "title"
                      ],
                      "additionalProperties": false
                    },
                    "revision": {
                      "type": "string"
                    },
                    "hasMore": {
                      "type": "boolean"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "versionNumber": {
                            "type": "string"
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "releaseType": {
                            "type": "string",
                            "enum": [
                              "release",
                              "beta",
                              "alpha"
                            ]
                          },
                          "publishedAt": {
                            "type": "string"
                          },
                          "loaders": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "mcVersions": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "files": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "filename": {
                                  "type": "string"
                                },
                                "size": {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                "sha512": {
                                  "type": [
                                    "string",
                                    "null"
                                  ]
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                },
                                "url": {
                                  "type": "string",
                                  "x-platform-site-url": true
                                },
                                "format": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "filename",
                                "size",
                                "sha512",
                                "isPrimary",
                                "url",
                                "format"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "id",
                          "versionNumber",
                          "name",
                          "releaseType",
                          "publishedAt",
                          "loaders",
                          "mcVersions",
                          "files"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "resource",
                    "revision",
                    "hasMore",
                    "items"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "304": {
            "description": "表示未变化；无响应正文。",
            "headers": {
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources/{slug}/updates",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed"
      }
    },
    "/v1/site/resources/{slug}/mentions": {
      "get": {
        "operationId": "getResourceMentions",
        "tags": [
          "资源"
        ],
        "summary": "获取提到资源的帖子",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": [
                  {
                    "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                    "title": "Fabric 1.20.1 性能配置交流",
                    "author_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                    "created_at": "2026-10-15T00:00:00Z",
                    "state": null
                  }
                ],
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "title": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "author_id": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      },
                      "state": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "id",
                      "title",
                      "author_id",
                      "created_at",
                      "state"
                    ],
                    "additionalProperties": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/resources/{slug}/mentions"
      }
    },
    "/v1/site/posts": {
      "get": {
        "operationId": "listPosts",
        "tags": [
          "帖子"
        ],
        "summary": "筛选公开帖子",
        "parameters": [
          {
            "schema": {
              "type": "integer",
              "minimum": 1
            },
            "required": false,
            "name": "page",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 10
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "activity",
                "newest",
                "created"
              ]
            },
            "required": false,
            "name": "sort",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "unanswered",
                "bounty",
                "changelog"
              ]
            },
            "required": false,
            "name": "filter",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "kind",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "state",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "ref",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "author",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            },
            "required": false,
            "name": "unanswered",
            "in": "query"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "q",
            "in": "query",
            "example": "性能"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "tag",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "loader",
            "in": "query"
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
            },
            "required": false,
            "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。",
            "name": "mc",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "filter": null,
                  "total": 1,
                  "counts": {
                    "all": 1,
                    "unanswered": 1,
                    "bounty": 0,
                    "changelog": 0
                  },
                  "page": 1,
                  "limit": 10,
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "title": "Fabric 1.20.1 性能配置交流",
                      "body": "分享你使用的配置与测试结果。",
                      "kind": "discussion",
                      "state": null,
                      "authorId": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                    }
                  ],
                  "posts": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "title": "Fabric 1.20.1 性能配置交流",
                      "body": "分享你使用的配置与测试结果。",
                      "kind": "discussion",
                      "state": null,
                      "authorId": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "filter": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "total": {
                      "type": "number"
                    },
                    "counts": {
                      "type": "object",
                      "properties": {
                        "all": {
                          "type": "number"
                        },
                        "unanswered": {
                          "type": "number"
                        },
                        "bounty": {
                          "type": "number"
                        },
                        "changelog": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "all",
                        "unanswered",
                        "bounty",
                        "changelog"
                      ],
                      "additionalProperties": false
                    },
                    "page": {
                      "type": "number"
                    },
                    "limit": {
                      "type": "number"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "title",
                          "kind",
                          "state",
                          "authorId"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformPostCard"
                      }
                    },
                    "posts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "title",
                          "kind",
                          "state",
                          "authorId"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformPostCard"
                      }
                    }
                  },
                  "required": [
                    "filter",
                    "total",
                    "counts",
                    "page",
                    "limit",
                    "items",
                    "posts"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformPostList"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/posts",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed"
      }
    },
    "/v1/site/posts/{id}": {
      "get": {
        "operationId": "getPost",
        "tags": [
          "帖子"
        ],
        "summary": "获取帖子及递归回复",
        "description": "返回 20 条直接回复，每个节点最多预览 2 个直接子回复；继续阅读通过回复分页接口。replyCount 是全部可见回复数。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "title": "Fabric 1.20.1 性能配置交流",
                  "body": "分享你使用的配置与测试结果。",
                  "kind": "discussion",
                  "state": null,
                  "authorId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "replies": [],
                  "references": [],
                  "related": [],
                  "repliesTotal": 0,
                  "repliesNextCursor": null,
                  "replyRevision": "1",
                  "ancestors": []
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "body": {
                      "type": "string"
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "kind": {
                      "type": "string"
                    },
                    "state": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "authorId": {
                      "type": "string"
                    },
                    "preview": {
                      "type": "string"
                    },
                    "author": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "avatar": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "x-platform-site-url": true
                        },
                        "badges": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "color": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "avatar",
                        "badges"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformAuthor"
                    },
                    "parentPostId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "rootPostId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "depth": {
                      "type": "number"
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "createdRel": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    },
                    "lastActivityAt": {
                      "type": "string"
                    },
                    "lastActivityRel": {
                      "type": "string"
                    },
                    "replyCount": {
                      "type": "number"
                    },
                    "ref": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "id": {
                          "type": "string"
                        },
                        "slug": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "title": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "summary": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "cover": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "x-platform-site-url": true
                        },
                        "tombstone": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "type",
                        "id",
                        "slug",
                        "title",
                        "summary",
                        "cover",
                        "tombstone"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformEntityReference"
                    },
                    "replies": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          },
                          "tombstone": {
                            "type": "boolean"
                          },
                          "children": {
                            "type": "array",
                            "items": {
                              "$ref": "#/components/schemas/PlatformReplyNode"
                            }
                          },
                          "childrenTotal": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "childrenNextCursor": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "reactions": {
                            "type": "object",
                            "properties": {
                              "like": {
                                "type": "number"
                              },
                              "favorite": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "like",
                              "favorite"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformReactions"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "tombstone",
                          "children",
                          "childrenTotal",
                          "childrenNextCursor"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReplyNode"
                      }
                    },
                    "references": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "source_type": {
                            "type": "string"
                          },
                          "source_id": {
                            "type": "string"
                          },
                          "source_release_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "relation": {
                            "type": "string"
                          },
                          "role": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_key": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "external_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "kind": {
                            "type": "string"
                          },
                          "fragment_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "fragment_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "note": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "sort_order": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "created_at": {
                            "type": "string"
                          },
                          "target_slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_cover": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "x-platform-site-url": true
                          },
                          "target_summary": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_deleted_at": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "target_status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "tombstone": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformPublicReference"
                      }
                    },
                    "related": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "title",
                          "kind",
                          "state",
                          "authorId"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformPostCard"
                      }
                    },
                    "repliesTotal": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "repliesNextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "replyRevision": {
                      "type": "string"
                    },
                    "ancestors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "tombstone": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "parentPostId",
                          "depth",
                          "tombstone"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReplyAncestor"
                      }
                    },
                    "reactions": {
                      "type": "object",
                      "properties": {
                        "like": {
                          "type": "number"
                        },
                        "favorite": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "like",
                        "favorite"
                      ],
                      "additionalProperties": false,
                      "x-platform-model": "PlatformReactions"
                    },
                    "refDetail": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "id": {
                          "type": "string"
                        },
                        "slug": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "title": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "summary": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "cover": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "x-platform-site-url": true
                        },
                        "tombstone": {
                          "type": "boolean"
                        },
                        "state": {
                          "type": "string"
                        },
                        "kind": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "versionNumber": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "typeLabel": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "type",
                        "id",
                        "slug",
                        "title",
                        "summary",
                        "cover",
                        "tombstone",
                        "state",
                        "kind",
                        "versionNumber",
                        "typeLabel"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "body",
                    "title",
                    "kind",
                    "state",
                    "authorId",
                    "replies",
                    "references",
                    "related",
                    "repliesTotal",
                    "repliesNextCursor",
                    "replyRevision",
                    "ancestors"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformPostDetail"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/posts/{id}",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed"
      }
    },
    "/v1/site/posts/{id}/replies": {
      "get": {
        "operationId": "postReplies",
        "tags": [
          "帖子"
        ],
        "summary": "继续读取帖子的直接回复",
        "description": "parent 为稳定帖子 ID，默认当前帖子；必须位于当前帖子后代范围。中间节点删除后以空正文墓碑承接公开后代。游标绑定线程版本，内容变化后请刷新。",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          },
          {
            "schema": {
              "type": "string"
            },
            "required": false,
            "name": "parent",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "required": false,
            "name": "limit",
            "in": "query",
            "example": 20
          },
          {
            "schema": {
              "type": "string",
              "maxLength": 4096
            },
            "required": false,
            "name": "cursor",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "postId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "parentId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "items": [],
                  "total": 0,
                  "nextCursor": null,
                  "revision": "1",
                  "ancestors": []
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "postId": {
                      "type": "string"
                    },
                    "parentId": {
                      "type": "string"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "state": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "authorId": {
                            "type": "string"
                          },
                          "preview": {
                            "type": "string"
                          },
                          "author": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "avatar": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "badges": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "color": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "avatar",
                              "badges"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformAuthor"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "createdRel": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "lastActivityAt": {
                            "type": "string"
                          },
                          "lastActivityRel": {
                            "type": "string"
                          },
                          "replyCount": {
                            "type": "number"
                          },
                          "ref": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "properties": {
                              "type": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "title": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "cover": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "x-platform-site-url": true
                              },
                              "tombstone": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "type",
                              "id",
                              "slug",
                              "title",
                              "summary",
                              "cover",
                              "tombstone"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformEntityReference"
                          },
                          "tombstone": {
                            "type": "boolean"
                          },
                          "children": {
                            "type": "array",
                            "items": {
                              "$ref": "#/components/schemas/PlatformReplyNode"
                            }
                          },
                          "childrenTotal": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "childrenNextCursor": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "reactions": {
                            "type": "object",
                            "properties": {
                              "like": {
                                "type": "number"
                              },
                              "favorite": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "like",
                              "favorite"
                            ],
                            "additionalProperties": false,
                            "x-platform-model": "PlatformReactions"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "tombstone",
                          "children",
                          "childrenTotal",
                          "childrenNextCursor"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReplyNode"
                      }
                    },
                    "total": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "revision": {
                      "type": "string"
                    },
                    "ancestors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "parentPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "depth": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "tombstone": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "parentPostId",
                          "depth",
                          "tombstone"
                        ],
                        "additionalProperties": false,
                        "x-platform-model": "PlatformReplyAncestor"
                      }
                    }
                  },
                  "required": [
                    "postId",
                    "parentId",
                    "items",
                    "total",
                    "nextCursor",
                    "revision",
                    "ancestors"
                  ],
                  "additionalProperties": false,
                  "x-platform-model": "PlatformReplyPage"
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "409": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/posts/{id}/replies",
        "security": [
          {},
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed"
      }
    },
    "/v1/site/tags": {
      "get": {
        "operationId": "listTags",
        "tags": [
          "标签"
        ],
        "summary": "查找开放标签",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "required": false,
            "name": "q",
            "in": "query",
            "example": "optimization"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "slug": "optimization",
                      "label": "性能优化",
                      "dimension": "gameplay",
                      "resource_count": 1,
                      "post_count": 1
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "dimension": {
                            "type": "string"
                          },
                          "resource_count": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "number"
                              }
                            ]
                          },
                          "post_count": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "number"
                              }
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "label",
                          "dimension",
                          "resource_count",
                          "post_count"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "items"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/tags"
      }
    },
    "/v1/site/tags/{slug}": {
      "get": {
        "operationId": "getTag",
        "tags": [
          "标签"
        ],
        "summary": "获取标签聚合页",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "slug": "optimization",
                  "label": "性能优化",
                  "dimension": "gameplay",
                  "items": [
                    {
                      "type": "resource",
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "title": "示例性能工具",
                      "slug": "example-performance"
                    }
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "dimension": {
                      "type": "string"
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "slug": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "type",
                          "id",
                          "title",
                          "slug"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "id",
                    "slug",
                    "label",
                    "dimension",
                    "items"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "401": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "403": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "404": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "REQUEST_FAILED",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          },
          "503": {
            "description": "请求错误",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "error"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "error": {
                    "code": "SERVICE_UNAVAILABLE",
                    "message": "请核对参数、权限或稍后重试。"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "x-legacy-api-path": "/api/tags/{slug}"
      }
    },
    "/v1/site/organizations": {
      "get": {
        "operationId": "listOrganizations",
        "summary": "列出公开组织",
        "tags": [
          "组织"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 0,
              "maxLength": 500
            },
            "description": "按组织名称、标语或 slug 搜索，最多 500 字符。",
            "example": "创作"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000
            },
            "description": "从 1 开始的页码。",
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            },
            "description": "每页条数，最多 50。",
            "example": 20
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "page": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 1000000
                    },
                    "pageSize": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 50
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "minLength": 26,
                            "maxLength": 26
                          },
                          "slug": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100,
                            "pattern": "^[a-z0-9][a-z0-9-]{0,99}$"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "summary": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 200
                          },
                          "avatar": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 2048,
                            "x-platform-site-url": true
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "approved",
                              "archived"
                            ]
                          },
                          "version": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991
                          },
                          "tagline": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 200
                          },
                          "category": {
                            "type": "string",
                            "minLength": 0,
                            "maxLength": 100
                          },
                          "memberCount": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "followerCount": {
                            "type": "integer",
                            "minimum": 0
                          },
                          "createdAt": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "required": [
                          "id",
                          "slug",
                          "name",
                          "summary",
                          "status",
                          "version",
                          "tagline",
                          "category",
                          "memberCount",
                          "followerCount",
                          "createdAt"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 50
                    }
                  },
                  "required": [
                    "total",
                    "page",
                    "pageSize",
                    "items"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "total": 1,
                  "page": 1,
                  "pageSize": 20,
                  "items": [
                    {
                      "id": "01JY0000000000000000000000",
                      "slug": "example-team",
                      "name": "示例组织",
                      "summary": "分享资源与教程",
                      "status": "approved",
                      "version": 1,
                      "tagline": "一起创作",
                      "category": "创作者",
                      "memberCount": 3,
                      "followerCount": 12,
                      "createdAt": "2026-10-29T00:00:00.000Z"
                    }
                  ]
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "description": "只返回已批准、公开且未解散的组织；已归档组织仍可读取，以 archived 标识只读状态。分页与搜索不会返回私有组织或成员关系。匿名调用，不接受 Cookie。",
        "security": []
      }
    },
    "/v1/site/organizations/{slug}": {
      "get": {
        "operationId": "getOrganization",
        "summary": "读取公开组织详情",
        "tags": [
          "组织"
        ],
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100,
              "pattern": "^[a-z0-9][a-z0-9-]{0,99}$"
            },
            "description": "组织的稳定标识。",
            "example": "example-team"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "organization": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 26,
                              "maxLength": 26
                            },
                            "slug": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100,
                              "pattern": "^[a-z0-9][a-z0-9-]{0,99}$"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "summary": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "avatar": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "approved",
                                "archived"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "tagline": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "category": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 100
                            },
                            "memberCount": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "followerCount": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "createdAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "description": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000
                            },
                            "banner": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "joinPolicy": {
                              "type": "string",
                              "enum": [
                                "open",
                                "apply"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "status",
                            "version",
                            "tagline",
                            "category",
                            "memberCount",
                            "followerCount",
                            "createdAt",
                            "description",
                            "joinPolicy"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 26,
                              "maxLength": 26
                            },
                            "slug": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100,
                              "pattern": "^[a-z0-9][a-z0-9-]{0,99}$"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "summary": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "avatar": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "dissolved"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "dissolvedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "status",
                            "version",
                            "dissolvedAt"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "required": [
                    "organization"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "organization": {
                    "id": "01JY0000000000000000000000",
                    "slug": "example-team",
                    "name": "示例组织",
                    "summary": "分享资源与教程",
                    "status": "approved",
                    "version": 1,
                    "tagline": "一起创作",
                    "category": "创作者",
                    "memberCount": 3,
                    "followerCount": 12,
                    "createdAt": "2026-10-29T00:00:00.000Z",
                    "description": "一个供创作者协作的组织。",
                    "joinPolicy": "apply"
                  }
                }
              }
            }
          }
        },
        "x-cookie-policy": "reject",
        "description": "返回公开组织资料；已归档组织以 archived 标识只读状态，已解散的公开组织只返回最小墓碑。私有或未公开组织不可通过此接口读取。匿名调用，不接受 Cookie。",
        "security": []
      }
    }
  },
  "webhooks": {}
}
