From 822d3fe4441c145d500dc586a1cde7efb67bebb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=88=E6=AD=86?= <2685475410@qq.com>
Date: Tue, 29 Sep 2026 23:55:44 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(api):=20=E8=A1=A5=E5=85=85?=
 =?UTF-8?q?=20search=20=E6=8E=A5=E5=8F=A3=20tab=5Ftype=20=E8=BF=87?=
 =?UTF-8?q?=E6=BB=A4=E8=AF=AD=E4=B9=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md    | 2 +-
 openapi.yaml | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5f2f687..ee08b83 100644
--- a/README.md
+++ b/README.md
@@ -145,7 +145,7 @@ go run ./cmd/fanqie
 
 | 接口 | 方法 | 说明 | 参数 |
 | ------ | ------ | ------ | ------ |
-| `/search` | GET | 搜索书籍 | `query`（或 `key`）, `tab_type`, `offset` |
+| `/search` | GET | 搜索书籍 | `query`（或 `key`）, `tab_type`, `offset`（`search_tabs` 仅返回匹配 `tab_type` 的 tab） |
 | `/detail` | GET | 书籍详情 | `book_id` |
 | `/info` | GET | 书籍详情（同 detail） | `book_id` |
 | `/catalog` | GET | 章节目录 | `book_id` |
diff --git a/openapi.yaml b/openapi.yaml
index 5196cfe..0cfc445 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -171,12 +171,12 @@ paths:
           example: 0
         - name: tab_type
           in: query
-          description: 搜索类型,默认 3
+          description: 搜索类型,默认 3;响应 search_tabs 仅保留匹配该值的 tab
           schema: { type: integer, default: 3 }
           example: 3
       responses:
         "200":
-          description: 搜索结果(上游转发,结构以实际返回为准)
+          description: 搜索结果(search_tabs 已按请求的 tab_type 过滤,仅保留匹配项)
           content:
             application/json:
               schema: