增强元宝与视频号Cookie兼容映射并优化后台提示与文档

This commit is contained in:
ucmao
2026-09-30 07:17:21 +08:00
parent b1d541cc66
commit 7d498406b1
5 changed files with 33 additions and 29 deletions
+1 -1
View File
@@ -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;` |
+6 -6
View File
@@ -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
+1 -1
View File
@@ -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"],
+19 -21
View File
@@ -224,26 +224,25 @@
平台 Cookie 凭据覆盖配置
</h2>
<p class="text-xs text-slate-500 mt-1">此处配置具有最高优先级(覆盖 <code>.env</code>
环境变量)。保存后无需重启即可即时生效;清空输入框并保存即可自动恢复读取 <code>.env</code> 凭据。</p>
环境变量)。保存后即时生效;支持直接复制粘贴浏览器中的完整 Cookie 字符串或推荐精简字段,清空并保存自动恢复读取 <code>.env</code> 凭据。</p>
</div>
</div>
<div class="space-y-5 text-xs">
<!-- 微信视频号 / 腾讯元宝 -->
<!-- 腾讯元宝 (Yuanbao) -->
<div class="space-y-1.5">
<div class="flex items-center justify-between">
<label for="cookie_wechat_channels"
<label for="cookie_yuanbao"
class="font-semibold text-slate-900 flex items-center gap-2">
<span>微信视频号 / 腾讯元宝</span>
<span>腾讯元宝 (Yuanbao)</span>
</label>
<span class="text-[11px] text-slate-400">后台键名: <code>cookie_wechat_channels</code> /
<span class="text-[11px] text-slate-400">后台键名: <code>cookie_yuanbao</code> /
降级环境变量: <code>YUANBAO_COOKIE</code></span>
</div>
<textarea id="cookie_wechat_channels" name="cookie_wechat_channels" rows="2"
placeholder="格式例: hybrid_sess=...; pass_ticket=..."
onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_wechat_channels', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于解析微信视频号无水印视频与图集内容。</p>
<textarea id="cookie_yuanbao" name="cookie_yuanbao" rows="2"
placeholder="推荐精简字段: hy_user=xxx; hy_token=xxx;" onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_yuanbao', settings.get('cookie_wechat_channels', '')) }}</textarea>
<p class="text-[11px] text-slate-400">腾讯元宝登录凭据。用于微信视频号无水印视频/图集及元宝 AI 内容的解析提取。</p>
</div>
<!-- 小红书 -->
@@ -257,7 +256,7 @@
<code>XHS_COOKIE</code></span>
</div>
<textarea id="cookie_xiaohongshu" name="cookie_xiaohongshu" rows="2"
placeholder="格式例: a1=...; webId=...; web_session=..."
placeholder="推荐精简字段: a1=xxx; webId=xxx; web_session=xxx;"
onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_xiaohongshu', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于绕过小红书风控阻断与提取高清无水印图集/视频。</p>
@@ -274,7 +273,7 @@
<code>KUAISHOU_COOKIE</code></span>
</div>
<textarea id="cookie_kuaishou" name="cookie_kuaishou" rows="2"
placeholder="格式例: did=...; kuaishou.server.web_st=..."
placeholder="推荐精简字段: kpf=PC_WEB; kpn=KUAISHOU_VISION; did=xxx;"
onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_kuaishou', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于解除快手风控阻断或滑块验证要求。</p>
@@ -291,8 +290,7 @@
<code>PINDUODUO_COOKIE</code></span>
</div>
<textarea id="cookie_pinduoduo" name="cookie_pinduoduo" rows="2"
placeholder="格式例: PDDAccessToken=...; pdd_user_id=..."
onchange="triggerSettingsSubmit(this)"
placeholder="推荐精简字段: PDDAccessToken=xxx;" onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_pinduoduo', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于拼多多商品/视频页面详情提取。</p>
</div>
@@ -307,7 +305,7 @@
<code>DOUYIN_COOKIE</code></span>
</div>
<textarea id="cookie_douyin" name="cookie_douyin" rows="2"
placeholder="格式例: passport_csrf_token=...; sessionid=..."
placeholder="推荐精简字段 (实况图/受限作品): UIFID=xxx; sessionid=xxx; sessionid_ss=xxx; passport_csrf_token=xxx; odin_tt=xxx;"
onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_douyin', '') }}</textarea>
<p class="text-[11px] text-slate-400">可选。常规抖音内容免 Cookie,针对受限作品做风控退避。</p>
@@ -322,8 +320,8 @@
<span class="text-[11px] text-slate-400">后台键名: <code>cookie_weibo</code> / 降级环境变量:
<code>WEIBO_COOKIE</code></span>
</div>
<textarea id="cookie_weibo" name="cookie_weibo" rows="2"
placeholder="格式例: SUB=...; SUBP=..." onchange="triggerSettingsSubmit(this)"
<textarea id="cookie_weibo" name="cookie_weibo" rows="2" placeholder="推荐精简字段: SUB=xxx;"
onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_weibo', '') }}</textarea>
<p class="text-[11px] text-slate-400">可选。常规内容免 Cookie,遇到频繁抓包限制时提供。</p>
</div>
@@ -337,8 +335,8 @@
<span class="text-[11px] text-slate-400">后台键名: <code>cookie_doubao</code> / 降级环境变量:
<code>DOUBAO_COOKIE</code></span>
</div>
<textarea id="cookie_doubao" name="cookie_doubao" rows="2" placeholder="格式例: sessionid=..."
onchange="triggerSettingsSubmit(this)"
<textarea id="cookie_doubao" name="cookie_doubao" rows="2"
placeholder="推荐精简字段: sessionid_ss=xxx;" onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_doubao', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于提取豆包 AI 对话中的视频/生成媒体。</p>
</div>
@@ -352,8 +350,8 @@
<span class="text-[11px] text-slate-400">后台键名: <code>cookie_jimeng</code> / 降级环境变量:
<code>JIMENG_COOKIE</code></span>
</div>
<textarea id="cookie_jimeng" name="cookie_jimeng" rows="2" placeholder="格式例: sessionid=..."
onchange="triggerSettingsSubmit(this)"
<textarea id="cookie_jimeng" name="cookie_jimeng" rows="2"
placeholder="推荐精简字段: sessionid=xxx;" onchange="triggerSettingsSubmit(this)"
class="w-full px-3.5 py-2 font-mono text-xs rounded-lg border border-slate-200 focus:outline-none focus:border-brand focus:ring-2 focus:ring-brand/20 transition bg-slate-50/50 custom-scroll">{{ settings.get('cookie_jimeng', '') }}</textarea>
<p class="text-[11px] text-slate-400">用于即梦 AI 生成内容的接口凭据支持。</p>
</div>
+6
View File
@@ -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)