{
  "openapi": "3.1.0",
  "info": {
    "title": "NexusMC 个人接口 (PAT / OAuth access)",
    "version": "1.0.0",
    "description": "个人接口。可使用具备逐操作权限的 PAT 或 OAuth access token。"
  },
  "servers": [
    {
      "url": "http://127.0.0.1:4520"
    }
  ],
  "components": {
    "securitySchemes": {
      "personalBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "个人访问令牌。每个 operation 的 x-required-scope 是必须授予的权限。"
      },
      "oauthAccessBearer": {
        "type": "http",
        "scheme": "bearer",
        "description": "已授权应用的 OAuth access token。仅在所需 scope 已授予时可访问；此处粘贴现成令牌，不在浏览器内交换 client secret。"
      }
    },
    "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": {}
  },
  "paths": {
    "/v1/personal/resources": {
      "get": {
        "operationId": "personalListResources",
        "tags": [
          "资源"
        ],
        "summary": "筛选公开资源",
        "description": "加载器、游戏版本和类型必须在同一条发布记录同时匹配。同一维度为 OR，跨维度为 AND。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed",
        "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"
      },
      "post": {
        "operationId": "createResource",
        "tags": [
          "资源"
        ],
        "summary": "创建资源",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "title": "示例性能工具",
                "summary": "用于说明资源发布参数。",
                "body": "## 安装说明\n请先选择匹配加载器与游戏版本的构建。",
                "slug": "example-performance",
                "tags": [
                  "optimization"
                ],
                "status": "draft"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "body": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000000
                  },
                  "slug": {
                    "type": "string",
                    "maxLength": 100,
                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                  },
                  "coverUrl": {
                    "type": "string",
                    "format": "uri"
                  },
                  "capabilities": {
                    "type": "object",
                    "additionalProperties": {},
                    "x-platform-open-json": "Resource capability keys and capability-specific payloads are author-defined JSON."
                  },
                  "tags": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ],
                    "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
                  },
                  "references": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            },
                            "fragmentType": {
                              "type": "string",
                              "enum": [
                                "release",
                                "section",
                                "block"
                              ]
                            },
                            "fragmentId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId",
                            "fragmentType",
                            "fragmentId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "externalName": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "externalKey": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "externalName"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "maxItems": 200
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "published"
                    ]
                  }
                },
                "required": [
                  "title",
                  "summary",
                  "body"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true,
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                  "slug": "example-performance"
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    },
                    "id": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ok",
                    "id",
                    "slug"
                  ],
                  "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"
      }
    },
    "/v1/personal/resources/names": {
      "get": {
        "operationId": "personalFindResourceNames",
        "tags": [
          "资源"
        ],
        "summary": "查找资源名称",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed",
        "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"
      }
    },
    "/v1/personal/resources/{slug}": {
      "get": {
        "operationId": "personalGetResource",
        "tags": [
          "资源"
        ],
        "summary": "获取资源详情及匹配发布",
        "description": "每个展示族返回最近 20 个完整合并发布单元。allReleases 仅兼容旧参数；继续加载使用发布分页接口。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed",
        "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}"
      },
      "patch": {
        "operationId": "updateResource",
        "tags": [
          "资源"
        ],
        "summary": "修改本人维护的资源",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:update:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "summary": "更新后的资源介绍。"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "body": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000000
                  },
                  "capabilities": {
                    "type": "object",
                    "additionalProperties": {},
                    "x-platform-open-json": "Resource capability keys and capability-specific payloads are author-defined JSON."
                  },
                  "tags": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ],
                    "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
                  },
                  "references": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            },
                            "fragmentType": {
                              "type": "string",
                              "enum": [
                                "release",
                                "section",
                                "block"
                              ]
                            },
                            "fragmentId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId",
                            "fragmentType",
                            "fragmentId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "externalName": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "externalKey": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "externalName"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "maxItems": 200
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "published"
                    ]
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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}"
      },
      "delete": {
        "operationId": "deleteResource",
        "tags": [
          "资源"
        ],
        "summary": "删除本人维护的资源",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:delete:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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}"
      }
    },
    "/v1/personal/resources/{slug}/releases": {
      "get": {
        "operationId": "personalResourceReleases",
        "tags": [
          "资源"
        ],
        "summary": "继续读取资源发布",
        "description": "displayGroup 只选择展示组，不参与检索筛选。loader、mc、type 仍在同一条原始发布记录中匹配。游标绑定资源、组、筛选和版本；内容变化后应刷新详情。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed",
        "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"
      }
    },
    "/v1/personal/resources/{slug}/updates": {
      "get": {
        "operationId": "personalResourceUpdates",
        "tags": [
          "资源"
        ],
        "summary": "查询当前兼容更新构建",
        "description": "返回当前公开的原始发布记录，按发布时间倒序；loader、mc、type 必须在同一条发布记录同时满足。releaseType 默认 release；多选同维度 OR、跨维度 AND。默认 20、最大 50，hasMore 表示还有更旧构建；这是当前快照，不是历史变化游标。安装前重新复核，撤回和删除先检查可见性再判断 304。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:feed",
        "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"
      }
    },
    "/v1/personal/posts": {
      "get": {
        "operationId": "personalListPosts",
        "tags": [
          "帖子"
        ],
        "summary": "筛选公开帖子",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed",
        "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"
      },
      "post": {
        "operationId": "createPost",
        "tags": [
          "帖子"
        ],
        "summary": "创建帖子",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:create",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "title": "Fabric 1.20.1 性能配置交流",
                "body": "分享你使用的配置与测试结果。",
                "tags": [
                  "optimization"
                ]
              },
              "schema": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "body": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000000
                      },
                      "ref": {
                        "type": "string"
                      },
                      "primaryRef": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "resource",
                              "tutorial"
                            ]
                          },
                          "id": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "id"
                        ],
                        "additionalProperties": false
                      },
                      "tags": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        ],
                        "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "title": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "needsHelp": {
                        "type": "boolean",
                        "enum": [
                          false
                        ]
                      }
                    },
                    "required": [
                      "body"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "body": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000000
                      },
                      "ref": {
                        "type": "string"
                      },
                      "primaryRef": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "resource",
                              "tutorial"
                            ]
                          },
                          "id": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "id"
                        ],
                        "additionalProperties": false
                      },
                      "tags": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        ],
                        "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "title": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 120
                      },
                      "state": {
                        "type": "string",
                        "enum": [
                          "open",
                          "resolved",
                          "closed"
                        ]
                      },
                      "needsHelp": {
                        "type": "boolean"
                      },
                      "bounty": {
                        "type": "object",
                        "properties": {
                          "amount": {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          }
                        },
                        "required": [
                          "amount"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "body",
                      "title"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true,
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    },
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ok",
                    "id"
                  ],
                  "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/posts"
      }
    },
    "/v1/personal/posts/{id}": {
      "get": {
        "operationId": "personalGetPost",
        "tags": [
          "帖子"
        ],
        "summary": "获取帖子及递归回复",
        "description": "返回 20 条直接回复，每个节点最多预览 2 个直接子回复；继续阅读通过回复分页接口。replyCount 是全部可见回复数。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed",
        "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}"
      },
      "patch": {
        "operationId": "updatePost",
        "tags": [
          "帖子"
        ],
        "summary": "修改本人帖子",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:update:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "body": "补充复现步骤。"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "body": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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/posts/{id}"
      },
      "delete": {
        "operationId": "deletePost",
        "tags": [
          "帖子"
        ],
        "summary": "删除本人帖子",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:delete:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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/posts/{id}"
      }
    },
    "/v1/personal/posts/{id}/replies": {
      "get": {
        "operationId": "personalPostReplies",
        "tags": [
          "帖子"
        ],
        "summary": "继续读取帖子的直接回复",
        "description": "parent 为稳定帖子 ID，默认当前帖子；必须位于当前帖子后代范围。中间节点删除后以空正文墓碑承接公开后代。游标绑定线程版本，内容变化后请刷新。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:feed",
        "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"
      }
    },
    "/v1/personal/users/{id}/resources": {
      "get": {
        "operationId": "listOwnResources",
        "tags": [
          "资源"
        ],
        "summary": "读取本人的资源",
        "description": "路径 id 仅允许本人用户 ID 或 handle。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:read:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          },
          {
            "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
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  ],
                  "total": 1
                },
                "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
                      }
                    },
                    "total": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "items",
                    "total"
                  ],
                  "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/users/{id}/resources"
      }
    },
    "/v1/personal/resources/{slug}/release": {
      "post": {
        "operationId": "createRelease",
        "tags": [
          "发布"
        ],
        "summary": "创建联合兼容发布记录",
        "description": "一条发布记录的加载器与游戏版本为联合约束；需要精确配对时提交多个 compat 项。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:update:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "versionNumber": "1.0.0",
                "compat": [
                  {
                    "loaders": [
                      "fabric"
                    ],
                    "mcVersions": [
                      "1.20.1"
                    ],
                    "versionGroup": "minecraft-java"
                  }
                ],
                "file": {
                  "uploadId": "REPLACE_WITH_READY_UPLOAD_ID",
                  "isPrimary": true
                },
                "installNote": "放入 mods 目录。",
                "status": "draft"
              },
              "schema": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "versionNumber": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "releaseType": {
                        "type": "string",
                        "enum": [
                          "release",
                          "beta",
                          "alpha"
                        ]
                      },
                      "environment": {
                        "type": "string",
                        "enum": [
                          "client_only",
                          "server_only",
                          "dedicated_server_only",
                          "client_or_server",
                          "unknown"
                        ]
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "listed",
                          "archived",
                          "unlisted",
                          "draft",
                          "scheduled"
                        ]
                      },
                      "publishedAt": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "changelog": {
                        "type": "string"
                      },
                      "installNote": {
                        "type": "string"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "compat": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "loaders": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "minItems": 1
                            },
                            "mcVersions": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "minItems": 1
                            },
                            "versionGroup": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "pattern": "^[a-z][a-z0-9-]{1,63}$",
                              "description": "游戏版本体系 slug；请求省略时按 Java 版处理。"
                            }
                          },
                          "required": [
                            "loaders",
                            "mcVersions"
                          ],
                          "additionalProperties": false
                        },
                        "minItems": 1,
                        "maxItems": 64
                      },
                      "files": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "uploadId": {
                                  "type": "string"
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "uploadId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "sha512": {
                                  "type": "string",
                                  "pattern": "^[0-9a-fA-F]{128}$"
                                },
                                "filename": {
                                  "type": "string",
                                  "maxLength": 255
                                },
                                "size": {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "format": {
                                  "type": "string",
                                  "maxLength": 32
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "sha512",
                                "filename",
                                "size",
                                "url"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "minItems": 1,
                        "maxItems": 64
                      }
                    },
                    "required": [
                      "versionNumber",
                      "compat",
                      "files"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "versionNumber": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "releaseType": {
                        "type": "string",
                        "enum": [
                          "release",
                          "beta",
                          "alpha"
                        ]
                      },
                      "environment": {
                        "type": "string",
                        "enum": [
                          "client_only",
                          "server_only",
                          "dedicated_server_only",
                          "client_or_server",
                          "unknown"
                        ]
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "listed",
                          "archived",
                          "unlisted",
                          "draft",
                          "scheduled"
                        ]
                      },
                      "publishedAt": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "changelog": {
                        "type": "string"
                      },
                      "installNote": {
                        "type": "string"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "compat": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "loaders": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "minItems": 1
                            },
                            "mcVersions": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "minItems": 1
                            },
                            "versionGroup": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "pattern": "^[a-z][a-z0-9-]{1,63}$",
                              "description": "游戏版本体系 slug；请求省略时按 Java 版处理。"
                            }
                          },
                          "required": [
                            "loaders",
                            "mcVersions"
                          ],
                          "additionalProperties": false
                        },
                        "minItems": 1,
                        "maxItems": 64
                      },
                      "file": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "uploadId": {
                                "type": "string"
                              },
                              "isPrimary": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "uploadId"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "sha512": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{128}$"
                              },
                              "filename": {
                                "type": "string",
                                "maxLength": 255
                              },
                              "size": {
                                "type": "integer",
                                "minimum": 0
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              },
                              "format": {
                                "type": "string",
                                "maxLength": 32
                              },
                              "isPrimary": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "sha512",
                              "filename",
                              "size",
                              "url"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      }
                    },
                    "required": [
                      "versionNumber",
                      "compat",
                      "file"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "versionNumber": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "releaseType": {
                        "type": "string",
                        "enum": [
                          "release",
                          "beta",
                          "alpha"
                        ]
                      },
                      "environment": {
                        "type": "string",
                        "enum": [
                          "client_only",
                          "server_only",
                          "dedicated_server_only",
                          "client_or_server",
                          "unknown"
                        ]
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "listed",
                          "archived",
                          "unlisted",
                          "draft",
                          "scheduled"
                        ]
                      },
                      "publishedAt": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "changelog": {
                        "type": "string"
                      },
                      "installNote": {
                        "type": "string"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "loaders": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 1
                      },
                      "mcVersions": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 1
                      },
                      "files": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "uploadId": {
                                  "type": "string"
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "uploadId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "sha512": {
                                  "type": "string",
                                  "pattern": "^[0-9a-fA-F]{128}$"
                                },
                                "filename": {
                                  "type": "string",
                                  "maxLength": 255
                                },
                                "size": {
                                  "type": "integer",
                                  "minimum": 0
                                },
                                "url": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "format": {
                                  "type": "string",
                                  "maxLength": 32
                                },
                                "isPrimary": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "sha512",
                                "filename",
                                "size",
                                "url"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "minItems": 1,
                        "maxItems": 64
                      }
                    },
                    "required": [
                      "versionNumber",
                      "loaders",
                      "mcVersions",
                      "files"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "versionNumber": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "releaseType": {
                        "type": "string",
                        "enum": [
                          "release",
                          "beta",
                          "alpha"
                        ]
                      },
                      "environment": {
                        "type": "string",
                        "enum": [
                          "client_only",
                          "server_only",
                          "dedicated_server_only",
                          "client_or_server",
                          "unknown"
                        ]
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "listed",
                          "archived",
                          "unlisted",
                          "draft",
                          "scheduled"
                        ]
                      },
                      "publishedAt": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "changelog": {
                        "type": "string"
                      },
                      "installNote": {
                        "type": "string"
                      },
                      "references": {
                        "type": "array",
                        "items": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "targetType": {
                                  "type": "string",
                                  "enum": [
                                    "resource",
                                    "tutorial",
                                    "post"
                                  ]
                                },
                                "targetId": {
                                  "type": "string"
                                },
                                "fragmentType": {
                                  "type": "string",
                                  "enum": [
                                    "release",
                                    "section",
                                    "block"
                                  ]
                                },
                                "fragmentId": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "targetType",
                                "targetId",
                                "fragmentType",
                                "fragmentId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "relation": {
                                  "type": "string",
                                  "maxLength": 100
                                },
                                "role": {
                                  "type": "string"
                                },
                                "kind": {
                                  "type": "string"
                                },
                                "note": {
                                  "type": "string"
                                },
                                "externalUrl": {
                                  "type": "string",
                                  "format": "uri"
                                },
                                "externalName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "externalKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "externalName"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "maxItems": 200
                      },
                      "loaders": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 1
                      },
                      "mcVersions": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "minItems": 1
                      },
                      "file": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "uploadId": {
                                "type": "string"
                              },
                              "isPrimary": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "uploadId"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "sha512": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{128}$"
                              },
                              "filename": {
                                "type": "string",
                                "maxLength": 255
                              },
                              "size": {
                                "type": "integer",
                                "minimum": 0
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              },
                              "format": {
                                "type": "string",
                                "maxLength": 32
                              },
                              "isPrimary": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "sha512",
                              "filename",
                              "size",
                              "url"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      }
                    },
                    "required": [
                      "versionNumber",
                      "loaders",
                      "mcVersions",
                      "file"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true,
                  "slug": "example-performance",
                  "versionNumber": "1.0.0",
                  "releases": [
                    "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                  ]
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    },
                    "slug": {
                      "type": "string"
                    },
                    "versionNumber": {
                      "type": "string"
                    },
                    "releases": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "ok",
                    "slug",
                    "versionNumber",
                    "releases"
                  ],
                  "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}/release"
      }
    },
    "/v1/personal/resources/{slug}/releases/{id}": {
      "patch": {
        "operationId": "updateRelease",
        "tags": [
          "发布"
        ],
        "summary": "修改本人维护的发布记录",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "resource:update:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "slug",
            "in": "path",
            "example": "example-performance"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "installNote": "放入 mods 目录并重启游戏。"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "changelog": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "installNote": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "listed",
                      "archived",
                      "unlisted",
                      "draft",
                      "scheduled"
                    ]
                  },
                  "publishedAt": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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}/releases/{id}"
      }
    },
    "/v1/personal/users/{id}/posts": {
      "get": {
        "operationId": "listOwnPosts",
        "tags": [
          "帖子"
        ],
        "summary": "读取本人的帖子",
        "description": "路径 id 仅允许本人用户 ID 或 handle。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:read:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          },
          {
            "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
          }
        ],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "items": [
                    {
                      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
                      "title": "Fabric 1.20.1 性能配置交流",
                      "body": "分享你使用的配置与测试结果。",
                      "createdAt": "2026-10-16T00:00:00.000Z",
                      "rootPostId": null,
                      "rootTitle": null,
                      "relTime": "刚刚"
                    }
                  ],
                  "total": 1
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "body": {
                            "type": "string"
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "rootPostId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "rootTitle": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "relTime": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "body",
                          "createdAt",
                          "rootPostId",
                          "rootTitle",
                          "relTime"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "total": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "items",
                    "total"
                  ],
                  "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/users/{id}/posts"
      }
    },
    "/v1/personal/posts/{id}/reply": {
      "post": {
        "operationId": "replyPost",
        "tags": [
          "帖子"
        ],
        "summary": "回复帖子",
        "description": "回复不能建立独立 Issue 或悬赏。",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:create",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "body": "可以补充日志与配置，方便其他人复现。"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000000
                  },
                  "tags": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ],
                    "description": "多值可重复传入同名参数，或用逗号分隔；同一筛选维度内满足任意值即可。"
                  },
                  "references": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "targetType": {
                              "type": "string",
                              "enum": [
                                "resource",
                                "tutorial",
                                "post"
                              ]
                            },
                            "targetId": {
                              "type": "string"
                            },
                            "fragmentType": {
                              "type": "string",
                              "enum": [
                                "release",
                                "section",
                                "block"
                              ]
                            },
                            "fragmentId": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "targetType",
                            "targetId",
                            "fragmentType",
                            "fragmentId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "relation": {
                              "type": "string",
                              "maxLength": 100
                            },
                            "role": {
                              "type": "string"
                            },
                            "kind": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            },
                            "externalUrl": {
                              "type": "string",
                              "format": "uri"
                            },
                            "externalName": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "externalKey": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "externalName"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "maxItems": 200
                  },
                  "title": {
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "body"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true,
                  "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    },
                    "id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ok",
                    "id"
                  ],
                  "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/posts/{id}/reply"
      }
    },
    "/v1/personal/posts/{id}/state": {
      "put": {
        "operationId": "changePostState",
        "tags": [
          "帖子"
        ],
        "summary": "修改 Issue 状态",
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-required-scope": "post:update:self",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "required": true,
            "name": "id",
            "in": "path",
            "example": "01ARZ3NDEKTSV4RRFFQ69G5FAV"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "state": "resolved"
              },
              "schema": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "enum": [
                      "open",
                      "resolved",
                      "closed"
                    ]
                  }
                },
                "required": [
                  "state"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "example": {
                  "ok": true
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "enum": [
                        true
                      ]
                    }
                  },
                  "required": [
                    "ok"
                  ],
                  "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/posts/{id}/state"
      }
    },
    "/v1/personal/me": {
      "get": {
        "operationId": "getMe",
        "summary": "读取本人展示资料",
        "tags": [
          "个人资料"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "user": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 26,
                          "maxLength": 26
                        },
                        "slug": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "avatar": {
                          "type": "string",
                          "minLength": 0,
                          "maxLength": 2048,
                          "x-platform-site-url": true
                        },
                        "banner": {
                          "type": "string",
                          "minLength": 0,
                          "maxLength": 2048,
                          "x-platform-site-url": true
                        },
                        "bio": {
                          "type": "string",
                          "minLength": 0,
                          "maxLength": 500
                        },
                        "location": {
                          "type": "string",
                          "minLength": 0,
                          "maxLength": 500
                        }
                      },
                      "required": [
                        "id",
                        "slug",
                        "name",
                        "bio"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "user"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "user": {
                    "id": "01JY0000000000000000000001",
                    "slug": "example-user",
                    "name": "示例用户",
                    "bio": "Minecraft 内容创作者"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-cookie-policy": "reject",
        "description": "仅返回本人展示资料，不包含邮箱、手机或安全设置。需要 user:read:self。",
        "x-required-scope": "user:read:self"
      }
    },
    "/v1/personal/organizations": {
      "get": {
        "operationId": "personalListOrganizations",
        "summary": "列出本人组织",
        "tags": [
          "组织"
        ],
        "parameters": [
          {
            "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": {
                        "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
                              },
                              "tagline": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 200
                              },
                              "description": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 10000
                              },
                              "category": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 100
                              },
                              "avatar": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 2048,
                                "x-platform-site-url": true
                              },
                              "banner": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 2048,
                                "x-platform-site-url": true
                              },
                              "ownerId": {
                                "type": "string",
                                "minLength": 26,
                                "maxLength": 26
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "owner",
                                  "admin",
                                  "member"
                                ]
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "approved",
                                  "suspended",
                                  "pending",
                                  "rejected",
                                  "archived"
                                ]
                              },
                              "visibility": {
                                "type": "string",
                                "enum": [
                                  "public",
                                  "private"
                                ]
                              },
                              "joinPolicy": {
                                "type": "string",
                                "enum": [
                                  "open",
                                  "apply"
                                ]
                              },
                              "version": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991
                              },
                              "createdAt": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "updatedAt": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "required": [
                              "id",
                              "slug",
                              "name",
                              "summary",
                              "tagline",
                              "description",
                              "category",
                              "ownerId",
                              "role",
                              "status",
                              "visibility",
                              "joinPolicy",
                              "version",
                              "createdAt",
                              "updatedAt"
                            ],
                            "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
                              },
                              "role": {
                                "type": "string",
                                "enum": [
                                  "owner",
                                  "admin",
                                  "member"
                                ]
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "dissolved"
                                ]
                              },
                              "version": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991
                              },
                              "dissolvedAt": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "required": [
                              "id",
                              "slug",
                              "name",
                              "summary",
                              "role",
                              "status",
                              "version",
                              "dissolvedAt"
                            ],
                            "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": "分享资源与教程",
                      "tagline": "一起创作",
                      "description": "一个供创作者协作的组织。",
                      "category": "创作者",
                      "ownerId": "01JY0000000000000000000001",
                      "role": "owner",
                      "status": "approved",
                      "visibility": "public",
                      "joinPolicy": "apply",
                      "version": 1,
                      "createdAt": "2026-10-29T00:00:00.000Z",
                      "updatedAt": "2026-10-29T00:00:00.000Z"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-cookie-policy": "reject",
        "description": "分页返回本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态；已解散组织仅返回最小墓碑。需要 organization:read:self。",
        "x-required-scope": "organization:read:self"
      },
      "post": {
        "operationId": "createOrganization",
        "summary": "创建组织",
        "tags": [
          "组织"
        ],
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "slug": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "pattern": "^[a-z0-9][a-z0-9-]{0,99}$"
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  },
                  "tagline": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 10000
                  },
                  "category": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 100
                  },
                  "joinPolicy": {
                    "type": "string",
                    "enum": [
                      "open",
                      "apply"
                    ]
                  },
                  "visibility": {
                    "type": "string",
                    "enum": [
                      "public",
                      "private"
                    ]
                  },
                  "avatar": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 2048
                  },
                  "banner": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 2048
                  }
                },
                "required": [
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "示例组织",
                "slug": "example-team",
                "summary": "分享资源与教程",
                "joinPolicy": "apply",
                "visibility": "public"
              }
            }
          },
          "description": "name 为必填；其他组织资料字段可选。"
        },
        "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
                            },
                            "tagline": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "description": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000
                            },
                            "category": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 100
                            },
                            "avatar": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "banner": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "ownerId": {
                              "type": "string",
                              "minLength": 26,
                              "maxLength": 26
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "approved",
                                "suspended",
                                "pending",
                                "rejected"
                              ]
                            },
                            "visibility": {
                              "type": "string",
                              "enum": [
                                "public",
                                "private"
                              ]
                            },
                            "joinPolicy": {
                              "type": "string",
                              "enum": [
                                "open",
                                "apply"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "createdAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "updatedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "tagline",
                            "description",
                            "category",
                            "ownerId",
                            "role",
                            "status",
                            "visibility",
                            "joinPolicy",
                            "version",
                            "createdAt",
                            "updatedAt"
                          ],
                          "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
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "dissolved"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "dissolvedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "role",
                            "status",
                            "version",
                            "dissolvedAt"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "required": [
                    "organization"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "organization": {
                    "id": "01JY0000000000000000000000",
                    "slug": "example-team",
                    "name": "示例组织",
                    "summary": "分享资源与教程",
                    "tagline": "一起创作",
                    "description": "一个供创作者协作的组织。",
                    "category": "创作者",
                    "ownerId": "01JY0000000000000000000001",
                    "role": "owner",
                    "status": "approved",
                    "visibility": "public",
                    "joinPolicy": "apply",
                    "version": 1,
                    "createdAt": "2026-10-29T00:00:00.000Z",
                    "updatedAt": "2026-10-29T00:00:00.000Z"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-cookie-policy": "reject",
        "description": "账号须具备发布资格。创建后组织为 approved，创建者成为活跃所有者；slug 留空时由名称生成。需要 organization:create。",
        "x-required-scope": "organization:create"
      }
    },
    "/v1/personal/organizations/{slug}": {
      "get": {
        "operationId": "personalGetOrganization",
        "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
                            },
                            "tagline": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "description": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000
                            },
                            "category": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 100
                            },
                            "avatar": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "banner": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "ownerId": {
                              "type": "string",
                              "minLength": 26,
                              "maxLength": 26
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "approved",
                                "suspended",
                                "pending",
                                "rejected",
                                "archived"
                              ]
                            },
                            "visibility": {
                              "type": "string",
                              "enum": [
                                "public",
                                "private"
                              ]
                            },
                            "joinPolicy": {
                              "type": "string",
                              "enum": [
                                "open",
                                "apply"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "createdAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "updatedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "tagline",
                            "description",
                            "category",
                            "ownerId",
                            "role",
                            "status",
                            "visibility",
                            "joinPolicy",
                            "version",
                            "createdAt",
                            "updatedAt"
                          ],
                          "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
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "dissolved"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "dissolvedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "role",
                            "status",
                            "version",
                            "dissolvedAt"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "required": [
                    "organization"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "organization": {
                    "id": "01JY0000000000000000000000",
                    "slug": "example-team",
                    "name": "示例组织",
                    "summary": "分享资源与教程",
                    "tagline": "一起创作",
                    "description": "一个供创作者协作的组织。",
                    "category": "创作者",
                    "ownerId": "01JY0000000000000000000001",
                    "role": "owner",
                    "status": "approved",
                    "visibility": "public",
                    "joinPolicy": "apply",
                    "version": 1,
                    "createdAt": "2026-10-29T00:00:00.000Z",
                    "updatedAt": "2026-10-29T00:00:00.000Z"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-cookie-policy": "reject",
        "description": "只读取本人拥有或作为活跃成员加入的组织。已归档组织以 archived 标识只读状态；已解散组织仅返回最小墓碑。需要 organization:read:self。",
        "x-required-scope": "organization:read:self"
      },
      "put": {
        "operationId": "updateOrganization",
        "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"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  },
                  "tagline": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  },
                  "description": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 10000
                  },
                  "category": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 100
                  },
                  "joinPolicy": {
                    "type": "string",
                    "enum": [
                      "open",
                      "apply"
                    ]
                  },
                  "visibility": {
                    "type": "string",
                    "enum": [
                      "public",
                      "private"
                    ]
                  },
                  "avatar": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 2048
                  },
                  "banner": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 2048
                  }
                },
                "required": [
                  "version"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "name": "示例组织新版",
                "summary": "更新后的组织简介"
              }
            }
          },
          "description": "version 为必填的当前组织版本；其余字段至少提供一项。"
        },
        "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
                            },
                            "tagline": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 200
                            },
                            "description": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 10000
                            },
                            "category": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 100
                            },
                            "avatar": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "banner": {
                              "type": "string",
                              "minLength": 0,
                              "maxLength": 2048,
                              "x-platform-site-url": true
                            },
                            "ownerId": {
                              "type": "string",
                              "minLength": 26,
                              "maxLength": 26
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "approved",
                                "suspended",
                                "pending",
                                "rejected"
                              ]
                            },
                            "visibility": {
                              "type": "string",
                              "enum": [
                                "public",
                                "private"
                              ]
                            },
                            "joinPolicy": {
                              "type": "string",
                              "enum": [
                                "open",
                                "apply"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "createdAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "updatedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "tagline",
                            "description",
                            "category",
                            "ownerId",
                            "role",
                            "status",
                            "visibility",
                            "joinPolicy",
                            "version",
                            "createdAt",
                            "updatedAt"
                          ],
                          "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
                            },
                            "role": {
                              "type": "string",
                              "enum": [
                                "owner",
                                "admin",
                                "member"
                              ]
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "dissolved"
                              ]
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            "dissolvedAt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            }
                          },
                          "required": [
                            "id",
                            "slug",
                            "name",
                            "summary",
                            "role",
                            "status",
                            "version",
                            "dissolvedAt"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "required": [
                    "organization"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "organization": {
                    "id": "01JY0000000000000000000000",
                    "slug": "example-team",
                    "name": "示例组织新版",
                    "summary": "更新后的组织简介",
                    "tagline": "一起创作",
                    "description": "一个供创作者协作的组织。",
                    "category": "创作者",
                    "ownerId": "01JY0000000000000000000001",
                    "role": "owner",
                    "status": "approved",
                    "visibility": "public",
                    "joinPolicy": "apply",
                    "version": 2,
                    "createdAt": "2026-10-29T00:00:00.000Z",
                    "updatedAt": "2026-10-29T00:00:00.000Z"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "personalBearer": []
          },
          {
            "oauthAccessBearer": []
          }
        ],
        "x-cookie-policy": "reject",
        "description": "仅活跃所有者可编辑未归档、未解散的 approved 组织；archived 组织只读，不能通过此接口编辑或恢复。提交当前正整数 version；资料变化后版本递增，旧版本返回 409。需要 organization:update:self。",
        "x-required-scope": "organization:update:self"
      }
    }
  },
  "webhooks": {}
}
