From bf961fb30bbd13ba9d04d16466eb8a851932297b Mon Sep 17 00:00:00 2001
From: ucmao <294323976@qq.com>
Date: Sat, 26 Sep 2026 09:37:24 +0800
Subject: [PATCH] =?UTF-8?q?fix(fanqie):=20=E5=88=86=E4=BA=AB=E9=A1=B5?=
=?UTF-8?q?=E5=8F=AA=E5=89=A930=E7=A7=92=E8=AF=95=E7=9C=8B=E6=97=B6?=
=?UTF-8?q?=E6=94=B9=E4=BB=8E=E5=AE=98=E7=BD=91=E6=92=AD=E6=94=BE=E5=99=A8?=
=?UTF-8?q?=E5=8F=96=E5=AE=8C=E6=95=B4=E5=88=86=E9=9B=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/index.md | 6 ++--
docs/parsers/fanqie.md | 20 +++++++++++
src/parsers/fanqie_parser.py | 65 +++++++++++++++++++++++++++++++++++-
tests/test_fanqie_parser.py | 57 +++++++++++++++++++++++++++++++
4 files changed, 144 insertions(+), 4 deletions(-)
diff --git a/docs/index.md b/docs/index.md
index 414e8e4..25980b6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -68,9 +68,9 @@
| 35 | **快影** | 模板视频 / 原声音乐 | ✅ 支持 | 🟢 免配置 | 快影 OpenAPI + 动态签名 | [查看指南](parsers/kwaiying.md) |
| 36 | **微信公众号** | 视频 / 文章插图图集 / 音频 | ✅ 支持 | 🟢 免配置 | SSR 正文解析 + 1080P 视频流提取与原画升级 | [查看指南](parsers/wechat-mp.md) |
| 37 | **拼多多** | 多多视频 / 商品图集 / 实物原图 | ✅ 支持 | 🟡 视频需 Cookie / 商品免配置 | anti-content 动态验签 + 307 素材提取 | [查看指南](parsers/pinduoduo.md) |
-| 38 | **番茄小说** | 短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页 HTML 提取 | [查看指南](parsers/fanqie.md) |
-| 39 | **红果短剧** | 短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页 HTML 提取 | [查看指南](parsers/fanqie.md) |
-| 40 | **红果漫剧** | 漫剧/短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页 HTML 提取 | [查看指南](parsers/fanqie.md) |
+| 38 | **番茄小说** | 短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页提取 + 官网播放器完整分集置换 | [查看指南](parsers/fanqie.md) |
+| 39 | **红果短剧** | 短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页提取 + 官网播放器完整分集置换 | [查看指南](parsers/fanqie.md) |
+| 40 | **红果漫剧** | 漫剧/短剧视频 | ✅ 支持 | 🟢 免配置 | H5 推广页提取 + 官网播放器完整分集置换 | [查看指南](parsers/fanqie.md) |
| 41 | **QQ音乐** | 歌曲音频 / LRC 歌词 / MV / 多档 MP4 | ✅ 支持 | 🟢 免配置 | PC Web 协议 + MusicU 播放与歌词接口 | [查看指南](parsers/qqmusic.md) |
| 42 | **网易云音乐** | MV / Mlog / 歌曲 / 动态图集与 LivePhoto | ✅ 支持 | 🟢 公开内容免配置 | SSR / Event 数据 + 公开播放接口 | [查看指南](parsers/netease-music.md) |
| 43 | **酷狗音乐** | MV / 免费歌曲 / 多档 MP4 | ✅ 支持 | 🟢 公开内容免配置 | H5 公开接口签名 + 分享页数据 | [查看指南](parsers/kugou-music.md) |
diff --git a/docs/parsers/fanqie.md b/docs/parsers/fanqie.md
index dca9ce0..908f42d 100644
--- a/docs/parsers/fanqie.md
+++ b/docs/parsers/fanqie.md
@@ -43,3 +43,23 @@
```
+
+---
+
+## 4. 推广落地页只给 30 秒试看处理机制
+
+### 现象与原理
+* 推广落地页中 `series_data.play_url` 携带 `&start=0&end=30`,且 CDN 上的实体切片本身仅 30 秒(约 1.85 MB)。
+* 鉴权签名覆盖整个 Query 参数,修改 `end`、删除参数或追加 `&full=1` 均会导致 CDN 返回 **HTTP 403**。
+
+### 完整分集置换方案
+当检测到 `play_url` 包含试看标识(`[?&]end=\d+`)时,通过以下逻辑获取完整分集:
+1. 从 `window._ROUTER_DATA` 提取:
+ * **剧集 ID**:`linkParams.schemeParams.video_id`
+ * **分集 ID**:`pageData.used_chapter_id`
+2. 请求官网网页播放器:`https://hongguoduanju.com/player/<剧集 ID>/<分集 ID>`。
+3. 从页面 `
+