XDownload — X/Twitter 视频下载器

仓库：MuZiCul/XDownload（原创）· 语言：Rust (Tauri v2) + TypeScript · 定位：X/Twitter 视频/图片下载桌面应用

项目简介

Paste an X/Twitter video link → get the video info → download it. That's it.

用 Rust + Tauri v2 打造的桌面下载器，底层依赖 yt-dlp + ffmpeg。粘贴链接 → 解析信息 → 下载。

架构（源码级）

Rust 后端模块划分

src-tauri/src/
├── main.rs          # 入口
├── lib.rs           # 库入口（Tauri 命令注册）
├── tray.rs          # 系统托盘
├── commands/        # 10 个 Tauri 命令模块（前端调用接口）
├── downloader/      # 下载核心（yt-dlp 调用、进度、队列）
├── services/        # 14 个服务模块（历史、书签、统计、更新、代理、Cookie…）
├── models/          # 数据模型（SQLite 实体）
└── utils/           # 工具函数

分层清晰：commands 暴露 Tauri IPC 接口 → services 承载业务逻辑 → downloader 专注下载 → models 定义持久化结构。这是 Tauri 应用的推荐架构。

技术栈

• 桌面壳：Tauri v2（Windows 平台，Rust edition 2021）
• 前端：Node.js 18+ / pnpm
• 下载核心：yt-dlp + ffmpeg（首次启动自动下载，或手动放 bin/）
• 数据库：SQLite（连接池 + WAL 模式）
• 打包：NSIS（.exe）/ MSI

核心功能详解

1. 下载引擎

• 粘贴即解析：显示标题/时长/缩略图/格式
• 智能最优质量：自动下载最高质量视频+音频并合并，无需手选
• ** staged 进度**：分离的视频/音频流分阶段显示，ffmpeg 合并时有独立进度条
• 原子下载：文件只在成功合并后才出现在下载目录——中断/取消不残留半成品
• 速度控制：每任务限速 + 可配 HLS 分片并发与重试数，加速 X 的分片流
• 多媒体推文：一次下载推文内所有视频/图片
• 队列控制：置顶/上移排序、单个或全部暂停/继续

2. 历史与书签

• 下载历史：封面、作者、时长、播放量、点赞、下载时间；搜索过滤；时间徽章（5 分钟内 → 10 年）
• 书签同步：一键同步 X 书签，按下载状态颜色区分，批量/单个入队
• 书签目录：本地 SQLite 持久化，离线浏览

3. 高级特性

• 浏览器扩展（MV3）：X 帖子上一键深链到桌面应用，v1.3.0 起自动捕获并推送 bookmarks 所需 queryId
• 代理：HTTP/SOCKS5，自动检测系统代理，设置即时生效，非法端口/主机输入在源头拒绝
• Cookie 导入：从浏览器导入（书签页显示登录用户名，按 Cookie 指纹缓存，仅在浏览器源变更时重取）
• 隐私模式：标题 *** 打码 + 封面磨砂模糊，可从设置/状态栏/托盘切换，重启保持
• 应用内日志查看器：暗色主题、ANSI 分级着色、按日期分 Tab、级别过滤、可复制、2s 自动刷新
• 下载统计：Apple 风格面板（总数/存储/成功率/使用天数）+ ECharts 图表（每日趋势、来源分布、Top 创作者、Top 账号）
• 批量深链：快速点击多个帖子合并为一批（去重、并发拉信息），只弹一个 toast
• 深链去重：已下载的视频询问确认（重新下载/跳过），不静默重复添加
• 来源徽章：任务/历史卡片标注来源（书签/批量/深链/单链接）
• i18n：中英双语即时切换，无需重启
• 防休眠：下载时保持系统唤醒，队列清空/退出后自动恢复

4. 性能与可靠性

• 数据库优化：连接池 + WAL 模式，读并发不阻塞下载写入
• 历史列表虚拟化：数千条记录依然流畅
• 分割滚动视图：活动下载与历史列表独立滚动（≥2 个活动任务时 50/50，否则 30/70）
• 缓存清理：启动时清理 7 天未动的残留分片；暂停/取消立即清除暂存

构建与发布

pnpm dev          # 开发（热重载）
.\build.bat       # 打包（Windows）

发布产物：XDownload_2.9.9_x64-setup.exe（NSIS）/ .msi

点评

这个项目功能点最多，下载核心、书签同步、浏览器扩展、统计面板、隐私模式、日志查看器都做了。

技术上属于比较标准的现代桌面应用做法： - Rust + Tauri 带来极小体积与原生性能 - 命令/服务/模型分层让 40+ Rust 文件依然可维护 - SQLite WAL + 连接池 + 虚拟列表解决大数据量下的性能问题 - 原子下载 + 缓存清理 + 防休眠是为了避免下载残留和中断

如果有人想做 Tauri 桌面开发、研究 Rust 工程组织，或集成 yt-dlp，这个项目可以拿来对照。