From 59c79c7d320b08654b513bd2e3ae57b81e3bd6ac Mon Sep 17 00:00:00 2001
From: "DESKTOP-L8OUL9F\\gfl0034" <1003614916@qq.com>
Date: Thu, 24 Sep 2026 10:58:47 +0800
Subject: [PATCH] =?UTF-8?q?fix(openapi):=20=E8=A1=A5=E5=85=A8=20Response?=
 =?UTF-8?q?=20=E5=BF=85=E5=A1=AB=20description=EF=BC=8C=E4=BF=AE=E5=A4=8D?=
 =?UTF-8?q?=20Swagger=20Fetch=20error?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

音乐/小说等 31 处 responses.200 缺 description，OpenAPI 3.0 校验失败导致 /docs 无法渲染。

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 internal/transport/http/docs/openapi.yaml | 31 +++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/internal/transport/http/docs/openapi.yaml b/internal/transport/http/docs/openapi.yaml
index 8df1029..52ae408 100644
--- a/internal/transport/http/docs/openapi.yaml
+++ b/internal/transport/http/docs/openapi.yaml
@@ -1983,6 +1983,7 @@ paths:
         - bearerAuth: []
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2002,6 +2003,7 @@ paths:
               $ref: "#/components/schemas/MusicSettings"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2029,6 +2031,7 @@ paths:
               $ref: "#/components/schemas/MusicUpsertRequest"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2046,6 +2049,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2060,6 +2064,7 @@ paths:
         - bearerAuth: []
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2081,6 +2086,7 @@ paths:
               $ref: "#/components/schemas/MusicCategoryUpsertRequest"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2105,6 +2111,7 @@ paths:
               $ref: "#/components/schemas/MusicCategoryUpsertRequest"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2122,6 +2129,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2152,6 +2160,7 @@ paths:
                   items: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2182,6 +2191,7 @@ paths:
                   format: binary
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2212,6 +2222,7 @@ paths:
                   format: binary
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2242,6 +2253,7 @@ paths:
                   format: binary
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2280,6 +2292,7 @@ paths:
           description: true 时返回一级含 children 树
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2305,6 +2318,7 @@ paths:
         - { name: size, in: query, schema: { type: integer, default: 24 } }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2325,6 +2339,7 @@ paths:
           schema: { type: string }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2345,6 +2360,7 @@ paths:
           schema: { type: string }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2365,6 +2381,7 @@ paths:
         - { name: chapterSlug, in: path, required: true, schema: { type: string } }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2403,6 +2420,7 @@ paths:
         - url: https://admin.fullstorynovel.com
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2421,6 +2439,7 @@ paths:
         - url: https://admin.fullstorynovel.com
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2441,6 +2460,7 @@ paths:
               $ref: "#/components/schemas/FsnNovelUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2459,6 +2479,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2482,6 +2503,7 @@ paths:
               $ref: "#/components/schemas/FsnNovelUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2499,6 +2521,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2544,6 +2567,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2569,6 +2593,7 @@ paths:
               $ref: "#/components/schemas/FsnChapterUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2607,6 +2632,7 @@ paths:
               $ref: "#/components/schemas/FsnChapterUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2624,6 +2650,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2639,6 +2666,7 @@ paths:
         - url: https://admin.fullstorynovel.com
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2659,6 +2687,7 @@ paths:
               $ref: "#/components/schemas/FsnGenreUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2683,6 +2712,7 @@ paths:
               $ref: "#/components/schemas/FsnGenreUpsert"
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema:
@@ -2700,6 +2730,7 @@ paths:
           schema: { type: integer, format: int64 }
       responses:
         "200":
+          description: OK
           content:
             application/json:
               schema: