From 7d498406b1bf726c4f1dc9c3ec1e4c045a76bf59 Mon Sep 17 00:00:00 2001 From: ucmao <294323976@qq.com> Date: Wed, 30 Sep 2026 07:17:21 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=BC=BA=E5=85=83=E5=AE=9D=E4=B8=8E?= =?UTF-8?q?=E8=A7=86=E9=A2=91=E5=8F=B7Cookie=E5=85=BC=E5=AE=B9=E6=98=A0?= =?UTF-8?q?=E5=B0=84=E5=B9=B6=E4=BC=98=E5=8C=96=E5=90=8E=E5=8F=B0=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E4=B8=8E=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/cookie-config.md | 2 +- docs/parsers/wechat-channels.md | 12 +++++----- src/utils/cookie_manager.py | 2 +- templates/admin/settings.html | 40 ++++++++++++++++----------------- tests/test_cookie_manager.py | 6 +++++ 5 files changed, 33 insertions(+), 29 deletions(-) diff --git a/docs/cookie-config.md b/docs/cookie-config.md index 3e893c3..6bafb05 100644 --- a/docs/cookie-config.md +++ b/docs/cookie-config.md @@ -11,7 +11,7 @@ | 平台名称 | 环境变量 Key | 别名支持 | 必要性 / 使用场景 | 推荐精简字段 | | :--- | :--- | :--- | :--- | :--- | | **小红书** | `XHS_COOKIE` | `XIAOHONGSHU_COOKIE` | 🟡 **可选 (防风控)**:日常免 Cookie 解析;机房 IP 遭遇 302 登录拦截时配置 | `a1=xxx; webId=xxx; web_session=xxx;` | -| **微信视频号** | `YUANBAO_COOKIE` | `WECHAT_CHANNELS_COOKIE` | 🔐 **必需 (媒体流)**:提取视频号无水印视频流与图集(依赖腾讯元宝接口) | `hy_user=xxx; hy_token=xxx;` | +| **微信视频号** | `YUANBAO_COOKIE` | `WECHAT_CHANNELS_COOKIE` | 🔐 **必需 (媒体流与标题)**:提取视频号无水印视频直链、视频标题与高清图集(微信官方加强了匿名 `generalToken` 鉴权,匿名模式下视频直链与标题为空,必须依赖元宝 Cookie) | `hy_user=xxx; hy_token=xxx;` | | **快手** | `KUAISHOU_COOKIE` | `KS_COOKIE` | 🟡 **可选 (防风控)**:日常免 Cookie 解析;触发 `result: 2` 反爬时配置 | `kpf=PC_WEB; kpn=KUAISHOU_VISION; did=xxx;` | | **拼多多** | `PINDUODUO_COOKIE` | `PDD_COOKIE` | 🟡 **部分依赖**:商品图集免 Cookie;多多视频短视频流解析需要 | `PDDAccessToken=xxx;` | | **豆包 AI** | `DOUBAO_COOKIE` | - | 🟡 **可选 (无水印)**:公开图文免 Cookie;提取 1080P 无水印视频需要 | `sessionid_ss=xxx;` | diff --git a/docs/parsers/wechat-channels.md b/docs/parsers/wechat-channels.md index de07bbf..530d383 100644 --- a/docs/parsers/wechat-channels.md +++ b/docs/parsers/wechat-channels.md @@ -17,8 +17,8 @@ * 视频号图集短链:`https://weixin.qq.com/sph/APclmPJEZ0` * H5 预览页长链:`https://channels.weixin.qq.com/finder-preview/pages/sph?id={short_id}` * **Cookie 依赖**: - * **公开基础信息 (标题/作者/封面)**:**无需 Cookie**(匿名请求官方 Finder Preview H5 页面即可提取)。 - * **完整媒体流 (高清无水印视频 / 高清图集 / 原声音乐)**:由于微信官方对媒体流和图集进行了鉴权限制(匿名访问仅返回 `picInfo: []` 与封面图),系统采用**腾讯元宝接口代理**方案,需在 `.env` 中配置 `YUANBAO_COOKIE`。 + * **基础作者信息 (作者昵称/头像/封面)**:**无需 Cookie**(匿名访问 Finder Preview 仅能提取作者与封面,无法解析视频直链与标题)。 + * **完整媒体流 (无水印视频直链 / 高清图集 / 视频标题 / 原声音频)**:由于微信官方对媒体流和标题进行了强鉴权限制(匿名 `generalToken: ""` 模式下接口不再返回 `videoUrl`、`title` 及 `picInfo`),系统采用**腾讯元宝接口代理**换取临时 `generalToken` 凭证,必须在 `.env` 中配置 `YUANBAO_COOKIE`。 * ⚠️ **隐私提示**:`YUANBAO_COOKIE` 包含腾讯元宝平台个人账号的会话凭证(`hy_user` 与 `hy_token`),属于**个人账号登录隐私凭证**,**强烈建议使用闲置小号**进行配置。 --- @@ -35,12 +35,12 @@ flowchart TD ExtractAuth --> FeedInfoAPI["请求 finder-preview get_feed_info 接口"] FeedInfoAPI --> MediaTypeCheck{"媒体类型判断"} - MediaTypeCheck -->|"mediaType == 4 (视频)"| ExtractVideo["提取原始未加密 MP4 视频直链 (H264/H265)"] - MediaTypeCheck -->|"mediaType == 2 (图集)"| ExtractAlbum["提取完整 picInfo 高清图集列表 + bgmInfo 原声音频"] + MediaTypeCheck -->|"mediaType == 4 (视频)"| ExtractVideo["提取原始未加密 MP4 视频直链 (H264/H265) + 标题"] + MediaTypeCheck -->|"mediaType == 2 (图集)"| ExtractAlbum["提取完整 picInfo 高清图集列表 + bgmInfo 原声音频 + 标题"] - AuthCheck -->|"未配置 / 接口异常"| PublicFallback["触发官方 H5 页面匿名兜底"] + AuthCheck -->|"未配置 / Cookie失效"| PublicFallback["触发官方 H5 页面匿名兜底"] PublicFallback --> FinderAPI["请求 finder-preview 页面与 feed 接口 (仅 shortUri)"] - FinderAPI --> BasicInfo["提取标题、作者、封面与公开元数据 (无媒体流)"] + FinderAPI --> BasicInfo["仅能提取作者昵称、头像与封面 (视频/图集/标题均为空)"] ``` ### 2.1 核心 API diff --git a/src/utils/cookie_manager.py b/src/utils/cookie_manager.py index 62369a4..e1a23bd 100644 --- a/src/utils/cookie_manager.py +++ b/src/utils/cookie_manager.py @@ -6,7 +6,7 @@ PLATFORM_COOKIE_ALIASES = { "xiaohongshu": ["XHS_COOKIE", "XIAOHONGSHU_COOKIE"], "pinduoduo": ["PINDUODUO_COOKIE", "PDD_COOKIE"], "douyin": ["DOUYIN_COOKIE", "DY_COOKIE"], - "yuanbao": ["YUANBAO_COOKIE"], + "yuanbao": ["YUANBAO_COOKIE", "WECHAT_CHANNELS_COOKIE"], "wechat_channels": ["YUANBAO_COOKIE", "WECHAT_CHANNELS_COOKIE"], "doubao": ["DOUBAO_COOKIE"], "jimeng": ["JIMENG_COOKIE"], diff --git a/templates/admin/settings.html b/templates/admin/settings.html index 2f957ec..40fe41a 100644 --- a/templates/admin/settings.html +++ b/templates/admin/settings.html @@ -224,26 +224,25 @@ 平台 Cookie 凭据覆盖配置

此处配置具有最高优先级(覆盖 .env - 环境变量)。保存后无需重启即可即时生效;清空输入框并保存即可自动恢复读取 .env 凭据。

+ 环境变量)。保存后即时生效;支持直接复制粘贴浏览器中的完整 Cookie 字符串或推荐精简字段,清空并保存自动恢复读取 .env 凭据。

- +
- - 后台键名: cookie_wechat_channels / + 后台键名: cookie_yuanbao / 降级环境变量: YUANBAO_COOKIE
- -

用于解析微信视频号无水印视频与图集内容。

+ +

腾讯元宝登录凭据。用于微信视频号无水印视频/图集及元宝 AI 内容的解析提取。

@@ -257,7 +256,7 @@ XHS_COOKIE

用于绕过小红书风控阻断与提取高清无水印图集/视频。

@@ -274,7 +273,7 @@ KUAISHOU_COOKIE

用于解除快手风控阻断或滑块验证要求。

@@ -291,8 +290,7 @@ PINDUODUO_COOKIE

用于拼多多商品/视频页面详情提取。

@@ -307,7 +305,7 @@ DOUYIN_COOKIE

可选。常规抖音内容免 Cookie,针对受限作品做风控退避。

@@ -322,8 +320,8 @@ 后台键名: cookie_weibo / 降级环境变量: WEIBO_COOKIE -

可选。常规内容免 Cookie,遇到频繁抓包限制时提供。

@@ -337,8 +335,8 @@ 后台键名: cookie_doubao / 降级环境变量: DOUBAO_COOKIE -

用于提取豆包 AI 对话中的视频/生成媒体。

@@ -352,8 +350,8 @@ 后台键名: cookie_jimeng / 降级环境变量: JIMENG_COOKIE -

用于即梦 AI 生成内容的接口凭据支持。

diff --git a/tests/test_cookie_manager.py b/tests/test_cookie_manager.py index fe9f8d1..3fc122e 100644 --- a/tests/test_cookie_manager.py +++ b/tests/test_cookie_manager.py @@ -38,6 +38,12 @@ class CookieManagerTest(unittest.TestCase): cookie = get_platform_cookie("wechat_channels") self.assertEqual(cookie, "pass_ticket=from_env;") + def test_db_setting_yuanbao_reads_wechat_channels_cookie(self): + with patch("src.db.setting", side_effect=lambda k: "hybrid_sess=from_db;" if k == "cookie_wechat_channels" else None): + with patch.dict(os.environ, {}, clear=True): + cookie = get_platform_cookie("yuanbao") + self.assertEqual(cookie, "hybrid_sess=from_db;") + def test_supported_platform_aliases(self): self.assertIn("xhs", PLATFORM_COOKIE_ALIASES) self.assertIn("douyin", PLATFORM_COOKIE_ALIASES)