萌趣提取器

项目借鉴自 parse-video-py，在保留原始萌萌趣味的基础上做了桌面化整理，并加了一点顺手的小功能。

一个偏 QQ 萌系风格的原生桌面解析小工具。

它不想做那种冷冰冰的“工具壳子”，而是把可爱的界面气质、轻快的交互反馈、顺手的解析体验都揉在一起。打开以后，语录会轻轻跳出来，主题色软软的，按钮文案也会带一点小俏皮，但真正点下去时，它又能认真把链接识别、资源解析、封面预览、下载保存这些事都做好。

项目定位

萌趣提取器 的核心目标很简单：

• 保留原本那套萌趣 UI 和动画氛围
• 用原生桌面方式承载解析体验
• 让窗口打开快、解析不卡、下载更稳
• 把复杂的解析流程藏在后台线程里

它更像一个轻盈的小助手，而不是一个生硬的下载面板。

界面特色

这个项目保留了原始 UI 的核心视觉语言和互动感觉：

• HITOKOTO 萌系语录
• 多套软萌主题色
• 浅色 / 深色模式切换
• 毛玻璃主卡片
• 全局 QSS 注入样式
• 萌趣按钮文案
• 解析进度和下载进度的动态反馈
• 结果卡片 + 封面预览 + 标签展示

整体观感偏轻、偏软、偏灵动，适合做一个“看起来就愿意点开”的桌面小应用。

界面预览

1. 主界面

   主界面走的是软萌又轻快的路线，主卡片、按钮文案和结果区会先把氛围感托起来，点下解析以后也能把封面预览、资源信息和下载动作顺顺地接住，属于那种看着萌、用着也很顺手的类型。

   

2. 设置界面

   设置界面会更偏清爽一点，把常用开关和保存路径整理得明明白白，像“下载封面”“独立文件夹”这类选项放进去以后，整体还是保留了那种乖乖软软的萌感，但操作上不会显得乱。

   

技术框架

当前项目采用的是 原生 UI + 异步解析驱动 架构。

• PyQt6 负责主窗口、设置弹窗、扫码弹窗、进度条、主题样式和界面交互。

• QThread 负责解析线程和下载线程，避免主线程阻塞。

• httpx 负责异步请求、资源探测和流式下载。

• QNetworkAccessManager 负责二维码、封面图等轻量网络资源加载。

• Parser 插件结构 各平台独立解析模块，后续扩展更方便。

• Cookie / 扫码登录 面向 B 站凭证场景，支持 cook/ 目录读取与扫码保存。

• ffmpeg 可选用于 DASH 音视频封装。

支持平台

当前项目已接入这些平台的解析能力：

• Bilibili
• 抖音
• 快手
• 微博
• 小红书
• Twitter / X
• AcFun
• 好看视频
• 西瓜视频
• 皮皮虾
• 皮皮搞笑
• 全民小视频
• 全民 K 歌
• 六间房
• 虎牙
• 美拍
• 逗拍
• 绿洲
• 梨视频
• 新片场
• 最右
• 微视

资源类型支持情况会随平台有所不同，常见包括：

• 单视频
• 视频 + 音频分离资源
• 图集
• Live Photo / 动图类资源

主要功能

自动识别链接

• 支持从剪切板自动拾取分享链接
• 支持从整段分享文案中提取真实 URL
• 复制新的链接后可以自动切换解析目标

原生界面秒开

• 主入口精简
• 启动阶段尽量减少重依赖阻塞
• 部分解析逻辑按需延迟加载
• 更贴近“先出界面、后做事”的体验

后台异步解析

• 点击后进入后台线程处理
• 主界面保持响应
• 解析成功 / 失败都能及时回传
• 结果自动映射到主界面卡片

封面与资源展示

• 视频解析后显示对应封面
• 图文解析后首图自动做预览
• 展示标题、作者、资源数和清晰度标签

真实下载进度

• 采用流式写入文件
• 优先按真实字节数计算进度
• 总大小未知时自动切换为分项进度
• 下载按钮状态会实时刷新

B 站登录与高画质支持

• 支持读取 cook/ 文件夹中的 cookie
• 支持扫码登录并保存凭证
• 有效凭证时优先尝试更高画质
• 凭证无效时自动回退可用清晰度

下载行为设置

设置界面已经支持这两个默认关闭的选项：

• 下载封面 关闭时不把封面加入下载队列，开启后资源统计会立即刷新。

• 独立文件夹 关闭时直接保存到当前保存目录，开启后会按标题创建独立文件夹。

保存路径管理

• 可在设置中自由选择保存位置
• 资源会按标题自动命名
• 路径逻辑更适合后续继续做安卓迁移适配

适用平台

当前主要适用于：

• Windows 桌面端

同时项目结构已经为后续跨平台迁移做了整理，后面继续往 Android 方向适配时，改动成本会更低一些。

目录结构

根目录保持简洁，只保留主入口和说明文件。

• start.py 项目唯一启动入口。

• README.md 当前项目说明。

• app/ 主程序界面层，包含窗口、状态、线程、下载、弹窗等模块。

• parser/ 各平台解析器。

• core/ 解析器公共基类和注册逻辑。

• utils/ URL 工具、cookie 工具等公共辅助模块。

• cook/ B 站 cookie 和扫码登录凭证目录。

• docs/ 依赖清单等辅助资料。

启动方式

先准备一个不太老的 Python 环境会更省心一点，建议使用 Python 3.10+，这样和当前代码里的类型写法会更合拍，跑起来也会乖一些。

安装依赖：

pip install -r docs/requirements.txt

启动程序：

python start.py

一句话总结

这是一个保留了萌趣界面灵魂、又认真把解析、预览、下载、登录这些能力做进去了的原生桌面提取器。